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

Attribute name

Description

Name
(required)

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

Attribute name

Description

Key
(required)

The ID of the global entry to be referenced.


Example XML configuration

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland