Form Settings > Conditional autofill

Conditional Autofill, designed to significantly streamline form-filling processes within your workflows! This enhancement allows for intelligent, automated population of form fields based on user actions (like uploading attachments) and predefined conditions. This means faster request initiation, reduced manual data entry, and improved accuracy for end-users.

Configuration

  1. Form Settings Configuration:
    1. A new "Form Settings" option is now available in the form's options drawer.

    2. Within "Form Settings," you can access and configure "Conditional Autofill" rules.

  2. Rule Creation for Autofill Logic:
    1. Define multiple IF conditions and a DO action to trigger autofill.
    2. Specify logic for IF conditions:
      1. Any of the IF conditions match: The action executes if at least one condition is true.

      2. All of the IF conditions match: The action executes only if all conditions are true.

    3. Field-Condition-Value Mapping: Configure rules based on various field types and conditions:
      1. Date (full date): is filled, before, after, is equal to date, not equal to date, in the past, in the future.

      2. Date (time): is filled, before, after, is equal to, not equal to.

      3. Date (date & time): is filled, before, after, is equal to date (compare dates only), not equal to date (compare dates only), in the past, in the future.

      4. Dropdown/Radio/Master/Static dropdown: Is any of, Is neither of, Is filled. (Values will render options with label (value)).

      5. Numeric: Is filled, Is less than, Is greater than.

      6. User component/Text/Attachment/Field Array: Is filled.

  3. Form Settings Edit and Validation:
    1. An explicit "Save" option is provided to save form settings configurations at the workflow draft version level.
    2. If a user attempts to publish an app before saving changes in form settings, an error will be shown under "Un-saved forms" in the "Review" workflow validations.
    3. If form fields used in saved form settings are edited or removed, validation errors ("Incomplete configurations under form settings for ‘form_name’") will be thrown to prompt the user to update the settings.

Improvements

  1. User Experience during Autofill:
    1. A loading state is displayed at the form level while the system executes actions and pre-fills information.
    2. A generic message ("Details are being retrieved...") is shown to the user during this loading state. This message covers both successful pre-fill and scenarios where pre-fill might not complete (e.g., API issues). No specific API error messages will be shown to the end-user to maintain a user-friendly experience.
  2. Default Re-initiation Logic for Autofill (MVP):
    1. The autofill action will re-initiate based on the following default behaviours without requiring specific configuration in this version:
      1. If ANY of the ‘IF’ conditions are met:
        1. Re-initiates if any subsequent IF condition is met.
        2. Re-initiates if the same IF condition is met again.
      2. If ALL of the ‘IF’ conditions are met:
        1. Re-initiates if all conditions are met again.
  3. Item Creation Handling (MVP):
    1. For forms utilising autofill, an item ID will not be created at the initiator input node until the user either saves the item as a draft or successfully submits the request.
    2. Troubleshooting for pre-fill issues can be done by referring to Execution Logs.
  4. Timeout Configurations:
    1. Conditional Autofill Action Timeout: An auto-timeout for the autofill action can be configured under form settings.
      1. Default: 10 seconds
      2. Minimum: 10 seconds
      3. Maximum: 30 seconds
    2. Frontend Timeout: A default frontend timeout of 30 seconds has been introduced for related operations.

DMS Utility App Specifics

The new "Form Settings" option (and thus Conditional Autofill) will be hidden and not available for forms within DMS utility apps.

How to configure a workflow under 'Execute Action'

You can create a workflow which can be initiated by an API. The documentation for the same is available here.

What's Next (Future Enhancements)

We are continuously working to improve the Workflow Builder and the new Conditional Autofill capabilities. Future enhancements may include:

  • Advanced Re-initiation Configuration: Granular controls for defining when and how autofill actions re-initiate.
  • Flagging Auto-filled Fields: Visual indicators in the form configuration to denote fields that are targets for autofill, improving clarity for workflow designers (especially for AA integration).
  • Enhanced AA Integration: Options to expose API details for AA to call or define specific behaviours for forms where details are pre-fetched.
  • Configurable Item ID Creation: App-level configuration for when an item ID should be created.
  • Detailed Progress Path: Visual tracking within the workflow for the execution of pre-filling actions and associated utility apps.
  • Dedicated Workflow Utility App for Dynamic Field Population: A specific utility app for managing and linking dynamic field population logic, potentially with navigation from the primary app.
  • Field Mapping Configuration: Introducing a mapper configuration, especially for Workflow utility apps, to define how source data maps to target form fields.