Sign in

List Control

4 min read

List control can be used to display properties of datatypes List, Filter List and Multi Value List. While displaying list, Aras ProAppDesigner uses same underlining list with options defined in the Innovator. List control comes with Control Style setting, with this, options can be shown as RadioButtonGroup in case of single selection list or CheckboxGroup in case of multi selection list. If you don’t set the Control Style, default Dropdown will be used to show the options. List control honors the default value set through ItemType definition.

  • 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. It can be List, Filter List or Multi Value List, 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.
  • Control Style: You can configure List control style as Radio Group in case of List or Check Group in case of Multi Value List.

When Radio Group or Check Group is selected as a style, Orientation setting will be shown to arrange options either horizontally or vertically.

List control with Radio Group Control Style:

Multi List control with Dropdown Control Style:

  • Selection Mode: It shows whether the current List control is a Single Value or Multi Value List. Selection mode is shown as disabled; it shows the list type as defined in the ItemType definition.

  • Document Associations: It allows you to associate a document with each option of the List. These associations will be used while generating word file based on what options have been selected from the List. If this List property is used as ContentControl in the word template, ContentControl will be replaced with the documents selected through List options.

  • 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 the returned value is false, the control will be hidden.
  • Validations: Validation rules work on List control similar to Text control. Please refer to Validation section of the Text control for complete details.
  • Conditional Formatting: Conditional Formatting works on List control similar to Text control. Please refer to the Conditional Formatting 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 and size for showing list options and the selected value. If any of the settings are changed, it shows Reset icon on the border, using which you can reset the settings.
  • Margin: It allows you to set required top, right, bottom, left margins with respect to adjacent controls. If any of the settings are changed, it shows Reset icon on the border, using which you can reset the settings.
  • 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.