Hyland Connect

resplin · ‎06-05-2015

The official documentation is at: http://docs.alfresco.com

Introduction

This page provides details on the workflow REST API being introduced in the 3.4 release. The page covers the design for the whole API but only a subset has been implemented in this release, mainly driven by the requirements of the new advanced workflow features added to Share.

The URLs that have not been implemented are clearly marked in each individual section.

Payload Definitions

JSON will be used for payloads throughout the API.

Requests

WorkflowDefinitionRequest


{
   'filePath': string
}

or


{
   'nodeRef': string
}

Notes:

The filePath needs to point to a file on the same machine as the repository hosting the REST API
The nodeRef points to a valid node in the repository hosting the REST API

WorkflowInstanceRequest


{
   'workflowDefinitionId': string
   'packageContainer': string
   'packageContents':
   [
      string,
      string,
      ...
   ],
   'properties':
   {
      'key': string, boolean, number, array or map,
      ...
   }
}

Notes:

The workflowDefinitionId is only required if the request is POSTed to the workflow-instances collection
The packageContainer and packageContents are mutually exclusive only one should be present

TaskInstanceRequest


{
   'key': string, boolean, number, array or map,
   ...
}

TransitionRequest


{
   'transition':
   {
      'id': string,
      'package':
      {
         'added': 
         [ 
            string, 
            string, 
            .... 
         ],
         'removed': 
         [ 
            string, 
            string, 
            .... 
         ]
      },
      'properties':
      {
         'key': string, boolean, number, array or map,
         ...
      }
   }
}

EventRequest


{
   'event':
   {
      'id': string,
      'package':
      {
         'added': 
         [ 
            string, 
            string, 
            .... 
         ],
         'removed': 
         [ 
            string, 
            string, 
            .... 
         ]
      },
      'properties':
      {
         'key': string, boolean, number, array or map,
         ...
      }
   }
}

TaskQueryRequest

TODO

Responses

SimpleWorkflowDefinitionResponse


{
   'id': string,
   'url': string,
   'name': string,
   'title': string,
   'description': string,
   'version': string
}

DetailedWorkflowDefinitionResponse


{
   'id': string,
   'url': string,
   'name': string,
   'title': string,
   'description': string,
   'version': string,
   'startTaskDefinitionUrl': string,
   'startTaskDefinitionType': string,
   'taskDefinitions':
   [
      {
         'url': string,
         'type': string
      },
      ...
   ]
}

SimpleWorkflowInstanceResponse


{
   'id': string,
   'url': string,
   'name': string,
   'title': string,
   'description': string,
   'isActive': boolean,
   'startDate': string,
   'endDate': string,
   'dueDate': string,
   'priority': number,
   'message': string,
   'context': string,
   'package': string,
   'initiator':
   {
      'userName': string,
      'firstName': string,
      'lastName': string
   },
   'definitionUrl': string
}

Notes:

The name, title and description are retrieved from the associated workflow definition.

DetailedWorkflowInstanceResponse


{
   'id': string,
   'url': string,
   'name': string,
   'title': string,
   'description': string,
   'isActive': boolean,
   'startDate': string,
   'endDate': string,
   'dueDate': string,
   'priority': number,
   'message': string,
   'context': string,
   'package': string,
   'initiator':
   {
      'userName': string,
      'firstName': string,
      'lastName': string
   },
   'definitionUrl': string,
   'diagramUrl': string   // 4.0 onwards
   'startTaskInstanceId': string,
   'definition':
   {
      'id': string,
      'url': string,
      'name': string,
      'title': string,
      'description': string,
      'version': string
      'startTaskDefinitionUrl': string,
      'startTaskDefinitionType': string,
      'taskDefinitions':
      [
         {
            'url': string,
            'type': string
         },
         ...
      ]
   },
   'tasks':
   [
      {
         'id': string,
         'url': string,
         'name': string,
         'title': string,
         'description': string,
         'state': string (IN_PROGRESS|COMPLETE),
         'path': string,
         'isPooled': boolean,
         'isEditable': boolean,
         'isReassignable': boolean,
         'isClaimable': boolean,
         'isReleasable': boolean,
         'outcome': string,
         'owner':
         {
            'userName': string,
            'firstName': string,
            'lastName': string
         },
         'properties':
         {
            'key': string, boolean, number, array or map,
            ...
         },
         'workflowInstance':
         {
            'id': string,
            'url': string,
            'name': string,
            'title': string,
            'description': string,
            'isActive': boolean,
            'startDate': string,
            'endDate': string,
            'dueDate': string,
            'priority': number,
            'message': string,
            'context': string,
            'package': string,
            'initiator':
            {
               'userName': string,
               'firstName': string,
               'lastName': string
            },
            'definitionUrl': string
         }
      },
      ...
   ]
}

Notes:

The definition is the same JSON structure used for the #DetailedWorkflowDefinitionResponse
If present, the tasks list uses the same JSON structure as #SimpleTaskInstanceResponse for each entry

SimpleTaskInstanceResponse


{
   'id': string,
   'url': string,
   'name': string,
   'title': string,
   'description': string,
   'state': string (IN_PROGRESS|COMPLETE),
   'path': string,
   'isPooled': boolean,
   'isEditable': boolean,
   'isReassignable': boolean,
   'isClaimable': boolean,
   'isReleasable': boolean,   
   'outcome': string,
   'owner':
   {
      'userName': string,
      'firstName': string,
      'lastName': string
   },
   'properties':
   {
      'key': string, boolean, number, array or map,
      ...
   },
   'workflowInstance':
   {
      'id': string,
      'url': string,
      'name': string,
      'title': string,
      'description': string,
      'isActive': boolean,
      'startDate': string,
      'endDate': string,
      'dueDate': string,
      'priority': number,
      'message': string,
      'context': string,
      'package': string,
      'initiator':
      {
         'userName': string,
         'firstName': string,
         'lastName': string
      },
      'definitionUrl': string
   }
}

Notes:

If the task does not have an owner the owner will be set to null.
Properties that have a null value should be present.
If the task has been completed the outcome label and completedDate will be present and populated.
The workflowInstance is the same JSON structure used for the #SimpleWorkflowInstanceResponse

DetailedTaskInstanceResponse


{
   'id': string,
   'url': string,
   'name': string,
   'title': string,
   'description': string,
   'state': string (IN_PROGRESS|COMPLETE),
   'path': string,
   'isPooled': boolean,
   'isEditable': boolean,
   'isReassignable': boolean,
   'isClaimable': boolean,
   'isReleasable': boolean,
   'outcome': string,
   'owner':
   {
      'userName': string,
      'firstName': string,
      'lastName': string
   },
   'properties':
   {
      'key': string, boolean, number, array or map,
      ...
   },
   'workflowInstance':
   {
      'id': string,
      'url': string,
      'name': string,
      'title': string,
      'description': string,
      'isActive': boolean,
      'startDate': string,
      'endDate': string,
      'dueDate': string,
      'priority': number,
      'message': string,
      'context': string,
      'package': string,
      'initiator':
      {
         'userName': string,
         'firstName': string,
         'lastName': string
      },
      'definitionUrl': string
   }
   'definition':
   {
      'id': string,
      'url': string,
      'type':
      {
         'name': string,
         'title': string,
         'description': string,
         'url': string
      },
      'node':
      {
         'name': string,
         'title': string,
         'description': string,
         'isTaskNode': boolean,
         'transitions':
         [
            {
               'id': string,
               'title': string,
               'description': string,
               'isDefault': boolean,
               'isHidden': boolean
            },
            ...
         ]
      }
   }
}

Notes:

The path is a URL that points to a resource that has detailed information.
If the task does not have an owner the owner will be set to null.
Properties that have a null value should be present.
If the task has been completed the outcome label and completedDate will be present and populated.
The definition is the same JSON structure used for the #DetailedTaskDefinitionResponse
The workflowInstance is the same JSON structure used for the #SimpleWorkflowInstanceResponse

SimpleTaskDefinitionResponse


{
   'id': string,
   'typeName': string,
   'typeTitle': string
   'typeUrl': string
}

DetailedTaskDefinitionResponse


{
   'id': string,
   'type':
   {
      'name': string,
      'title': string,
      'description': string,
      'url': string
   },
   'node':
   {
      'name': string,
      'title': string,
      'description': string,
      'isTaskNode': boolean,
      'transitions':
      [
         {
            'id': string,
            'title': string,
            'description': string,
            'isDefault': boolean,
            'isHidden': boolean
         },
         ...
      ]
   }
}

Notes:

The type URL points to the data dictionary REST API for the type.
The 'isHidden' value for a transition is determined by the presence of that transition id in the 'bpm:hiddenTransitions' multi-valued property.

WorkflowPathResponse


{
   'id': string,
   'url': string,
   'isActive': boolean,
   'workflowInstanceUrl': string,
   'node':
   {
      'name': string,
      'title': string,
      'description': string,
      'isTaskNode': boolean,
      'transitions':
      [
         {
            'id': string,
            'title': string,
            'descirption': string,
            'isDefault': boolean,
            'isHidden': boolean
         },
         ...
      ]
   }
}

Notes:

The node object uses the same JSON structure as used in #DetailedTaskDefinitionResponse

WorkflowTimerResponse


{
   'url': string,
   'name': string,
   'error': string,
   'dueDate': string,
   'pathUrl': string,
   'taskInstanceUrl': string
}

Resources

Workflow Definition Collection

Get Workflow Definition Collection

Retrieves the latest version of all deployed workflow definitions in the system.


GET /api/workflow-definitions?exclude={exclude?}

Example response data:


{
   'data': 
   [
      {
         'id' : 'jbpm$2',
         'url': 'api/workflow-definitions/jbpm$2',
         'name': 'jbpm$wf:adhoc',
         'title': 'Adhoc Task',
         'description': 'Assign task to colleague'
      },
      {
         'id' : 'jbpm$1',
         'url': 'api/workflow-definitions/jbpm$1',
         'name': 'jbpm$wf:review',
         'title': 'Review & Approve',
         'description': 'Review & approval of content'
      },
      ...
   ]
}

See SimpleWorkflowDefinitionResponse for payload definition.

Workflow Definition

A workflow definition defines the structure of a workflow, for example, the tasks it contains and what metadata those tasks provide.

Get Workflow Definition

Retrieves a specific workflow definition.

NOTE: This URL has not been implemented yet.


GET /api/workflow-definitions/{workflow_definition_id}

Example response data:


{
   'data':
   {
      'id' : 'jbpm$2',
      'url': 'api/workflow-definitions/jbpm$2',
      'name': 'jbpm$wf:adhoc',
      'title': 'Adhoc Task',
      'description': 'Assign task to colleague'
      'version': '1.0',
      'startTaskDefinitionUrl': 'api/classes/wf_submitAdhocTask',
      'startTaskDefinitionType': 'wf:submitAdhocTask',
      'taskDefinitions':
      [
         {
            'url': 'api/classes/wf_adhocTask',
            'type': 'wf:adhocTask'
         },
         {
            'url': 'api/classes/wf_completedAdhocTask',
            'type': 'wf:completedAdhocTask'
         }
      ]
   }
}

See DetailedWorkflowDefinitionResponse for payload definition.

Post Workflow Definition

Deploys a new workflow definition and returns a detailed representation of the newly deployed workflow definition.

NOTE: This URL has not been implemented yet.


POST /api/workflow-definitions
    =>WorkflowDefinitionRequest

Example request data:


{
   'nodeRef': 'workspace://SpacesStore/19c3c4e6-86f1-4640-ae48-673a39a3ce87'
}

See WorkflowDefinitionRequest for payload definition.

For example response data see the Get Workflow Definition method.

Put Workflow Definition

Updates (redeploys) the provided workflow definition and returns a detailed representation of the redeployed workflow definition.

NOTE: This URL has not been implemented yet.


PUT /api/workflow-definitions
    =>WorkflowDefinitionRequest

Example request data:


{
   'filePath': '/usr/opt/alfresco/uploads/my_process_definition.xml'
}

See WorkflowDefinitionRequest for payload definition.

For example response data see the Get Workflow Definition method.

Delete Workflow Definition

Removes (undeploys) the provided workflow definition.

NOTE: This URL has not been implemented yet.


DELETE /api/workflow-definitions/{workflow_definition_id}

Workflow Instance Collection

Get Workflow Instance Collection

Retrieves all workflow instances, the returned list can be optionally filtered by the state of the workflow instance, the authority that initiated the workflow instance, the priority and the due and start date.


GET api/workflow-instances?state={active|completed?}&initiator={authority?}&priority={priority?}&dueBefore={isoDate?}&dueAfter={isoDate?}&definitionId={workflow_definition_id?}&
    startedBefore={isoDate?}&startedAfter={isoDate?}&completedBefore={isoDate?}&completedAfter={isoDate?}&maxItems={maxItems?}&skipCount={skipCount?}&exclude={exclude?}

Example response data:


{
   'data':
   [
      {
         'id': 'jbpm$45',
         'url': 'api/workflow-instances/jbpm$45',
         'name': 'Adhoc',
         'title': 'Adhoc Task (Assign task to colleague)',
         'description': 'Assign task to colleague',
         'isActive': true,
         'startDate': '2010-07-08T22:51:07.000+01:00',
         'endDate': null,
         'initiator':
         {
            'userName': 'gavinc',
            'firstName': 'Gavin',
            'lastName': 'Cornwell'
         },
         'definitionUrl': 'api/workflow-definitions/jbpm$12'
      },
      {
         'id': 'jbpm$94',
         'url': 'api/workflow-instances/jbpm$94',
         'name': 'Adhoc',
         'title': 'Adhoc Task (Assign task to colleague)',
         'description': 'Assign task to colleague',
         'isActive': true,
         'startDate': '2010-05-15T09:26:09.000+01:00',
         'endDate': null,
         'initiator':
         {
            'userName': 'gavinc',
            'firstName': 'Gavin',
            'lastName': 'Cornwell'
         },
         'definitionUrl': 'api/workflow-definitions/jbpm$12'
      },
      ....
   ],
   'paging':
   {
      'totalItems': 145,
      'maxItems': 50,
      'skipCount': 100
   }
}

See SimpleWorkflowInstanceResponse for payload definition.

Get Workflow Instance Collection for Workflow Definition

Retrieves all workflow instances that are based on the specified workflow definition. The returned list can be optionally filtered by the state of the workflow instance, the authority that initiated the workflow instance, the priority and by the due, started and completed dates.


GET /api/workflow-definitions/{workflow_definition_id}/workflow-instances?state={active|completed?}&initiator={authority?}&priority={priority?}&dueBefore={isoDate?}&dueAfter={isoDate?}&
    startedBefore={isoDate?}&startedAfter={isoDate?}&completedBefore={isoDate?}&completedAfter={isoDate?}&maxItems={maxItems?}&skipCount={skipCount?}&exclude={exclude?}

For example response data see the Get Workflow Instance Collection method.

Get Workflow Instance Collection for NodeRef

Retrieves all active workflow instances that the given node is part of.


GET api/node/{store_type}/{store_id}/{id}/workflow-instances

For example response data see the Get Workflow Instance Collection method.

Workflow Instance

A workflow instance represents an 'in-flight' workflow.

Get Workflow Instance

Retrieves a specific workflow instance, optionally with all the tasks.


GET api/workflow-instances/{workflow_instance_id}?includeTasks={includeTasks?}

Example response data:


{
   'data':
   {
      'id': 'jbpm$45',
      'url': 'api/workflow-instances/jbpm$45',
      'name': 'jbpm$wf:adhoc',
      'title': 'Adhoc Task (Assign task to colleague)',
      'description': 'Assign task to colleague',
      'isActive': true,
      'startDate': '2010-07-08T22:51:07.000+01:00',
      'dueDate': '2010-09-09T10:00:00.000+01:00',
      'endDate': null,
      'priority': 2,
      'initiator':
      {
         'userName': 'gavinc',
         'firstName': 'Gavin',
         'lastName': 'Cornwell'
      },
      'context': 'workspace://SpacesStore/19c3c4e6-86f1-4640-ae48-673a39a3ce87',
      'package': 'workspace://SpacesStore/19c3c4e6-92f6-2481-fq43-123e56a3ce45',
      'diagramUrl: null,
      'startTaskInstanceId': 'jbpm$56',
      'definition':
      {
         'id' : 'jbpm$2',
         'url': 'api/workflow-definitions/jbpm$2',
         'name': 'jbpm$wf:adhoc',
         'title': 'Adhoc Task',
         'description': 'Assign task to colleague'
         'version': '1.0',
         'startTaskDefinitionUrl': 'api/classes/wf_submitAdhocTask',
         'startTaskDefinitionType': 'wf:submitAdhocTask',
         'taskDefinitions':
         [
            {
               'url': 'api/classes/wf_adhocTask',
               'type': 'wf:adhocTask'
            },
            {
               'url': 'api/classes/wf_completedAdhocTask',
               'type': 'wf:completedAdhocTask'
            }
         ]
      },
      'tasks':
      [
         {
            'id': 'jbpm$18',
            'url': 'api/task-instances/jbpm$18',
            'name': 'wf:adhocTask',
            'title': 'Adhoc Task',
            'description': 'Adhoc Task allocated by colleague',
            'state': 'COMPLETED',
            'outcome': 'Task Done',
            'completedDate': '2010-07-08T22:51:07.000+01:00',
            'typeDefinitionTitle': 'Adhoc Task',
            'isPooled': false,
            'owner':
            {
               'userName': 'gavinc',
               'firstName': 'Gavin',
               'lastName': 'Cornwell'
            },
            'properties':
            {
               'bpm_description': 'Please have a look at this',
               'bpm_percentComplete': 50,
               'bpm_priority': 1,
               ...
            }
         },
         ...
      ]
   }
}

See DetailedWorkflowInstanceResponse for payload definition.

Get Workflow Instance Diagram

Retrieves a diagram representing the current state of a specific workflow instance.


GET api/workflow-instances/{workflow_instance_id}/diagram

NOTE: This URL is available in 4.0 onwards.

Post Workflow Instance

Starts a workflow instance and returns a representation of the newly started workflow. By default the first task in the workflow will be signalled to end, to avoid this the autoEndFirstTask parameter can be set to false.

NOTE: These URLs have not been implemented yet.


POST api/workflow-instances?autoEndFirstTask={autoEndFirstTask?}
    => WorkflowInstanceRequest


POST api/workflow-definitions/{workflow_definition_id}?autoEndFirstTask={autoEndFirstTask?}
    => WorkflowInstanceRequest

Example request data:


{
   'workflowDefinitionId': 'jbpm$12',
   'packageContents':
   [
      'workspace://SpacesStore/19c3c4e6-86f1-4640-ae48-673a39a3ce87',
      'workspace://SpacesStore/19c3c4e6-92f6-2481-fq43-123e56a3ce45'
   ],
   'properties':
   {
      'bpm_description': 'This is a description of the workflow.',
      'bpm_percentComplete': 0,
      'bpm_priority': 2,
      ...
   }
}

See WorkflowInstanceRequest for payload definition.

For example response data see the Get Workflow Instance method.

Delete Workflow Instance

Either cancels or deletes the specified workflow instance. If the force parameter is omitted the workflow instance is cancelled, to delete the workflow instance pass the forced parameter set to true.


DELETE api/workflow-instances/{workflow_instance-id}?forced=true|false

Task Instance Collection

Get Task Instance Collection

Retrieves all task instances in the system. The list can optionally be filtered by an authority (the task assignee), the task state, priority and due date. The properties to return can also be defined if desired.


GET api/task-instances?authority={authority_id?}&state={in_progress|completed?}&priority={priority?}&pooledTasks={true|false?}&
    dueBefore={isoDate?}&dueAfter={isoDate?}&properties={prop1, prop2, prop3...?}&maxItems={maxItems?}&skipCount={skipCount?}&exclude={exclude?}

Example response data:


{
   'data':
   [
      {
         'id': 'jbpm$2',
         'url': 'api/task-instances/jbpm$2',
         'name': 'wf:reviewTask',
         'title': 'Review',
         'description': 'Review Documents to Approve or Reject them',
         'state': 'IN_PROGRESS',
         'typeDefinitionTitle': 'Review',
         'isPooled': false,
         'owner':
         {
            'userName': 'gavinc',
            'firstName': 'Gavin',
            'lastName': 'Cornwell'
         },
         'properties':
         {
            'bpm_description': 'This is a description of the workflow.',
            'bpm_percentComplete': 0,
            'bpm_priority': 2,
            ...
         }
      },
      {
         'id': 'jbpm$18',
         'url': 'api/task-instances/jbpm$18',
         'name': 'wf:adhocTask',
         'title': 'Adhoc Task',
         'description': 'Adhoc Task allocated by colleague',
         'state': 'IN_PROGRESS',
         'typeDefinitionTitle': 'Adhoc Task',
         'isPooled': false,
         'owner':
         {
            'userName': 'gavinc',
            'firstName': 'Gavin',
            'lastName': 'Cornwell'
         },
         'properties':
         {
            'bpm_description': 'Please have a look at this',
            'bpm_percentComplete': 50,
            'bpm_priority': 1,
            ...
         }
      },
      ...
   ],
   'paging':
   {
      'totalItems': 145,
      'maxItems': 50,
      'skipCount': 100
   }
}

See SimpleTaskInstance for payload definition.

Get Task Instance Collection for Workflow Instance

Retrieves all task instances belonging to the provided workflow instance. The list of tasks can optionally be filtered by an authority (the task assignee), state, priority and due date. The properties to return can also be defined if desired.


GET api/workflow-instances/{workflow_instance_id}/task-instances?state={in_progress|completed?}&priority={priority?}&
    dueBefore={isoDate?}&dueAfter={isoDate?}&properties={prop1, prop2, prop3...?}&maxItems={maxItems?}&skipCount={skipCount?}&exclude={exclude?}

For example response data see the Get Task Instance Collection method.

Task Instance

A task instance represents a step in a workflow.

Get Task Instance

Retrieves a specific task instance.


GET api/task-instances/{task_instance_id}

Example response data:


{
   'data':
   {
      'id': 'jbpm$2',
      'url': 'api/task-instances/jbpm$2',
      'name': 'wf:reviewTask',
      'title': 'Review',
      'description': 'Review Documents to Approve or Reject',
      'state': 'IN_PROGRESS',
      'path': 'api/task-instances/jbpm$2/paths/jbpm$43-@',
      'isPooled': false,
      'owner':
      {
         'userName': 'gavinc',
         'firstName': 'Gavin',
         'lastName': 'Cornwell'
      },
      'properties':
      {
         'bpm_priority': 1,
         'bpm_description': 'Please have a look at these'
         ...
      },
      'workflowInstance':
      {
          'id': 'jbpm$94',
         'url': 'api/workflow-instances/jbpm$94',
         'name': 'Review and Approve',
         'title': 'Review and Approve',
         'description': 'Review and Approve',
         'isActive': true,
         'startDate': '2010-05-15T09:26:09.000+01:00',
         'endDate': null,
         'initiator':
         {
            'userName': 'gavinc',
            'firstName': 'Gavin',
            'lastName': 'Cornwell'
         },
         'definitionUrl': 'api/workflow-definitions/jbpm$98'
      }
      'definition':
      {
         'id': 'wf:reviewTask',
         'url': 'api/task-definitions/jbpm$8'
         'type':
         {
            'name': 'wf:reviewTask',
            'title': 'Review',
            'description': 'Review',
            'url': 'api/classes/wf_reviewTask'
         },
         'node':
         {
            'name': 'review',
            'title': 'Review',
            'description': 'Review',
            'isTaskNode': true,
            'transitions':
            [
               {
                  'id': 'approve',
                  'title': 'Approve',
                  'description': 'Approve',
                  'isDefault': true,
                  'isHidden': false
               },
               {
                  'id': 'reject',
                  'title': 'Reject',
                  'description': 'Reject',
                  'isDefault': false,
                  'isHidden': false
               }
            ]
         }
      }
   }
}

See DetailedTaskInstanceResponse for payload definition.

Post Task Instance

Signals a transition for the specified task instance. This will end the current task and move the workflow to the next task.

NOTE: This URL has not been implemented yet.


POST api/task-instances/{task_instance_id}
    => TransitionRequest

Example request data:


{
   'transition':
   {
      'id': 'approve',
      'package':
      {
         'added': 
         [ 
            'workspace://SpacesStore/19c3c4e6-86f1-4640-ae48-673a39a3ce87'
         ],
         'removed': 
         [ 
            'workspace://SpacesStore/19c3c4e6-92f6-2481-fq43-123e56a3ce45'
         ]
      },
      'properties':
      {
         'bpm_description': 'This is a description of the workflow.',
         'bpm_percentComplete': 0,
         'bpm_priority': 2,
         ...
      }
   }
}

See TransitionRequest for payload definition.

For example response data see the Get Task Instance method.

Put Task Instance

Updates the properties of a specific task and returns a detailed representation of the updated task instance.

Note: Only the task owner or the initiator of the workflow instance the task is part of may update the task properties.


PUT api/task-instances/{task_instance_id}
    => TaskInstanceRequest

Example request data:


{
   'bpm_description': 'Please review these documents.',
   'bpm_priority': 3
}

See TaskInstanceRequest for payload definition.

For example response data see the Get Task Instance method.

Task Definition Collection

Get Task Definition Collection for Workflow Definition

Retrieves all task definitions contained in the specified workflow definition.

NOTE: This URL has not been implemented yet.


GET api/workflow-definitions/{workflow_definition_id}/task-definitions

Example response data:


{
   'id': 'wf:reviewTask',
   'typeName': 'wf:reviewTask',
   'typeTitle': 'Review'
   'typeUrl': 'api/classes/wf_reviewTask'
}

See SimpleTaskDefinitionResponse for payload definition.

Workflow Path Collection

Get Workflow Path Collection

Retrieves all the workflow paths associated with the specified workflow instance.

NOTE: This URL has not been implemented yet.


GET api/workflow-instances/{workflow_instance_id}/workflow-paths

Workflow Path

A workflow path represents a specific point in an 'in-flight' workflow instance.

Get Workflow Path

Retrieves a specific workflow path.

NOTE: This URL has not been implemented yet.


GET api/workflow-instances/{workflow_instance_id}/workflow-paths/{path_id}

Post Workflow Path

Signals a transition or fires an event against the provided workflow path and returns the updated workflow path. A set of properties to update

NOTE: This URL has not been implemented yet.


POST api/workflow-paths/{path_id}
    => TransitionRequest or EventRequest

Workflow Timer

Get Workflow Timer

Retrieves all the timers associated with the provided workflow instance.

NOTE: This URL has not been implemented yet.


GET api/workflow-instances/{workflow_instance_id}/timers

Task Query

A task query allows a list of task instances that match the provided criteria to be retrieved.

Post Task Instance Query

Retrieves a list of task instances matching the provided search criteria.

NOTE: This URL has not been implemented yet.


POST api/task-instances
    => TaskQueryRequest

Hyland Connect

Workflow REST API

Table of Contents

Introduction

Payload Definitions

Requests

WorkflowDefinitionRequest

WorkflowInstanceRequest

TaskInstanceRequest

TransitionRequest

EventRequest

TaskQueryRequest

Responses

SimpleWorkflowDefinitionResponse

DetailedWorkflowDefinitionResponse

SimpleWorkflowInstanceResponse

DetailedWorkflowInstanceResponse

SimpleTaskInstanceResponse

DetailedTaskInstanceResponse

SimpleTaskDefinitionResponse

DetailedTaskDefinitionResponse

WorkflowPathResponse

WorkflowTimerResponse

Resources

Workflow Definition Collection

Get Workflow Definition Collection

Workflow Definition

Get Workflow Definition

Post Workflow Definition

Put Workflow Definition

Delete Workflow Definition

Workflow Instance Collection

Get Workflow Instance Collection

Get Workflow Instance Collection for Workflow Definition

Get Workflow Instance Collection for NodeRef

Workflow Instance

Get Workflow Instance

Get Workflow Instance Diagram

Post Workflow Instance

Delete Workflow Instance

Task Instance Collection

Get Task Instance Collection

Get Task Instance Collection for Workflow Instance

Task Instance

Get Task Instance

Post Task Instance

Put Task Instance

Task Definition Collection

Get Task Definition Collection for Workflow Definition

Workflow Path Collection

Get Workflow Path Collection

Workflow Path

Get Workflow Path

Post Workflow Path

Workflow Timer

Get Workflow Timer

Task Query

Post Task Instance Query