Page Comparison

"User Management" activities are those Operation activities that are commonly used in self-service workflows, such as the "ChangePassword" and "Enrollmment" 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.

ChangePasswordOperation Activity

The ChangePasswordOperation activity is an Operation activity used in workflows where people delegated users can change their own passwords. Stock workflows include the ChangePassword and CreatePersonAndAccount workflows.

Activity Properties

Example Usage

//Set reference to Operation
var ChangePasswordOperation = CurrentWorkflow.ChangePasswordRequest;

//Get TargetPerson and CurrentAccount
var TargetPerson = Person.GetCurrentPerson();
var CurrentAccount = Person.GetCurrentAccount();

//Set Operation Properties
ChangePasswordOperation.TargetPerson = TargetPerson;
ChangePasswordOperation.CurrentAccount = CurrentAccount;

;

EnrollOperation Activity

The EnrollOperation is an Operation activity used in workflows to allow users to enroll in the Self-Service Password Reset Center. Once enrolled, users can reset forgotten passwords by answering a series of challenge questions. The Stock workflow with this activity is the Enrollment workflow.

Activity Properties

Example Usage

//Set reference to Operation
var EnrollOperation = CurrentWorkflow.Enroll;

//Get TargetPerson
var TargetPerson = Person.GetCurrentPerson();

//Set Operation Properties
EnrollOperation.TargetPerson = TargetPerson;

UnenrollPerson Activity

The UnenrollPerson activity is in workflows to remove people from the Self-Service Password Reset Center. People who unenroll cannot self-service reset forgotten passwords. In the below example, users unenroll themselves.

Activity Properties

Example Usage

//Set reference to Operation
var UnEnroll = CurrentWorkflow.UnenrollPersonActivity;

//Get TargetPerson
var TargetPerson = Person.GetCurrentPerson();

//Set Activity Properties
UnEnroll.TargetPerson = TargetPerson;

;

ResetPasswordOperation Activity

The ResetPasswordOperation is an Operation activity used in workflows to allow delegated users the ability to reset the passwords of other people. The Stock workflow with this activity is the ResetPassword workflow.

Activity Properties

Example Usage

//Set reference to Operation
var ResetPasswordOperation = CurrentWorkflow.ResetPasswordRequest;

//Get TargetPerson
var TargetPerson = C.Person.GetByPersonID(349);

//Set Operation Properties
ResetPasswordOperation.TargetPerson = TargetPerson;

EditPersonOperation Activity

Activity Properties

The EditPersonOperation is a Multi-Operation Operation activity that is used in workflows to allow delegated users the ability to edit the attributes of another person. The type of attributes that can be edited depend on the operations allowed in workflow usage. The Stock workflow with this activity is the EditPerson workflow.

Activity Properties

Example Usage

//Set reference to Operation
var EditPersonOperation = CurrentWorkflow.EditPersonRequest;

//Set the TargetPerson and the attribute being edited
var TargetPerson = C.Person.GetByPersonID(349);
TargetPerson.Office = "Hampton";

//Create a TargetPeople list and add TargetPerson to it
var TargetPeople = new E.TList();
TargetPeople.Add(TargetPerson);

//Set the TargetPeople property on the Operation
EditPersonOperation.TargetPeople = TargetPeople;

;

UpdatePersonLoginAssociationsOperation Activity

The UpdatePersonLoginAssociationsOperation is a Dual Resource Multi-Operation Operation activity that is used in workflows to add and remove the login associations people have within EmpowerID. Login associations, also known as "persona switching," enables people to log in to EmpowerID as another identity, without requiring them to know the passwords associated with those identities. The Stock workflow with this activity is the Update Person Login Associations workflow.

Activity Properties

Example Usage

// Set reference to AddLoginAssociation Operation Activity
var addLoginAssociation = CurrentWorkflow.AddLoginAssociation;
 
// Get GUID of assignee as the UpdatePersonLoginAssociations base expects Guids 
var AssigneeGUID = C.Person.GetByPersonID(223).PersonGUID;
 
// Create a list of guids for allowed person logins
var allowedLoginGUIDs = new List<Guid>();
 
// Create a view that returns all people for allowed logins
// In this example, we are returning everyone with an Office of Hampton
E.VList<C.PersonView> pView = C.PersonView.Get("Office = 'Hampton'", "Name Desc");

// Create a new list of Person components for allowed logins
var allowedLogins = new List<C.Person>();

// Convert the people in the view to components
foreach(var per in pView)
{
     allowedLogins.Add(per.ToPerson());
}

// Add each person's PersonGUID to allowedLoginGUIDS 
foreach (var p in allowedLogins)
{
     allowedLoginGUIDs.Add(p.PersonGUID);
}

// Create new list of AssigneeLoginAssociation
List<C.AssigneeLoginAssociation> assigneesToAdd = new List<C.AssigneeLoginAssociation>(); 

 // Create a new AssigneeLoginAssociation for each allowed login
foreach(Guid g in allowedLoginGUIDs)
{
        C.AssigneeLoginAssociation ala = new C.AssigneeLoginAssociation();
        ala.AssigneeID = AssigneeGUID;
        ala.AllowedLoginPersonID = g;
        assigneesToAdd.Add(ala);
}

// Set the Operation activity's TargetAssigneeLoginAssocations property
addLoginAssociation.TargetAssigneeLoginAssociations = assigneesToAdd;