Participant

Workflow participant entity, which specifies an activity participant. In a mail node, this entity specifies the mail recipient.

Participant applies only to manual activity types, including Approval, RFI, WorkOrder, and Mail.

The participant of an activity can be specified during workflow design as Custom Defined Participant. In this case, the Participant JavaScript object can be used to construct the appropriate participant based on the process context.

Availability

IBM® Tivoli® Identity Manager 4.x

IBM Tivoli Identity Manager 5.x

IBM Security Identity Manager 6.x

IBM Security Identity Manager 7.0.

Provided by

com.ibm.itim.workflow.script.WorkflowExtension

Constructor

new Participant(type, dn)

Arguments

type: Code that categorizes the participant type.
dn: Optional DN of a specific entity.

Returns

The newly created and initialized participant object.

Constructor for custom self approval

new Participant(type, boolean)

Arguments

type: Type is either REQUESTEE or REQUESTOR.
boolean: Self approval values. true enables the custom self approval workflow. false disables the custom self approval workflow.
Returns: The newly created and initialized participant object.

Properties

implementation: This property contains JavaScript that returns participant when the participant type is Custom.
name: Identifies the participant.
type: Code that categorizes the participant type.

Description

The participant specifies an activity participant. Participant applies only to manual activity types, including Approval, RFI,

Work
Orde

r and Mail activities. The participant of an activity or recipient of a mail activity can be specified during workflow design as Custom Defined Participant. In this case, the Participant JavaScript object can be used to construct the appropriate participant based on the process context.

Usage

//assume person is one of the relevant data in the workflow
//process for the target user involved
if( person.get().getProperty(“title”)[0]==”Manager” )
  return new Participant(ParticipantType.SYSTEM_ADMIN);
else
  return new Participant(ParticipantType.SUPERVISOR); 


//assume person is one of the relevant data in the workflow
//process for the target user involved
if( person.get().getProperty(“title”)[0]==”Manager”)
  return new Participant(ParticipantType.USER, person.get().dn);
else
  …