The Form Editor

Last modified on 2023/07/17 16:14

Definition

Forms are used to display information on objects, e.g. incidents, catalog entries, problems, in the Service Manager interface. Open url.png See the description of the Form mode.

You can update forms in the editor if you are an employee authorized to edit them.

EndDefinition

Each form:

  • Is built using a parent query specific to the menu option.
  • Has a title and an overview found in the top banner.
  • Is linked to a main form presentation made up of two parts:
    • The Details tab containing the main information on the record.
    • A set of tabs and sub-tabs called areas containing additional information in grids (tables) or forms.
  • Is designed by placing different types of objects, e.g. text, tree or list fields, action buttons or hyperlinks, and data separators. Each of these objects has properties for defining its layout and behavior in the interface, e.g. field name, size, or associated actions.
  • Is linked to a set of wizards used to perform predefined tasks.
     

Forms can also:

  • Contain deep links defined locally in a given field to access directly to third-party collaboration tools such as EV Reach, Teams, Slack, etc.
  • Be linked to Service Apps apps. The information displayed by the app is specific to the current record. Open url.png See The contextual apps.
  • Have variants that adapt to the context. These variants are displayed instead of the main form presentation when certain conditions defined using filters are met:
    • Display a conditional form presentation to hide certain fields or tabs, or to authorize access to specific profiles.
    • Declare a redirection to another form using a hyperlink or action button.

Examples

1. Configure the Equipment form.

  • The main form presentation displays equipment-related information.
  • A conditional form presentation defined for Phone equipment displays different information in two tabs.
    • Details tab: Apply a filter, Type of equipment = Phone, with an SQL query to hide the Network Identifier and Last Automatic Inventory Date fields that are not relevant for phones.
    • Installed Software tab: Displayed if the current record meets the condition called Type of equipment<> Phone.

2. The main form presentation or conditional form presentation is displayed based on the selected Equipment form, i.e. depending whether the filter conditions are met.

  •  Phone equipment: The conditional form presentation is displayed. Users do not see the Network Identifier and Last Automatic Inventory Date fields or the Installed Software tab.
  • Other types of equipment: The main form presentation is displayed. Users see the Network Identifier and Last Automatic Inventory Date fields as well as the Installed Software tab.

Notes

  • Forms are created by EasyVista. You cannot create new ones.
  • You can modify a form as long as you are authorized to edit display presentations. Open url.png See User Profiles > Edit rights and display rights.
    • Modifications autorized on a form: Modify the visual layout by adding, modifying or deleting objects, associate wizards, create conditional form presentations, declare redirections, select the tabs to be displayed, modify the name of the tab and the order in which tabs and sub-tabs are displayed.
    • Access rights to forms are defined by profile. You can also define them by selecting Administration > Access Management > User Profiles in the menu.
  • Parent queries of each form are defined by EasyVista.
  • You can add fields manually to a form's parent query, as long as you are authorized to edit display presentations. Open url.png See User Profiles > Edit rights and display rights.
    • Fields are displayed with their alias (or logical name).
    • If the alias is not specified, the physical field name will appear.

      example  

      • Alias: Phone, Physical Name: PHONE_NUMBER
      • Alias: Serial Number, Physical Name: AM_ASSET.SERIAL_NUMBER

Structure of a form

  • Top banner of the form:
    • By default, the title of the form is the name of the first field in the Details tab.
    • By default, the form overview displays the first six fields in the form. You can switch to edit mode to customize this. You should define the Overview section. Open url.png See the procedure.
    • In the forms of process elements such as incidents, requests or problems, the life cycle is displayed.
  • The Details tab is always displayed first. You cannot modify its name.
  • By default, each new conditional form presentation is an identical copy of the form presentation in edit mode.
  • You can declare a redirection to another form only for the Details tab.
  • Icons objects can be used for defining action buttons, except for the following objects which are configured to appear as hyperlinks: Attachments, Known Errors, Questionnaire and Search.
  • All wizards shipped by EasyVista can be associated with a form. Users can see only visible wizards which their profile authorizes them to access.
  • You must first configure deep links locally in a given field in a form by selecting Administration > Deep Linking Tools > Settings - Deep Linking in the menu. The Automatic display of the Deep Linking icon option must not be checked for the link. Open url.png See the procedure.

Caution

  • Adding conditional form presentations to a form has a significant effect on the display time because each condition is evaluated every time the form is displayed. To ensure the shortest loading and display time:
    • Restrict the number of conditional form presentations to 10 or less for a given form.
    • Arrange conditional form presentations in the order of their display frequency, from most to least frequently displayed.
    • Number tests in the order of their use frequency. By default, tests are run alphabetically based on the name of the conditional form presentation.
    • Respect the rules above for the most frequently used forms, namely the Action form which is a tool used daily and constantly by Service Desk technicians.
  • If you move a row, all of the objects in it will be moved.
  • The subscription identifier is the first field of the overview form or, failing that, the first field of the form. If you change one of the information, you must update the subscription to ensure that the identifier change is taken into account. Open url.png See the procedure.
             Subscription - Notification ID.png

Best Practice

  • Check the top of the screen to see which form presentation you are modifying. The physical name of the current form is followed by the words (Form presentation) or (Conditional form presentation).
             example   DialogHD_IncidentsCatalog (Form presentation)
  • To modify the presentation of a specific tab, display it before switching to edit mode.
  • To create a conditional form presentation, first select the tab/sub-tab with which it should be associated.
  • Beware of positions that appear to be vacant but in reality are not. This is due to fields that occupy two columns (tree). To check this, you should preview the form.
  • Place the line data separator in rows with only one position because the line will occupy the entire row. On the other hand, you can place the space data separator next to a field.
  • Narrow down the list of fields available to display only the fields that are useful in designing the form. You can add them again at any time by clicking Add Field.

Characteristics specific to versions 2016 and earliers

The form editor in versions 2016 and earlier is different:

Screens description

Form presentations

Form presentation of the Details tab

Access: Tools icon.png in the top banner of the form > Edit Form > Select Another Area and click the name of the first tab. Note: The Details tab is always displayed first in the form.
         Form - Tabs list areas - edit mode.png
 

Edit mode Interface Service Manager
Form - Details tab - edit mode.png Form - Details tab - execution mode.png

(1) Form name (Note: Non-modifiable): Physical name of the form, followed by the words (Form presentation).


(2) Area representing the tab in which the objects to be displayed are placed.

Object properties:
         Object - Edit mode.png

  • Grip icon.png: Move handle belonging to the field. Click and drag it to the form presentation.
    • When you move an object, a green border will appear in the spots where you can place the object.
    • The move handle found at the start of the row is used to move the entire row. All of the objects in the row will be moved.
  • Delete red cross icon.png: Used to delete the form presentation field. It will automatically appear in the list of available fields found at the bottom of the form.
  • Inspector properties icon.png: Used to open the Properties Inspector specific to the type of object. Open url.png See the list of objects.
  • Field name, specified in the Properties Inspector.
  • [ Text ], [ Tree ], etc.: Type of field. Note: If the tab presents information in a grid, the type of field is not displayed.


(3) List of all available objects that are not displayed in the tab. Note: Field objects are fields from the parent query associated with the form and other manually added fields. If the tab presents information in a grid, only Field objects are available.

  • Select the move handle Grip icon.png of an object to move it to the area representing the tab (2).
  • The color of the object's border indicates its type:
    • Green for fields, with the name of the field or its physical name if the alias is not specified.
               example   Manager / AM_MANAGER.LAST_NAME
    • Blue for action buttons or hyperlinks, containing the word Icons.
    • Blue for data separators, containing  ______ for lines or the word Spaces.
    • Blue for links to XML or Excel reports, containing the words Print Reports.
       

Organize Related Elements: Used to select the list of tabs/sub-tabs displayed in a form.

  • Click and drag the elements you want to or from the Tab Sheet Visible and Tab Sheet Hidden panes using the move handle Grip icon.png.
  • You can also click Multilingual labels icon.png to enter the name in different languages.

Note: Users can define their own tab configuration by clicking Tools icon.png > Reorganize my Tabs.

          Form - Organize related elements.png

  • Save icon.png: Used to save your changes.
  • Delete red cross icon.png: Used to return to the standard configuration defined by EasyVista.

Caution: All names will also be reinitialized.

Select Another Area: Used to display the list of all tabs and sub-tabs in the form. 

  • Click one of the elements to edit its presentation.
  • The first tab is always the Details tab.
             Form - Tabs list areas - edit mode.png
     

Create / Select a Form Presentation: Used to create a conditional form presentation for the current tab/sub-tab or to select an existing one. In the Details tab, also used to declare a redirection to another form or to select an existing form presentation.

  • In both cases, a filter must be defined. If the filter conditions are met when the tab/sub-tab is displayed, then it will automatically be replaced by the conditional form presentation or redirection.
     

List of Displayed Wizards (Note: Only for the Details tab): Used to select the list of wizards displayed in the form (box is checked). Note: All wizards shipped with the Service Manager setup are available.
 

Change Displayed Labels: Used to switch between the name of the fields and their physical name. Note: Fields added manually to the parent query appear with their alias. If the alias is not specified, then the physical name will appear.
         example   Manager / AM_MANAGER.LAST_NAME
 

Add View: Used to add an SQL query containing a join with one of the parent query tables.

Add Table: Used to add a table not belonging to the parent query.

Add Field: Used to add a field belonging to one of the parent query tables or belonging to a manually added SQL table or view.

Delete a Field: Used to narrow down the list of fields and display only the fields that are useful in designing the form. Note: To display a field again, click Add Field.

Tabs/sub-tabs presentations and Conditional form presentations

Access: Tools icon.png in the top banner of the form > Edit Form then:

  • For a tab/sub-tab: Select Another Area and click the object you want.
  • For a conditional form presentation: Select the tab/sub-tab you want and click Create / Select a Form Presentation. Next, select the form presentation you want.
     
Edit mode Service Manager Interface
Form - Other tab - edit mode.png Form - Other tab - execution mode.png

(1) Form name (Note: Non-modifiable): Physical name of the form, followed by the words (Form presentation) for a tab/sub-tab, or by the words (Conditional form presentation) for a conditional form presentation and its physical name.

Filter related to the Form Presentation: Conditions that must be met before the tab/sub-tab or conditional form presentation can appear. 

  • Click Browse points icon.png to define the filter conditions.
  • The conditions are stored in an SQL query when the form presentation is saved and are evaluated when the form presentation is displayed.

By default, new Profiles: Used to define access to the form presentation by profile for all profiles created after the form presentation was modified.

  • Can access this Form Presentation: If the conditions defined in the filter are met, then users who are assigned the new profile can access the new form presentation.
  • Cannot access this Form Presentation: Even if the conditions defined in the filter are met, users who are assigned the new profile can only access the previous form presentation. 

Manage the List of existing User Profiles: Used to define access to the form presentation by profile only for profiles created before the form presentation was modified. Click Browse points icon.png.

  • Visible pane: Profiles with access to the form presentation if filter conditions are met.
  • Invisible pane: Profiles with no access to the form presentation even if filter conditions are met.
  • Use the Last icon.png, Next icon.png, Previous icon.png and First icon.png icons to move profiles from one pane to the other.
     

Name: Name of the tab/sub-tab or conditional form presentation.

(2) Area representing the tab/sub-tab or conditional form presentation in which the objects to be displayed are placed.

Properties of the tab/sub-tab:
         Object tab - Toolbar.png

  • Inspector properties icon.png: Used to open the Properties Inspector for GRID objects and configure action icons in the tab/sub-tab. Open url.png See the description.
  • To help users identify active actions in the tab/sub-tab, the associated icons will be displayed.
     
Properties of the tab/sub-tab Properties Inspector for GRID objects Service Manager Interface
Form - Inspector properties - Grid Object.png Form - Properties tab - Grid Object.png Form - Properties tab - Execution mode

Object properties. Open url.png  See the Details tab.
         Object - Edit mode.png 

(3) List of available objects that are not displayed in the tab/sub-tab or conditional form presentation. Note: Field objects are fields from the parent query associated with the form and other manually added fields. If the tab presents information in a grid, only Field objects are available. Open url.png See the Details tab.

Redirection

Access: Tools icon.png in the top banner of the form > Edit Form > Select Another Area and click the name of the first tab (Details tab). Next, click Create / Select a Form Presentation and select the redirection you want.
 

Edit mode
Form - Redirection - edit mode.png

(1) Form name (Note: Non-modifiable): Physical name of the form, followed by the words (Conditional form presentation) and the physical name of the redirection form.

Name of Related Form: Physical name of the form that must replace the main form presentation if the filter conditions are met.

Other fields: Open url.png  See Tabs/sub-tabs and main/conditional form presentations.

Specific case: Quick Call

The quick call is divided into several sections but the configuration principle remains identical to the other forms.

  • The Main section area includes the Details tab as well as User Informations and Description related elements (1).
  • The other related elements (2) are accessible via the other areas as in the other forms.

   The case management uses a simplified quick call which is a conditional form presentation of a ticket. It replaces the main form presentation of the standard quick call that is used for incidents and requests.

     Open url.png See the procedure How to define the Simplified quick call conditional form presentation

          Form - Quick call - execution mode.png

Access: Tools icon.png in the top banner of the form > Edit Form > Select Another Area
         Form - Select another area.png

Properties Inspector for each type of object

Access: In a form, click Inspector properties icon.png next to an object. The fields to be specified depend on the type of object.
         Object - Edit mode.png

FIELD object

   Form - Inspector properties - Field Object.png

Table (Note: Non-modifiable): Physical name of the table where the field belongs.

Field (Note: Non-modifiable): Physical field name.

Alias: Name identifying the field in the interface. Click Multilingual labels icon.png to enter the name in different languages.

Read Only: Used to indicate if the field is accessible in read-only mode (True) or modifiable (False). Note: Select True if the field comes from a related table. This option depends on each form. A given field may be modifiable in one form and non-modifiable in another.

example  Phone field: modifiable in the Employee form and read-only in the Equipment form.

Required (Note: Not available for Tree fields): Used to indicate if the field is mandatory (True) or optional (False). Note: This option depends on each form. A given field may be mandatory in one form and optional in another.

Size: Size of the data entry field in the interface based on the type of field:

  • 1: standard field size, non-modifiable ==> BOOLEAN, COMBO VALUES, COMBO VALUES (Translated), DATE, and DATEANDTIME fields
  • 2: used to increase the field size ==> TREE and TEXT AREA fields
  • Other values: user-defined size in pixels ==> COMBO, CURRENCY, EDIT and INTEGER fields Note: For EDIT fields, the size can be completed by specifying the Maximum Length of String property.

Type: Type of field that affects the data entry field layout, size and type, e.g. drop-down list, tree or free text field. Note: The type of field in the data model can be different.

example  TEXT field in the data model, BOOLEAN in the interface (boxes to check) ==> in the database, a text value is stored: 0 if the box is not checked; 1 if the box is checked.

Note: Click Browse points icon.png to define the properties.

Value Description Example in the interface Notes
TREE Tree field, can be accessed by clicking Black Down arrow icon.png in the interface, e.g. location, department, type or category.

Properties:

  • Root: Click Edit to select the level of the tree view you want to display when users click Black Down arrow icon.png.
  • Save Root by default: Used to indicate if the Root property value is saved in the tree field (True) or not (False). If the value selected is True and users select None, the Root value will be stored in the database. If the value selected is False and users select None, no value will be stored in the database.

example Root= North America/USA; True ==> Click Black Down arrow icon.png in the Location field:

  • The tree will display the North America/USA level.
  • Select None: the current value of the field will be replaced by the Root value = North America/USA.
Location Black Down arrow icon.png Europe/France/Paris
BOOLEAN Field with two possible values (e.g. True, False), followed by a box to be selected in the interface. Storage location Box checked.png
COMBO Drop-down list containing reference table values, can be accessed by clicking Black Down arrow icon.png in the interface.

Properties:

  • Field Key: Key in the main table of the form, used to retrieve the selected element.
  • Look Up SQL (Note: Only if the Look Up Key property is not specified): Query used to display the list.
Type of warranty Black Down arrow icon.png Onsite
COMBO VALUES Drop-down list containing predefined values, can be accessed by clicking Black Down arrow icon.png in the interface.
  • Click Plus icon.png to add a new row and enter the value.
  • Click Minus icon.png to delete one of the values.
Color Form - Combo Values.png
  • The list is identical regardless of the interface language. To specify names in different languages, use COMBO VALUES (Translated).
  • Do not specify the first row of the list. This enables users to select a null value to empty the field and cancel data entry.
COMBO VALUES (Translated) Identical to COMBO VALUES, with the possibility of entering names in different languages for predefined values.
  • In the first row of the value, enter the name in your choice of language.
  • In the second row, enter the name in other languages using Multilingual labels icon.png.
Color Form - Combo Values.png
DATE Field for entering the date using a calendar, can be accessed by clicking Calendar icon.png in the interface. Installation date 09/07/2009 Calendar icon.png
DATEANDTIME Field for entering the date and time.
CURRENCY Field for entering a numeric value with two decimal places.
  • If users enter an integer in the interface, two decimal places will automatically be added to the record.
Purchase price 1490.99
LIST Drop-down list containing reference table values, can be accessed by clicking Black Down arrow icon.png in the interface.

Properties:

  • Properties (Query): Name of the object (list) opened using List mode icon.png. Click Edit to select it.
  • Parent Key: Parent key of the main table in the list.
  • Relation Key: Key of the related table used for displaying the list. Generally = main table key.
Main user Black Down arrow icon.png Adam, Carol
INTEGER Field for entering an integer. Duration of the period (months) 12
MEMO Identical to TEXT, of unlimited size, can be accessed by clicking Browse points icon.png in the interface. You then enter text in a secondary window opened by clicking Edit icon.png.

Note: When the Size property of the field is specified, the default height of the field is the one defined in Other Parameters.

TEXT Free text field of limited size.

Note: Only for fields whose contents do not refer to a related table.

Available Field 1 …my text… .
  • Use the MEMO field if you do not want to restrict the size of the field.
TEXT AREA Identical to MEMO, with the possibility of entering HTML code for formatting text, can be accessed by clicking Edit icon.png in the interface. Comment Note in bold Edit icon.png

Properties specific to the type of field

Maximum Length of String (Note: Only for TEXT fields whose Size property is specified): Used to indicate the maximum length of the data entry field.

Manage VIP (Note: Only for fields from the AM_EMPLOYEE and AM_ASSET tables): In the interface, used to identify VIP users and critical equipment quickly using red stars Red star.png.

  • Possible values: Equipment ID/Employee ID, based on the table.
  • The number of stars displayed depends on the user VIP level and the critical level of the equipment.

CI Status (Note: Only for fields from the AM_ASSET table): In the interface, used to identify the availability status of CI equipment using an icon: CMDB - Available icon.png available; CMDB - Not available icon.png unavailable.

Display Time (Note: Only for DATETIME fields): Used to indicate if the time should be displayed in the interface (True) or not (False).

Graphical Presentation (CI) (Note: Only for fields from the AM_ASSET_CI table): This determines if access to the CMDB graph is authorized for a CI (True) or not (False). If the value selected is True, the Display CMDB Graph action is added to the list of options Black Down arrow icon.png of the CI field in the interface.

Action icons

In the interface, the different actions that can be performed in a field are grouped. They can be accessed by clicking Black Down arrow icon.png to the right of the field.
         example   Incident Catalog form > Manager field Form - Action icons Object - execution mode.png

Note: Select True to make the action available in the interface and define its properties by clicking Browse points icon.png. Otherwise, select False.

Icon Description Example in the interface
Edit form icon.png Dialog Open the related form.

Note: When the value of the Display popup icon.png Popup icon is equal to True, the form can be modified (depending on the rights of the logged-in user). Otherwise it is available in read-only mode.

Properties:

  • Properties Dialog: Name of the related form. Click Edit to select it.
  • Parent Key: Key used to retrieve the value that initializes the related form.
Equipment form > Department field > Edit form icon.png --> Open the Department form in edit mode.
Mail icon.png Email Used to open the messaging system.

Properties:

  • E-mail Field: Field used to preload the recipient's email address when opening the messaging system.
Employee form > Manager field > Mail icon.png --> Open the messaging system to send an email to the manager. The recipient's email address is automatically loaded using the manager's email address.
Display popup icon.png Popup Used to open a secondary window displaying information specific to the field in consult mode.

Properties:

  • Properties Dialog: Name of the open form. Click Edit to select it.
  • Parent Key: Key used to retrieve the value that initializes the related form.
Equipment form > Model field > Display popup icon.png --> Open a secondary window displaying additional information on the model.
World icon.png URL Used to call an object, e.g. map, workflow or URL.

Properties:

  • HTTP Address: Type of link to open (e.g. URL, Via Michelin website, attachment, etc.).
  • URL Field (Note: Except for Via Michelin): URL of the object opened using World icon.png.
  • Address 1: For Link links.
  • Address 2, City, Zip Code, Country: Additional information for searching addresses on the Via Michelin website. The properties displayed depend on the type of link selected.
Equipment field
  • Location field > World icon.png --> Open the Via Michelin website with the URL of the location hosting the equipment.
  • Network Identifier field > World icon.png --> Connect automatically to the specified Network machine.
  • Type field > World icon.png --> Open the UNSPSC website to search for the type associated with the equipment.

Deep Linking

The section is used to define deep links specific to the field, i.e. links that allow direct access to third-party collaboration tools. In the interface, dedicated icons for these links will appear only in this form on hover over the relevant field.

  • The Deep Linking section will appear only if a deep link is defined for one of the fields in the main form presentation, provided the Automatic display of the Deep Linking icon option is not checked in Administration > Deep Linking Tools > Settings - Deep Linking.
  • Click  +  in the Deep Linking section to open the Deep Linking Properties Inspector and specify the properties of the link.
            Form - Inspector properties - Deep Linking.png
FieldsDeepLinking

Software: Name of the third-party collaboration tool that will run when the deep link is selected in the form.

Action Type: Type of action run by the third-party collaboration tool.

Action: Description of the deep link that will appear on hover over the dedicated icon.

Icon: Dedicated icon that will appear on hover over the field.

Title: Multilingual description of the deep link that will appear on hover over the dedicated icon.

URI: Automatically specified URL that will run when the deep link is selected in the form.

List of parameters specific to each URI: Select the value from the contextual drop-down list of the parameter.

example  Parameter @@E_MAIL@@: value AM_ASSET.ASSET_ID

EndFieldsDeepLinking

FIELD object in a grid

   Form - Inspector properties - Grid field Object.png

Table (Note: Non-modifiable): Physical name of the table where the field belongs.

Field (Note: Non-modifiable): Physical field name.

Alias: Name of the field in the interface. Click Multilingual labels icon.png to enter the name in different languages.

Currency (Note: Only for numeric fields): Used to indicate if the number should be displayed as a currency (True) or not (False). If the value selected is True, two decimal places will be added to the number.

Time zone (Note: Only for date fields): Used to indicate if the date/time stored in the database should take into consideration the time zone of the logged-in user (True) or not (False). If the value selected is True, the database date/time will be converted to the local date/time.

User Key: Key used to retrieve the time zone to be used instead of the time zone of the logged-in user.

Alignment: Used to indicate how the value is aligned in the column, e.g. left align, center or right align. The Automatic value lets the browser manage alignment automatically. 

Full Path (Note: Only for Tree fields such as location, department, type or category): Used to indicate if the full path should be displayed (True) or only the last level (False).
        example   Location field

  • Complete tree view:  North America/USA/Salt Lake City/Building 1/Level 07/731
  • Last level:  731

Show Hint: Information displayed in infotips when the mouse rolls over the field.  

SPACES object

   Form - Inspector properties - Space Object.png

Alias: User-defined name in the interface, not linked to any field. Note: If no name is specified, a blank field is displayed.

ICONS object

   Form - Inspector properties - Icons Object

Alias: Name of the action button or hyperlink in the interface. Click Multilingual labels icon.png to enter the name in different languages.

  • You should only enter the name. The shortcut should be entered in the Keyboard Shortcut property.
  • The Attachments, Known Errors, Questionnaire and Search actions are configured to appear as hyperlinks. All other actions are displayed as buttons.
             example   Action form > Transfer; Action form > Known Errors [Alt+K]

Parent Key: Key used to retrieve the value to be passed to the related form.

Wizard Properties: Wizard opened using an action button or hyperlink. Click Edit to select it.

  • The Attachments, Known Errors, Questionnaire and Search actions are configured to appear as hyperlinks. All other actions are displayed as buttons.

Caution: Action buttons or hyperlinks can open a wizard or a file. If both settings are specified, then the Popup Link property will apply.

Display Trend: If the wizard is not implemented in Service Manager, this is used to indicate if the number of elements linked to the action button or hyperlink should be displayed (True) or not (False). Note: If the number of elements is not available, then N/A appears.
         example   Attachments (3)

Keyboard Shortcut: Keyboard shortcut associated with the action button or hyperlink, for performing the action without using the mouse.

  • You should only enter the letter you want. The Alt + sequence will automatically be added by the interface.
             example   Keyboard shortcut K  ==>  Known Errors [Alt+K]

Button Width (Note: Only for action buttons): Width of the action button in the interface.

Popup Link: Used to specify the file opened with an action button or hyperlink.

  • The file must be in the <easyvistapath> folder which is your EasyVista folder on the Apache server.
  • Special cases:
    • Search: fts.php
    • Known Errors: knownPB.php
    • Attachments: upload_f_doc_details.php

PRINT REPORTS objects

   Form - Inspector properties - Print reports Object.png

Alias: Name of the action button for printing reports in the interface. Click Multilingual labels icon.png to enter the name in different languages.

  • If no name is specified, a blank field is displayed.

Parent Key: Parent key of the report's main table.

Report: List of reports linked to the parent key table (reports provided by EasyVista and Report Designer reports).

File Type: Report output format, e.g. PDF or XML.

Keyboard Shortcut: Keyboard shortcut associated with the action button, for performing the action without using the mouse.

  • You should only enter the letter you want. The Alt + sequence will automatically be added by the interface.
             example   Keyboard shortcut L ==> Equipment in Stock [Alt+L]

Button Width: Width of the action button in the interface.

Popup Link: (not used)

GRID objects in tabs/sub-tabs

Edit mode Interface Service Manager
Form - Inspector properties - Grid Object.png Form - Properties tab - Execution mode.png

The different actions that can be performed in a tab/sub-tab are grouped. They can be accessed by clicking the icons found in the header of the grid or of each row.

Note: Select True to make the action available in the interface and define its properties by clicking Browse points icon.png. Otherwise, select False.

Button Description Example in the interface
Add icon.png Add Used to add a new record to the grid.

Properties (depending on the add action type):

  • Type: Used to indicate how the add action will be performed, i.e. in a new row at the bottom of the grid, in a form that replaces the grid, or via a wizard that opens a secondary window.
  • Properties (Query/Form/Wizard): Type of object opened. Click Edit to select it.
  • Table (Query/Form): Name of the table in which you want to add data.
  • Parent Key (Query/Form): Key associated with the selected object.
  • Relation Key: Key of the form.
Action form > Consumable tab > Add icon.png --> Open a wizard for creating a new consumable destocking operation.
Delete icon.png Delete Used to delete a record associated with a table or view directly in the grid.

Properties (specify one of the following):

  • Table Name: Name of the table containing the record to be deleted.
  • Display Name: Name of the view containing the record to be deleted.
Delete icon.png Delete (Wizard) Identical to the Delete Button property, but using a wizard that guides users through the steps.

Properties:

  • Wizard Properties: Name of the delete wizard. Click Edit to select it.
  • Parent Key: Key used to retrieve the record to be deleted = key of the form.
  • Parent Key 2: Key used to retrieve the record to be deleted = relation key.
Delete icon.png Un-assign Identical to the Delete Button property, but by removing the link between the two elements.

Properties:

  • Field Name: Name of the field to be purged (null value).
Equipment form > Location tab > Delete icon.png --> Delete the link between the location and its equipment.
Edit icon.png Edit (Wizard) Used to open a secondary window (via a wizard) displaying the form of the record selected in the grid. It can be modified depending on the rights of the logged-in user.

Properties:

  • Wizard Properties: Name of the wizard opened in the secondary window. Click Edit to select it.
  • Parent Key: Key used to retrieve the record to be edited. Note: This is not the key of the form.
SLA form > Overridden SLA tab > Edit icon.png --> Open the selected record in a secondary window.
Display popup icon.png Popup Used to open a secondary window displaying contextual information on the record selected in the grid.

Properties:

  • Properties Dialog: Name of the form opened in the secondary window. Click Edit to select it.
  • Parent Key: Key used to initialize the form.
Action form > History tab > Display popup icon.png --> Open a secondary window displaying additional information on the action.
Edit form icon.png Edit (Form) Used to open the form of the record selected in the grid. It can be modified depending on the rights of the logged-in user.

Properties:

  • Properties Dialog: Name of the open form. Click Edit to select it.
  • Parent Key: Key used to initialize the form = key of the grid row.
  • Parent Key 2 (Note: Only if it is a relation table): Key used to initialize the form = key of the current form.
Equipment form > Licenses tab > Edit form icon.png --> Open the License form to modify it.

Procedures

How to modify the form presentation

Step 1: Open the form in edit mode.

1. Open the form you want.

2. Click Tools icon.png in the top banner and select Edit Form.
The main form presentation will appear.
         Form - Details tab - edit mode.png
 

Step 2 (optional): Add the required fields to the parent query manually.

Note: Your profile must be authorized to edit the display for the menu associated with the form.

1. Click Add View to add fields belonging to an SQL view.

2. Click Add Table to add fields belonging to a related table.

3. Click Add Field and Delete a Field to select the fields you want.
 

Step 3: Define the main presentation of the Details tab.

1. Select and place the objects in the tab.

Insert an object in the tab

  • Click the move handle Grip icon.png of the object you want from the list of available objects at the bottom of the screen.
  • Drag it to the area representing the tab at the top of the screen.
    A green border will appear in the spots where you can place the object.

Insert an object in a new row

  • Click the move handle Grip icon.png of the object you want from the list of available objects at the bottom of the screen.
  • Drag it below the last row at the bottom of the screen.
  • Click Grip icon.png at the start of the row.
  • Drag it to the spot you want.

Move an object in the tab

  • Click Grip icon.png in the object's border.
  • Drag it to the spot you want in the area representing the tab.

Move a row in the tab

  • Click Grip icon.png at the start of the row.
  • Drag it to the spot you want.

2. Click Inspector properties icon.png in the border of each object to define its properties.

3. Click Save.
 

Step 4: Select wizards.

1. Click List of displayed Wizards.

2. Select the wizards that users must be able to access.

3. Click OK.
 

Step 5: Define the main form presentation of related elements.

1. Click Select another Area.

2. Click the name of the related element.

3. Place objects in the same way as in the Details tab.

4. Click Inspector properties icon.png to define the properties of the related element in the first row.

5. Define the properties of objects in the related element by clicking Inspector properties icon.png in the object's border.

6. Click Save.

7. Repeat the procedure for each related element.
 

Step 6 (optional): Define the conditional form presentation of related elements.

1. Click Select another Area.

2. Click the name of the related element.

3. Click Create / Select a Form Presentation and select New conditional Form Presentation.

4. Click Browse points icon.png next to Filter related to the Form Presentation to define the filter conditions.

5. Click Browse points icon.png next to Manage the List of existing User Profiles and specify the profiles authorized to access the new conditional form presentation.

6. Place objects in the same way as in the Details tab.

7. Define the properties of objects using Inspector properties icon.png.

8. Click Save.
 

Step 7 (optional): Define redirections in the Details tab.

1. Click Select another Area.

2. Click the name of the first tab in the Details tab.

3. Click New Redirection to another Form.

4. Enter the name of the related form.

5. Specify the conditions of the filter, profiles, and object properties.
 

Step 8: Check that the form is correctly configured.

1. Click Save and Close.
You will return to the form interface.

2. Check the visual aspect of the different form presentations.

3. Check that redirections work correctly.

How to define the Simplified quick call conditional form presentation

     Open url.png See the procedure

How to modify the display of the form overview

Note: Only for authorized user profiles.

Caution: The subscription identifier is the first field of the overview form or, failing that, the first field of the form. If you change one of the information, you must update the subscription to ensure that the identifier change is taken into account. Open url.png See the procedure.

1. Open the form you want.

2. Click Tools icon.png in the top banner and select Edit Form.

The main form presentation will appear.

3. Complete the Overview section.

          Form - Overview.png

  • Query: Select the parent query from the list of queries linked to the same table as the form.
  • Report: Select the specific view that will display the overview of the form. You should use the List view or create a new view prior to this.

example  Overview of the Equipment form ==> Selection of the List view

Form - Overview - Example List mode.png

4. Click Save and Close.

The first fields in the selected view will automatically appear. The number of fields displayed depends on the width of the screen.
         Form - Overview - Example Form mode.png

How to manage and configure related elements

Step 1: Select the tab you want to configure.

Via edit mode in the form

1. Click Tools icon.png in the top banner and select Edit Form.

2. Click Select another Area.

3. Click the name of the related element.
The main tab presentation will appear.

Via edit mode in the tab

1. Click Edit icon.png in the toolbar of the related element.
The main tab presentation will appear.
 

Step 2: Define the default display mode of the tab, i.e. card or grid.

1. Click Inspector properties icon.png in the tab toolbar.
         Object tab - Toolbar.png
The Properties Inspector of the tab will open.
         Form - Inspector properties - Grid Object.png

2. Select the default display mode in the Display Mode property. Open url.png See the description.

  • Card
  • Grid

3. Click Apply Changes.

4. Select and configure the default display mode for the other related elements.

  • Click Select another Area.
  • Click the name of the related element.
  • Repeat points 1 to 3 of the procedure.
      

Step 3: Configure the visibility and default order of related elements.

1. Click Organize Related Elements.

2. Define the related elements that should be displayed or hidden.

  • Click and drag the related elements that should be displayed to the top pane (1).
  • Click and drag the related elements that should be hidden to the bottom pane (2).
          Fundamentals - Tools - Display related elements.png

3. Define the order of the visible related elements by clicking and dragging them to the position you want within the top pane (1).
 

Step 4: Check that the form is correctly configured.

1. Click Save.
You will return to the main form presentation.

2. Click Save and Close.
You will return to the form interface.

3. Check that the list of related elements is correctly displayed.

How to link a contextual app to a form

 Open url.png See:

  • The Procedure.
  • A use case: Retrieve information from a Self Help knowledge base based on the title of a ticket via a contextual app.

        Apps - Exposed properties - Example Self Help search.png

How to create a deep link locally in a form

     Open url.png See the procedure.

Tags:
Powered by XWiki © EasyVista 2022