Click or drag to resize

RuntimeServiceAddAssociationsToParticipant Method

Adds associations to a participant. Intended for web use only.

Namespace:  Advantys.Workflow.Web.Services.Processes.Runtime
Assembly:  Advantys.Workflow.Web.Services.Processes.Runtime (in Advantys.Workflow.Web.Services.Processes.Runtime.dll) Version: 7.19.0.0 (7.19.0.20200615)
Syntax
public void AddAssociationsToParticipant(
	string participantName,
	string associationsDefinition
)

Parameters

participantName
Type: SystemString
Name of the participant to add associations to.
associationsDefinition
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:
XML
<Associations>
 <Users>
   <User>
     <Username>wfgen_admin</Username>
   </User>
 </Users>
 <Groups />
 <Directories />
 <Coordinators />
</Associations>
Sample code:
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);

See Also