Legacy Workflows Documentation

Looks like you followed an old link. Comala Workflows is now Comala Document Management.

Please access our latest documentation here Welcome to Comala Document Management

Documentation for other versions of Comala Workflows are available too.

(info) This space is no longer being updated.

Purpose

The state-election macro is used to restrict the list of possible states available from the state selection drop-down box. The user can select from the current state along with those listed with the macro. This macro must be used inside of a {state} macro.

Note

This macro cannot be used when the {approval} macro is also present.

Syntax

{state-selection} Syntax
{state:state_name}
   {state-selection:states=state_name1[,state_name2][,state_name3]...}
{state}

Parameters

Parameters

Mandatory

Default

Description

states

Yes

Comma-delimited list of states to display in the current state. All states listed must be defined with a {state} macro in the current workflow.

Conditions

No

 

Sets the conditions that have to be met in order to change the state. If no conditions are set, then any user who has permission to see draft versions can change the state.

Example

The code below restricts the state selections available when a page is in the Approved state to Approved (current state is always displayed), For Review, and Cancelled.

{state:Approved|taskable=true}
  {state-selection:states=For Review,Cancelled}
{state}
  • No labels