Create Linked Work Item (Extended Method)

Description

Creates a manual work item that is linked to another manual work item. The extended parameter bDependent is used to specify the dependency between the original work item and the linked work item. If bDependent is false, the work items are independent, just like CreateLinkedWorkItem().If bDependent is true, the original (source) work item cannot be marked as completed before new work item has been completed.

Syntax

public virtual WFEvent CreateLinkedWorkItemEx(string sourceWorkItemID, string workToPerform, string userID, WFTimeDuration duration, string clientData, bool bDependent)

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.
bDependent	bool	If true: The source work item waits until the linked work item is either completed or canceled, before it can be completed/canceled. If false: The source work item can be completed/canceled regardless of whether the linked work item is completed/canceled.

Output

WFEvent object that provides the status of the transaction. Possible statuses are Success, Failed, and Sent.

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("15", WFTimeUnit.DAY, false);
    string user = @"[DOMAIN NAME]\username"; //the participant of the
    linked work item
    WFEvent evt = svc.CreateLinkedWorkItem(
             sourceWorkItem.WorkItemID,
             workToPerform,
             user,
             duration,
             null,
             true);
	}

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

Supported Versions

4.6 and above

Parent topic: Methods for Manual Work Items (Tasks)