APIs, SDKs, and Services

Back Next

Process Server Extensions to WSHT API

Task data has the following information:

Identifier (task ID)

Name (name of task).

Type (TASK or NOTIFICATION).

Presentation information such as presentation name, subject, description, and so on

Context data such as potential owners, business administrators, actual owner, creation dates, and other meta data

Operational data such as the input for example, loan approval name, email, loan amount), output, comments, attachments, and others

The current version of the WSHT API (at endpoint

/services/AeB4PTaskClient-taskOperations

) allows you to access all of these data by making multiple web service calls. For example, if you have an application that needs to populate the user interface with the task presentation name, input data, output data, and comments, you will have to make discrete web service calls to operations using the following functions:

getTaskInfo()

getTaskDescription()

getInput()

getOutput()

getComments()

Alternate method to retrieve all of the task data using a single web service call is the Process Server

getInstance

operation available from the

aeTaskOperations

port type at endpoint

http://host:port/active-bpel/services/AeB4PTaskClient-aeTaskOperations

. This operation returns a single element

<trt:taskInstance>

described in the

aeb4p-task-rt.xsd

schema. It contains all of the task data, including input data, output data, comments, attachments, presentation information, and the like. (The

aeTaskOperations

port type is described in

aeb4p-task-state.wsdl

). The

<trt:taskInstance>

element also contains some additional useful meta data such as the list of operations the current principal can invoke given the task's current status and the principal's role.

See the XML files at

/docs/ae-getTaskInstance-request.xml

and

/docs/ae-getTaskInstance-response.xml

for a detailed request and response example within your Process Developer installation's

com.activevos.com

plugin directory

The complete list of extension operations provided by the

/services/AeB4PTaskClient-aeTaskOperations

is shown in the following table:

Process Server Extension Operation	Description
authorize	Verifies that the principal can access the service endpoint.
deleteAttachmentById	Deletes an attachment using its attachment ID. Process Server assigns an ID for each attachment that is added to a task..The WSHT API does not have an operation for deleting attachments.
getAttachmentById	Retrieves attachment by ID. (The WSHT API identifies attachments by their name instead of by unique IDs.)
deleteComment	Deletes a comment using its comment ID. The Process Server assigns an ID to each comment that is added to the task. The WSHT API does not have an operation to delete comments.
updateComment	Updates a comment. This operation is not provided in the standard WSHT API.
getInstance	Returns full details of a task given a task ID. This operation is useful when you need the complete information about a task with out having to make separate WSHT API calls to get the information.
getTasks	Provides index offset (for pagination), column ordering, and the like. This is an extension to the WSHT getMyTasks task listing operation.

Rename Saved Search

Table of Contents

APIs, SDKs, and Services

APIs, SDKs, and Services

Process Server Extensions to WSHT API

Process Server Extensions to WSHT API