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.

{approval} and {trigger} macros could have conditions associated to them. Conditions can be defined as part of the macro parameters.

Reference

Description

Compare-to values

user

the user is one of the listed

a comma-separated list of specific user names, groups, anonymous or Value References.
In approvals, if the list is preceded by a '&' then all the users must give the approval.

group

the user belongs to the given group

a comma-separated list of specific group names or Value References.
In approvals, if the list is preceded by a '&' then all the users must give the approval.

haslabel

the page has any of the given labels

a comma-separated list of specific labels

hasapproval

the page has a given approval

an approval name

permission

the user has to given permission

edit, view or administer

title

the title name

a page title or a Value Reference to a page title

isorphan

Whether or not the page has no parent page

true or false

ishomepage

Whether or not the page is the home page of the current space

true or false

ischildof

Whether or not the page is child (or grandchild) of the given page (name)

a specific value or a Value Reference

space or spacekey

Whether or not the page part of the space identified by the given space key

a specific value or a Value Reference

state

the page's or news/blog post's current state is the given

a state name

stateindraft

the current state of the page or news/blog post in the corresponding Draft space as defined through Comala Publishing.

a state name

isminorchange

the page's or news/blog post's update was marked as minor (used only on pageupdated or newsupdated events)

true or false

parenthaslabel

the page's parent (ancestors) has any of the given labels

a comma-separated list of specific labels

usersdefinedthe value reference contains usersa comma-separated list of Value References

Metadata reference

A reference to a metadata value. See Note 1

a specific value or a Value Reference

Negation

The compared-to value could be preceded by a '!' to negate the condition. Several conditions could be defined in a macro.

Notes

  • 1. if a Metadata condition is include in a pageupdated trigger, the trigger will not fired if the referred metadata value is being updated.

Examples

{...|user=primus|...}

... the user is primus

{...|user=@Project Team:Project Manager@|...}

... the user is the one indicate in the metadata value name Project Manager in the page Project Team

{...|haslabel=!approved|...}

... the page does not have the label approved

{...|group=@WF:Workflow:Releasers@|...}

... the user belongs to the group defined in the metadata value name Releasers of the page WR:Workflow

{...|permission=administer|...}

... the user can administer the page

{...|hasapproval=!Project Management|...}

... the page does not have the Project Management approval

{...|@Reviewer@=!@user@|...}

... the page's metadata value Reviewer is not the current user

{...|user=!johndoe, janedoe|...}

... the current user is neither johndoe nor janedoe

{...|haslabel=!cat, dog, turtle|...}

... the page does not have any of label cat, dog or turtle

{...|title=Requirements|...}

... the page's title is Requirements

{...|ishomepage=false|...}

... the page is not the homepage

{...|isorphan=true|...}

... the page does not have a parent page

{...|usersdefined=!Developers,Designer|...}... the Developers and Designer users have not been set for the workflow