Internal Errigal Collaboration Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
=====Introduction to Ticket Forms (creation, modification)=====

Author: Sophie Renshaw


===Forms in Tickets===
Forms are a key part of every ticket. The forms differ between workflows and customers but they all have an important role in the tickets that they are assigned to. 

=== Ticket Form Creation Flow diagram  ===

{{:onboarding:ticketer:ticketer_form_creation_diagram.png?200|}}

=== Ticket Form Publish Action Flow diagram  ===

{{:onboarding:ticketer:ticketer_form_publish_func_diagram.png?200|}}

ER Diagram:

{{:onboarding:ticketer:er_diagram_for_ticketer_forms.png?200|}}

=== Adding a Form to a Ticket ===

To add a form to a ticket navigate to the forms section of the ticket at the bottom half of the screen. There you will see a dropdown menu and two buttons. Clicking the dropdown menu will allow you to select which form you would like to add. Once the forms has been added you will need to fill in all relevant fields and click Save Forms before it is saved to the ticket. If you want to remove the form that you just added (but haven't saved yet) or undo some changes that you made to a form you can click the Discard Changes Button.

{{:onboarding:ticketer:screen_shot_2016-08-25_at_10.45.39.png?300|}}


----


=== Key Customer Forms ===

Possibly the two most important and customer visible forms are the relevant NOC forms. For ExteNet it is the ExteNet NOC Form. These forms are added to all tickets that create as a result of us receiving an alarm into the Node Monitor. These forms are usually added automatically when the ticket is transitioned into a state of investigation by the NOC. The NOC forms can also be added to Manual Tickets. 

The top half of both forms have very similar functionality. It allows the user to select the affected network element down to the Node Level. The dropdowns are populated with info related to what was selected in the previous dropdowns. The bottom half of the forms relates to Neutral Hosts. 

__ExteNet NOC Form__
{{:onboarding:ticketer:screen_shot_2016-08-25_at_10.45.59.png?1000|}}


Another key form that customers use is the SNMP Trap form. This form is added when the ticket is automatically opened upon receiving an alarm. It is also auto-populated with relevant information. 


__ExteNet SNMP Trap Form__
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.22.56.png?1000|}}


----


===Form Creation and Modification===

One type of support task that we receive is for the creation or modification of forms. To carry out these tasks we use the Form Architect in the Ticketer.

{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.29.53.png?1000|}}

This allows us to build the forms using different types of components depending on what is requested, either by the customer or internally. 

To build a form you can drag and drop the component into the white space below. You will need to provide it with a component name that will be used in the database to reference it. After that you can define the different necessary fields. 

It is also possible to add groovy functionality to the components, using groovlets, and define validation on each component with either preset or custom validators. 

There are a number of different components available:
  * Text Label 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.43.32.png?200|}}
  * Text Box 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.43.41.png?200|}}
  * Dropdown List (Static options) 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.43.49.png?200|}}
  * Check box 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.43.54.png?200|}}
  * Text Area 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.43.59.png?200|}}
  * Dropdown List (Database Options) 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.44.05.png?200|}}
  * Date 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.44.11.png?200|}}
  * Time 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.44.18.png?200|}}
  * Hyperlink 
{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.44.24.png?200|}}


----


==Form Component Properties==

{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.51.02.png?500|}}

Double clicking on a component will open it's properties window. From here you can fill in the Description Text, whether the component is Editable, Hidden or Tracked in Running Log, The initial Value and the size of the component. You can also define groovlets and validation in this window. Restrictions can also be set on the form component to allow the field to be editable to users with certain roles.

{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.57.33.png?500|}}


----


==Form Role & Market Visibilities, Advance Properties==

{{:onboarding:ticketer:screen_shot_2016-08-25_at_11.59.05.png?200|}}

Selecting the Current Form dropdown in the top left corner of the Form Architect will allow you to set the role and market visibilities as well as managing the advance properties on the form. 


**Market Visibilities**

Setting the market visibilities on a form will only allow the users with that visibility (or any visibility above that) to see the form. If the Strict Visibility checkbox is checked then only users with that specific visibility can see the form. 

{{:onboarding:ticketer:screen_shot_2016-08-25_at_12.01.33.png?500|}}


**Role Visibilities**

Similarly to the specific form components, role visibilities can also be set on the entire form. For the Role Visibilities there are two options: Hide Form and Editable. Hide form means that only users with the defined role can see the form (they must also have the market visibility as well) and Editable means that only users with that role can edit the form. 

{{:onboarding:ticketer:screen_shot_2016-08-25_at_12.04.25.png?500|}}


**Advanced Properties**

Selecting Manage Advanced Properties from the dropdown will direct you to a new page. Here you will be able to define if a ticket is allowed to have more than one of these forms added to it, either by the users or automatically by the system. This functionality can also be controlled using groovlets. 



----


=====Onboarding Self Assessment=====
  - Open a ticket and select a new form to add to the ticket. 
  - Populate the relevant fields with information. (S)
  - Click the discard changes button and confirm that the form is removed from the ticket. Click the Refresh ticket button to make sure of this.
  - Add another form to the ticket, populate and click Save Forms. Refresh ticket to confirm the form has been saved to the ticket. (S)
  - Make a change to a ticket that is already on a form, click the Save Forms button and ensure that your changes have applied
  - Open the Form Architect. Create a new form with different components. (S) 
  - Open the properties of all components that you added and ensure that all have the necessary fields populated. Mark some as Editable, some as Hidden and some to be tracked in running log. (S)
  - Add validators to some and try to define a custom validator for one component. (S)
  - Publish the new form.
  - Re-open the form and define role and market visibilities. (S)
  - Publish the form and add your new form to a ticket. Populate all fields and make sure that the ones that you have marked as Hidden, Editable and Track in running log behave as expected. (S)
  - Close the ticket. Re-open the ticket and confirm that all your changes have been saved. 
**Please as your mentor to go through the relevant ticket numbers and screenshots (steps marked with an S require a screenshot) with you to ensure they are correct.**
Sidebar

Internal Errigal Collaboration Wiki

User Tools

Site Tools

Page Tools
