setMatrixValue Step

Use this step to set the matrix cell value.

Last published at: August 12th, 2025

Description:

The step 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 process definition called “setGetMatrixValueDef” and open the definition in designer mode. 
  • Drag a “setMatrixValue, getMatrixValue” step to the canvas. 
  • Connect the dots between the “Start” step and other steps, as shown above.
  • Define a variable or a global to store the matrix data and the cell value.
  • Click the "setMatrixValue" step to configure its "Required" properties. Provide a name for the step. Click the Save button. Note: Click the "AI Predict" button for the Copilot to add new process steps that match your process description. 

 

  • 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 or a 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 pop-up 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. You may add multiple matrix row indexes and values using the Add Row button. You can use the “arrow keys” to reorder the row position. You can click the “copy” icon to duplicate the row contents onto the new row.  

 

  • Click the "getMatrixValue" step to configure its "Required" properties. Provide a name for the step. 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 "getMatrixValue" step to configure its "Optional" properties. Provide the variable or global reference that holds the XML value. Provide the column name and the index row value. Provide a variable or global reference 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 then execute it. Render the process instance. Click the process step to view its properties. The step should set the matrix data, retrieve the matrix cell value, and store it in a variable or global as configured. 

 

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.