Add to group activity
The Add to group activity is intended to add a certain object, such as a user, computer, or group, to particular groups in Active Directory. This activity has the following configuration options:
-
Activity target: This option lets you specify the object you want the activity to add to groups. You can select the object when you configure the activity, or you can configure the activity to select the appropriate object at workflow run time. For more information, see Activity target.
-
Groups: This option lets you define the groups to which you want the activity to add the object. When you configure an Add to group activity, you can specify a list of groups. For each of the groups in the list, the activity will add the object to that group. To add a group to the list, you can choose from the following options:
-
Fixed group in directory: You can select the desired group in Active Directory when you configure an Add to group activity. A unique identifier of the group is saved in the configuration of the activity. The activity will use that identifier to select the group when calculating the list of groups at workflow execution time.
-
Object from workflow data context: The group will be selected by the activity on the basis of the data found in the workflow environment at the time of executing the workflow. When configuring an Add to group activity, you can specify which group you want the activity to select at workflow execution time.
-
Object identified by DN-value rule expression: The Distinguished Name (DN) of the group is specified by the string value of a certain rule expression. By using a rule expression you can compose a string value based on properties of various objects found in the workflow environment at the time of executing the workflow. You can create the desired rule expression when you configure an Add to group activity.
The Add to group activity also has a number of configuration settings that are common to CRUD activities:
-
Notification: Active Roles can notify via email about whether or not the activity has encountered an error condition at run time.
-
Error handling – CRUD activities: Determines whether or not the workflow is allowed to continue if the activity has encountered an error condition at run time.
-
"Run as" options: Determines the user account under which to run the activity.
-
Additional settings – CRUD activities: Some advanced configuration options that allow you to adjust the processing of the operation requested by the activity.
Remove from group activity
The Remove from group activity is intended to remove a certain object, such as a user, computer or group, from particular groups in Active Directory. This activity has the following configuration options:
-
Activity target: This option lets you specify the object you want the activity to remove from groups. You can select the object when you configure the activity, or you can configure the activity to select the appropriate object at workflow run time. For more information, see Activity target.
-
Groups - Remove the object from all groups: This options configures the activity to remove the object from all groups in Active Directory.
NOTE: The Remove from group activity cannot remove the object from its primary group. It can only remove the object from all other groups.
-
Groups - Remove the object from these groups: This option lets you list the groups from which you want the activity to remove the object. You can specify a list of groups when you configure a Remove from group activity. For each of the groups in the list (with the exception of the object’s primary group), the activity will remove the object from that group. To add a group to the list, you can choose from the following options:
-
Fixed group in directory: You can select the desired group in Active Directory when you configure a Remove from group activity. A unique identifier of the group is saved in the configuration of the activity. The activity will use that identifier to select the group when calculating the list of groups at workflow execution time.
-
Object from workflow data context: The group will be selected by the activity on the basis of the data found in the workflow environment at the time of executing the workflow. When configuring a Remove from group activity, you can specify which group you want the activity to select at workflow execution time.
-
Object identified by DN-value rule expression: The Distinguished Name (DN) of the group is specified by the string value of a certain rule expression. By using a rule expression you can compose a string value based on properties of various objects found in the workflow environment at the time of executing the workflow. You can create the desired rule expression when you configure a Remove from group activity.
The Remove from group activity also has a number of configuration settings that are common to CRUD activities:
-
Notification: Active Roles can notify via email about whether or not the activity has encountered an error condition at run time.
-
Error handling – CRUD activities: Determines whether or not the workflow is allowed to continue if the activity has encountered an error condition at run time.
-
"Run as" options: Determines the user account under which to run the activity.
-
Additional settings – CRUD activities: Some advanced configuration options that allow you to adjust the processing of the operation requested by the activity.
Move activity
The Move activity is intended to move a certain object to a particular container in Active Directory. The activity has the following configuration options:
-
Activity target: This option lets you specify the object you want the activity to move. You can select the object when you configure the activity, or you can configure the activity to select the appropriate object at workflow run time. For more information, see Activity target.
-
Destination container: You can specify the Organizational Unit (OU) or container to which you want the activity to move the object. The following options are available:
-
Fixed container in directory: Move the object to the given OU or container. You can select the OU or container in Active Directory when you configure a Move activity.
-
Parent OU of workflow target object: In case of a change workflow, move the object to the OU that holds the target object of the request that started the workflow.
-
Activity target object: Move the object to the OU or container created or otherwise processed by another CRUD activity at the time of executing the workflow. You can select the CRUD activity from the workflow definition when you configure a Move activity.
-
Object identified by workflow parameter: Move the object to the OU or container specified by the value of a certain parameter of the workflow. You can choose the parameter from the workflow definition when you configure a Move activity.
-
Object from workflow data context: Move the object to the OU or container that will be selected by the Move activity on the basis of the data found in the workflow environment at the time of executing the workflow. When configuring a Move activity, you can specify which OU or container you want the activity to select at workflow run time.
-
Object identified by DN-value rule expression: Move the object to the OU or container whose Distinguished Name (DN) is specified by the string value of a certain rule expression. By using a rule expression you can compose a string value based on properties of various objects found in the workflow environment at the time of executing the workflow. You can create the rule expression when you configure a Move activity.
The Move activity also has a number of configuration settings that are common to CRUD activities:
-
Notification: Active Roles can notify via email about whether or not the activity has encountered an error condition at run time.
-
Error handling – CRUD activities: Determines whether or not the workflow is allowed to continue if the activity has encountered an error condition at run time.
-
"Run as" options: Determines the user account under which to run the activity.
-
Additional settings – CRUD activities: Some advanced configuration options that allow you to adjust the processing of the operation requested by the activity.
Deprovision activity
The Deprovision activity is intended to apply the Active Roles deprovisioning policies to a particular user or group. This activity causes Active Roles to perform all the tasks prescribed by the deprovisioning policies, thereby deprovisioning the user or group.
The activity allows you to specify the user or group object you want the activity to deprovision. You can select the object when you configure the activity, or you can configure the activity to select the appropriate object at workflow run time. For more information, see Activity target.
The Deprovision activity also has a number of configuration settings that are common to CRUD activities:
-
Notification: Active Roles can notify via email about whether or not the activity has encountered an error condition at run time.
-
Error handling – CRUD activities: Determines whether or not the workflow is allowed to continue if the activity has encountered an error condition at run time.
-
"Run as" options: Determines the user account under which to run the activity.
-
Additional settings – CRUD activities: Some advanced configuration options that allow you to adjust the processing of the operation requested by the activity.