When form become large and complex with hundreds and thousands of fields, end users experience long response time when rendering forms at runtime. To minimize the response time, adaptive forms allows you to break forms into logical fragments and configure to defer initialization or loading of fragments until the fragment needs to be visible. It is referred to as lazy loading. In addition, the fragments configured for lazy loading are unloaded once user navigates to other sections in the form and the fragments are no longer visible.
Let’s first understand the requirements and preparatory steps before you configure lazy loading.
Before you configure lazy loading of fragments in your adaptive form, it is important you define strategies to create fragments, identify values that are used in scripts or referred in other fragments, and define rules to control visibility of fields in lazily loaded fragments.
Identify and create fragments
You can configure only adaptive form fragments for lazy loading. A fragment is a stand-alone segment that resides outside an adaptive form and can be reused across forms. So, the first step toward implementing lazy loading is to identify logical sections in a form and convert them into fragments. You can create a fragment from scratch or save an existing form panel as fragment.
For more information about creating fragments, see Adaptive form fragments.
Identify and mark global values
Forms-based transactions involve dynamic elements to capture relevant data from users and process it to simplify form filling experience. For example, your form has field A in fragment X whose value determines the validity of field B in another fragment. In this case, if fragment X is marked for lazy loading, the value of field A must be available to validate field B even when fragment X is not loaded. To achieve this, you can mark field A as global, which ensures that its value is available for validating field B when fragment X is not loaded.
For information about how to make a field value global, see Configuring lazy loading.
Write rules to control visibility of fields
Forms include some fields and sections that are not applicable to all users and in all conditions. Forms authors and developers use visibility or show-hide rules to control their visibility based on user inputs. For example, the Office Address field is not shown to the users who choose Unemployed in the Employment Status field in a form. For more information about writing rules, see Using rule editor.
You can leverage visibility rules in the lazily loaded fragments so that conditional fields are shown only when they are required. Also, mark the conditional field global to refer to it in the visibility expression of the lazily loaded fragment.
Perform the following steps to enable lazy loading on an adaptive form fragment:
Open the adaptive form in authoring mode that contains the fragment you want to enable for lazy loading.
Select the adaptive form fragment and tap .
In the sidebar, enable Load fragment lazily and tap Done.
The fragment is now enabled for lazy loading.
You can mark the values of objects in the lazily loaded fragment as global so that they are available for use in scripts when the containing fragment is not loaded. Do the following:
Open the adaptive form fragment in authoring mode.
Tap the field whose value you want to mark as global, and then tap .
In the sidebar, enable Use value during lazy loading.
The value is now marked as global and will be available for use in scripts even when the containing fragment is unloaded.
Some limitations, recommendations, and important points to keep in mind when working with lazy loading are as follows:
Important points to keep in mind while developing scripts for lazy loading panels are as follows:
Ensure that initialize and calculate scripts used on the fields of a lazy loaded fragment are are idempotent in nature. Idempotent scripts are those which have same effect even after multiple executions.
Use the globally available property of fields to make value of fields located in a lazy loading panel available to all other panels of a form.
Do not forward reference value of a field inside a lazy panel irrespective of field being marked globally across fragments or not.
Use panel reset feature to reset everything visible on the panel by using the following click expression.