> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Transformation options

> Reference for transformation task options in Itential Platform Studio, with instructions for setting them on the workflow canvas and in JST Designer.

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](#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.

#### Open the Run Transformation modal

Click **Run** in the JST toolbar.

#### 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**.