12.1.2.1.1.1.1. Binding

In the Binding category, users can link a control to its corresponding attribute and define its binding properties.

1. Attribute: This field allows users to select the attribute associated to the control.
   • To access the list of relevant attributes, click on the ellipses () inside the field.
     

     **In the Object Browser window, users can access a list of the associated entity’s attributes—specifically, the attributes relevant to the control. To select an attribute, either click on the Select button or double-click on the entry from the list.

   • Once an attribute has been selected, it will populate the Attribute field.
     

*Controls can be linked to attributes created in either the Entity Designer or the Form Entity tab.

2. Control Properties: This field allows users to configure the control properties.
   • To access the control properties, click on the ellipses () inside the field.
     
     1. Call at Loading Page: This is a checkbox which, if selected, allows for the linked code to run automatically whenever the form is loaded in the DBP web application.
        • In the web application, the running of the code will be indicated by the loading icon displayed when the form is first opened.

          **This feature is typically used to perform various tasks when a form is first loaded, such as initializing controls or updating visibility settings. For example, users can apply this feature to set the initial values for a dropdown or date picker.

     2. Active: This is a checkbox which, if selected, allows users to activate the code linked to the control, enabling it to be executed.
        • If this checkbox is selected, the adjacent field will be enabled. In this field, users can define and modify the linked code.
          
          • Edit Code: This button allows users to launch the Code Designer, in which users can write code specifying the behavior and properties of the control.
            • For more details on how to configure controls using the Code Designer, click here.
          • Designer: This button allows users to launch the Rule Designer, in which they can define rules that specify the conditions and actions for the controls.
            • For more details on how to configure controls using the Rule Designer, click here.
          • Remove: This button allows users to remove the code.
        • If this checkbox is not selected, the linked code will not be executed when the form is opened.

          **A control that has a linked code will be visually identified in the design environment by the symbol.

          • Control Preview: Linked Code Design View

     3. Autopostback (Update All Controls): This is a checkbox which, if selected, allows for the automatic updating of all controls in the form.
        • To enable a control to be updated according to the linked code, simply select it from the Code Item List field.
          
        • To enable a control (specifically a dropdown, grid, or table) to be reloaded according to the linked code, simply select it from the Reload Dropdown/Grid/Table field.
          
        • Once the linked code has been executed, any change made to the control to which the code is linked will automatically trigger an update of all controls selected in the Code Item List and Reload Dropdown/Grid/Table fields.

          **The autopostback feature ensures that connected controls, such as those that are hidden or shown based on user selection, are properly updated after the code has been executed.

          • Autopostback Feature Preview: Web View

     4. Code Item List: This table displays all codes that are currently linked to controls in the form.
        • Once the linked code for the control has been executed, all selected items in this list are updated accordingly.
     5. Reload Dropdown/Grid/Table: This table displays all dropdowns, grids, and tables that are being used in the form.
        • Once the linked code for the control has been executed, all selected controls in this grid are reloaded accordingly.