Common Registration Activities
- Phillip Hanegan
- Kim Landis (Unlicensed)
Registration" activities are those Operation activities that are commonly used in provisioning workflows, such as the "CreatePerson" and "CreateAccount" workflows. This topic provides a brief overview of these activities and the notable properties associated with each.
As Operation activities, the activities discussed in this topic execute code to create or manipulate objects in EmpowerID. Theses activities have both general properties that are common to all Operation activities, as well as a number of activity-specific properties, also known as "Dependency properties." Dependency properties are properties that can bound from one activity to another for maintaining the consistency of workflow data at runtime.
See Common Workflow Activities for discussion of the general properties associated with Operation activities.
CreatePersonOperation Activity
The CreatePersonOperation activity is an Operation activity used in workflows where a person can be provisioned. Stock workflows include the CreatePerson and CreatePersonAndAccount workflows.
Activity Properties
Property | Category | Type | Description |
---|---|---|---|
TargetPeople | TList of Person Components | Input | Specifies the person or people on the Operation approval form. |
Form_TargetPerson | Person Component | Input | Specifies the person on the Operation approval form. Used when a single person is being created. |
TargetOrgRoleOrgZone | OrgRoleOrgZone | Input | Sets the Primary Business Role and Location specified in the workflow for each person being created. |
Password | String | Input | Sets the password for the person being created, if one is specified in the workflow. |
CreatePrivAccount | Person | Input | Used by the activity to create a privileged Active Directory account, if one is specified in the workflow. Relevant for the CreatePersonAndAccount activity. |
CreatePrivilegedPerson | Boolean | Input | Specifies whether the person being created is a privileged person. This evaluates to true when the Active Directory user account being provisioned is a privileged account. |
CreateAccountOperation Activity
The Create Account activity is an Operation activity used in workflows where a user account can be provisioned. Stock workflows include the CreateAccount and CreatePersonAndAccount workflows.
Activity Properties
Property | Type | Category | Description |
---|---|---|---|
TargetAccounts | TList of Account Components | Input | Specifies the account or accounts on the Operation approval form. |
Password | String | Input | Sets the password for the person being created if one is specified in the workflow. |
AddAccountsToGroupOperation Activity
The Add Accounts to Group activity is an Operation activity used in workflows where one or more accounts are being added to one or more groups. Stock workflows include the AssignPersonResourceRole workflow.
Activity Properties
Property | Type | Category | Description |
---|---|---|---|
TargetAccount | Account Component | Input | Specifies the account that is being added to the group or groups. var targetAccount = C.Account.GetByAccountID(386); AddAccountsToGroupsRequest.TargetAccount = targetAccount; |
TargetAccounts | TList of Account Components | Input | Specifies one or more accounts that are being added to the selected group or groups. var accView = C.AccountView.Get("AccountManagerPersonID=349", "AccountID"); var accList = new E.Tlist<C.Account>(); if(accView.Count > 0) { foreach(var acc in AccView) { accList.Add(acc.ToAccount()); } } AddAccountsToGroupRequest.TargetAccounts = accList; |
TargetGroup | Group Component | Input | Specifies the group to which one or more accounts are being added. var targetGroup = C.Group.GetByGroupID(70); AddAccountsToGroupsRequest.TargetGroup = targetGroup; |
TargetGroups | TList of Group Components | Input | Specifies the group or groups to which one or more accounts are being added. var grpView = C.GroupView.Get("IsHighSecurityGroup = 1", "GroupID"); var grpList = new E.Tlist<C.Group>(); if(grpView.Count > 0){ foreach(var grp in grpView){ grpList.Add(grp.ToGroup()); } } AddAccountsToGroupRequest.TargetGroups = grpList; |
Groups | TList of Group Components | Input | Specifies the group or groups to which one or more accounts are being added. |
RBACAssigned | Boolean | Input | Specifies whether the account group membership is linked to each EmpowerID Person owning the accounts being added. This allows the group membership to be controlled on the EmpowerID Person. Set to True by default. |
TargetGroupAccounts | TList of GroupAccount Components | Input | Specifies the group or groups to which one or more accounts are being added. |
TimeConstrain | Boolean | Input | Specifies whether the groups membership is limited to a specific period of time. var timeConstrain = CurrentWorkflow.TimeConstrain; timeConstrain = new TimeConstrain(); timeConstrain.ValidFrom.Add(DateTime.Now); timeConstrain.ValidTo.AddMonths(6); |
CreateGroupOperation Activity
Activity Properties
The CreateGroupOperation activity is used in workflows where one or more groups need to be created. Stock workflows include the CreateGroup and CreateGroupBulk workflows, among others. A simple code example follows.
Property | Type | Category | Description |
---|---|---|---|
TargetGroups | List of Group Components | Input | This is the list of groups to be created. Can be either a single group or more than one. |
TargetAccountStore | AccountStore Component | Input | This specifies the account store in which the group or groups are to be created. |
AssignCreatorAsOwner | Boolean | Input | Specifies whether the initiator of the workflow should be assigned as the owner of the group being created. |
Example Usage
//Set the location for the group var TargetOrgZone = C.OrgZone.GetByOrgZoneID(11073); //Instantiate a new group var TargetGroup = new C.Group(); //Set group properties TargetGroup.AccountStoreID = 1001; TargetGroup.Name = "BK-207-WynDot2"; //Required field TargetGroup.FriendlyName = "WynDot Users"; TargetGroup.LogonName = "BK-207-WynDot2"; TargetGroup.Description = "WynDot Users Group"; TargetGroup.GroupTypeID = 1; //Required field //Instantiate a new list of groups and add TargetGroup to it var TargetGroups = new E.TList<C.Group>(); TargetGroups.Add(TargetGroup); //Add properties to the CreateGroupOperation CurrentWorkflow.CreateGroupRequestOperation.TargetGroups = TargetGroups; CurrentWorkflow.CreateGroupRequestOperation.TargetOrgZone = TargetOrgZone; CurrentWorkflow.CreateGroupRequestOperation.ShowExecutionMessage = false; //Keeps the Operation Execution Summary from showing
SendEmail Activity
The SendEmail activity is used in workflows where email notifications need to be sent. Stock workflows include the CreatePerson, ResetPassword and HelpDeskPasswordReset workflows, among others.
Activity Properties
Property | Type | Category | Description |
---|---|---|---|
EmailMessageID | Int16 | Input | This is the ID for an existing EmailMessage that is stored in the EmpowerID database. If set to 0, no existing EmailMessage is being used. |
DefaultEmailBody | String | Input | Specifies the body of the email messages being sent. If an existing EmailMessage is being used, the default email subject is set from the EmailMessage. Otherwise, set this value and pass it in to the activity. var email = this.CurrentWorkflow.SendEmailActivity; var targetPerson = this.CurrentWorkflow.TargetPerson; email.DefaultEmailBody = string.Format("Welcome to the organization {0, 1}!", targetPerson.FirstName + " " + targetPerson.LastName)"; |
DefaultEmailSubject | String | Input | Specifies the subject of the email messages being sent. If an existing EmailMessage is being used, the default email subject is set from the EmailMessage. Otherwise, set this value and pass it in to the activity.var email = this.CurrentWorkflow.SendEmailActivity; email.DefaultEmailSubject = "Welcome Aboard" |
PeopleToEmail | TList of Persons | Input | List of people to email. Includes TargetPerson, TargetPeople, TargetManagementRole and TargetManagementRoles. |
FromEmail | String | Input | Specifies the From address of the email message. Set by default to the FromEmail configuration settings specified in EmpowerID. Otherwise, set this value and pass it to the activity.var email = this.CurrentWorkflow.SendEmailActivity; email.FromEmail = "captainjack@acmeanvils.com" |
AdditionalEmails | String | Input | Specifies any additional email addresses in which to send the email.var email = this.CurrentWorkflow.SendEmailActivity; email.AdditionalEmails = "captainjack@acmeanvils.com" |