Definition

Process API can interact with process instances and its workflow variables, for the specified process.

This API is based on the specified process in the current app context.


NameDescription
1Process

Select any process present in the current app, for interaction with API.

2Short Description

Any description here.

3

Abort activity instance

Abort an activity instance in a running process instance.

NameDescription
URL/process/*yourProcessId*/abortActivity/{processId}/{activityId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Sample Response
{
  "date": "Thu Aug 29 18:33:39 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
4

Abort process instance

Abort a process instance.

NameDescription
URL/process/*yourProcessId*/abortProcess/{processId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
Sample Response
{
  "date": "Thu Aug 29 18:35:31 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
5

Complete activity instance

Complete an activity instance to continue the flow of a process instance.

NameDescription
URL/process/*yourProcessId*/completeActivity/{processId}/{activityId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Sample Response
{
  "date": "Thu Aug 29 18:41:53 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
6

Clone running process instance

Essentially cloning a running process instance along with its state and workflow variable(s) to a new process instance.

Option available to simultaneously abort the original running process instance.

NameDescription
URL/process/*yourProcessId*/copyProcess/{processId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
Query String Parameters
ParameterDescription
abortCurrent

Abort the original running process instance.

Expects a boolean.

Sample Response
{
  "processId": "152_expenseclaim_process1",
  "recordId": "747ada41-a7e8-4537-a060-ae7daface7b5",
  "activities": [
    "393_152_expenseclaim_process1_new_claim"
  ]
}
7

Get activity instance detail

Get details of an activity instance in a process instance.

NameDescription
URL/process/*yourProcessId*/getActivityDetail/{processId}/{activityId}
HTTP MethodGET
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Sample Response
{
  "finishTime": "",
  "variables": {
    "SelectApprover": "admin",
    "status": ""
  },
  "serviceLevelMonitor": "-",
  "dueDate": "",
  "activityName": "HOD Approve",
  "activityDefId": "approve_claim",
  "processVersion": "7",
  "participant": "approver",
  "activityId": "384_149_expenseclaim_process1_approve_claim",
  "processId": "149_expenseclaim_process1",
  "processName": "Expense Approval Process",
  "createdTime": "Wed Aug 28 15:03:15 SGT 2019",
  "assignee": [
    "admin"
  ],
  "processDefId": "expenseclaim#7#process1"
}
8

Get activity instance workflow variables

Get the workflow variables and its values from an activity instance.

NameDescription
URL/process/*yourProcessId*/getActivityVariables/{processId}/{activityId}
HTTP MethodGET
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Sample Response
{
  "SelectApprover": "admin",
  "status": "",
	.....
}
9

Get process instance detail

Get details of a process instance.

NameDescription
URL/process/*yourProcessId*/getProcessDetail/{processId}
HTTP MethodGET
Path Parameters
ParameterDescription
processIdProcess Instance ID.
Sample Response
{
  "requester": "admin",
  "startedTime": "",
  "finishTime": "",
  "variables": {
    "SelectApprover": "admin",
    "status": ""
  },
  "serviceLevelMonitor": "-",
  "processId": "149_expenseclaim_process1",
  "dueDate": "",
  "packageId": "expenseclaim",
  "name": "Expense Approval Process",
  "processDefId": "expenseclaim#7#process1",
  "version": "7",
  "states": "open.running"
}
10

Get process instance workflow variables

Get the workflow variables and its values from an process instance.

NameDescription
URL/process/*yourProcessId*/getVariables/{processId}
HTTP MethodGET
Path Parameters
ParameterDescription
processIdProcess Instance ID.
Sample Response
{
  "SelectApprover": "admin",
  "status": "",
	.....
}
11

List activity instances

List all activity instances of a process instance.

NameDescription
URL/process/*yourProcessId*/listActivities/{processId}
HTTP MethodGET
Path Parameters
ParameterDescription
processIdProcess Instance ID.
Query String Parameters
ParameterDescription
sort

Activity list data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
[
  {
    "dateCreated": "28-08-2019 03:03 PM",
    "serviceLevelMonitor": "-",
    "name": "HOD Approve",
    "id": "384_149_expenseclaim_process1_approve_claim",
    "state": "open.not_running.not_started"
  },
	.....
]
12

List completed process instances

List all completed process instance(s) of the specified process.

NameDescription
URL/process/*yourProcessId*/listCompleted
HTTP MethodGET
Query String Parameters
ParameterDescription
sort

Completed processes list data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
[
  {
    "startedTime": "25-04-2019 08:14 PM",
    "requesterId": "admin",
    "serviceLevelMonitor": "-",
    "due": "-",
    "name": "Expense Approval Process",
    "id": "44_expenseclaim_process1",
    "state": "closed.aborted",
    "version": "1"
  },
	.....
]
13

List running process instances

List all running process instance(s) of the specified process.

NameDescription
URL/process/*yourProcessId*/listRunning
HTTP MethodGET
Query String Parameters
ParameterDescription
sort

Running processes list data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
[
  {
    "startedTime": "26-08-2019 07:29 PM",
    "requesterId": "admin",
    "serviceLevelMonitor": "-",
    "due": "-",
    "name": "Expense Approval Process",
    "id": "149_expenseclaim_process1",
    "state": "open.running",
    "version": "7"
  },
	.....
]
14

Reassign activity instance

Explicitly set a user to replace an existing assignee of an activity instance, via username.

NameDescription
URL/process/*yourProcessId*/reassignActivity/{processId}/{activityId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Query String Parameters
ParameterDescription
assigneeUsername of the original user assigned to the task.
replacementUsername of the user to replace the assignee.
Sample Response
{
  "date": "Thu Aug 29 19:27:03 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
15

Reevaluate activity instance

Update/Replace the assignee(s) of an activity instance according to the current participant mapping of the specified process.

NameDescription
URL/process/*yourProcessId*/reevaluateActivity/{processId}/{activityId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Sample Response
{
  "date": "Thu Aug 29 19:32:19 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
16

Set activity instance workflow variables

Set the values of the workflow variable(s) of an activity instance.

NameDescription
URL/process/*yourProcessId*/setActivityVariables/{processId}/{activityId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processIdProcess Instance ID.
activityIdActivity Instance ID.
Query String Parameters

The parameters required here is highly dependent on the app/process design.

ParameterDescription
variables

Workflow variables and its values.

Do ensure that the workflow variable spelling and letter case is correct, as no error is outputted for non-existing workflow variables.
Sample Response
{
  "date": "Thu Aug 29 21:32:19 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
17

Start activity of a process instance

Start an activity instance in a process instance.

Option available to simultaneously abort the current running activity instance in the specified process instance.

NameDescription
URL/process/*yourProcessId*/startActivity/{processId}/{activityDefId}
HTTP MethodPOST
Path Parameters
ParameterDescription
processId

Process Instance ID.

Expects the ID of an existing process instance.

activityDefIdActivity Definition ID.
Query String Parameters
ParameterDescription
abortCurrent

Abort the current running activity instance in the process instance.

Expects a boolean.

Sample Response
{
  "processId": "152_expenseclaim_process1",
  "recordId": "747ada41-a7e8-4537-a060-ae7daface7b5",
  "activities": [
    "394_152_expenseclaim_process1_approve_claim"
  ]
}
18

Start process by current user

Start a new process instance of the specified process as the currently logged in user.

This API method only works for Basic Access Authentication.

See here on how to configure this setting in Manage API Key userview menu.

Tips

Remember to check Process Start White List to make sure the user is allowed to start the process instance.


NameDescription
URL/process/*yourProcessId*/startProcess
HTTP MethodPOST
Query String Parameters
ParameterDescription
processInstanceIdProcess Instance ID of a process that has been created, but not started.
recordIdPopulate the process instance's starting activity form with an existing record.
Body Parameters

The workflow variable(s) parameter required here is highly dependent on the app/process design. Example:

{
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

Note

If there is a Form mapped to the start process node, the Body Parameters apply to Form Data
If there is no Form mapped to the start process node, the Body Parameters apply to Workflow Variables

Sample Response
{
  "processId": "153_expenseclaim_process1",
  "recordId": "747ada41-a7e8-4537-a060-ae7daface7b5",
  "activities": [
    "395_153_expenseclaim_process1_new_claim"
  ]
}
19

Start process by username

Start a new process instance of the specified process on behalf of a user via username.

Tips

Remember to check Process Start White List to make sure the user is allowed to start the process instance.

NameDescription
URL/process/*yourProcessId*/startProcessByUser/{username}
HTTP MethodPOST
Path Parameters
ParameterDescription
usernameUsername of a Joget user.
Query String Parameters
ParameterDescription
processInstanceIdProcess Instance ID of a process that has been created, but not started.
recordIdPopulate the process instance's starting activity form with an existing record.
Body Parameters

The workflow variable(s) parameter required here is highly dependent on the app/process design. Example:

{
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
}

Note

If there is a Form mapped to the start process node, the Body Parameters apply to Form Data
If there is no Form mapped to the start process node, the Body Parameters apply to Workflow Variables

Sample Response
{
  "processId": "154_expenseclaim_process1",
  "recordId": "747ada41-a7e8-4537-a060-ae7daface7b5",
  "activities": [
    "396_154_expenseclaim_process1_new_claim"
  ]
}




  • No labels