Parameters

In any Ivanti Automation environment, there will be Tasks that are used many times over, with just minor changes to their configuration. For example, you may have configured a Task Create Local User. Each time you use this Task to create a new local user, the only thing that differs from the last time is the user name. Of course, you could manually adjust the values in the Task each time you use it, but it is much more efficient to parameterize these values. In Ivanti Automation, parameters function as placeholders for values in various fields, such as text, file paths, credentials, etc. The actual values of these fields can be provided when they are needed. This makes it possible to create generic Modules, Projects and Run Books that can be customized to each situation when required.

You can configure parameters on three levels:

  • With Module parameters, you can parameterize values in Tasks.
  • With Project parameters, you can link Module parameters from various Modules in a Project.
  • With Run Book parameters, you can link Module parameters and/or Project parameters from various Modules and/or Projects in a Run Book.

Configuration

Properties tab

  • Parameters can be renamed. For example, this makes it easier to correct earlier mistakes or changes in naming conventions. When renaming parameters, linked parameters may become unlinked. This may lead to unexpected results when executing Modules, Projects or Run Books in which they are used:
    • If you rename a Module parameter that is linked to a Project parameter, the link will be broken.
    • If you rename a Project parameter that is linked to a Module parameter, the link will remain.
    • If you rename a Project parameter that is linked to a Run Book parameter, the link will be broken.
    • If you rename a Run Book parameter that is linked to a Project parameter, the link will remain.
    • The new name of the parameter will also be reflected when used in other parameters, conditions and evaluators.
  • You can use various types of parameters. Each parameter type represents a different type of information (e.g. parameters for text, for passwords, for credentials, for a list of values, etc).
  • You can define a default value for the parameter. You can define these values manually, but can also base them on other parameters and functions (by right-clicking the Value field and choosing from the context menu). The values of Text and Credentials parameters can also be based on Global Variables.
    • Parameter values can have a maximum length of 512 characters.
    • If a different parameter value is provided at the moment of use, the default value will be overwritten.
    • Alternatively, you may choose to leave the Value field empty.
  • When configuring List or Multi-select list parameters, you can specify the order in which the list values will be shown at the input moment by using the arrow buttons arrowup arrowdown.

Links tab

This tab is only available when configuring parameters on Project level or Run Book level. On this tab, you can view the way in which parameters are linked to each other and change this, if necessary. It is not possible to create new parameter links.

Input tab

The input settings of a parameter determine when a new value for a parameter needs to be provided (e.g. when scheduling a Job or when importing a Building Block), but also if this is mandatory, if the new value needs to be confirmed, etc).

In previous versions of Ivanti Automation, parameter values in List and Multi-select List parameters were sorted alphabetically at the input moment. Although the specific order of parameter values will be retained when downgrading again to a previous version of Ivanti Automation, it will revert to an alphabetical order once the Task in which the parameters are used is edited again.