Placeholder Configuration Macro
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.
Macro Parameters
Parameter | Description | Type | Default Value |
|---|---|---|---|
Placeholder | Enter an existing Placeholder (e.g. $$project_number$$) | Text-Input | empty |
Format | Select the type of Placeholder:
| 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, multiple values can be selected in the dropdown | Checkbox | false |
Multiple Users | Only when User is selected: If checked, multiple users can be selected in the dropdown | Checkbox | false |
Regex Pattern | Only when Regex selected: Inset a Regular Expression to replace a placeholder with something more specific: e.g. P[0-9] will only allow replacements like: P0, P1, …, P9 | Text-Input | empty |
Choose a Type/Set | Only when Advanced Dropdown is selected: Select the Type and a Set of the EDM | Dropdown | Type: Predefined-Set Set: empty |
Prefix | Only when Counter is selected: The prefix will always be prepended to the counter value when replacing the placeholder | Text-Input | empty |
Postfix | Only when Counter is selected: The postfix will always be appended to the counter value when replacing the placeholder | Text-Input | empty |
Counter | Only when Counter is selected: The number set is the value from where the counter will start counting | Number-Input | 0 |
Number of digits | Only when Counter is selected: Minimum number of digits used to print the counters value when replacing tags | Number-Input | 3 |