Description:
Sets the value of a given matrix cell
Inputs
- xmlVariable – variable that holds the XML for the matrix
- columnName – provide column name
- setMatrixValues – multiple cell values to assign
- valueToAssign – value to assign to the cell
- rowIndex – index position for the row
Returns
- True – step executed successfully
- False – step failed to execute
Usage:
Example:
Let’s build and execute the “setGetMatrixValueDef” example.
- Create a new definition called “setGetMatrixValueDef”
- Select the definition and click the “design” button
- Drag a “setMatrixValue, getMatriValue” steps from the toolbox
- Connect the dots between the Start and the steps above
- Define a variable/global to store the matrix data and the cell value
- Click the "setMatrixValue" step to configure its "Required" properties. Provide a name to the step. Click the Save button.
- The following XML 2 x 2 matrix values are used in this example.
- Click the "setMatrixValue" step to configure its "Optional" properties. Provide a variable/global reference to hold the XML data. Provide the matrix column name. You may configure individual matrix values (1 x 1) by providing data and row index values. Click the button to configure multiple matrix values. A popup window is displayed for configuration. Click the Add Row button to insert an empty row. Provide the row index value, column name, and value to assign. Click the Save button. Using the Add Row button, you may add multiple matrix row indexes and values. Click the Save button on completion.
- Click the "getMatrixValue" step to configure its "Required" properties. Provide a name to the step. Click the Save button.
- Click the "getMatrixValue" step to configure its "Optional" properties. Provide the variable or global that holds the XML reference. Provide the column name and the index row value. Provide the variable or global to store the cell value. 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 execute. Render the process instance. Click on the process step to view its properties. The step should set the matrix data, get the matrix cell value, and store it in the variable/global as configured
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 sample file.