Add a Configuration Template
You must be a user assigned either the Super User or the Network Administrator role with the privilege to add configuration templates.
To add a configuration template:
Table 1 lists fields to be entered on the Basic Information tab of the Add Configuration Templates page.
Field |
Description |
---|---|
Template Name |
Enter a unique name for the configuration template. The name can only contain alphanumeric characters, hyphen, period, and underscore; 64-characters maximum. |
Description |
Enter a description for the configuration template; 255-characters maximum. |
Configuration Format |
Select the output format for the configuration template:
|
Device Family |
Select a device family for which you are deploying the configuration template:
|
Table 2 lists the actions that you can perform on the Generated UI tab of the Add Configuration Templates page.
Action |
Description |
---|---|
Reorder the UI |
Drag and drop individual fields, grids, or sections to change the order in which the parameters appear on the UI. |
Modify the settings for a field, section, or grid |
To modify the settings for a field, section, or grid:
|
Reset the generated UI |
Click Undo all Edits to discard the changes that you made and undo the changes made on the UI. |
Preview configuration |
Preview the configuration defined in the configuration template. To preview a configuration template:
|
Table 3 lists the fields on the Form Settings pane.
Setting |
Guideline |
---|---|
Basic Settings Tab |
Fields populated in this tab are based on the input type that you select for a parameter. |
Input Type |
The input type for the parameter in the configuration template. Select:
|
Label |
Enter the label that you want displayed (on the UI) for the parameter. |
Default Value |
Specify a default value for the parameter. |
Validate |
For Text input type, select one or more validation criteria against which the input value will be checked:
If the value that you entered for the parameter on the UI does not meet the selected validation criteria, an error message appears. Note:
For greater control of input values, you can use the regular expression option in the Advanced Settings tab. |
Description |
Enter an explanation for the parameter, which will appear when you hover over the Help (?) icon for the parameter; the maximum length allowed is 256 characters. |
Global Scope |
Enable the toggle button to make the parameter common across all devices to which the configuration template is being deployed. A Global (G) icon is displayed beside the selected parameter. If you disable the toggle button, which is default, the parameter must be specified for each device. |
Hidden |
Click the toggle button to hide the parameter on the UI when you preview and deploy the template. Typically, this option is used to hide a parameter and display it in the template only when an event is triggered. By default, the toggle button is disabled, which means that the parameter is displayed. |
Required |
Click the toggle button to make the parameter mandatory; parameters that are mandatory are marked with an asterisk (*) on the UI. |
Maximum Value |
For parameters that are numbers, enter the maximum value (up to 16 digits) for the input. |
Minimum Value |
For parameters that are numbers, enter the minimum value (up to 16 digits) for the input. |
Visibility for Disabled |
For Boolean parameters, select one or more parameters that must appear on the UI when the toggle button is disabled (Boolean value is FALSE). |
Visibility for Enabled |
For Boolean parameters, select one or more parameters that must appear on the UI when the toggle button is enabled (Boolean value is TRUE). |
Advanced Settings Tab |
|
Regexp |
Enter a regular expression (regex pattern) to validate the input value. A regular expression defines a search pattern that is used to match characters in a string. For example, the regular expression [A-Z] matches the input with the characters A through Z. If the input consists of characters other than A through Z, an error message (as specified in the Invalid Message field) appears. |
Invalid Message |
Enter an error message that you want to display on the UI when the input value does not match the specified regular expression. |
What's Next
You can deploy the template on devices; see Deploy a Configuration Template to a Device.