Description:
This step fetches the Form field values by the Form Instance ID.
Inputs
- formInstanceID – Variable that holds the form instance ID
- fieldMappings – Mapping of values to fields
- formID - Select Form Definition
Returns
- True – step executed successfully
- False – step failed to execute
Usage:
Example:
Let’s build and execute the “getFormFieldValuesDef” example.
- Create a new Form Definition called “getFormFieldValuesDef”
- Select the definition and click the “design” button
- Drag the “bootstrapGrid, labels, textboxes, text area, date, and submit” controls and arrange them as below. Save the form configuration.
- Create a new Process Definition called “getFormFieldValuesDef”
- Select the definition and click the “design” button
- Drag a “routeForm, getFormFieldValues” steps from the toolbox
- Connect the dots between the steps as shown above
- Define the variables/globals as below to store the form field values during execution
- Click the “routeForm” step to configure its “Settings” properties. Select the above form definition from the drop-down list. Configure the user to route in the “Advanced” tab. Provide a variable/global to store the form instance ID.
- Click on the “getFormFieldValues” step to configure its “Settings” properties
- Click on Mapping of fields to variables and add map fields to variables or Globals
- The “Logging” setting configuration is necessary for documentation and also measures the workflow progress and the percent complete. This is achieved by configuring the step state and percent fields individually, as shown in the images below. Configure the “Logging” using the following properties.
- Save the process definition, create a new process instance, and execute. The process instance is sleeping, and the Form task is assigned to the user configured.
- Navigate to the Engage - Tasks page to view the Form Task.
- Click the Form task to render the Form. Provide the values and submit the Form.
- The process instance completes with “getFormFieldValues” step. Click on the process step to view its properties. The step gets form field values and assigns them to a given variable or global.
Definition Sample:
You may download the sample definition(s) from the link here and later import it (drag-drop) to your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.
NOTE: Please verify and complete the process steps for any missing configurations, such as file path references and database connections after import. Then, save the definition to confirm the changes.
Click here to download the Form Definition sample file.