You can use template keys in profiles to avoid having to set up numerous profiles which differ only in terms of a few points. The template keys contain parameters that are to receive divergent values for different devices. In addition, there are static template keys that receive their values from the device. The profiles containing template keys are called template profiles.
| Info |
|---|
Template keys, values and template profiles created in the Console are also available in the UMS Web App, and vice versa. The following are only available in the UMS Console:
For details on the listed features, see Template Profiles in the IGEL UMS. |
...
Prerequisites
The following steps give you an overview of how template profiles are used in the UMS Web App:
...
Enable template profiles option
...
is activated. For
...
more information, see How to Activate Template Profiles in the IGEL UMS.
...
Access the Template Keys Dialog
You can create template keys and values
...
and apply them to the parameters in the Template Keys dialog. To access the dialog:
Edit an existing profile or create a new profile.
| Info |
|---|
In the IGEL Web App we always use the Profile Configurator to create template keys and values. For more information on how to create profiles |
...
, see How to Create and Assign Profiles in the IGEL UMS Web App |
...
. |
...
To use template keys and values in profiles, proceed as follows:
...
In the Profile Configurator, go to the parameter for which you want to use the template key.
Activate the parameter and click the template key icon at the right side to open the Template Keys sidebar.
...
| Info |
|---|
Certain parameters cannot be configured with template keys and only offer the |
...
option inactive or active. This applies for example to passwords or parameters which depend on other configuration settings. |
...
The following template key types are listed in
...
the Template Keys tree node:
Custom
Here you can create your template keys and directories and template key values.
Static
The values of static template keys are received directly from the device. Static template keys are marked with the § symbol. The following static template keys are available:
MAC: MAC address of the device
HOSTNAME: Host name of the device
UNITID: Unit ID of the device
SERIALNUMBER: Serial number of the device
Create Template Key Directories
To organize your template keys under directories, create the directories first:
Click
...
Create new directory.Give a name to your directory. The name cannot be empty and it cannot be more than 200 characters long.
Click
...
☑ or press [Enter] to save.
| Note |
|---|
|
Create Template Keys
To create template keys:
Select the directory under which you want to create the template key.
Click Create new template key.
...
Give a
...
Name to the key.
The
...
name:
cannot be empty.
has to be unique.
cannot be more than 200 characters long.
Optionally, give a
...
Description.
...
| Info |
|---|
The |
...
Type for the key is stipulated by the selected parameter. For example, the type is going to be StringType for a parameter with a string field. |
Add Template Key Values
To add values to the template keys:
Click + Add.
Define the desired parameter value in
...
the Value field, or in case of parameters with a fixed value range, select from the available value options.
...
Add a Description.
...
In case of parameters with a fixed value range such as selection menu or checkbox, the available options will be provided for selection. Click
...
Add
...
all to add all predefined values to the template key. You can change the predefined description of the parameters according to your needs.
| Tip |
|---|
Using |
...
Add |
...
all can be helpful when parameters are known by their predefined Descriptions rather then their Values, for example, the Timezone parameter. With all the Descriptions listed, it is easier to find the predefined Value that you are looking for. |
...
 |
Define the Description.
Click
Save.
If you do not want to save the template key, click Cancel.
If want to modify an already saved template key, select the template key in the tree and click edit.
...
| Note |
|---|
Template keys can be used in several profiles. Renaming a template key makes all profiles using the template key partly undefined. Check these profiles and deactivate or replace the edited template key there. |
Apply the Key to the Parameter
Select the Template Key for the parameter and click [+] Use. The key is displayed at the bottom.
...
...
| Tip |
|---|
You can also combine template keys by typing the keys manually: |
...
 When you assign the values, both keys will be resolved and the displayed value will be a combination of both. |
...
Click Set key to apply the key with its values and return to the profile.
The key is shown in the profile parameter:
...
When a template key is in use, it is marked in the Profile Configurator with the following symbols:
...
- There is a saved template key change in one of the child pages.
...
- There is a saved template key change in the page.
...
/ There is a saved template key change in the tab.
Save the template profile
...
.
| Tip |
|---|
The template keys used in the profile are listed under the Template Key Relation tab of the Profile Management panel.  |
Assign Profile and Values to Devices
Assign the template profile and the template values in the Devices area to individual devices or device directories. For more information on how to assign them, see How to Create and Assign Profiles in the IGEL UMS Web App and How to Assign Objects in the IGEL UMS Web App.