12.1.2.1.1.19. Nested Form Link

The nested form link control is a user interface element that allows users to link or associate one form with another form. It consists of a link or button that, when clicked, opens a nested form within the main form.

When a nested form link control is selected in the design environment, its associated properties are displayed in the Control Properties panel.

*To access the Control Behavior category, users must first create the form behavior.

1. Binding: In this category, users can link a control to its corresponding attribute and define its binding properties.
   • For more information on the fields in this category, click here.

*For more information on the required attributes for nested form link controls, click here.

2. Name: In this category, users can access basic properties required for the control’s identification and proper referencing in the code.
   • For more information on these properties and how to configure them, click here.
3. Control Behavior: In this category, users can configure the behavior of the control and define how it interacts with the form or application.
   • Form Behavior: This is a single-select dropdown field that retrieves the list of form behaviors (from the Form Behavior section of the Forms module). It allows users to select the form behavior associated to the control.
     • Any state properties set for the control will apply only to the selected form behavior.
       

       **Only form behaviors linked to the associated form will be displayed in this dropdown.

   • Control State: This field displays the current state of the control.

     • Control States

       1. Enabled: This option allows for the control to be visible and editable in the web application.
       2. Disabled: This option allows for the control to be visible but not editable in the web application.
       3. Invisible: This option allows for the control to be hidden in the web application.
          

   • Control Governance: This field allows users to configure various properties that govern the functionality of controls.
     • To access the control governance properties, click on the ellipses () inside the field.
       
       • Enable View: This is a checkbox which, if selected, allows users to enable the View function for the control.
         • If this checkbox is selected, it will enable the View Form Behavior field.
           • View Form Behavior: This is a single-select dropdown field that retrieves the list of form behaviors (from the Form Behavior section of the Forms module). It allows users to select the form behavior linked to the control’s ‘view’ functionality.
             • To define a new form behavior, select the button.
               • It will display the Form Behavior Properties window.
             • To modify an existing form behavior, select the button.
             • To remove a form behavior, select the button.
               

               !!To set up the ‘View Form’, users only need to provide a name and a title.

       • Enable Edit: This is a checkbox which, if selected, allows users to enable the Edit function for the control.
         • If this checkbox is selected, it will enable the Edit Form Behavior field.
           • Edit Form Behavior: This is a single-select dropdown field that retrieves the list of form behaviors (from the Form Behavior section of the Forms module). It allows users to select the form behavior linked to the control’s ‘edit’ functionality.
             • To define a new form behavior, select the button.
               • It will display the Form Behavior Properties window.
             • To modify an existing form behavior, select the button.
             • To remove a form behavior, select the button.
               

               !!To set up the ‘Edit Form’, users only need to provide a name and a title.

       • Enable New: This is a checkbox which, if selected, allows users to enable the Add function for the control.
         • If this checkbox is selected, it will enable the New Form Behavior field.
           • New Form Behavior: This is a single-select dropdown field that retrieves the list of starter form behaviors (from the Form Behavior section of the Forms module). It allows users to select the form behavior linked to the control’s ‘new’ functionality.
             • To define a new form behavior, select the button.
               • It will display the Form Behavior Properties window.
             • To modify an existing form behavior, select the button.
             • To remove a form behavior, select the button.
               

               !!To set up the ‘New Form’, users only need to provide a name, a title, and select the Starter checkbox.

       • Enable Delete: This is a checkbox which, if selected, allows users to delete the added instance of the nested form.
       • Apply: This button allows users to save their changes.
       • OK: This button allows users to save their changes and close the window.
       • Cancel: This button allows users to cancel their changes and close the window.
   • State Matrix: This field allows users to configure the control state properties.
     • To access the control state properties, click on the ellipses () inside the field.
       
       • Form Behavior: This field displays the form behavior.
         • All form behaviors linked to associated form will be listed in this window.
       • Control State: This is a single-select dropdown field that displays the list of control states. It allows users to modify the current control state of the form behavior.
       • Control Governance: This field allows users to configure the control governance properties.
         • If selected, it will display the Form / Behavior / Control window (described above).
       • Apply: This button allows users to save their changes.
       • OK: This button allows users to save their changes and close the window.
       • Cancel: This button allows users to cancel their changes and close the window.
         

         **By modifying the control state per form behavior, users can determine whether the control is made enabled, disabled, or invisible at different stages of the workflow.

         !!In this window, users can also configure the governance properties for the control across multiple form behaviors. To gain an understanding of how these properties can be configured, click here.

4. Appearance: In this category, users can customize the visual appearance of the control.
   • Tooltip: This field allows users to input a tooltip for the control.
     • In the web application, the tooltip is represented by the tooltip icon ( ) next to the control.

     • Nested Form Link Tooltip Preview: Web View

       **A tooltip is a brief message or description that appears when the user hovers their cursor over the tooltip icon next to the control. This feature can help to provide additional context and guidance to the user as they interact with the form or application.

5. Caption Appearance: In this category, users can customize the visual appearance of the control’s caption.
   • For more information on the fields in this category, click here.

Nested Form Link Control Preview: Web View

*For more information on how to use this field in the web application, click here.