Assign Work Item (Extended Method)

Description

Assigns a work item to a user, which often means claiming a work item for oneself. This is often used with task pools where work items are created, and then multiple users are notified, but the work item is not immediately assigned to a user. A user then claims the work item, or his manager assigns it to him. The user must have privileges to claim or assign the work item. This method extends AssignWorkItem() by allowing you to specify client data.

Syntax

public virtual WFEvent AssignWorkItemEx(string wID, string clientData)

Parameters

Name	Type	Description
wID	string	A 32-byte unique work item (task) ID that represents a manual work item.
clientData	string	A string that contains the client data. If clientData is null, the system will keep existing client data, otherwise the relevant data would be overwritten.

Output

WFEvent object representing the workflow event instance raised by the invocation of the work assignment.

Example

IWFWorkflowService svc = GetWorkflowService();
string wID = …// work item ID
string clientData = null;

try
    {
    WFEvent evt = svc.AssignWorkItemEx(wID, clientData);
    }

catch( Exception ex)
    {
    Console.WriteLine("Failed! " + ShUtil.GetSoapMessage(ex));
    }

Supported Versions

3.2.0.4 and higher

Parent topic: Methods for Manual Work Items (Tasks)