Workflow definition overview
Log in to add to favouritesProperties
| Name | Type | Format | Description |
|---|---|---|---|
| id | string | A unique workflow definition identifier. | |
| uuid | string | uuid | The workflow definition identifier as a 128 bit GUID. |
| projectId | string | The project identifier, e.g. "movieDb". Found in the project overview screen of the management console. | |
| name | object | localized value | The friendly name given to the workflow definition. |
| description | object | localized value | The description text given to the workflow definition. |
| states | object[...] | A collection of states that an entry with the workflow definition may have. | |
| eventGroup | object[...] | event group | A collection of event groups for events within the states. |
| isSystem | boolean | Indicates whether the workflow definition is predefined and read only (true) or a custom definition (false). | |
| version | object | version | Version information about the workflow definition. |
Example
This example shows a custom approval workflow definition.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257{
"uuid": "e7d8611a-88d6-44b3-8910-c894f1d6a42a",
"id": "CustomEntryApproval",
"projectId": "website",
"name": {
"en-GB": "Custom Approval workflow"
},
"description": {
"en-GB": "A custom workflow for entries with approval"
},
"states": [
{
"id": "draft",
"name": {
"en-GB": "Draft"
},
"events": [
{
"id": "submit",
"name": {
"en-GB": "Send for approval"
},
"auditText": {
"en-GB": "Sent for approval"
},
"description": {
"en-GB": "Send the entry for approval"
},
"transitionTo": "awaitingApproval",
"color": "green",
"groupId": "submitRevoke",
"uiAction": "navigateToEntryListing",
"validate": true,
"parameters": [
{
"id": "message",
"name": {
"en-GB": "Add an optional message for the approver"
},
"dataType": "string",
"dataFormat": null,
"description": {
"en-GB": "The message included with the entry submission"
},
"default": null,
"validations": {},
"editor": {
"id": "multiline",
"instructions": {
"en-GB": "Optionally include a message to let an approver understand your changes"
},
"properties": null
}
}
]
}
],
"color": "cobalt",
"uiEditorView": "default"
},
{
"id": "awaitingApproval",
"name": {
"en-GB": "Awaiting approval"
},
"events": [
{
"id": "revoke",
"name": {
"en-GB": "Revoke and edit"
},
"auditText": {
"en-GB": "Revoked"
},
"description": {
"en-GB": "Revoke the entry submission"
},
"transitionTo": "draft",
"color": "white",
"groupId": "submitRevoke",
"uiAction": "none",
"validate": false,
"parameters": []
},
{
"id": "decline",
"name": {
"en-GB": "Decline"
},
"auditText": {
"en-GB": "Declined"
},
"description": {
"en-GB": "Decline the entry for approval"
},
"transitionTo": "declined",
"color": "red",
"groupId": "approveDecline",
"uiAction": "navigateToEntryListing",
"validate": false,
"parameters": [
{
"id": "message",
"name": {
"en-GB": "Add a message to explain to the author why this content is being declined"
},
"dataType": "string",
"dataFormat": null,
"description": {
"en-GB": "The decline reason"
},
"default": null,
"validations": {
"required": {
"message": {
"en-GB": "The decline reason is required"
}
}
},
"editor": {
"id": "multiline",
"instructions": {
"en-GB": "Include a message to let an approver know your changes"
},
"properties": null
}
}
]
},
{
"id": "approve",
"name": {
"en-GB": "Approve"
},
"auditText": {
"en-GB": "Approved"
},
"description": {
"en-GB": "Approve the entry changes for publishing"
},
"transitionTo": "sysWorkflow",
"color": "green",
"groupId": "approveDecline",
"uiAction": "navigateToEntryListing",
"validate": false,
"parameters": [],
"invokableWhen": [
{
"field": "isScheduledForPublish()",
"equalTo": false
}
]
},
{
"id": "scheduledApprove",
"name": {
"en-GB": "Approve and schedule"
},
"auditText": {
"en-GB": "Approved and scheduled"
},
"description": {
"en-GB": "Approve the entry changes for publishing"
},
"transitionTo": "sysWorkflow",
"color": "green",
"groupId": "approveDecline",
"uiAction": "navigateToEntryListing",
"validate": false,
"parameters": [],
"invokableWhen": [
{
"field": "isScheduledForPublish()",
"equalTo": true
}
]
}
],
"color": "yellow",
"uiEditorView": "previousPublishedVersionCompare",
"allowUpdates": false
},
{
"id": "declined",
"name": {
"en-GB": "Declined"
},
"events": [
{
"id": "submit",
"name": {
"en-GB": "Re-submit"
},
"auditText": {
"en-GB": "Re-submitted for approval"
},
"description": {
"en-GB": "Re-submit the entry for approval"
},
"transitionTo": "awaitingApproval",
"color": "green",
"groupId": "submitRevoke",
"uiAction": "navigateToEntryListing",
"validate": true,
"parameters": [
{
"id": "message",
"name": {
"en-GB": "Message"
},
"dataType": "string",
"dataFormat": null,
"description": {
"en-GB": "The message included with the entry re-submission"
},
"default": null,
"validations": {},
"editor": {
"id": "multiline",
"instructions": {
"en-GB": "Include a message to let an approver understand the reasons for the re-submisson"
},
"properties": null
}
}
]
}
],
"color": "red",
"uiEditorView": "default"
}
],
"eventGroups": [
{
"id": "submitRevoke",
"name": {
"en-GB": "Submit / revoke"
}
},
{
"id": "approveDecline",
"name": {
"en-GB": "Approve / decline"
}
}
],
"isSystem": true,
"version": {
"createdBy": "",
"created": "0001-01-01T00:00:00",
"modifiedBy": "",
"modified": "0001-01-01T00:00:00",
"publishedBy": null,
"published": null,
"versionNo": "0.1"
}
}