Create Linked Work Item

Description

Creates a manual work item that is linked to another manual work item. The work item you create does not depend on the completion of the work item to which it is linked. In other words, the original (source) work item can be marked as completed before new work item is completed.

Syntax

public virtual WFEvent CreateLinkedWorkItem(string sourceWorkItemID, string workToPerform, string userID, WFTimeDuration duration, string clientData)

Parameters

Name	Type	Description
sourceWorkItemID	string	A unique, 32-character ID for the original, or source, work item.
workToPerform	string	A string that specifies the work to perform.
userID	string	A string that contains a user ID for the user associated with the work item.
duration	WFTimeDuration	A time-duration object that specifies the duration setting of the 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

None.

Example

IWFWorkflowService svc = base.GetWorkflowService();
// get existing work item
string workItemID = ..// for example,
"90CF843AC57644058A391FBFA030F607"

try
	{
    // Get the source WFManualWorkItem object
    WFManualWorkItem sourceWorkItem = svc.GetWorkItem(workItemID
    string workToPerform = sourceWorkItem.Name; //different
    workToPerform can be used if desired
    WFTimeDuration duration = new WFTimeDuration();
    duration.Length = "15"; //for example, 15 days
    duration.Unit = WFTimeUnit.DAY;
    string user = @"[DOMAIN NAME]\username"; //the participant of the
    linked work item
    WFEvent evt = svc.CreateLinkedWorkItem(
             sourceWorkItem.WorkItemID,
             workToPerform,
             user,
             duration,
             null);
	}

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)