getDBFieldValue Step
Description:
This step retrieves a database field value and assigns it to a variable.
Inputs
- connectionString – connection string to the database
- changeDatabase – connect to different database
- fieldname – the name of the field to get the value from
- tableName – name of the table
- whereFieldName – field name for the where clause
- whereFieldValue – field value for the where clause
- variableName – name of the variable to store the field value
Returns
- True – step executed successfully
- False – step failed to execute
Usage:
Example:
Let’s build and execute the “getDBFieldValueDef” example.
- Create a new process definition named “getDBFieldValueDef” and open it in designer mode.
- Drag a “getDBFieldValue” step to the canvas.
- Define a variable or a global to store the result.
- Connect the dots between the “Start” and “getDBFieldValue” steps, as shown above.
- Click the “getDBFieldValue” step to configure its “Required” properties. Provide a name for the step, then click the Save button. Note: Click the "AI Predict" button to have the Copilot add new process steps that match your process description.
- Click the “getDBFieldValue” step to configure its “Optional” properties. Select a connection string from the drop-down list. If required, provide a different DB name (other than FlowWright); by default, the step connects to the FlowWright database. Provide the table name, field name, and SQL search condition that refers to the field name and criteria. Provide a variable or global to store the result. Click the Save button.
- The “Logging” configuration is necessary for documentation and also measures workflow progress and percent complete. This is achieved by configuring the step state and percent fields individually, as shown below. Configure the “Logging” using the following properties.
- Save the process definition, create a new instance, and execute it. Render the process instance. Click the process step to view its properties. The step should retrieve and assign the database field value to the variable.
Definition Sample:
You may download the sample definition(s) from the link provided and later import them (drag-and-drop) into 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 the import. Then, save the definition to confirm the changes.