Add a new parameter

At Run Books or Projects, from the Parameters tab of a selected Run Book or Project, you can add a new Run Book or Project parameter.

Configuration

Properties tab

On this tab, you specify:

  • Name: specify the parameter name. 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.
  • Type: select the type of parameter. Each parameter type represents a different type of information. The parameter types are:
    • Credentials
    • List
    • Multi-line text
    • Multi-select list
    • Password
    • Text
  • Value: optionally, define a default value for the parameter. You can define these values manually, but can also base them on other parameters and functions (by clicking the selection button insertplaceholder and choosing from the menu).
    • 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.
    • When configuring Text or Credentials parameters, you can also base the values on Global Variables.
    • 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_new arrowdown_new from the puntjes menu.

Links tab

On this tab, you have an overview the way in which parameters are linked to each other. This tab is only available when configuring parameters on Project level and Run Book level.

Input tab

On this tab, you configure advanced input settings of the parameter, such as when a new value needs to be provided, if the value needs to be configured and if the value has any format restrictions (by input mask).