Description:
This step converts JSON items to a list.
Inputs
- varGlobalHoldingJSON – variable or global that holds JSON
- JSONPathExp – JSON path expression
- separator – list separator
- varGlobalToStoreList – variable or global to store the list items
Returns
- True – step executed successfully
- False – step failed to execute
Usage:
Example:
Let’s build and execute the “JSONPathToListDef” example.
- Create a new process definition named “JSONPathToListDef” and open it in designer mode.
- Drag an “executeSQL and JSONPathToList” step to the canvas.
- Connect the dots between the “Start” and other steps, as shown above.
- Define a variable or a global to store the JSON values and the List.
- Click the first "executeSQL" step to configure its "Required" properties. Provide a name for the step. Select the connection string from the list. Enter the SQL SELECT statement. Select the result format as XML or JSON. Click the Save button. Note: Click the "AI Predict" button to have Copilot add new process steps that match your process description.
- Click the first "executeSQL" step to configure its "Optional" properties. If the database differs from the connection string configured in Integration - Connections, provide the database name. Provide a variable or a global to store the result. Select the result to return a single row or column (if necessary). Set the SQL command timeout value in seconds. Click the button to configure the SQL parameters and values. A pop-up window appears for configuration.
- Click the “JSONPathToList” step to configure its “Required” properties. Provide a name for the step. Provide the variable or global reference that holds the JSON value. Provide the JSON path expression. Provide a variable or a global reference to store the list. Click the Save button. Note: Click the "AI Predict" button to have Copilot add new process steps that match your process description.
- Click the “JSONPathToList” step to configure its “Optional” properties. The default list separator is a pipe character ("|") unless otherwise specified. If the separator differs from the default, enter it. Then click the Save button.
- The “Logging” configuration is necessary for documentation and to track workflow progress and completion percentage. 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 convert JSON values to a list and store the result 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 import process steps for any missing configurations, such as file path references and database connections. Then, save the definition to confirm the changes.