...
Available for the "Replace using a regular expression" operation. A regular expression pattern to match against the existing value of the variable.
Ignore case when matching regular expression
When ticked regular expression pattern will match both lower and upper case characters
Replace first regular expression match only
When ticked only the first regular expression pattern match will be replaced
Replace With
Available for the "Replace using a regular expression" operation. This text will used to replace regular expression matches in the variable's value. This may contain back references to captured groups in the regular expression pattern, see Substitutions in Regular Expressions. Note these need to be escaped e.g. $1 => $$1 if expanding.
...
- Build variable: This is the default option and is used to set the value of the build variable only. Build variables inherit the value of the configurationConfiguration, project Project or application Application server variable at the start of the build. Changes to the build variable, either manually entered into the Queue Options prompt or set by actions such as this one are specific to the current build. Build variables are not accessible by other builds.
- Server variable: This option is used to set the value of Configuration, Project and Application variables. These variables that you can edit manually on the server are referred to as Server variables. The values of these variables determine the initial value of build variables at the start of each build. Server variables are therefore accessible across multiple builds within their defined scope.
- Server variable and overwrite build variable with result: This option allows you to overwrite parts of thevariable's old value which match a regular expression pattern. set both the server variable and the build variable.
Synchronise agent variable with updated server variable value
Variable expressions prefixed with a namespace, such as %Configuration.VariableName%, %Project.VariableName% and %Application.VariableName%, contain the value of the server variable at the start of the build. These can be referred to as agent variables.
When this option is ticked, the value of agent variables are updated with the new value set for the server variable.
Acquire a write lock on the server variable
A write lock will be acquired when updating the server variable. Tick this option to extend the write lock until the end of the build. This will prevent other builds and users from updating the variable value for the duration of the build.
Release write lock at the end of stage
A write lock will be acquired when updating the server variable. Tick this option to extend the write lock until the end of the build. This will prevent other builds and users from updating the variable value for the duration of the build.
WORK IN PROGRESS
------
Note: When a variable is set during a build, it is copied from the Configuration variables namespace and stored in Build variable namespace. This means you can still reference the variable's original value by using %Configuration.MyVariable%. Otherwise, to use the updated value, simply reference the variable by its name %MyVariable%.
...