Page and User references

1 Where can they be used? | 2 Page References | 3 User References | 4 Example

Overview

These value references provide information related to the current page and can be used in workflow macros.

Where can they be used?

Use in the following macros (including, where applicable, parameters, conditions, and the macro body):

Page:

approval macro — Add content-focus reviews to states
Page:

get-metadata macro — Retrieve and display Value References
Page:

state macro — Define workflow states & basic transitions
Page:

state-selection macro — Specify direct state transitions
Page:

task macro — Add tasks to workflow states
Page:

trigger macro — Trigger actions when events are fired
Page:

workflowparameter macro — Define editable workflow Value References

They can also be used in trigger action macros.

See Event references for a full list of references that can be used in action macros.

Page References

Reference	Type	Event(s)	Description
`@modification@`	date	all events	The date that this content was last modified
`@page@`	link	all events	A link to this piece of content
`@parent@`	link	all events	A link to the parent of the page (only for pages)
`@created@ or @posted@`	date	all events	The date that this piece of content was created
`@space@`	text	all events	Name of the space that this content belongs to
`@title@`	text	all events	The title of this piece of content
`@version@`	text	all events	The version number of this piece of content
`@id@`	text	all events	The ID of this piece of content
`@labels@`	text	all events	List of comma-separated labels of this piece of content

User References

Reference	Type	Event(s)	Description

Reference	Type	Event(s)	Description
`@author@` or `@creator@`	`username`	all events	The username of the person who created the page or blog post. Specifically, it returns the username of the person who clicked the Publish button when the page or blog post was first created. Page: Adding page activity to email Page: Who can be assigned, or assign users to an approval
`@modifier@`	`username`	all events	The username of the person who last changed this content.
`@user@`	`username`	all events	The username of the active user who triggered the event or state transition. Page: Adding page activity to email
`@user@`	`username`	all events	Using this reference can be unreliable outside of events, and also in cases where an event or transition is caused by state or task expiry.

Example

A common use is to prevent page creators from taking part in a content review.

{workflow:name=Review}
   {state:In progress|submit=Review}
   {state}
   {state:Review|approved=Approved|rejected=In progress}
      {approval:Review|assignable=true|exclude=@creator@}
   {state}
   {state:Approved|final=true|updated=In progress}
   {state}
{workflow}

‹ Back to Value References