Port/VLAN Configuration (EOS) - JSON Form
  • 07 Dec 2022
  • Dark
    Light
  • PDF

Port/VLAN Configuration (EOS) - JSON Form

  • Dark
    Light
  • PDF

Article Summary

create_json_form_title

In this module, we will build a JSON form. A JSON Form is just one of the ways an automation can be triggered.  For our use case today, this form is how users will submit the information needed when running our Port Turn Up automation.


Step 1

From the Itential Automation Platform dashboard, click Automation Studio in the left navigation panel.

Graphical user interface, website  Description automatically generated


Step 2

Click the + icon at the top of the left navigation panel.

Graphical user interface, website  Description automatically generated


Step 3

The Create window opens. Click the dropdown menu and select JSON Form in the What would you like to create field.


Step 4

Enter the name Lab - Port Turn Up - EOS Form - XX, where XX is your initials. Click CREATE to create the form.

Graphical user interface  Description automatically generated


Step 5

JSON Forms also utilizes a drag and drop interface. By clicking the Form Elements found on the right panel, you can select which types of fields appear in the form.  There are six types of form fields or elements to choose from.  The first element we need is an auto approve checkbox.  Click and drag the Checkbox form element to the canvas where we can see the text Drop elements here.

Step5_EOS_JSONForms(1)


Step 6

When the element reaches the canvas, a red box will appear indicating where the element will be placed.  Step6_EOS_JSONForms


Step 7

Once the element has been added to the form, an ellipses icon will appear in the top-right corner. Hover the mouse over the ellipses to see the gear icon.


Step 8

Click the gear icon to configure the form element.


Step 9

In Itential's Port Turn Up Pre-Built automation, there are a few manual approvals for the user to confirm.  In our form, we will create an Auto Approve checkbox that bypasses these manual approvals for scenarios in which we do not need a user to confirm that the automation should proceed.  For our checkbox element, enter the name Auto Approve in the Label field.

Step9_EOS_JSONForms


Step 10

We will accept the default settings for the remaining options and click Save.


Step 11

Our next element will let the user determine our target device.  We will choose the Dropdown element for this field.

Step11_EOS_JSONForms


Step 12

Add a Dropdown element to the canvas.


Step 13

Hover your cursor over the ellipses in the upper right corner of the Dropdown section and click the gear icon.


Step 14

Type Device in the Label field. Select Yes for Required, and accept the remaining default settings. This time click + Options in the lower right corner to set another option.

Step14_EOS_JSONForms


Step 15

Within the Options section, we have the option to create a static dropdown in which we define the dropdown values or dynamic that would be populated by making an API call.  For the sake of simplicity, we will select Static. Click the + Option button.

Step15_EOS_JSONForms(1)


Step 16

This is where we can add choices for our dropdown. We will add only one here, but multiple entries can be added. Add EOS and click Back.

Step16_EOS_JSONForms


Step 17

Click the Save button.

Step17_EOS_JSONForms


Step 18

Use the same process to complete the form using the fields specified below:

  • Add a Dropdown
    • Label: Type
    • Required: Yes
    • Read-Only: Yes
    • Placeholder: Choose interface type
    • Static Options: Vlan
  • Add a Text Input
    • Label: ID
    • Required: Yes
    • Placeholder: Enter interface ID
  • Add a Text Input
    • Label: Description
    • Required: Yes
    • Placeholder: Enter interface description
  • Add a Text Input
    • Label: IP Address
    • Required: Yes
    • Placeholder: Enter IPv4 Address
    • Format: ipv4
  • Add a Text Input
    • Label: CIDR
    • Required: Yes
    • Read-Only: Yes
    • Placeholder: Enter CIDR Size
    • Minimum Length: 1
    • Maximum Length: 2


Step 19

If there is a value that should be populated by default within the form, the user can enter it on the form element on the canvas.

Step19_EOS_JSONForms


Step 20

Complete the default values for the following fields:

  • Type: Vlan
  • CIDR: 30

Step20_EOS_JSONForms


Step 21

The JSON Form Canvas should look like the image below. Click the Save icon.

Step21_EOS_JsonForms


Step 22

Click the Preview icon.

Step22_EOS_JsonForms


Step 23

Complete the form as shown, using the following inputs:

  • Auto Approve: selected
  • Device: EOS
  • Type: Vlan
  • ID: 30
  • Description: Test_Vlan
  • IP Address: 10.20.30.1
  • CIDR: 30

Click the Show Form Data button.

Step23_EOS_JSONForms


Step 24

This is the format in which the data will be submitted when executing our automation from Operations Manager. Hover the mouse near the text 7 items at the top of the list, and click the clipboard icon to copy the text.

Paste the text into a text editor, such as Notepad. You will use this data when we build the Transformation.

Click the Close button when you are finished.

Step24_EOS_JSONForms





Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.