The Placeholder Configuration Macro allows the author of a template to set a placeholder format, if it is required, description and dropdown options automatically to a Placeholder. When doing so, the configurations for the respective Placeholder in the Placeholder Replacement Dialog is set to that configuration automatically.

The Placeholder Configuration Macro can be placed within any page of the page tree and if there are multiple of the same placeholder, will favour the placeholder configuration macro in the same page or work its way up the tree.

Placeholder Macro Configuration Inheritance

If a page does not contain a macro and the page is a child page down the page tree, it will search upwards for a configured placeholder macro and will keep working up until it finds a parent page that contains a placeholder configuration macro. It will then adopt this configuration.

Inheritance Concept | Image

Macro Parameter

Parameter

Description

Type

Default Value

Placeholder

Enter an existing Placeholder (e.g. $$project_number$$)

Text-Input

empty

Format

Select the type of Placeholder:

  • Standard

  • Date

  • Link

  • Multiline

  • Dropdown

  • Regex

  • User

Dropdown

Standard

Required

If checked, the placeholder must be replaced with a value in the Replace Placeholder View

Checkbox

false

Description

If a description is added, it will display underneath the placeholder field in the Replace Placeholder View

Text-Input

empty

Dropdown Options

Only when Dropdown selected:

Insert the comma separated values that will appear in the Replace Placeholder View and be replaced with a selected option

e.g. yes,no,maybe

Text-Input

empty

Multi-dropdown

Only when Dropdown selected:

If checked, allows for multiple values to be selected in the dropdown

Checkbox

false

Regex Pattern

Only when Regex selected:

Inset a Regular Expressions to replace a placeholder with something more specifc:

e.g. P[0-9] will only allow replacements like: P0, P1, …, P9

Text-Input

empty