Placeholder Definition
Purpose and use
Placeholders are required in order for dynamic data to be displayed in layouts.
This function can be used to define placeholders in layouts for Word and in PowerPoint master templates. This specifies in the layout which fields must be filled in the content without the layout knowing the promised content.
The configured placeholders are inserted into the template via the primedocs editor and then filled with the correct data during document generation via Placeholder Mapping in the content.
An error message appears in the content if a placeholder has not been filled.
Basic structure
<PlaceholderDefinitionConfiguration>
<Definitions>
<!-- Placeholders -->
</Definitions>
</PlaceholderDefinitionConfiguration>
Attributes
The following attributes must be set for all available element types (Text, Picture):
Attribute name | Description |
---|---|
| Is required for identification. Must not contain any spaces and must be unique. |
Elements
Text
<Text Name="CreateDate" />
Picture
<Picture Name="PartnerLogo" />
GlobalDefinitions
The GlobalDefinitions
element can be used to retrieve a globally stored placeholder definition.
More information about the global configurations can be found here: Global Configurations | Working with typed fields.
A concrete example for recognizing the connection between the global entry and the reference to a global entry can be found here: Global Configurations | Referencing global entries in the templates .
Attributes for GlobalDefinitions
The reference to a global entry is made using the Key
attribute. If you select it, a list of all available global entries is automatically displayed.
Attribute name | Description |
---|---|
| The ID of the global entry to be referenced. |
Example XML configuration
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland