Update Form Data Tool

Introduction

The Update Form Data Tool in Joget DX allows users to update information in forms that have already been submitted. It is ideal for processing existing forms and updating fields based on business rules or data from external systems. Attempting to use this tool for a form that has not yet been submitted will result in an exception.

For pre-populating form fields of new forms, consider using the Preset Form Data Tool instead or hash variables in your forms.

Configure update form data

To configure Update Form Data, drag and drop the Tool element onto the canvas in Process Builder,  click on it, and select Mapping.

When adding Update Form Data in the field Tools, you will see the following fields available for configuration:

• Form: Select the target form where data will be updated.
• Update Fields: Specify the fields to be updated.
  
  Which record row to update?
   By default, the tool looks for a record with the same ID as the current process instance. Alternatively, you can explicitly define an id field and value to update a specific record.
  • Field ID: Enter the field ID in the form you want to update. The field ID must exist in the chosen form.
  • Value: Define the new value to be set for the field.
    
    Note
    

    1. The Value field supports multi-line input and line breaks. This allows you to enter longer or formatted text without using workarounds.
    2. Joget DX 8.2 does not support multi-line input for this field. If an app created in Joget DX 9 that uses multi-line values is imported into Joget DX 8.2, the Value field will be displayed as a single-line input, and line breaks will not be preserved.

See the Updating Foreign Record using Form Data Update Tool documentation for more information.