Append Environment Variable

Declaration

<AMAPPENDENVIRONMENT NAME="Text" TYPE="Text" VALUE="Text" RESULTVARIABLE="Text" />

See Also

Append Environment Variable Action-Setting Properties

Description

Appends text to a system or user-level environment variable. Optionally, the action can populate a variable with the resulting value.

Practical Usage

Used to change the value of an existing environment variable by appending text to the existing value.

Parameters

General Tab

Environment Variable Name

Text, Required
MARKUP: NAME="TEMP"

Specifies the name of the environment variable to which the text will be appended.

Environment Variable Scope

Text, Optional - Default "User"
MARKUP: TYPE="USER"

Specifies the scope of the environment variable.

Options are:
 

Text to append

Text, Required
MARKUP: VALUE="new text"

Specifies the text to be appended to the value of the environment variable.

Populate Variable With the Value

Text, Optional
MARKUP: RESULTVARIABLE="VariableName"

Specifies a variable to populate with the resulting value.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMAPPENDENVIRONMENT NAME="TEMP" TYPE="USER" VALUE="\subtemp" RESULTVARIABLE="VariableName2" />