Transformation options

Transformation options control how a JSON Schema Transformation (JST) handles input validation, output formatting, and default values. You can set options in two places: on the transformation task in the workflow canvas, or in the Run Transformation modal in JST Designer.

Options reference

Option	Description
Mask Input Variable Values	Encrypts incoming variables and displays them as asterisks in Jobs (Operations Manager). Available on all tasks.
Mask Output Variable Values	Encrypts outgoing variables and displays them as asterisks in Jobs (Operations Manager). Available on all tasks.
Extract Output	Removes the wrapper object from the output and returns only the value of the property. Applies only when a single outgoing schema exists.
Validate Incoming	Validates that the input is the correct type and compatible with any keywords set in the incoming schema, such as `enum` or `const`.
Revert to Default Value	Enables use of the `default` keyword. Default values from incoming schemas are used when a key or incoming data value is not provided. If an outgoing schema has a default value and nothing is assigned to it, the default value appears in the transformation output.

Set options on the workflow canvas

Add a transformation task to a workflow

Open Studio

From the Itential Platform home page, select Studio from the left navbar.

Create or open a workflow

Click + Create a Workflow from the Quick Start card, or open an existing workflow.

Find the transformation task

In the Search bar at the top of the Task panel, type Transformation to locate the transformation task.

Drag to the canvas

Drag the transformation task to the canvas and connect it to the tasks that require data transformation.

Configure options on the task

Open the task

Double-click the Transformation task.

Select a JST and set variables

Choose the transformation to run and edit the incoming variables.

Select options

Check any options from the options reference above.

Close and save

Close the task — it saves automatically. Then click Save on the workflow.

Run the workflow

Click Start in the top-right of the canvas to run the transformation.

Set options in JST Designer

When running a JST directly from JST Designer, a subset of options is available in the Run Transformation modal.

Enter input data and select options

Enter the JSON input for the incoming schema, then check any desired options:

Option	Available in Run modal
Validate Incoming	Yes
Extract Output	Yes
Revert to Default Value	Yes
Mask Input Variable Values	No — set on the canvas task
Mask Output Variable Values	No — set on the canvas task

Run

Click Run. The output appears in the Log Console.