WebSphere Process Server, Version 6.2.0.1 Operating Systems: AIX, HP-UX, Linux, Solaris, Windows, i5/OS, z/OS


Human Task Manager REST Interface - Task Instance Fault Data Resource - GET Method

Use this method to retrieve a task's fault data.

Resource URI

GET /v1/task/{tkiid}/fault?{parameters}

Parameters

Required Parameters
NameValue TypeDescription
faultName string
Name of the fault for which a new fault is to be created - only allowed with new=true.
Optional Parameters
NameValue TypeDescription
new boolean
Indicates whether an "empty" fault should be returned.
ValueDescription
true
Return an "empty" fault.
false (default)
Return the fault for a task.

Request Content

None.

Response Content

Human task fault. The XML Schema for the task fault, that is, the XML Schema type/element used for the WSDL message part definition, is defined as part of the custom task template definition. Data defined by an XML Schema simple type is wrapped in an XML element provided by this REST interface (see Simple-Typed XML Data).

The default content-type is application/xml.

Error Response Content

Detailed error information.

The default content-type is application/json.

MIME Type: application/json


+ View Schema
{  "description": "HTM Error Response", 
   "type": "object",
   "properties":
   {  "errorNumber": {"type": "string",
         "description": "Message ID of the exception."
      },
      "errorMessage": {"type": "string",
         "description": "Message text of the exception."
      },
      "programmersDetails": {"type": "object", "optional": true,
         "description":"Additional, exception details, for example, a stack trace."
      }
   }
} 

Status Codes

The method returns one of the following status codes:
CodeDescription
200 OKSuccess completion.
400 Bad RequestThe parameters are not valid or they are missing.
401 UnauthorizedThe caller is not authorized for this request.
403 Forbidden
A fault does not exist because the task's interface refers to a one-way operation.
404 Not Found
The task or the task fault does not exist.
500 Internal Server ErrorA severe problem has occurred, programmer's details are provided.

Available Since

6.1.2

Parent Topic: Task Instance Fault Data Resource