Online Manual: "User Management Resource Adminstrator"
Go to: User Management Resource Administrator homepage
Script Action: Split Variable
Function
Split the value of an existing variable in two parts, and store the
results in two (new) variables. This action does not do any network calls.
It is used for configuration and formatting within the User Management
script. The Variable is split in two parts, the split position is determined
by a separator character available in the data.
Deployment
Many implementations of User Management scripts
are configured so that the input for the properties
of the script actions they contain are defined as variables. The contents
of these variables are usually read from the input
data. This table is often created from information provided by the
user. This information may however not fit seamless to the requirements
of the script actions in the script. Therefore there are several functions
that can be used in the script for some formatting of data. This is one
of these.
This function in particular can be used as one variable in the input
data contains information that a certain script action expects to
be in different variables. For example, the input data may have a field
that contains the variable %HomeDirectory% in the form "server name\share
name\sub directory". The action Script
Action: Create Directory for instance that creates a directory, requires
the name of the server, the name of the share, and the rest of the path
to be in three different variables. With the script action Split
variable it is possible to create the required variables. In this
particular example the action is first used to retrieve the server name,
and then used again to retrieve the share name.
Properties
|
Property Name |
Description |
Typical setting |
Remarks |
|
Input variable |
The name of the variable that contains the
information that must be split. |
|
The name of the variable must be enclosed
in "%" characters. e.g. %Domain% |
|
Output variable 1 |
The name of the variable that contains as
result the first part of the input string up to the first separator character. |
|
|
|
Output variable 2 |
The name of the variable that contains as
result the rest of the original string |
|
|
|
Result if no split |
Specifies which variable contains a copy of
the original string as the data cannot be split. |
Value of variable 2 empty |
Sometimes the data cannot be split if there
is no separator character. This setting determines which of the 2 output
variables should get a value in this case. |
|
Process from right to left |
specifies that the input string is should
be evaluated from right to left |
No |
if specified, the part of the string after
the last separator character is stored in variable 1, and the part before
the last separator character is stored in variable 2 |
|
Separator(s) |
Specifies which character(s) count as separator |
No |
The variable is split at the first position
that one of the specified characters is encountered. |
More information:
Principle of operation
Project operations - Input data
Project operations - Manage script actions
Project operations - Variables
Help on help
|