Manipulate Local Variables

For information about Global Variables see Global Variables.

Local Variables are set at the level of the Process and are not shared with any other process or instance of that process. Local variables can be used anywhere that accepts variables by using it's namee, surrounded by curly brackets and preceded by a percent sign (for example: %{myLocalVariable}).

When the process ends, the local variable forgets whatever value was given to it by the process and goes back to its default value. Local variables are generally used to keep information that is useful for the process itself but not to any other process or instance of the process. For example, you could store the current order ID for the process, a name or an email. You can have as many local variables as you want in any given process.

To add a local variable, you can use one of two methods:

Select the process where you want to add the variable.
Click on the Home tab of the PlanetPress Suite Ribbon, then click Local Variable in the Variables group.
Right-click on the process in the Configuration Components area, then click on Insert Local Variable.

Shared tasks

These procedures can be used on both local and global variables.

To delete a variable

Right-click on the variable name in the Configuration Components Area and click Delete.

To rename a variable:

Right-click on the variable name in the Configuration Components Area.
Click Rename
Type in the new name of the variable, then press Enter on your keyboard.

While renaming a variable will correctly rename all references to it in task properties or wherever else it is used in a task, it will not change the references in any script within a Run Script task. Deleting a variable, on the other hand, does not delete any reference to it. In both the case where a script refers to a variable and it is renamed, or in the case of deleting a variable, any task or script that refers to it will cease to function and will generate an error.

You can set the value of a variable within your process in two ways:

Use the Set Job Info and Variable action task. See Set Job Infos and Variables.
You can use Scripts. See the chapter Using Scripts.

Variables may be used as variable properties in variable property boxes (see Variable Properties).