Joget DX 8 Stable Released
The stable release for Joget DX 8 is now available, with a focus on UX and Governance.
Warning |
---|
Introduced in v5, the API Domain Whitelist setting in General Settings needs to be configured to allow JSON API requests. If a request is from a non-whitelisted domain, the response will be a HTTP 400 Bad Request. |
Table of Contents
Description
Retrieves all columns for a form
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/app/crm/form/crm_account/columns
Sample Result
Code Block | ||
---|---|---|
| ||
[{
"value": "accountName",
"label": "Account Name"
}, {
"value": "address",
"label": "address"
}, {
"value": "city",
"label": "City"
}, {
"value": "country",
"label": "Country"
}, {
"value": "dateCreated",
"label": "Date Created"
}, {
"value": "dateModified",
"label": "Date Modified"
}, {
"value": "id",
"label": "ID"
}, {
"value": "state",
"label": "State"
}] |
...
...
...
...
Description
Retrieves package (app) list
User Role
Admin
URL
/web/json/workflow/package/list
Description
Executes a generator plugin based on a form
User Role
Admin
Method
HTTP Method
HTTP GET/ POST
Parameters
Sample Result
Sample URL
http://localhost:8080/jw/web/json/app/crm/generator/crm_account/generate?plugin=org.joget.plugin.enterprise.CrudGenerator
Sample Result
Code Block | ||
---|---|---|
| ||
Code Block | ||
| ||
{ "datamessage": [{ "packageId": "crm", "packageName": "CRM" }, { "packageId": "helpdesk", "packageName": "Helpdesk" }] } |
Description
Gets latest Process def Id of a process based on a Process def Id
User Role
Admin
URL
/web/json/workflow/process/list
Method
HTTP GET/POST
Parameters
Sample Result
Description
Retrieves process list
User Role
Admin
URL
/web/json/workflow/process/list
Method
HTTP GET/POST
Parameters
Sample Result
"CRUD generated. Click <a href=\"/jw/web/console/app/crm/2/userview/builder/crm_userview_sales?menuId=c4a0c79c-c0a83810-5291318b-96650e7d\" target=\"_blank\">here<\/a> to continue edit CRUD in Userview Builder.",
"error": false,
"pluginDisabled": false
} |
Description
Downloads and imports an app form an URL
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/apps/install?url=http%3A%2F%2Fwww.joget.org%2Fdownloads%2Fsimple_crm.jwa
Sample Result
Code Block | ||
---|---|---|
| ||
{
"appId" : "mcrm",
"appName" : "Simple CRM",
"appVersion: : "1"
} |
Description
Retrieves all published processes based on logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/apps/published/processes?appId=crm
Sample Result
Code Block | ||
---|---|---|
| ||
{
"apps": [{
"processes": [{
"id": "crm#3#process1",
"processVersion": "3",
"appVersion": 2,
"name": "Proposal Approval Process",
| ||
Code Block | ||
| ||
{ "total": 3, "desc": false, "sort": "name", "start": 0, "data": [{ "ididWithoutVersion": "hdc_v1001#1#hdc_certification_processprocess1", "packageName": "halal certification", "nameurl": "HDC Certification Process",/jw/web/client/app/crm/2/process/process1?start=true" "packageId": "hdc_v1001"}], "labelid": "HDC Certification Process ver 1crm", "versionname": "1" }, {CRM", "idversion": "mdec_v1002#12#mdec_wp1",2 }] } |
Description
Retrieves all published userviews based on logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/apps/published/userviews?appId=crm
Sample Result
Code Block | ||
---|---|---|
| ||
{ "packageNameapps": "Mdec Work Progress",[{ "nameid": "mdec_wp1crm", "packageIdname": "mdec_v1002CRM", "labeluserviews": "mdec_wp1 ver 12", [{ "versionid": "12crm_userview_sales", }, { "iddescription": "mora#5#mora_new_application", "packageNamename": "MORA Halal CertificationCRM: Sales Force Automation", "nameurl": "MORA New Application/jw/web/userview/crm/crm_userview_sales", "packageIdversion": "mora",2 "label": "MORA New Application ver 5"}], "version": "5"2 }] } |
...
...
...
Description
Retrieve first process with details of every packages
Retrieves all apps
User Role
AdminURL/web/json/workflow/process/list/package
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc
checkWhiteList- (Optional) Boolean value to
return the list based on process white listSample Result
determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/list?name=crm
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 2, |
...
"data": [{
"id": " |
...
crm", " |
...
name": |
...
"CRM", " |
...
version": |
...
2 |
...
}, { " |
...
id": " |
...
mcrm", " |
...
name": " |
...
Simple |
...
CRM", " |
...
version": |
...
1 |
...
}]
} |
Description
Retrieves all version of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http:/localhost/jw/web/json/workflow/process/list/package
Sample Result
Code Block | ||
---|---|---|
| ||
{ "total": 2, |
...
" |
...
data": |
...
[{ " |
...
dateModified": " |
...
23-07-2015 07:25 AM", " |
...
description": |
...
null, " |
...
dateCreated": " |
...
28-05-2015 10:08 PM", " |
...
published": " |
...
",
" |
...
version": " |
...
1" }, { " |
...
dateModified": " |
...
04-09-2015 03:05 AM", " |
...
description": |
...
null, " |
...
dateCreated": " |
...
22-07-2015 11:24 PM", " |
...
published": " |
...
<div class=\"tick\"><\/div>", " |
...
version": " |
...
2" }] } |
...
...
...
...
...
Description
Retrieves all Datalist Actions plugins
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/builder/actions
Sample Result
Code Block | ||
---|---|---|
| ||
{
"actions": [{
"name": "Data List Hyperlink Action",
"className": "org.joget.apps.datalist.lib.HyperlinkDataListAction",
"label": "Hyperlink",
"type": "text",
"propertyOptions": "[{ title : 'Configure Link', properties : [{ label : 'Hyperlink', name : 'href', type : 'textfield', description : 'URL (Eg. http:\\/\\/www.google.com)' }, { label : 'Hyperlink Target', name : 'target', type : 'selectbox', description : 'Hyperlink Target is for Row Action usage only', options : [{ value : '_self', label : 'Current Window' }, { value : '_blank', label : 'New Window' }, { value : 'popup', label : 'Popup Dialog' }] }, { name : 'parameters', label : 'Hyperlink Parameters', type : 'gridCombine', columns : [{ key : 'hrefParam', label : 'Parameter Name' }, { key : 'hrefColumn', label : 'Column Name' }] }, { label : 'Label', name : 'label', type : 'textfield', description : 'Label shown in the column (for row actions)', value : 'Hyperlink' }, { label : 'Confirmation Message', name : 'confirmation', type : 'textfield' }, { label : 'Visible when no record or checkbox? ', name : 'visible', type : 'checkbox', options : [ {'value' : 'true', 'label' : ''} ] }] }]"
}, {
"name": "Form Row Delete Action",
"className": "org.joget.apps.datalist.lib.FormRowDeleteDataListAction",
"label": "Delete",
"type": "text",
"propertyOptions": "[{ title : 'Edit Delete Action', properties : [{ name : 'label', label : 'Label', type : 'textfield' }, {name:'formDefId',label:'Form',type:'selectbox',options_ajax:'[CONTEXT_PATH]/web/json/console/app/crm/2/forms/options',required:'True'},{ name : 'confirmation', label : 'Confirmation Message', type : 'textfield' }, { name:'deleteGridData', label:'Delete Associated Grid Data?', type:'checkbox', value:'false', options:[ { value:'true', label:'' } ] }, { name:'deleteSubformData', label:'Delete Associated Child Form Data? ', type:'checkbox', value:'false', options:[ { value:'true', label:'' } ] }, { name:'abortRelatedRunningProcesses', label:'Abort Related Running Processes? ', type:'checkbox', value:'false', options:[ { value:'true', label:'' } ] }] }]"
}]
} |
Description
Retrieves all environment variable of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/envVariable/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 2,
"data": [{
"id": "refNo",
"value": "75",
"remarks": "Used for plugin: IdGeneratorField"
}, {
"id": "welcome",
"value": "<b>Welcome Message<\/b>",
"remarks": ""
}]
} |
Description
Retrieves all datalist of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/datalist/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"id": "crm_contact_list",
"dateModified": "22-07-2015 11:24 PM",
"description": "Contact List",
"name": "Contact List",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_inbox",
"dateModified": "28-08-2015 09:42 AM",
"description": null,
"name": "Task Inbox",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_opportunity_list",
"dateModified": "22-07-2015 11:24 PM",
"description": "Opportunity List",
"name": "Opportunity List",
"dateCreated": "22-07-2015 11:24 PM"
}]
} |
Description
Retrieves all datalist of an app in value-label pair.
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/datalist/options
Sample Result
Code Block | ||
---|---|---|
| ||
[{
"value": "",
"label": ""
}, {
"value": "crm_account_list",
"label": "Account Listing"
}, {
"value": "crm_contact_list",
"label": "Contact List"
}, {
"value": "crm_opportunity_list",
"label": "Opportunity List"
}, {
"value": "crm_inbox",
"label": "Task Inbox"
}] |
Description
Retrieves all table name used in an app
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/form/tableNameList
Sample Result
Code Block | ||
---|---|---|
| ||
{
"tableName": ["crm_account", "crm_contact", "crm_opportunity", "crm_proposal"]
} |
Description
Retrieves all forms in an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/forms
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 7,
"data": [{
"id": "crm_account",
"dateModified": "07-09-2015 08:30 AM",
"tableName": "crm_account",
"name": "Account Form",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_contact",
"dateModified": "22-07-2015 11:24 PM",
"tableName": "crm_contact",
"name": "Contact Form",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_opportunity",
"dateModified": "22-07-2015 11:24 PM",
"tableName": "crm_opportunity",
"name": "Opportunity Form",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_proposal_approval_form",
"dateModified": "22-07-2015 11:24 PM",
"tableName": "crm_proposal",
"name": "Proposal Approval Form",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_proposal_form",
"dateModified": "13-08-2015 02:55 AM",
"tableName": "crm_proposal",
"name": "Proposal Form",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_proposal_resubmit_form",
"dateModified": "22-07-2015 11:24 PM",
"tableName": "crm_proposal",
"name": "Proposal Resubmit Form",
"dateCreated": "22-07-2015 11:24 PM"
}, {
"id": "crm_proposal_sending_form",
"dateModified": "22-07-2015 11:24 PM",
"tableName": "crm_proposal",
"name": "Proposal Sending Form",
"dateCreated": "22-07-2015 11:24 PM"
}]
} |
Description
Retrieves all form in an app in value-label pair
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/forms/options
Sample Result
Code Block | ||
---|---|---|
| ||
[{
"value": "",
"label": ""
}, {
"value": "crm_account",
"label": "Account Form"
}, {
"value": "crm_contact",
"label": "Contact Form"
}, {
"value": "crm_opportunity",
"label": "Opportunity Form"
}, {
"value": "crm_proposal_approval_form",
"label": "Proposal Approval Form"
}, {
"value": "crm_proposal_form",
"label": "Proposal Form"
}, {
"value": "crm_proposal_resubmit_form",
"label": "Proposal Resubmit Form"
}, {
"value": "crm_proposal_sending_form",
"label": "Proposal Sending Form"
}] |
Description
Deploy a new version of XPDL to an app
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/package/deploy
Sample Result
Code Block | ||
---|---|---|
| ||
{"status" : "complete"} |
Description
Retrieves XPDL file of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/package/xpdl
Description
Retrieves all configured default plugin properties of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/pluginDefault/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 2,
"data": [{
"id": "org.joget.apps.app.lib.EmailTool",
"pluginName": "Email Tool",
"pluginDescription": "Sends email message to targeted recipient(s)"
}, {
"id": "org.joget.apps.app.lib.ProcessDataCollectorAuditTrail",
"pluginName": "Process Data Collector",
"pluginDescription": "Save process data into app_report_* tables for reporting purposes"
}]
} |
Description
Retrieves all created custom i18n message of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/message/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"message": "查询",
"id": "general.method.label.search_zh_CN",
"locale": "zh_CN",
"messageKey": "general.method.label.search"
}
} |
Description
Retrieves all userviews of an app
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/userview/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"id": "crm_userview_sales",
"dateModified": "13-09-2015 02:55 AM",
"description": "",
"name": "CRM: Sales Force Automation",
"dateCreated": "22-07-2015 11:24 PM"
}
} |
Description
Retrieves all userviews of an app in value-label pair
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/app/crm/userview/options
Sample Result
Code Block | ||
---|---|---|
| ||
[{
"value": "",
"label": ""
}, {
"value": "crm_userview_sales",
"label": "CRM: Sales Force Automation"
}] |
Description
Retrieves package (app) list
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/package/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"data": [{
"packageId": "crm",
"packageName": "CRM"
}, {
"packageId": "helpdesk",
"packageName": "Helpdesk"
}]
} |
Description
Accept an assigned assignment
Note |
---|
Deprecated Since v3, the concept of accept & withdraw assignment is removed |
User Role
Anyone (Including anonymous)
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/accept/879_223_crm_process1_approve_proposal
Sample Result
Code Block | ||
---|---|---|
| ||
{
"assignment" : "879_223_crm_process1_approve_proposal"
"status" : "accepted"
} |
Description
Completes an assigned assignment
User Role
Anyone (Including anonymous)
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/complete/879_223_crm_process1_approve_proposal
Sample Result
Code Block | ||
---|---|---|
| ||
{
"activityId": "879_223_crm_process1_approve_proposal",
"nextActivityId": "882_223_crm_process1_send_proposal",
"processId": "223_crm_process1",
"status": "completed"
} |
Description
Completes an assigned assignment with option to set workflow variables.
User Role
Anyone (Including anonymous)
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/completeWithVariable/879_223_crm_process1_approve_proposal?var_status=Sent
Sample Result
Code Block | ||
---|---|---|
| ||
{
"activityId": "879_223_crm_process1_approve_proposal",
"nextActivityId": "882_223_crm_process1_send_proposal",
"processId": "223_crm_process1",
"status": "completed"
} |
Description
Retrieves all assignments of current logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list?rows=3&packageId=crm
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 10,
"data": [{
"id": "477_118_crm_process1_approve_proposal",
"activityId": "477_118_crm_process1_approve_proposal",
"processVersion": "1",
"serviceLevelMonitor": "-",
"processId": "118_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "21-07-2015 03:03 AM",
"label": "Approve Proposal",
"acceptedStatus": false,
"activityName": "Approve Proposal"
}, {
"id": "479_119_crm_process1_approve_proposal",
"activityId": "479_119_crm_process1_approve_proposal",
"processVersion": "1",
"serviceLevelMonitor": "-",
"processId": "119_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "21-07-2015 03:03 AM",
"label": "Approve Proposal",
"acceptedStatus": false,
"activityName": "Approve Proposal"
}, {
"id": "481_120_crm_process1_approve_proposal",
"activityId": "481_120_crm_process1_approve_proposal",
"processVersion": "1",
"serviceLevelMonitor": "-",
"processId": "120_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "21-07-2015 03:03 AM",
"label": "Approve Proposal",
"acceptedStatus": false,
"activityName": "Approve Proposal"
}]
} |
Description
Retrieves the number of assignments of current logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list/count?packageId=crm
Sample Result
Code Block | ||
---|---|---|
| ||
{"total":10} |
Description
Retrieves all accepted assignments of current logged in user
Note |
---|
Deprecated Since v3, the concept of accept & withdraw assignment is removed |
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list/accepted?rows=3
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 10,
"data": [{
"id": "477_118_crm_process1_approve_proposal",
"activityId": "477_118_crm_process1_approve_proposal",
"processVersion": "1",
"serviceLevelMonitor": "-",
"processId": "118_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "21-07-2015 03:03 AM",
"label": "Approve Proposal",
"acceptedStatus": false,
"activityName": "Approve Proposal"
}, {
"id": "479_119_crm_process1_approve_proposal",
"activityId": "479_119_crm_process1_approve_proposal",
"processVersion": "1",
"serviceLevelMonitor": "-",
"processId": "119_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "21-07-2015 03:03 AM",
"label": "Approve Proposal",
"acceptedStatus": false,
"activityName": "Approve Proposal"
}, {
"id": "481_120_crm_process1_approve_proposal",
"activityId": "481_120_crm_process1_approve_proposal",
"processVersion": "1",
"serviceLevelMonitor": "-",
"processId": "120_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "21-07-2015 03:03 AM",
"label": "Approve Proposal",
"acceptedStatus": false,
"activityName": "Approve Proposal"
}]
} |
Description
Retrieves the number of accepted assignments of current logged in user
Note |
---|
Deprecated Since v3, the concept of accept & withdraw assignment is removed |
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list/accepted/count
Sample Result
Code Block | ||
---|---|---|
| ||
{"total":3} |
Description
Retrieves processes list based on accepted assignment of current logged in user
Note |
---|
Deprecated Since v3, the concept of accept & withdraw assignment is removed |
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list/accepted/process
Sample Result
Code Block | ||
---|---|---|
| ||
{
"data": [{
"count": 3,
"processVersion": "3",
"processName": "Proposal Approval Process",
"processDefId": "crm#3#process1",
"label": "Proposal Approval Process ver 3 (3)",
"url": "/json/workflow/assignment/list/accepted?processId=crm%233%23process1"
}]
} |
Description
Retrieves all pending assignments of current logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list/pending
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"id": "841_206_crm_process1_send_proposal",
"activityId": "841_206_crm_process1_send_proposal",
"processVersion": "3",
"serviceLevelMonitor": "-",
"processId": "206_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "04-09-2015 11:05 AM",
"label": "Send Proposal",
"activityName": "Send Proposal"
}, {
"id": "842_207_crm_process1_approve_proposal",
"activityId": "842_207_crm_process1_approve_proposal",
"processVersion": "3",
"serviceLevelMonitor": "-",
"processId": "207_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "04-09-2015 11:05 AM",
"label": "Approve Proposal",
"activityName": "Approve Proposal"
}, {
"id": "843_208_crm_process1_send_proposal",
"activityId": "843_208_crm_process1_send_proposal",
"processVersion": "3",
"serviceLevelMonitor": "-",
"processId": "208_crm_process1",
"description": "",
"processName": "Proposal Approval Process",
"due": "-",
"dateCreated": "04-09-2015 11:05 AM",
"label": "Send Proposal",
"activityName": "Send Proposal"
}]
} |
Description
Retrieves the number of all pending assignments of current logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/list/pending/count
Sample Result
Code Block | ||
---|---|---|
| ||
{"total":3} |
Description
Retrieves process list based on pending assignments of current logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http:/localhost:8080/jw/web/json/workflow/assignment/list/pending/process
Sample Result
Code Block | ||
---|---|---|
| ||
{
"data": [{
"count": 3,
"processVersion": "3",
"processName": "Proposal Approval Process",
"processDefId": "crm#3#process1",
"label": "Proposal Approval Process ver 3 (3)",
"url": "/json/workflow/assignment/list/accepted?processId=crm%233%23process1"
}]
} |
Description
Retrieves process information based on available assignment of current logged in user
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/process/view/208_crm_process1
Sample Result
Code Block | ||
---|---|---|
| ||
{
"activityId": "843_208_crm_process1_send_proposal",
"processVersion": "3",
"activityDefId": "send_proposal",
"processId": "208_crm_process1",
"assigneeId": "admin",
"description": "",
"processName": "Proposal Approval Process",
"dateCreated": "04-09-2015 03:05 AM",
"participant": "Requester",
"processDefId": "crm#3#process1",
"variable": {
"status": "approved"
},
"activityName": "Send Proposal"
} |
Description
Withdraws an accepted assignment
Note |
---|
Deprecated Since v3, the concept of accept & withdraw assignment is removed |
User Role
Anyone (Including anonymous)
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/withdraw/879_223_crm_process1_approve_proposal
Sample Result
Code Block | ||
---|---|---|
| ||
{
"activityId": "879_223_crm_process1_approve_proposal",
"status": "withdrawn"
} |
Description
Sets value of workflow variable of an assignment
User Role
Anyone (Including anonymous)
Method
HTTP POST
Parameters
Sample URL
Sample Result
Code Block | ||
---|---|---|
| ||
{"status":"variableSet"} |
Description
Retrieves information of an assignment
User Role
Anyone (Including anonymous)
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/assignment/view/843_208_crm_process1_send_proposal
Sample Result
Code Block | ||
---|---|---|
| ||
{
"activityId": "843_208_crm_process1_send_proposal",
"processVersion": "3",
"activityDefId": "send_proposal",
"processId": "208_crm_process1",
"assigneeId": "admin",
"description": "",
"processName": "Proposal Approval Process",
"dateCreated": "04-09-2015 03:05 AM",
"participant": "Requester",
"processDefId": "crm#3#process1",
"variable": {
"status": "approved"
},
"activityName": "Send Proposal"
} |
Description
Aborts a running process instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/process/abort/208_crm_process1
Sample Result
Code Block | ||
---|---|---|
| ||
{"status":"aborted","processId":"208_crm_process1"} |
Description
Gets latest Process def Id of a process based on a Process def Id
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/process/latest/crm:1:process1
Sample Result
Code Block | ||
---|---|---|
| ||
{"id":"crm#3#process1","encodedId":"crm:3:process1"} |
Description
Retrieves process list
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/process/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"desc": false,
"sort": "name",
"start": 0,
"data": [{
"id": "hdc_v1001#1#hdc_certification_process",
"packageName": "halal certification",
"name": "HDC Certification Process",
"packageId": "hdc_v1001",
"label": "HDC Certification Process ver 1",
"version": "1"
}, {
"id": "mdec_v1002#12#mdec_wp1",
"packageName": "Mdec Work Progress",
"name": "mdec_wp1",
"packageId": "mdec_v1002",
"label": "mdec_wp1 ver 12",
"version": "12"
}, {
"id": "mora#5#mora_new_application",
"packageName": "MORA Halal Certification",
"name": "MORA New Application",
"packageId": "mora",
"label": "MORA New Application ver 5",
"version": "5"
}]
} |
Description
Retrieve first process with details of every packages
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http:/localhost:8080/jw/web/json/workflow/process/list/package
Sample Result
Code Block |
---|
{
"data": [{
"id": "hr_expense",
"count": 2,
"processVersion": "3",
"packageName": "HR Expenses Claim App",
"processId": "hr_expense#3#process1",
"processName": "Expense Approval Process",
"packageId": "hr_expense",
"label": "HR Expenses Claim App",
"url": "/json/workflow/process/list?packageId=hr_expense"
}, {
"id": "isr",
"count": 1,
"processVersion": "2",
"packageName": "ISR",
"processId": "isr#2#isr",
"processName": "ISR Process",
"packageId": "isr",
"label": "ISR",
"url": "/json/workflow/process/list?packageId=isr"
}, {
"id": "hrleave",
"count": 2,
"processVersion": "1",
"packageName": "JINC Leave Solution",
"processId": "hrleave#1#la",
"processName": "Leave Application System",
"packageId": "hrleave",
"label": "JINC Leave Solution",
"url": "/json/workflow/process/list?packageId=hrleave"
}]
} |
Description
Starts a process based on process start whitelist
User Role
Anyone (Including anonymous)
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/process/start/crm:3:process1
Sample Result
Code Block | ||
---|---|---|
| ||
{"activityId":"885_224_crm_process1_approve_proposal","processId":"224_crm_process1"} |
Description
Sets workflow variable of a process instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/process/variable/208_crm_process1/status?value=test
Sample Result
Code Block | ||
---|---|---|
| ||
{"status" : "variableSet"} |
Description
Retrieves information of a process definition
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/process/view/crm:3:process1
Sample Result
Code Block | ||
---|---|---|
| ||
{
"packageName": "CRM",
"processId": "crm#3#process1",
"name": "Proposal Approval Process",
"packageId": "crm",
"version": "3"
} |
Description
Retrieves all variables of a process instance
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/variable/list/208_crm_process1
Sample Result
Code Block | ||
---|---|---|
| ||
{
"processId": "208_crm_process1",
"variable": {
"status": "approved"
}
} |
Description
Aborts an activity of a process instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/abort/208_crm_process1/send_proposal
Sample Result
Code Block | ||
---|---|---|
| ||
{"activityDefId":"send_proposal","status":"aborted","processId":"208_crm_process1"} |
Description
Retrieves a list of all activities
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/list?processId=116_hr_expense_process1
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"id": "474_116_hr_expense_process1_approve_claim",
"serviceLevelMonitor": "-",
"name": "Approve Claim",
"state": "open.not_running.not_started",
"dateCreated": "15-07-2015 02:54 AM"
}, {
"id": "472_116_hr_expense_process1_new_claim",
"serviceLevelMonitor": "-",
"name": "Edit Claim",
"state": "closed.completed",
"dateCreated": "15-07-2015 02:53 AM"
}, {
"id": "473_116_hr_expense_process1_tool4",
"serviceLevelMonitor": "-",
"name": "Update Record Status to Submitted",
"state": "closed.completed",
"dateCreated": "15-07-2015 02:54 AM"
}]
} |
Description
Reassigns a user to replace another user assigned to an assignment
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/reassign?activityId=841_206_crm_process1_send_proposal&username=admin&replaceUser=cat
Sample Result
Code Block | ||
---|---|---|
| ||
{"activityId":"841_206_crm_process1_send_proposal","username":"admin","replaceUser":"cat"} |
Description
Reevaluates an activity
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/reevaluate?activityId=841_206_crm_process1_send_proposal
Description
Starts an activity in a running process instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/start/116_hr_expense_process1/verify_claim
Sample Result
Code Block | ||
---|---|---|
| ||
{"result":true,"activityDefId":"verify_claim","processId":"116_hr_expense_process1"} |
Description
Sets value to a workflow variable to a running activity instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/variable/474_116_hr_expense_process1_approve_claim/status?value=test
Sample Result
Code Block | ||
---|---|---|
| ||
{"status":"variableSet"} |
Description
Retrieves information of an activity instance
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/activity/view/474_116_hr_expense_process1_approve_claim
Sample Result
Code Block | ||
---|---|---|
| ||
{
"processId": "116_hr_expense_process1",
"serviceLevelMonitor": "-",
"createdTime": "Wed Jul 15 10:54:10 MYT 2015",
"processName": "Expense Approval Process",
"assignee": "admin",
"activityId": "474_116_hr_expense_process1_approve_claim",
"activityDefId": "approve_claim",
"processVersion": "1",
"processDefId": "hr_expense#1#process1",
"participant": "approver",
"finishTime": "",
"variable": {
"status": "test"
},
"activityName": "Approve Claim",
"dueDate": ""
} |
Description
Retrieves a list of all completed process instances
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/monitoring/completed/process/list?rows=3
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 74,
"data": [{
"id": "133_hr_expense_process1",
"serviceLevelMonitor": "-",
"requesterId": "admin",
"name": "Expense Approval Process",
"state": "closed.aborted",
"due": "-",
"startedTime": "29-07-2015 01:46 AM",
"version": "2"
}, {
"id": "135_crm_process1",
"serviceLevelMonitor": "-",
"requesterId": "admin",
"name": "Proposal Approval Process",
"state": "closed.aborted",
"due": "-",
"startedTime": "04-08-2015 09:28 AM",
"version": "2"
}, {
"id": "136_crm_process1",
"serviceLevelMonitor": "-",
"requesterId": "admin",
"name": "Proposal Approval Process",
"state": "closed.aborted",
"due": "-",
"startedTime": "04-08-2015 09:31 AM",
"version": "2"
}]
} |
Description
Copies the state and workflow variables of a running process instance to start a new process instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/process/copy/116_hr_expense_process1/hr_expense:1:process1
Sample Result
Code Block | ||
---|---|---|
| ||
{
"processId": "228_hr_expense_process1",
"processDefId": "hr_expense#1#process1",
"activities": [ "896_228_hr_expense_process1_approve_claim" ]
} |
Description
Sets a value to workflow variable of a process instance
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/process/variable/224_crm_process1/status?value=test
Sample Result
Code Block | ||
---|---|---|
| ||
{"status":"variableSet"} |
Description
Retrieves information of a process instance
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/process/view/224_crm_process1
Sample Result
Code Block | ||
---|---|---|
| ||
{
"requester": "admin",
"serviceLevelMonitor": "-",
"processId": "224_crm_process1",
"name": "Proposal Approval Process",
"finishTime": "",
"states": ["open.running", "open.running"],
"packageId": "crm",
"processDefId": "crm#3#process1",
"dueDate": "",
"startedTime": "",
"version": "3"
} |
Description
Completes a running activity
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/running/activity/complete?processDefId=crm:3:process1&processId=224_crm_process1&activityId=885_224_crm_process1_approve_proposal
Description
Reassigns a user to replace another user assigned to an assignment
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/running/activity/reassign?processDefId=crm:3:process1&processId=227_crm_process1&activityId=890_227_crm_process1_approve_proposal&username=cat&replaceUser=admin
Description
Retrieves a list of all running process instances
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/monitoring/running/process/list?packageId=crm&rows=3
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 16,
"data": [{
"id": "118_crm_process1",
"serviceLevelMonitor": "-",
"requesterId": "admin",
"name": "Proposal Approval Process",
"state": "open.running",
"due": "-",
"startedTime": "21-07-2015 03:03 AM",
"version": "1"
}, {
"id": "119_crm_process1",
"serviceLevelMonitor": "-",
"requesterId": "admin",
"name": "Proposal Approval Process",
"state": "open.running",
"due": "-",
"startedTime": "21-07-2015 03:03 AM",
"version": "1"
}, {
"id": "120_crm_process1",
"serviceLevelMonitor": "-",
"requesterId": "admin",
"name": "Proposal Approval Process",
"state": "open.running",
"due": "-",
"startedTime": "21-07-2015 03:03 AM",
"version": "1"
}]
} |
Description
Reevaluates all assignments of an user
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/monitoring/user/reevaluate?username=cat
Description
Retrieve first process with details of every packages
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/activity/sla/list?appId=crm
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"ratioOnTime": 100,
"activityDefId": "approval",
"serviceLevelMonitor": "<span class=\"dot_green\"> <\/span>",
"minDelay": 0,
"ratioWithDelay": 0,
"maxDelay": 0,
"activityName": "Approval"
}, {
"ratioOnTime": 100,
"activityDefId": "parallel",
"serviceLevelMonitor": "<span class=\"dot_green\"> <\/span>",
"minDelay": 0,
"ratioWithDelay": 0,
"maxDelay": 0,
"activityName": "Parallel"
}, {
"ratioOnTime": 100,
"activityDefId": "route1",
"serviceLevelMonitor": "<span class=\"dot_green\"> <\/span>",
"minDelay": 0,
"ratioWithDelay": 0,
"maxDelay": 0,
"activityName": "Route 1"
}]
} |
Description
Retrieves a list of audit trail
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/workflow/audittrail/list?rows=5
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3225,
"data": [{
"timestamp": "25-06-2015 07:41 AM",
"message": "Authentication for user admin: true",
"id": "2c90a1574e29523a014e29aa77590000",
"username": "anonymousUser",
"method": "authenticate",
"clazz": "org.joget.apps.workflow.security.WorkflowAuthenticationProvider"
}, {
"timestamp": "25-06-2015 08:41 AM",
"message": "Authentication for user admin: true",
"id": "2c90a1574e29e104014e29e178080000",
"username": "anonymousUser",
"method": "authenticate",
"clazz": "org.joget.apps.workflow.security.WorkflowAuthenticationProvider"
}, {
"timestamp": "25-06-2015 08:55 AM",
"message": "testProcess",
"id": "2c90a1574e29e81c014e29eddb7a0000",
"username": "admin",
"method": "processUpload",
"clazz": "org.joget.workflow.model.service.WorkflowManagerImpl"
}, {
"timestamp": "25-06-2015 08:55 AM",
"message": "50_testProcess_process1",
"id": "2c90a1574e29e81c014e29eddecf0001",
"username": "anonymousUser",
"method": "processCompleted",
"clazz": "org.joget.workflow.model.service.WorkflowManagerImpl"
}, {
"timestamp": "25-06-2015 08:55 AM",
"message": "50_testProcess_process1",
"id": "2c90a1574e29e81c014e29edded80002",
"username": "anonymousUser",
"method": "processCompleted",
"clazz": "org.joget.workflow.model.service.WorkflowManagerImpl"
}]
} |
Description
Retrieves all department
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/dept/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 7,
"data": [{
"id": "D-001",
"description": "",
"name": "CEO Office",
"organization.name": "Joget.Org",
"parent.name": ""
}, {
"id": "D-002",
"description": "",
"name": "Human Resource and Admin",
"organization.name": "Joget.Org",
"parent.name": ""
}, {
"id": "D-003",
"description": "",
"name": "Finance",
"organization.name": "Joget.Org",
"parent.name": ""
}, {
"id": "D-004",
"description": "",
"name": "Marketing",
"organization.name": "Joget.Org",
"parent.name": ""
}, {
"id": "D-005",
"description": "",
"name": "Product Development",
"organization.name": "Joget.Org",
"parent.name": ""
}, {
"id": "D-006",
"description": "",
"name": "Training and Consulting",
"organization.name": "Joget.Org",
"parent.name": ""
}, {
"id": "D-007",
"description": "",
"name": "Support and Services",
"organization.name": "Joget.Org",
"parent.name": ""
}]
} |
Description
Retrieves all user with employment details
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/employment/list?name=j
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 2,
"data": [{
"grade.name": "Managers",
"user.firstName": "Jack",
"user.id": "jack",
"role": null,
"user.lastName": "Drake",
"organization.name": "Joget.Org",
"employeeCode": null,
"user.username": "jack",
"department.name": "Training and Consulting"
}, {
"grade.name": "Executives",
"user.firstName": "Julia",
"user.id": "julia",
"role": null,
"user.lastName": "Kapatelis",
"organization.name": "Joget.Org",
"employeeCode": null,
"user.username": "julia",
"department.name": "Human Resource and Admin"
}]
} |
Description
Retrieves all users not belong to any organization
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/employment/noHaveOrganization/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"user.firstName": "Admin",
"user.id": "admin",
"role": "",
"user.lastName": "",
"employeeCode": "",
"user.username": "admin"
}
} |
Description
Retrieves all users not belong to a department
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/employment/noInDept/list?orgId=ORG-001&deptId=D-003&name=j
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"grade.name": "Executives",
"user.firstName": "Cat",
"user.id": "cat",
"role": "",
"user.lastName": "Grant",
"employeeCode": "",
"user.username": "cat",
"department.name": "Product Development"
}, {
"grade.name": "Managers",
"user.firstName": "Jack",
"user.id": "jack",
"role": null,
"user.lastName": "Drake",
"employeeCode": null,
"user.username": "jack",
"department.name": "Training and Consulting"
}, {
"grade.name": "Executives",
"user.firstName": "Julia",
"user.id": "julia",
"role": null,
"user.lastName": "Kapatelis",
"employeeCode": null,
"user.username": "julia",
"department.name": "Human Resource and Admin"
}]
} |
Description
Retrieves all users not belong to a grade
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/employment/noInGrade/list?orgId=ORG-001&gradeId=G-003&name=c
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"grade.name": "Managers",
"user.firstName": "Clark",
"user.id": "clark",
"role": null,
"user.lastName": "Kent",
"employeeCode": null,
"user.username": "clark",
"department.name": "Product Development"
}, {
"grade.name": "Managers",
"user.firstName": "Jack",
"user.id": "jack",
"role": null,
"user.lastName": "Drake",
"employeeCode": null,
"user.username": "jack",
"department.name": "Training and Consulting"
}, {
"grade.name": "Managers",
"user.firstName": "David",
"user.id": "david",
"role": null,
"user.lastName": "Cain",
"employeeCode": null,
"user.username": "david",
"department.name": "Support and Services"
}]
} |
Description
Retrieves all groups
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/group/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"id": "G-001",
"description": "",
"name": "Managers",
"organization.name": ""
}, {
"id": "G-002",
"description": "",
"name": "CxO",
"organization.name": ""
}, {
"id": "G-003",
"description": "",
"name": "hrAdmin",
"organization.name": ""
}]
} |
Description
Retrieves all grades
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/grade/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 3,
"data": [{
"id": "G-001",
"description": "",
"name": "Board Members"
}, {
"id": "G-002",
"description": "",
"name": "Managers"
}, {
"id": "G-003",
"description": "",
"name": "Executives"
}]
} |
Description
Retrieves all organizations
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/organization/list
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"id": "ORG-001",
"description": "",
"name": "Joget.Org"
}
} |
Description
Retrieves all sub department of a department
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/subdept/list?deptId=D-001
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"id": "sub",
"description": "",
"name": "Sub Department"
}
} |
Description
Retrieves all departments and grades in an organization
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/directory/admin/user/deptAndGrade/options?orgId=ORG-001
Sample Result
Code Block | ||
---|---|---|
| ||
{
"departments": [{
"id": "",
"name": "",
"prefix": ""
}, {
"id": "D-001",
"prefix": "",
"name": "CEO Office"
}, {
"id": "D-003",
"prefix": "",
"name": "Finance"
}, {
"id": "D-002",
"prefix": "",
"name": "Human Resource and Admin"
}, {
"id": "D-004",
"prefix": "",
"name": "Marketing"
}, {
"id": "D-005",
"prefix": "",
"name": "Product Development"
}, {
"id": "D-007",
"prefix": "",
"name": "Support and Services"
}, {
"id": "D-006",
"prefix": "",
"name": "Training and Consulting"
}],
"grades": [{
"id": "",
"name": "",
"prefix": ""
}, {
"id": "G-001",
"name": "Board Members"
}, {
"id": "G-003",
"name": "Executives"
}, {
"id": "G-002",
"name": "Managers"
}]
} |
Description
Retrieves the groups that a user is in or not in.
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/user/group/list?userId=admin
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"id": "G-001",
"description": "",
"name": "Managers",
"organization.name": ""
}
} |
Description
Retrieves a list of users
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/user/list?groupId=G-002
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"data": {
"id": "terry",
"lastName": "Berg",
"username": "terry",
"email": "",
"active": "Active",
"firstName": "Terry"
}
} |
Description
Retrieves a list of user not in a group
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/directory/admin/user/notInGroup/list?groupId=G-002
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 4,
"data": [{
"id": "admin",
"lastName": "",
"username": "admin",
"email": "",
"firstName": "Admin"
}, {
"id": "cat",
"lastName": "Grant",
"username": "cat",
"email": "owen@joget.org",
"firstName": "Cat"
}, {
"id": "clark",
"lastName": "Kent",
"username": "clark",
"email": "",
"firstName": "Clark"
}, {
"id": "david",
"lastName": "Cain",
"username": "david",
"email": "",
"firstName": "David"
}]
} |
Description
To single sign on a user
User Role
Anonymous
Method
HTTP GET/POST, support HTTP basic authentication
Parameters
Sample URL
http://localhost:8080/jw/web/json/directory/user/sso?username=admin&password=admin
Sample Result
Code Block | ||
---|---|---|
| ||
{"username":"admin","isAdmin":"true"} |
Description
Retrieves the username of current logged in user
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/currentUsername
Sample Result
Code Block | ||
---|---|---|
| ||
{"username":"admin"} |
Description
Retrieves a list of plugins
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/plugin/list?start=0&rows=5
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 140,
"start": 0,
"data": [{
"id": "org.joget.plugin.enterprise.AjaxSubForm",
"description": "AJAX Subform Element",
"name": "AJAX Subform",
"version": "5.0.0"
}, {
"id": "org.joget.plugin.enterprise.AdminUserviewPermission",
"description": "",
"name": "Is Admin",
"version": "5.0.0"
}, {
"id": "org.joget.plugin.enterprise.AdvancedFormRowDataListBinder",
"description": "Retrieves data rows from a form table.",
"name": "Advanced Form Data Binder",
"version": "5.0.0"
}, {
"id": "org.joget.plugin.enterprise.AdvancedGrid",
"description": "Advanced Grid Element",
"name": "Advanced Grid",
"version": "5.0.0"
}, {
"id": "org.joget.plugin.enterprise.AnonymousUserviewPermission",
"description": "",
"name": "Is Anonymous",
"version": "5.0.0"
}]
} |
Description
Retrieves a list of OSGI plugins
User Role
Admin
Method
HTTP GET/POST
Parameters
start - where rows start from
rows - number of rows per page
Sample URL
http://localhost:8080/jw/web/json/plugin/listOsgi?start=0&rows=10
Sample Result
Code Block | ||
---|---|---|
| ||
{
"total": 1,
"start": 0,
"data": {
"id": "test.directory.TestDirectoryManager",
"description": "Test Directory Manager",
"name": "Test Directory Manager",
"version": "1.0.0"
}
} |
Description
Retrieves options of plugins based on a plugin type abstract class or interface
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/property/json/getElements?classname=org.joget.plugin.base.DefaultApplicationPlugin
Sample Result
Code Block | ||
---|---|---|
| ||
[{
"value": "",
"label": ""
}, {
"value": "org.joget.apps.app.lib.DatabaseUpdateTool",
"label": "Database Update Tool"
}, {
"value": "org.joget.apps.app.lib.EmailTool",
"label": "Email Tool"
}, {
"value": "org.joget.apps.app.lib.JsonTool",
"label": "Json Tool"
}] |
Description
Retrieves the Plugin Properties Options of a plugin
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/property/json/getPropertyOptions?value=org.joget.apps.app.lib.BeanShellTool
Sample Result
Code Block | ||
---|---|---|
| ||
[{
title: 'Configure Bean Shell',
properties: [{
name: 'script',
label: 'Script',
type: 'codeeditor',
required: 'True',
mode: 'java'
}]
}] |
Description
Retrieves the default Plugin Properties Options of a plugin based on App Definition meta
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/property/json/crm/getDefaultProperties?value=org.joget.apps.app.lib.EmailTool
Sample Result
Code Block | ||
---|---|---|
| ||
{
"host": "smtp.gmail.com",
"port": "456",
"security": "SSL",
"username": "test@gmail.com",
"password": "test",
"from": "test@gmail.com",
"toSpecific": "",
"toParticipantId": "",
"cc": "",
"bcc": "",
"subject": "",
"message": "",
"isHtml": "",
"formDefId": "",
"fields": [],
"files": []
} |
Description
Retrieves the Plugin Properties Options of a plugin with App Definition meta
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/property/json/crm/getPropertyOptions?value=org.joget.apps.app.lib.BeanShellTool
Sample Result
Code Block | ||
---|---|---|
| ||
[{
title: 'Configure Bean Shell',
properties: [{
name: 'script',
label: 'Script',
type: 'codeeditor',
required: 'True',
mode: 'java'
}]
}] |
Description
Verifies a URL is valid
User Role
Admin
Method
HTTP HEAD
Parameters
Sample URL
http://localhost:8080/jw/web/json/apps/verify?url=http%3A%2F%2Fwww.joget.org
Description
Retrieves all messages added in Manage Messages
User Role
Admin
Method
HTTP GET/POST
Parameters
sort - (Optional) column name to be sorted
desc - (Optional) Boolean value to determine whether to sort by ascending or descending order (true equals to descending)
start - (Optional) where rows start from
rows - (Optional) number of rows per page
Sample URL
http://localhost:8080/jw/web/json/console/setting/message/list
Sample Result
Code Block | ||
---|---|---|
| ||
{"total":1,"data":{"message":"搜索","id":"402880824fb19a77014fb5025ed80002","locale":"zh_CN","key":"general.method.label.search"}} |
Description
Retrieves all available Hash Variable syntax
User Role
Admin
Method
HTTP GET/POST
Sample URL
http://localhost:8080/jw/web/json/hash/options
Sample Result
Code Block | ||
---|---|---|
| ||
["assignment.activityDefId", "assignment.activityId", "assignment.activityName", "assignment.assigneeId", "assignment.processDefId", "assignment.processId",
"assignment.processName", "assignment.processRequesterId", "assignment.processVersion", "currentUser.active", "currentUser.email", "currentUser.firstName",
"currentUser.lastName", "currentUser.timeZone", "currentUser.username", "date.DAY+INTEGER.FORMAT", "date.DAY-INTEGER.FORMAT", "date.FORMAT", "date.MONTH+INTEGER.FORMAT",
"date.MONTH-INTEGER.FORMAT", "date.YEAR+INTEGER.FORMAT", "date.YEAR-INTEGER.FORMAT", "envVariable.KEY", "form.TABLE.COLUMN", "form.TABLE.COLUMN[PRIMARY_KEY]", "i18n.KEY",
"performer.ACTIVITY_DEF_ID.active", "performer.ACTIVITY_DEF_ID.email", "performer.ACTIVITY_DEF_ID.firstName", "performer.ACTIVITY_DEF_ID.id", "performer.ACTIVITY_DEF_ID.lastName",
"performer.ACTIVITY_DEF_ID.timeZone", "performer.ACTIVITY_DEF_ID.username", "request.characterEncoding", "request.contextPath", "request.header.NAME", "request.locale",
"request.method", "request.pathInfo", "request.protocol", "request.queryString", "request.remoteAddr", "request.requestURI", "request.requestURL", "request.requestedSessionId",
"request.scheme", "request.serverName", "request.serverPort", "request.servletPath", "requestParam.KEY", "user.USERNAME.active", "user.USERNAME.email", "user.USERNAME.firstName",
"user.USERNAME.lastName", "user.USERNAME.timeZone", "variable.KEY"] |
Description
To tests a JDBC connection
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/workflow/testConnection?datasource=default&driver=com.mysql.jdbc.Driver&url=jdbc%3Amysql%3A%2F%2Flocalhost%3A3306%2Fjwdb%3FcharacterEncoding%3DUTF-8&user=root&password=
Sample Result
Code Block | ||
---|---|---|
| ||
{"success":true,"datasource":"default"} |
...