For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
DocumentationAPI referenceRelease notes
DocumentationAPI referenceRelease notes
  • Platform On-Prem
    • Overview
    • Navigate
    • Search resources
  • Apps
      • Overview
      • Navigate
        • Overview
        • Create and manage
        • Migrate transformations
        • Transformation options
    • Itential Automation Gateway
  • Resources
    • Itential Academy
    • Version lifecycle
    • Itential MCP
    • Accessibility conformance
    • Get support
    • FAQs
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Options reference
  • Set options on the workflow canvas
  • Add a transformation task to a workflow
  • Configure options on the task
  • Run the workflow
  • Set options in JST Designer
AppsStudioTransformations

Transformation options

Was this page helpful?
Previous

Operations Manager overview

Next
Built with

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

OptionDescription
Mask Input Variable ValuesEncrypts incoming variables and displays them as asterisks in Jobs (Operations Manager). Available on all tasks.
Mask Output Variable ValuesEncrypts outgoing variables and displays them as asterisks in Jobs (Operations Manager). Available on all tasks.
Extract OutputRemoves the wrapper object from the output and returns only the value of the property. Applies only when a single outgoing schema exists.
Validate IncomingValidates 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 ValueEnables 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

1

Open Studio

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

2

Create or open a workflow

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

3

Find the transformation task

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

4

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

1

Open the task

Double-click the Transformation task.

2

Select a JST and set variables

Choose the transformation to run and edit the incoming variables.

3

Select options

Check any options from the options reference above.

4

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.

1

Open the Run Transformation modal

Click Run in the JST toolbar.

2

Enter input data and select options

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

OptionAvailable in Run modal
Validate IncomingYes
Extract OutputYes
Revert to Default ValueYes
Mask Input Variable ValuesNo — set on the canvas task
Mask Output Variable ValuesNo — set on the canvas task
3

Run

Click Run. The output appears in the Log Console.