Generate one or more names based on the value of one or more input variables.
The algorithm that is used to generate the output names is configurable.
The output value names are stored in variables.
Deployment
This action is typically used in UMRA form projects to propose the user
name and full name of a new user account. These names are generated by
the algorithm of the script action when the end-user specifies the input
names (typically first, middle and last name). The resulting names are
presented in a form an the end-user can then accept the names or let the
algorithm generate new names (next iteration cycle).
The script actions that create user accounts, Script
Action: Create User (AD) and Script
Action: Create User (no AD) contain a user name generation algorithm.
If the generated names are used as input names for these actions, the
user name generation algorithm of these actions should not be used. So,
when creating user accounts, there are 2 methods to generated user names
automatically:
Use script action Generate
name(s) and disable the name
generation algorithm of the create
user action.
Do not use
script action Generate name(s) and use the name generation algorithm of
the create user action
instead.
With the first method, the script
must implement a loop:
Generate
name
Check
if name is unique
If
name is unique, continue with step 4, if not unique goto step 1 to generate
next name
Create user account.
This method requires a more complex
script. On the other hand, the names that are generated by the algorithm
can be shown to the end-user before the account is created.
To configure the name generation
action, the following dialog is used:
Use the Edit and
browse (...) button to edit the currently configured algorithm or import
another algorithm.
Iteration - Use internal data (can
only be used for mass projects)
If the name generation action is called multiple times in mass projects,
new names are generated according to the configuration of the name generation
algorithm. If this option is selected, the iteration mechanism is controlled
by the action itself. This option can only be used in mass projects. In
form projects, the same names will be generated if this option is selected.
Iteration - Use variable
If this option is selected, the iteration mechanism is controlled by a
numeric variable specified in this field. This variable holds a number
that corresponds with the iteration cycle. The first time, the variable
is 0. The action will generate the names according to the first iteration
cycle. Next, the value of the
variable is incremented. This,
the next time the action is called during the same session, the variable
has a value of 1. Hence, the next iteration cycle of the name generation
algorithm is used to generate the names. This process continues.
Note: The action will create the iteration variable if it does not exist
when executed.
Properties
Property Name
Description
Typical setting
Remarks
Name generation algorithm
The name of the algorithm.
Input variable N
The name of input variable 1,...,N as configured
in the name generation algorithm.
%FirstName%
%MiddleName%
%LastName%
When the action is executed, the input variables
should have a value that is used to calculate the output names.
Output variable M
The name of output variable 1,...,M as configured
in the name generation algorithm.
%UserName%
%FullName%
Iteration
A description of the method used to iterate
through the name generation algorithm when the action is called multiple
times.
