Skip to content

Class: metadata

Object workflows apply to a single object lifecycle and a single object.

AttributeMetadataDescription
labelType: String
Required
Max length: 40
UI-friendly string in the Vault's base language.
activeType: Boolean
Required
Indicates whether the component is active.
object_lifecyclesType: Component
Required
Multi-value
The Objectlifecycle to which this workflow belongs. The Objectlifecycle must be associated with an Object.
document_content_lifecycleType: ComponentFor document workflows only, the Doclifecycle to which this workflow belongs. Must be empty for all other workflow types.
record_content_lifecycleType: ComponentFor object workflows only, the Objectlifecycle to which this workflow belongs. Must be empty for all other workflow types.
descriptionType: String
Max length: 255
Description of the workflow.
auto_startType: BooleanIf true, this workflow can be auto-started from an event action or entry action.
envelope_name_formatType: String
Max length: 128
The format used to auto-number envelope workflows in Vaults where auto-numbering is configured.
cancellation_commentType: BooleanIf true, the Confirm Cancellation dialog includes a space where users can provide a reason for the cancellation.
workflow_variablesType: XMLString
Max length: 32000
Admin-defined variables which workflow initiators can select at the start of a workflow.
workflow_content_typeType: Enum
Allowed values:
  • Document
  • Object
Indicates the type, objects or documents, of the workflow’s contents.
classType: Enum
Allowed values:
  • ReadAndUnderstood
Indicates the classification of the workflow.
cardinalityType: Enum
Allowed values:
  • One
  • OneOrMany
Indicates how many contents can be included in a workflow.
show_fieldsType: BooleanFor ReadAndUnderstood workflows created in v21.2+, if set to false, document fields are hidden and cannot be updated while the workflow is in progress. If the value is true or null, document fields are shown as usual. For workflows created in v21.1 and lower, or if class is not ReadAndUnderstood, this must be blank.
bound_create_draftType: BooleanFor document workflows only, if set to true, the Create Draft action increments the document’s minor version while the active workflow remains on the previous major document version. The default value for document workflows is false. Must be empty or null for object and R&U workflows.
users_can_only_complete_one_taskType: BooleanIndicates if users can complete more than one task in this workflow. If true, users can only complete one task in this workflow. If false, users can complete multiple tasks in this workflow. Defaults to false.
roles_cannot_complete_taskType: String
Max length: 1500
If this workflow is configured to exclude specific roles from participating, this field indicates the role names which are not allowed to participate.
disallowed_workflow_owner_actionsType: Enum
Multi-value
Allowed values:
  • cancel_workflow
  • email_participants
  • remove_content
  • update_participants
  • update_workflow_due_date
  • cancel_task
  • reassign_task
  • update_task_due_date
Actions not allowed for the workflow owner.
disallowed_non_task_owner_actionsType: Enum
Multi-value
Allowed values:
  • cancel_workflow
  • email_participants
  • remove_content
  • update_participants
  • update_workflow_due_date
  • cancel_task
  • reassign_task
  • update_task_due_date
Actions only allowed for the task owner.
disallowed_actionsType: Enum
Multi-value
Allowed values:
  • cancel_workflow
  • email_participants
  • remove_content
  • update_participants
  • update_workflow_due_date
  • cancel_task
  • reassign_task
  • update_task_due_date
Actions not allowed for any user.

Object workflows apply to a single object lifecycle and a single object.

AttributeMetadataDescription
labelType: String
Required
Max length: 40
typeType: Enum
Required
Allowed values:
  • start
  • end
  • usertask
  • contenttask
  • notification
  • placeholder
  • changestate
  • decision
  • join
  • action
  • updaterecordfield
  • updatesharingsettings
  • updatedocumentsharingsettings
  • updaterelatedrecordfield
  • contentaction
  • job
The type of step.
next_stepsType: Component
Multi-value
The Objectworkflowstep to move to once this step is complete.
tagsType: String
Max length: 40
Multi-value
Used to determine whether the step should be canceled when short-circuiting tasks.
step_detailType: XMLString
Max length: 128000
Details of the step configuration.
descriptionType: String
Max length: 255

Object workflows apply to a single object lifecycle and a single object.

AttributeMetadataDescription
ruleType: XMLString
Required
Max length: 32000
An XML String describing the workflow cancellation action rule.
orderType: Number
Required
The order in which the cancellation action is executed.
OperationSupport
Create*
Recreate*
Alter*
Drop
Rename
Describe
Generate Recreate
Queryable

Notes:

  • Create, Recreate, Alter: MDL Operation is supported, but the Component Type contains field(s) that use proprietary XML. Direct modification of the XML is not supported or recommended. Instead, creating and/or updating the component is better suited through the Admin UI.
  • Alter: MDL Operation may not be supported for some multi-value attributes.