Webservice: Workflow

Interaction with the Workflow engine [Commercial editions only]

Index Method Request(s) Response Description
1 complete sid
taskId
transition
completes a task
2 claim sid
taskId
claims a task
3 unclaim sid
taskId
turns a task back to pool
4 getTasksICanOwn sid
tasks retrieves the tasks that can be owned by the current user
5 getHistories sid
instanceId
event
histories gets the histories of a workflow instance
6 appendDocuments sid
taskId
docIds
appends new documents to the workflow
7 getWorkflows sid
workflows lists the available wokflows
8 startWorkflow sid
workflow
tag
docIds
instanceId launches a new workflow instance
9 getTasksAssignedToMe sid
tasks retrieves the tasks assigned to the current user
10 addNote sid
taskId
note
history adds a new note

Method #1: complete

completes a task

Request

Name Type Required Multiple Description
     sid
String Y
     taskId
String Y
     transition
String Y

Method #2: claim

claims a task

Request

Name Type Required Multiple Description
     sid
String Y
     taskId
String Y

Method #3: unclaim

turns a task back to pool

Request

Name Type Required Multiple Description
     sid
String Y
     taskId
String Y

Method #4: getTasksICanOwn

retrieves the tasks that can be owned by the current user

Request

Name Type Required Multiple Description
     sid
String Y

Response

Name Type Required Multiple Description
     tasks
WSWorkflowTask Y Y
          id
String Y task identifier
          name
String Y name of the task
          instanceId
String Y identifier of the workflow instance
          workflowName
String Y
          tag
String Y tag of the workflow instance
          lastNote
String Y
          assignee
String Y
          candidates
String Y Y possible candidates for this task
          appendedDocs
Long Y Y documents appended to the current workflow instance
          transitions
String Y Y
          startDate
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          dueDate
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          endDate
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

Method #5: getHistories

gets the histories of a workflow instance

Request

Name Type Required Multiple Description
     sid
String Y
     instanceId
String Y
     event
String optional filter on a specific event type

Response

Name Type Required Multiple Description
     histories
WSWorkflowHistory Y Y
          id
Long Y
          docId
Long document identifier
          folderId
Long Y
          userId
Long Y
          date
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          username
String Y
          event
String Y
          comment
String Y
          version
String Y
          sessionId
String Y
          filename
String Y
          templateId
Long Y
          instanceId
String Y
          taskname
String Y
          transition
String Y
          taskId
String Y

Method #6: appendDocuments

appends new documents to the workflow

Request

Name Type Required Multiple Description
     sid
String Y
     taskId
String Y
     docIds
Long Y Y

Method #7: getWorkflows

lists the available wokflows

Request

Name Type Required Multiple Description
     sid
String Y

Response

Name Type Required Multiple Description
     workflows
String Y Y

Method #8: startWorkflow

launches a new workflow instance

Request

Name Type Required Multiple Description
     sid
String Y
     workflow
String Y
     tag
String tag you can assign to the new instance
     docIds
Long Y the documents to be appended to the workflow

Response

Name Type Required Multiple Description
     instanceId
String Y

Method #9: getTasksAssignedToMe

retrieves the tasks assigned to the current user

Request

Name Type Required Multiple Description
     sid
String Y

Response

Name Type Required Multiple Description
     tasks
WSWorkflowTask Y Y
          id
String Y task identifier
          name
String Y name of the task
          instanceId
String Y identifier of the workflow instance
          workflowName
String Y
          tag
String Y tag of the workflow instance
          lastNote
String Y
          assignee
String Y
          candidates
String Y Y possible candidates for this task
          appendedDocs
Long Y Y documents appended to the current workflow instance
          transitions
String Y Y
          startDate
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          dueDate
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          endDate
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'

Method #10: addNote

adds a new note

Request

Name Type Required Multiple Description
     sid
String Y
     taskId
String Y
     note
String Y

Response

Name Type Required Multiple Description
     history
WSWorkflowHistory Y
          id
Long Y
          docId
Long document identifier
          folderId
Long Y
          userId
Long Y
          date
String Y format must be 'yyyy-MM-dd HH:mm:ss' or 'yyyy-MM-dd'
          username
String Y
          event
String Y
          comment
String Y
          version
String Y
          sessionId
String Y
          filename
String Y
          templateId
Long Y
          instanceId
String Y
          taskname
String Y
          transition
String Y
          taskId
String Y