Page Comparison

Overview

This article describes how Expiry Dates interact with specific macros.

{state}

Expiry date

state

The expiry date for a workflow state is set via the duedate parameter, which .

The duedate parameter accepts both date and duration formats, as well as Value References.

The duedate for a state is set on the transition into the state. The time period to expiry is displayed in the workflow popup for the state.

...

Upon expiry :

...

of the duedate fixed date or duration period

• the expiry indicator in the workflow popup

  will turn red – see

  turns red

...

If the expiry date occurs whilst the page or blog post is in the state

...

(not before, not after):

• The 

  the stateexpired event is sent

If the expiring state has an expired parameter, the workflow

...

transitions to the state

...

specified in the expired parameter.

On the expired parameter, the following workflow events are sent

• statechanged

• pagestatechanged if the event occurred for a workflow applied to a page

• newstatechanged if the event occurred for a workflow applied to a blog post

...

If the expiry date is set as a date that is before the date on which occurrence of the transition to the state is entered,

• the state

...

• shows as expired but

...

• does not trigger any events or transition to another state

Examples

...

Filter by label (Content by label)
showLabels false max 100 showSpace false sort title excerptType simple cql label = "macro-state" and label = "example" and label in ( "parameter-expired" , "parameter-duedate" , "parameter-changeduedate" ) and label != "concept" and space = currentSpace ( )

...

set-state-expiry

...

This macro can be used during an event (including expiry events) to set a new expiry date for a state.

It accepts both date and duration formats, as well as Value References.

Examples

...

Filter by label (Content by label)
showLabels false max 100 showSpace false sort title excerptType simple cql label = "macro-workflowparameter" and label = "example" and label != "concept" and space = currentSpace ( )

...

task

...

Expiry The expiry date for a task is set via the duedate parameter, which accepts both date and duration formats, as well as Value References.

Upon expiry:

• The expiry indicator

  the expiry date and time is displayed in the

  workflow popup will turn red – see: State expiry date

  tasks popup

• If the expiry date occurs whilst the state is active (not before, not after):

  • The stateexpired

    the taskexpired event is sent

The expiry of the task event is displayed in the document activity report for the page.

...

If the state in which the expiring

...

task has

...

a taskcompleted parameter, the workflow

...

transitions to the state

...

the taskcompleted parameter specifies

...

On the taskcompleted parameter transition, the following events are sent

• statechanged

• pagestatechanged if the event occurred for a workflow applied to a page

• newstatechanged if the event occurred for a workflow applied to a blog post

Info
Watchers and participants

...

receive a notification

Examples

...

Filter by label (Content by label)
showLabels false max 100 showSpace false sort title excerptType simple cql label = "macro-task" and label = "example" and label in ( "parameter-expired" , "parameter-duedate" , "parameter-changeduedate" ) and label != "concept" and space = currentSpace ( )

...

set-message

...

When a {set-message} expires:

• The message will be removed
• That is all.

Examples: macro in a trigger has a duedate parameter value and this expires

• the message is removed

Examples

...

workflowparameter

...

This macro creates editable Value References which, depending on its edit parameter setting, can be edited by Space by space admins or Usersusers:

• Parameters - Space Tools

• Workflow setup - Workflow Popup

Be sure to specify the type as duration. Note that the  as duration.

The resulting editable field

...

usually

...

requires an exact date to be input.

Examples:

Filter by label (Content by label)
showLabels false max 100 showSpace false sort title excerptType simple cql label = "macro-workflowparameter" and label = "example" and label = "type-duration" and label != "concept" and space = currentSpace ( )

‹ Back to Expiry Dates