RuntimeService.AddAssociationsToParticipant Method

Namespace: Advantys.Workflow.Web.Services.Processes.Runtime
Assembly: Advantys.Workflow.Web.Services.Processes.Runtime (in Advantys.Workflow.Web.Services.Processes.Runtime.dll) Version: 6.6.0.0 (6.6.0.0)

Syntax

Copy

public void AddAssociationsToParticipant(
	string participantName,
	string associationsDefitinion
)

Public Sub AddAssociationsToParticipant ( 
	participantName As String,
	associationsDefitinion As String
)

Parameters

participantName: Type: SystemString
Name of the participant to add associations to.
associationsDefitinion: Type: SystemString
Definition of the associations to add.

Remarks

Available since WorkflowGen version: 6.2.0

Optional Parameters.

These parameters can be used in the query string or as parameters of the Headers object in the RuntimeService class instance. See example below.

ParticipantId (int)	Specifies the Id of the participant to add associations to. Supercedes the participant name.
ProcessId (int)	Specifies the Id of the process the participant is linked to. Supercedes a combination of process name and process version.
ProcessName (string)	Specifies the name of the process the participant is linked.
ProcessVersion (int)	Specifies the version of the process the participant is linked.
IgnoreMissingAssociations (bool)	Sets whether or not to return an error when an association (user, group, directory) is missing from the target. Default = true.

Sample associations definition to add a user to a participant:

Copy

<Associations>
 <Users>
   <User>
     <Username>wfgen_admin</Username>
   </User>
 </Users>
 <Groups />
 <Directories />
 <Coordinators />
</Associations>

Sample code:

Copy

RuntimeServiceWebService.RuntimeService myRuntimeService = new RuntimeServiceWebService.RuntimeService();
RuntimeServiceWebService.ParticipantHeader myParticipantHeader = new RuntimeServiceWebService.ParticipantHeader();
myRuntimeService.ParticipantHeaderValue = myParticipantHeader;

myParticipantHeader.ParticipantId = participantId;
myParticipantHeader.ProcessId = processId;
myParticipantHeader.IgnoreMissingAssociations = false;

myRuntimeService.AddAssociationsToParticipant(participantName, associationDefinition);

Reference

RuntimeService Class

Advantys.Workflow.Web.Services.Processes.Runtime Namespace