Online Manual: "User Management Resource Adminstrator"
Go to: User Management Resource Administrator homepage
Script Action: Convert to multi-value variable
Function
Converts the value of a variable into multiple values. The multiple
values will be stored under one variable. 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 multiple values and stored
under a new variable, 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 them.
This function in particular can be used when one variable in the input data contains information
that has multiple values for one property of a script action. For example,
the input data may have a field that contains the variable %GroupMemberships%
specified as "Domain\Administrators;Domain\Backup Operators;Domain\Users".
The action Script
Action: Set group membership (AD) for instance can be used to make
an user account member of multiple groups. With the script action Convert to multi-value variable it is
possible to create the required variable which contains the three groups
as separate values under one variable. In this particular example the
action is used to separate the value of a variable into three new values
for an other variable.
Properties
|
Property Name |
Description |
Typical setting |
Remarks |
|
Input variable: |
The variable that contains the data which
is multi-value. |
|
The data in the input variable should be separated
by an separator character. |
|
Output variable: |
The variable which contains the same data
as the input variable only now the data is available as multiple values
instead of one value. |
|
The output variable can be a different variable
or the same variable as the input variable. |
|
Separator character |
A character that separates one value from
the other. This character is used to determine where the new value begins. |
; |
The following characters can be chosen to
separate the values:
, : ; <tab> |
|
Insert empty values |
When two separator characters are placed directly
after each other a blank value could be created. |
No |
When you want blank values to be defined this
property should be set to 'Yes'. When you want to remove all blank characters
this property should be set 'No'. |
Related topics
Help on help
Principle of operation
Project operations - Manage script action properties
|