Item Control

Item control is used to display properties of datatype Item from the associated ItemType. Using this control, you can select existing item of the property’s Data Source ItemType through Select Dialog.

• Name: It is used to uniquely identify control inside the template.
• Label: It is used to show label on the control. It can be localized by defined Languages and Locales inside innovator.
• Data Type: It shows the type of the property as defined in the ItemType definition. In case of Item control, it will always be Item, and it is shown as disabled.
• Tooltip: Tooltip will be shown when you hover the mouse on the information icon on the form field. It is derived from the property bound to the control.
• Help Text: Help Text flyout will be shown when you click on the information icon on the form field label. It is derived from the property bound to the control.
• Data Source: It shows the type of the Item that can be selected as defined in the ItemType definition. It is shown as disabled.
• Select Filter: It allows you to select filter criteria based on the properties of the Related ItemType. Defined filter is always applied with ‘And’ condition on the Selected Items dialog along with the Search Keyword. If FilterType is Static, for the expression you need to provide constant value. If FilterType is Dynamic, for the expression you need to provide other property name as value, with this at runtime it will pull the value from the selected property and send it in the filter request to the server. As an admin, you can also enforce the filter, in that case end-user can see the applied filter on the Select Dialog but can’t change the filter criteria. If enforce filter is not set, end-user can change the filter criteria at the runtime.
• Select Columns: It allows you to define columns that you want to show in the Select Dialog. Column widths can be given in percentage or pixels modes. In percentage mode, you never see horizontal scrollbar, column widths will be adjusted to the available dialog width. But in pixels mode, based on the given column widths you may see horizontal scrollbar in the dialog. Flyout width in percentage, allows you to set width of the flyout shown for selecting the item. By selecting Show Add command ‘Yes’, Select Item flyout with show toolbar with Add Item command on the table. Using this command, new item can be created on the fly as part of the select item operation.
• Access: It allows you to define roles which can access control. Roles (in the form group identities) can be at Show and Edit level. When control is hidden because you do not have defined role, property associated with this control is not even fetched from server.
• Read Only: Based on the option selected for Read Only, control can become read-only even if you can edit the properties used inside the page with lock. You can select one of the options like ‘Yes’, ‘No’, ‘Expression’, or ‘Script’. Expression allows you to define a Boolean expression using properties from the current and previous pages (in case of multi-page application) to conditionally make the control read-only if expression is evaluated to true. Expression will be evaluated based on the cached property values on the client. Script allows you to write custom JavaScript code that should return Boolean value. If returned value is true, the control will be read-only.
• Display Condition: Based on the option selected for Display Condition, the control will be shown or hidden in the wizard at runtime. You can select one of the options like ‘Always Show’, ‘Always Hide’, ‘Expression’, or ‘Script’. Expression allows you to define a Boolean expression using properties from the current and previous pages (in case of multi-page application) to conditionally display the control if expression is evaluated to true. Expression will be evaluated based on the cached property values on the client. Script allows you to write custom JavaScript code that should return Boolean value. If returned value is false, the control will be hidden.
• Validations: Validation rules work on Item control similar to Text control. Please refer to Validations section of the Text control for complete details.
• Reset Dependency: It allows you reset value of the control to the default if any of the controls defined in “Reset Dependency” have their value changed at runtime.
• Font: It allows you to set the required font, size and color for the value of Item control.
• Margin: It allows you to set required top, right, bottom, left margins with respect to adjacent controls.
• On Load: OnLoad event allows you to write custom logic that will be executed after the value in the control is loaded. Please refer to the Template Customization section for more details.
• On Change: OnChange event allows you to write custom logic that will be executed after the value in the control is updated. Please refer to the Template Customization section for more details.
• On Select Filter: On Select Filter event will be launched after hitting the search button in item selection flyout. Admin can configure a custom script to modify entered filter expression or assign entirely new filter expression string to the eventData. EventData object is available in the scope of the event handler code. Please refer to the Template Customization section for more details.