- 18 Oct 2024
-
DarkLight
-
PDF
Security Rule Creation (Panorama) - JSON Form
- Updated on 18 Oct 2024
-
DarkLight
-
PDF
Before building the lab exercise, let's take a look at JSON Forms. JSON Forms allow you to quickly and easily build forms to collect user input. Here you will build a simple form to demonstrate the form builder and the various input types available.
This exercise is not required for our use case but is intended to show the variety of ways a form can be designed to take in data from a user.
JSON Form Video
Step 1
From IAP Cloud, log in to your IAP instance by clicking on the blue Launch icon.
Step 2
From the IAP Home page, Click Automation Studio.
Step 3
Click the + at the top of the left navigation panel.
Step 4
The Create window opens. Click the drop down and select JSON Form.
Step 5
We give it a name of Form - Panorama - XX where XX represents your initials.
Click CREATE to create the form.
Step 6
We use a drag and drop concept within JSON Forms. By clicking the Form Elements found on the right panel, you can select which types of fields appear in the form. There are seven types of form fields or elements to choose from.
We will drag several Form Elements to the area marked Drop elements here.
Click and drag the Text Input form element to the form canvas.
Step 7
When the element reaches the canvas, a red box will appear indicating where the element will be placed.
Step 8
Next, we need to configure the text field. Hover the mouse over the ellipses located in the upper-right corner.
Step 9
A gear icon appears. Click the gear.
Step 10
The Configure window opens. The Text Input field will be for the user's first name. For Label, enter First Name.
Next, let’s make this a required field. Click the Yes radio button.
For the Placeholder, type Enter your first name.
Click Save.
Step 11
Next, add a Text Area. Drag the Text Area field to the canvas.
Step 12
Hover the mouse over the ellipses and click the gear icon.
Step 13
Name the field Interesting Fact and add a place holder description of Enter an interesting fact about yourself.
Click Save.
Step 14
The next type of field we want to add is a Number Input. In the Label field, enter Favorite Number.
Step 15
Next, you will need a Dropdown field. Drag the Dropdown field to the canvas and open the configure window.
Label the field Favorite Color and make it required. Notice near the bottom, there is a warning about options being needed. Click the + Options button.
Step 16
The Configure Options window opens. Click the + Option button three times to add three options.
Step 17
Click in each of the three fields and add any color you want. In our example we used Green, Blue, and Purple. Click the Back button.
Step 18
The options message has changed. Click Save.
Step 19
You will add one more field, the Checkbox. Drag the Checkbox element to the canvas. Hover over the ellipses and click the gear icon. Give it a label of I Like Pizza and have it default to checked. Click Save.
Step 20
Our form is complete. Click the Save button and then the Preview icon in the upper-right corner.
Step 21
The Preview Form window opens and we complete the form. Click Show Form Data at the bottom of the Preview Form window.
Step 22
With automations, forms can be created to gather data from users or to build a structure for data input. Later on in this use case, we'll use a similar form that gathers Security Rule policy information.
Often times we need to modify the way that the data is structured to fit the needs of other systems or the automation itself. Itential’s low-code solution for data manipulation is called JSON Schema Transformation, or simply Transformations. We’ll take a look at that next.
Click Close.