Section Control

Section control is a layout control to organize group controls placed inside it. Section controls are vertically stacked one over the other. Section controls are the top-level container controls that exist in pages and dialogs. By defining display condition or access permissions, section control can be shown or hidden based on the evaluation criteria. When section control is created on the page, by default a group control is placed inside it.

Section control behavior or characteristics can be configurated through its settings flyout by selecting gear-icon from top-right corner. You can place the section anywhere on the page among other sections using drag-drop icon. By selecting 3-dot icon, it shows Delete and MoveTo options to delete or move the section to other pages.

• Name: It is used to uniquely identify control inside the template.
• Label: It is used to show the title of the section. It can be localized by defined Languages and Locales inside innovator.
• Associated Type: Following options can be selected for the Associated Type. By default, Associated Type is set as Context Type.
  

  • Associated Type: Context Type

    When Context Type is selected, while adding control to a group of sections, properties from the template ItemType will be shown for binding with the control.
    

  • Associated Type: Reference Type

    When Reference Type is selected, a dropdown with a list of all item properties from the contextual ItemType will be shown. By selecting a value for the dropdown, you will be shown with properties of the selected ItemType inside the groups of the section for binding with controls.
    

  • Associated Type: Type

    When Type is selected, while adding a control to a group of sections, properties from the selected ItemType will be shown for binding with the control. In this case, the section will be shown in the UI only when the item of the selected ItemType is set as context item on the section.
    

  • Associated Type: Type (UI)

    When Type (UI) is selected, while adding control to a group of sections, properties from the selected ItemType will be shown for binding with the control. In this case, the section will always be shown in the UI with empty values. Selected ItemType will only be used to show custom form with properties defined on the selected ItemType. You must write your own custom script to save these values to the server.

• Access: It allows you to define roles which can access the section. Roles (in the form group identities) can be at Show and Edit level. When section is hidden because you do not have defined role, properties used inside this section are not even fetched from server.
• Read Only: Based on the option selected for Read Only, section 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 section 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 the returned value is true, the whole section will be read-only.
• Display Condition: Based on the option selected for Display Condition, the section will be shown or hidden from 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 section 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 whole section will be hidden.
• Border: It allows you to show or hide the border and legend of the section. In case if you choose to show the border, you can select the border style using Color, Background, Type and Thickness settings. If any of the settings are changed, it shows Reset icon on the border, using which you can reset the settings.
• Font: It allows you to set the required font, size, color for showing the legend of the section. 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.

• Padding: It allows you to set the required top, right, bottom, left padding with respect to parent control. If any of the settings are changed, it shows Reset icon on the border, using which you can reset the settings.