ProcessTaskResponseUsingToken

Registers a response, using a task token, to a workflow task in the specified task list.

Syntax

public void ProcessTaskResponseUsingToken(
	string comments,
	Outcome outcome,
	string taskToken,
	int customOutcome
)

Parameters

comments
Type: System.String

Optional. Comments to include with the task response.

outcome
Type: Outcome

Required. The outcome of the task response, for workflow approval, data, review, and to-do tasks. Set the value of this parameter to Outcome.Custom for Flexi task tasks.

taskToken
Type: System.String

Optional. The task token for the task.

customOutcome
Type: System.Int32

Required. The configured outcome of the task response, for Flexi task tasks. Set the value of this parameter to zero (0) for workflow approval, data, review, and to-do tasks.

Remarks

Task tokens can be obtained by using the GetTaskStubsForCurrentUser method. The value of the TaskToken property of the TaskStub object represents the task token for that workflow task.

This method does not return a value. If the task response is successfully registered, the method returns an empty response; otherwise, the method returns an error.

Example: Processing a workflow to-do task

The following example demonstrates how to use this operation to complete a workflow to-do task.

Request

The following SOAP request uses a task token to process a task response for a workflow to-do task.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nin="http://nintex.com">
   <soap:Header/>
   <soap:Body>
      <nin:ProcessTaskResponseUsingToken>
         <nin:comments>Second attempt</nin:comments>
         <nin:outcome>Continue</nin:outcome>
         <nin:taskToken>[#BBBDFF#]</nin:taskToken>
         <nin:customOutcome>0</nin:customOutcome>
      </nin:ProcessTaskResponseUsingToken>
   </soap:Body>
</soap:Envelope>

Response

The following SOAP response indicates that the task response was successfully processed.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" 
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
   xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ProcessTaskResponseUsingTokenResponse xmlns="http://nintex.com"/>
   </soap:Body>
</soap:Envelope>

See Also

Concepts

Workflow tasks

Operations

Processing workflow task responses

Reference

GetTaskStubsForCurrentUser

Web Service Reference