Assign Work Item

API Type

Web Services

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.

Syntax

public virtual WFEvent AssignWorkItem(string workItemID)

Parameters

Name Description

workItemID

Definition:
An ID that represents a work item (task).
Type
string
Allowed Values:
A valid, unique 32-byte work item (task) ID.

Output

WFEvent class that represents the workflow event instance that is created when the task is assigned.

Example

IWFWorkflowService svc = GetWorkflowService();
string workItemID = …// work item ID

try
    {
    WFEvent evt = svc.AssignWorkItem(workItemID);
    }

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

Supported Versions

3.2.0.4 and higher