- 18 Oct 2024
-
DarkLight
-
PDF
Port/VLAN Configuration (EOS) - Transformations
- Updated on 18 Oct 2024
-
DarkLight
-
PDF
Next we will build a Transformation (JST) to manipulate the data from form input to the Itential Pre-Built. We know that users will be submitting data using our form, but when doing that the values are not sent to the workflow individually; they are sent as a single variable called formData. To handle this, we will need to transform the data. To do that, we’ll build a Transformation.
For this module, we will leverage the JSON Form created in the Port/VLAN Configuration (EOS) - JSON Form module. If you have not yet, please complete that module first. We will be using the JSON Preview form data for our Transformation in this module.
Transformation Video
Step 1
From the IAP Home page, click Automation Studio
Step 2
Click the + icon in the upper left navigation window. The Create window opens.
Step 3
In the Create window, select Transformation and give it a name of Lab - Port Turn Up - EOS JST - XX. (XX represents your initials)
Click CREATE.
Step 4
A fresh canvas opens and we begin to create our transformation. Click the + under Incoming Schemas.
Step 5
Schemas can be created by entering sample JSON. We'll use the output data we copied from the JSON Form. Paste the JSON Form data on the right. In case you no longer have your copied data, you can use the sample data below.
{
"autoApprove": false,
"type": "Vlan",
"cidr": "30",
"device": "EOS",
"id": "25",
"description": "test_vlan",
"ipAddress": "20.0.0.97"
}
Step 6
Next, click Infer Schema From Example JSON.
Step 7
By clicking Infer Schema from Example JSON, IAP digests the sample JSON, parses the data, determines appropriate data types and creates a JSON schema for it. We just need to add an ID.
To the right of “$id”: click between the ““ and enter formData, then click Save.
Step 8
The incoming schema is created. Next we need to build the Outgoing Schema. The Outgoing Schema represents what the Pre-Built needs to run. This is done using the Incoming Schema data.
Click the half-circle for the autoApprove value in the Incoming Schema and then click the + under Outgoing Schemas.
Step 9
The Outgoing Schema is created, building a connection between it and the Incoming Schema.
Step 10
Repeat for each formData value in the Incoming Schema. Click the Save icon.
Step 11
We are ready to test the Transformation. Click the ▶ button.
Step 12
Click the Run button.
Step 13
Review the output.