getMatrixValue Step

Use this step to retrieve a XML node value from the N (x) N XML matrix.

Last published at: January 22nd, 2026

Description:

This step retrieves the XML node value from the N × N XML matrix.

 

Inputs

  • xmlVariable – variable that holds the XML for the matrix
  • columnName – provide column name
  • rowIndex – index position for the row
  • valueVariable – variable/global to store the cell value
 

 

Returns

  • True – step executed successfully
  • False – step failed to execute 
 

 

 

Usage:

 

 

Example:

Let’s build and execute the “getSetMatrixValueDef” example.          

  • Create a new definition named “getSetMatrixValueDef” and open it in designer mode. 
  • Drag a “setMatrixValue, getMatrixValue” step to the canvas. 
  • Connect the dots between the “Start” step and the 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, then click the Save button. Note: Click the "AI Predict" button to have the Copilot add new process steps that match your process description. 

 

  • The following XML 2x2 matrix values are used in this example. 

 

  • Click the "setMatrixValue" step to configure its "Optional" properties. Provide a variable or global reference to hold the XML data. Provide the matrix column name. You may configure individual matrix values (1 x 1) by specifying the data and row index. Click the button to configure multiple matrix values. A pop-up window appears for configuration. Click the Add Row (+) button to insert an empty row. Provide the row index value, column name, and the value to assign. Click the Save button. You may insert multiple matrix row indexes and values using the Add Row button. 

 

  • Click the "getMatrixValue" 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 "getMatrixValue" step to configure its "Optional" properties. Provide the variable or global reference that holds the XML reference. Provide the column name and the row index value. Provide a variable or global reference to store the cell value. 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 the matrix cell value and store it in the variable or global, as configured. 

 

 

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.

Click here to download the sample file.