Form


Forms are used to display information on Product name - ev itsm.png objects, e.g. incidents, catalog entries, problems, in the Product name - ev itsm.png interface. You can design forms in the editor if you are authorized to edit them.

Each form:

  • Is built using a parent query (defined by Logo - EasyVista.png) specific to the menu option.
  • 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.
  • Can 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.
  • 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.

Example

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

  • Access rights to forms are defined by profile.
    You can also manage access to tabs by selecting Administration > Access Management > User Profiles in the menu.
  • Only profiles authorized to edit the module associated with the menu option that opens the form can configure the form.
  • You cannot create new forms. Forms are created by Logo - EasyVista.png.
  • You can, however, perform the following actions on forms: 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.
  • The Details tab is always displayed first. You cannot modify its name.
  • You can add other fields to the parent query of the form manually, as long as you are authorized to edit the module associated with the menu option that opens the form.
  • Fields added manually appear with their alias. If the alias is not specified, then the physical name will appear.
             Example documentation icon EN.png  Phone / PHONE_NUMBER
  • 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 Logo - EasyVista.png can be associated with a form. Users can see those their profile authorizes them to access.

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.

Best Practice big icon.pngBest 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 documentation icon EN.png  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 ].

Screens description

Form presentations

Access the editor in edit mode: In a form, click Tools icon.png > Edit icon.png [ EDIT ]

Form presentation of the Details tab

Access from the editor: [ 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 Product name - ev itsm.png
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 documentation icon EN.png  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 ALL TAB SHEET ]: 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.
         Form - Organize all tab sheet.png

  • Save icon.png: Used to save your changes.
  • Delete red cross icon.png: Used to return to the standard configuration defined by Logo - EasyVista.png. Caution: All names will also be reinitialized.
  • Note: Users can define their own tab configuration by clicking Tools icon.png > [ REORGANIZE MY TABS ].
     

[ 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 Product name - ev itsm.png 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 documentation icon EN.png  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 and main/conditional form presentations

Access from the editor:

  • Tab/sub-tab: [ SELECT ANOTHER AREA ] and click the object you want.
  • 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 Interface Product name - ev itsm.png
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 - Edit mode.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 Interface Product name - ev itsm.png
Form - Inspector properties - Grid Object.png Form - Properties tab - Grid Object.png Form - Properties tab - Execution mode

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

(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 from the editor: [ 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

Form name (1) (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 two sections but the configuration principle remains identical to the other forms.

  • The configuration of the main section (1) is identical to the one in the Details tab in forms.
  • The configuration of the lower section (2) is identical to the one in the other tabs in forms.
     

Access from the editor:

  • Main section: [ SELECT ANOTHER AREA ] and click Main section. You can then create conditional form presentations and redirections in this area.
  • Lower section: [ SELECT ANOTHER AREA ] and click Lower section.
             Form - Quick call list areas - edit mode.png
     

 

Edit mode Interface Product name - ev itsm.png
Form - Quick call top screen - edit mode.png Form - Quick call top screen - execution mode.png
Form - Quick call bottom screen - edit mode.png Form - Quick call bottom screen - execution mode.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 documentation icon EN.png 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 documentation icon EN.png 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.

List of possible values - 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 documentation icon EN.png 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 Switch wysiwyg 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 Switch wysiwyg icon.png in the interface. Comment Note in bold Switch wysiwyg 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 documentation icon EN.png  Incident Catalog form > Manager field Form - Action icons Object - execution mode.png

List of authorized actions - Select True to make the action available in the interface and define its properties by clicking Browse points icon.png. Otherwise, select False.
Value Description Example in the interface
Edit form icon.png Dialog Icon Open the related form that can be modified depending on the rights of the logged-in user.

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 Icon 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 Icon 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 Icon 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.

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 documentation icon EN.png  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 documentation icon EN.png  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 EasyVista, 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 documentation icon EN.png  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 documentation icon EN.png  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 Logo - EasyVista.png 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 documentation icon EN.png  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 Product name - ev itsm.png
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.

List of authorized actions - Select True to make the action available in the interface and define its properties by clicking Browse points icon.png. Otherwise, select False.
Value Description Example in the interface
Add icon.png Add Button 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 Button 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 Button (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 Icon 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 Button (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 Button 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 Button (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.

Procedure: How to modify the form presentation

1. Open the form you want and click Tools icon.png > Edit icon.png [ EDIT ]. The form presentation of the current tab will automatically appear.
 

2. Check that the list of fields available contains all of the fields you want to use. If this is not the case, you should add them manually to the parent query (Note: Your profile must be authorized to edit the module).

  • Click [ ADD VIEW ] for fields belonging to an SQL view. Click [ ADD TABLE ] for fields belonging to a related table.
  • Click [ ADD FIELD ] to select the fields you want.
  • You can narrow down the list of available fields by clicking [ DELETE A FIELD ].
     

3. Define the main form presentation of the Details tab.

  • Place the objects:
    • Select the move handle Grip icon.png next to 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. Note: A green border will appear in the spots where you can place the object.
    • In the area representing the tab, you can click Grip icon.png in the border of each object to move it.
  • Click Grip icon.png at the start of the row to move the entire row. Drag it to the spot you want.
  • Click Inspector properties icon.png in the border of each object to define its properties.
  • Click [ SAVE ] once you have completed the form presentation.
     

4. Click [ LIST OF DISPLAYED WIZARDS ] to select the wizards that users can access.
 

5. Define the main form presentation of each tab/sub-tab.

  • Click [ SELECT ANOTHER AREA ] and select the name of the tab/sub-tab you want.
  • Place objects in the same way as in the Details tab.
  • Click Inspector properties icon.png to define the properties of the tab/sub-tab in the first row.
  • Define the properties of each object in the tab/sub-tab by clicking Inspector properties icon.png in the object's border.
  • Click [ SAVE ] once you have completed the form presentation.
     

6. If required, define conditional form presentations for the tab/sub-tab.

  • Click [ SELECT ANOTHER AREA ] and select the name of the tab/sub-tab you want.
  • Click [ CREATE / SELECT A FORM PRESENTATION ] and select [ NEW CONDITIONAL FORM PRESENTATION ].
  • Click Browse points icon.png next to the filter associated with the form presentation to define the filter conditions.
  • 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.
  • Place objects in the same way as in the Details tab.
  • Define the properties of objects using Inspector properties icon.png:
  • Click [ SAVE ] once you have completed the form presentation.
     

7. If required, define redirections in the Details tab.

  • Click [ SELECT ANOTHER AREA ] and select the name of the first tab identifying the Details tab.
  • Click [ NEW REDIRECTION TO ANOTHER FORM ].
  • Enter the name of the related form. 
  • Specify the conditions of the filter, profiles, and object properties.
     

8. Exit the form to check the visual layout and ensure that the conditional form presentation or redirection works correctly.

Tags:
Last modified by Unknown User on 2018/06/08 14:08
Created by Administrator XWiki on 2013/03/26 15:52

Shortcuts

Recent Updates

Haven't been here in a while? Here's what changed recently:

-   Product name - ev itsm.png
-   Product name - ev sas.png

Interesting Content

How to Automate Integration
Add a Shortcut to an App
History
Quick Dashboard
Full text search - Stop Words

Powered by XWiki ©, EasyVista 2018