Skip to main content
Browse Documentation
HTTP - Management

Workflow definition event parameter

Created by c.neale, last modified by j.moore on 17 Dec 2020

A parameter which defines a message to be displayed in the Contensis UI when a workflow event is triggered, and validation to be performed.

 

Currently the only editor supported for use in workflow definitions is the multiline editor, which displays a customisable message to the user when the parent event is triggered to prompt the user to enter text, e.g. when submitting an entry for approval. This editor can be used in conjunction with the required validation to make entering text mandatory.

Properties

NameData typeData formatDescription
idstringThe identifier for the parameter.
nameobjectlocalized valueThe friendly name given to the parameter.
descriptionobjectlocalized valueThe description given to the parameter.
dataTypestringThis should be set to "string".
defaultobjectThis should be set to null.
validationsobject[...]validationThe validation to be used.
editorobjecteditorThe editor to be used.

Example

This example shows a parameter as used in a workflow definition.

{
    "id": "message",
    "name": {
        "en-GB": "Add an optional message for the approver"
    },
    "description": {
        "en-GB": "The message included with the entry submission"
    },
    "dataType": "string",
    "dataFormat": null,
    "default": null,
    "validations": {
        "required": {
            "message": {
                "en-GB": "The reason is required"
            }
        }
    },
    "editor": {
        "id": "multiline",
        "instructions": {
            "en-GB": "Optionally include a message to let an approver understand your changes"
        },
        "properties": null
    }
}