updateDBFieldValue Step
Description:
This step updates a given database row and column with a new value.
Inputs
- connectionString – connection string to the database
- tableName – the name of the database table
- changeDatabase – connect to different database
- fieldName – the name of the field to update
- fieldValue – value to update
- whereFieldName – name of the where clause field
- whereFieldValue – the value of the where clause field
Returns
- True – step executed successfully
- False – step failed to execute
Usage:
Example:
Let’s build and execute the “updateDBFieldValueDef” example.
- Create a new process definition called “updateDBFieldValueDef” and open the definition in designer mode.
- Drag an “updateDBFieldValue” step to the canvas.
- Connect the dots between the “Start” and “updateDBFieldValue” steps, as shown above.
- Click the “updateDBFieldValue” step to configure its “Required” properties. Provide a name for the step. Select the connection string from the drop-down list. Provide a table name. Provide the field name and the new value. Define the SQL search condition by referencing the field name and the corresponding criteria. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description.
- Click the “updateDBFieldValue” step to configure its “Optional” properties. Provide a different DB name (other than FlowWright) that exists on the exact connection string, if required. By default, the step will connect to the FlowWright database. Click the Save button.
- 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 instance, and then execute it. Render the process instance. Click the process step to view the properties. The step should update the DB field.
- Included here for reference is the DB field value (External User Email) before the change.
- Included here for reference is the DB field value (External User Email) after the change.
Definition Sample:
You may download the sample definition(s) from the link here and later import them (drag-and-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 sample file.