Displaying a widget on a form
Forms. generally, display a set of fields of various types, occasionally split for the sake of clarity. Forms also can include widgets
Before a widget can be displayed on some form, it should be pre-configured for this. To pre-configure a widget, you need to:
- Create a widget. Widget creating is described in the Create a New Widget article.
- Define the widget behavior and look, define its server and client logic.
- Specify the tables on records of which this widget should be displayed. These tables can be selected in the Table ID field of the widget creation form.
- To denote that this widget should be displayed on records of the child tables, use the Inheritance attribute.
- Add a widget to a form using the Form Layout base functionality.
For example, you are creating a widget to be displayed on records of all tables of the ITSM Task type (for example, Incidents, Change Requests, Problems, and so on). These tables are child tables for the ITSM Tasks table.
So, when you are creating a widget, select the ITSM Tasks table in the Table ID field and mark the Inheritance checkbox, and the widget will be available on records of all the tables child for the ITSM Tasks table (including this table itself).
Displaying a widget on a portal
Отображение виджетов на портале:
- Выбрать страницу портала, для которой необходимо настроить отображение какого-либо виджета (т.е. Page Column).
- Перейти на связанный список Widget Instances и создать новую запись, заполнив поля.
To place a widget on a portal page, use the Widget Instances. These elements help to define a specific location for the widget according to the portal column specified and to customize the widget options with the option schema.
To create a widget instance, follow the steps below:
- Navigate to Portal Structure → Widget Instances.
- Click New and fill in the form.
- Click Save or Save and Exit to apply changes.
The Widget Instance form
| Field | Mandatory | Description |
|---|---|---|
| Widget | N | Click the magnifier icon, and select a Widget you want to display from the list. |
| Active | N | Select this checkbox to make this widget instance active or inactive. |
| Public | N | If selected, then this widget instance can be displayed on the Self-Service Portal. |
| Page Column ID | N | Click the magnifier icon, and select a Portal Column you want to add a widget to. |
| Order | N | This field specifies the order of widgets location in a portal column. Fill in this field with the integer number to display the widgets by the value of this field increases. When displaying a simple widget in a column, the order value does not matter. |
| Option Schema Values | N | Fill in the field with widget options overridden if it is necessary. |
