Joget DX 8 Stable Released
The stable release for Joget DX 8 is now available, with a focus on UX and Governance.
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.
Form Data API and List Data API are newly added feature in Joget Workflow v6.
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
[{ "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
Executes a generator plugin based on a form
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/app/crm/generator/crm_account/generate?plugin=org.joget.plugin.enterprise.CrudGenerator
Sample Result
{ "message": "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
{ "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
{ "apps": [{ "processes": [{ "id": "crm#3#process1", "processVersion": "3", "appVersion": 2, "name": "Proposal Approval Process", "idWithoutVersion": "process1", "url": "/jw/web/client/app/crm/2/process/process1?start=true" }], "id": "crm", "name": "CRM", "version": 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
{ "apps": [{ "id": "crm", "name": "CRM", "userviews": [{ "id": "crm_userview_sales", "description": "", "name": "CRM: Sales Force Automation", "url": "/jw/web/userview/crm/crm_userview_sales", "version": 2 }], "version": 2 }] }
Description
Retrieves all apps
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/list?name=crm
Sample Result
{ "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
{ "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
{ "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
{ "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
{ "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
[{ "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
{ "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
{ "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
[{ "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
{"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
{ "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
{ "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
{ "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
[{ "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
{ "data": [{ "packageId": "crm", "packageName": "CRM" }, { "packageId": "helpdesk", "packageName": "Helpdesk" }] }
Description
Accept an assigned assignment
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
{ "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
{ "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/complete/879_223_crm_process1_approve_proposal ?var_status=Sent
Sample Result
{ "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
{ "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
{"total":10}
Description
Retrieves all accepted assignments of current logged in user
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
{ "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
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
{"total":3}
Description
Retrieves processes list based on accepted assignment of current logged in user
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
{ "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
{ "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
{"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
{ "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
{ "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
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
{ "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
{"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
{ "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
{"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
{"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
{ "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
{ "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
{"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
{"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
{ "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
{ "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
{"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
{ "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
{"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
{"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
{"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
{ "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
{ "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
{ "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
{"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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{ "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
{"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
{"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
{ "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
{ "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
[{ "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 插件属性选项与配置 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
[{ title: 'Configure Bean Shell', properties: [{ name: 'script', label: 'Script', type: 'codeeditor', required: 'True', mode: 'java' }] }]
Description
Retrieves the default 插件属性选项与配置 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
{ "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 插件属性选项与配置 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
[{ 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
{"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
["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
{"success":true,"datasource":"default"}
Description
Load a specific form record
User Role
Admin
Method
HTTP GET/POST
Parameters
includeSubformData - Optional, set to true to recursively include subform data
includeReferenceElements - Optional, set to true to include data from reference elements e.g. selectbox, etc.
flatten - Optional, set to true to flatten data into a one level key-value map
Sample URL
http://localhost:8080/jw/web/json/data/form/load/crm/crm_account/001
Sample cURL Request
curl -v -d "j_username=admin&j_password=admin" "http://localhost:8080/jw/web/json/data/form/load/crm/crm_account/001?includeSubformData=true&includeReferenceElements=true&flatten=true"
Sample Response
{ "country": "", "dateCreated": "27-07-2015 04:26 AM", "address": "", "accountName": "001", "city": "", "dateModified": "20-10-2016 04:36 AM", "id": "001", "state": "" }
Description
Create or update a form record
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/data/form/store/crm/crm_account/001
Sample cURL Request
curl -v -X POST -d "j_username=admin&j_password=admin&accountName=001%Updated&address=001%20Address" http://localhost:8080/jw/web/json/data/form/store/crm//crm_account/001
or
curl -v --header "Authorization: Basic YWRtaW46YWRtaW4=" -F "accountName=001 Updated" -F "address=001 Address" http://localhost:8080/jw/web/json/data/form/store/crm//crm_account/001
Sample Response
{ "id": "001" }
Description
Delete an existing form record
User Role
Admin
Method
HTTP POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/data/form/delete/crm/crm_account/001
Sample cURL Request
curl -v -X POST -d "j_username=admin&j_password=admin" http://localhost:8080/jw/web/json/data/form/delete/crm//crm_account/001
Sample Response
{ "id": "001" }
Description
Load a specific form record
User Role
Admin
Method
HTTP GET/POST
Parameters
Sample URL
http://localhost:8080/jw/web/json/data/list/crm/crm_account_list
Sample cURL Request
curl -v -d "j_username=admin&j_password=admin" http://localhost:8080/jw/web/json/data/list/crm/crm_account_list?start=0&rows=20
Sample Response
{ "total": 3, "data": [{ "country": "", "accountName": "001 Updated", "id": "001", "state": "" }, { "country": "", "accountName": "002", "id": "002", "state": "" }, { "country": "", "accountName": "003", "id": "003", "state": "" }] }