Forms for the user interface
User interface forms are used to display and edit data in the user interface. The basic information for representing data on the user interface forms is described in form definitions and form templates. The form definition referenced by the interface form needs to be found. The form template given in the form definition is checked for existence in the form archive and to see if it labeled for the correct display purposes.
Detailed information about this topic
Recommendations for editing forms
-
If necessary, you can disable individual predefined forms to prevent them being shown in the user interface. They remain disabled even after schema installation.
-
The default installation of One Identity Manager already provides a series of form templates and definitions, for example for editing main data as well as many-to-many relations and object relations (Parent/ChildRelation). These can be used for easily creating your own forms.
-
To display information about a base object, you create an overview form.
-
You can do this using the Overview Form Editor in the Designer.
-
Create menu items for object relations you need to display frequently, and use these menu items as reference in the form elements of the overview form.
TIP: You can have the Overview Form Editor create the menu items for object relations.
-
Select the object relation you want to display and drag and drop it on an element in the element area of the Overview Form Editor.
-
Use the context menu items Create list element reference or Create reference to data element.
The menu items are entered below the InfoSheets.QIM.Links menu item with the InfoSheet.List.<table> and InfoSheet.Node.<table> labels, respectively.
The condition for the menu items is defined as the %<table>WhereClause% variable. In the form element you assign a condition as WHERE clause to the variable.
-
Default forms can be used to customize column extensions on default tables under certain conditions.
-
To edit the main data of custom tables, use the Designer's Form Editor to create an interface form with the VI_Generic_MasterData form definition.
-
To define mappings, create additional interface forms with the MemberRelation form type.
-
Assign the forms and menu items to the application, such as the Manager program.
-
Assign the forms and menu items to the permissions groups for non role-based and role-based login.
Related topics
Editing user interface forms
User interface forms are connected to object definitions, so that different forms are offered in the user interface depending on which object is selected. These interface forms are made available to system users, taking into account their permissions group memberships, by the additional assignment of interface forms to permissions groups. Further more, interface forms can be defined for separate menu items. When the associated menu item is selected in the navigation or the item is selected in the result list, the interface forms are shown for all system users without taking their permissions group memberships into account.
Predefined configurations are maintained by the schema installation and cannot be edited apart from a few properties.
NOTE: You can disable individual predefined tasks to prevent them being shown in the user interface. They remain disabled even after schema installation.
Related topics
Tips for working with the Form Editor
Use the Form Editor to create and edit the interface forms, such as the main data forms or assignment forms. All user interface forms are displayed in the form overview.
-
Forms that are disabled by preprocessor conditions are grayed out in the form overview.
-
In the Form Editor, use F5 to refresh the form overview.
-
Forms can be displayed hierarchically or in a list. The interface forms are grouped by form template and form definition in the hierarchical representation. To change the display, select the Options > Tree/List view menu item.
-
Using the Options > Show captions menu, you can switch between the forms’ technical names and the user-friendly captions.
-
To display additional columns in the form overview, use the Options > Select columns menu.
-
Define filters to restrict the number of forms displayed in the form list. Select the menu items Define filter or Manage filters for this purpose. For more information about working with user-defined filters in the Designer, see One Identity Manager User Guide for One Identity Manager Tools User Interface.
-
Use the form preview while editing main data forms. In the Form Editor, select the View > Form preview menu item to display an additional Form preview tab.
The form preview shows the contents of the interface form. You can display which base tables will be used to display the data. The permissions of the logged in the Designer user are taken into account when loading and displaying an interface form.
If a form cannot be loaded, an appropriate error message is displayed.