The Create Group smart service allows you to add new groups at runtime via process model.
This activity allows you to display a form for your users to fill out, which creates a group based on the information they submit. Alternatively, you can also set all the required node inputs at design time.
This smart service was previously called Create Custom Group.
This smart servive has been enhanced to support Group Type as opposed to just Text. As a consequence, group types can be tracked as precedents.
The Assignment tab allows you to specify a user account that is assigned the activity, or to run the activity automatically – taking the process designer or the process initiator's user account for security purposes. You can only run this activity as a user that is a system administrator or in the process administrator's role. (Other users, such as members of the Portal Administrators group cannot execute this activity.)
Attempting to execute this task as a basic user causes a run-time exception that pauses the process and sends an alert to the process administrator.
Category: Identity Management
Assignment Options: Attended/Unattended
The following characters are not allowed in group names.
/ \ < > " , . * '
You must select a group type for the node input. This data cannot be collected from users at runtime, from an associated form.
The default values are Yes or No. The integer 1 equals yes. 0 equals no.
The user account that activates this activity must have Administrator rights for the parent group in order to add this new group as a child.
Default value options: Closed, Exclusive, Automatic
Default value options: Public, Personal, Restricted
Default value options: Low, High
If the activity is run without being assigned to a user (or a group) you must specify values for each of the required node inputs listed.
Selecting a Personal visibility input value sets other associated node input values automatically. Be aware that the node input lists on the Data tab and the dropdown lists displayed task form are not automatically filtered when this happens to show only valid options for the Visibility. Any invalid selections (made by you at design time, or by your users at runtime) are ignored when the group is created.
If the Visibility input is set to Personal, the following settings are configured automatically.
The Group Type input is set to Custom
No value can be specified for the Parent Group node input.
The Membership Policy node input is set to Closed.
The Group Privacy node input is set to High.
This activity returns the group created.
You can save this group into a process variable in the following manner.
Select the Outputs property sheet (tab).
Click group on the Results list. The Result Properties are displayed.
Create a new Process Variable to store the result, or select an existing Process Variable with a Group data type from the available list.
onSuccess (Any Type): A list of saves or an HTTP response to execute after the smart service executes successfully. Created with a!save() or a!httpResponse(). The following function variable is available when configuring this input:
fv!group (Any Type): The group that was created.
onError (Any Type): A list of saves or an HTTP response to execute when the smart service does not execute successfully. Created with a!save() or a!httpResponse().