Platzhalterdefinition (PlaceholderDefinition)
- Robert Mühsig
- Dinah Bolli
Zweck und Einsatz
Damit in Layout-Vorlagen und PowerPoint-Vorlagen dynamische Daten angezeigt werden können, benötigen sie Platzhalter.
Über diese Funktion können in Layouts für Word sowie in PowerPoint Master-Vorlagen Platzhalter definiert werden:
In Word-Layouts wird dann vorgegeben, welche Felder im Inhalt befüllt werden müssen, ohne dass die Layout den versprochenen Inhalt kennt. Die konfigurierten Platzhalter werden über den primedocs Editor in die Vorlage eingebaut.
In PowerPoint Master-Vorlagen werden die Platzhalter dann Tags von Shapes zugewiesen.
Anschliessend wird in der Inhaltsvorlage bzw. der PowerPoint-Vorlage über die Platzhalterzuordnung (PlaceholderMapping) bestimmt, welches SourceField der Platzhalter genau holt.
Grundaufbau
<PlaceholderDefinitionConfiguration>
<Definitions>
<!-- Platzhalter -->
</Definitions>
</PlaceholderDefinitionConfiguration>Attribute
Die folgenden Attribute müssen bei allen verfügbaren Elementen gesetzt sein:
Attributname | Beschreibung |
|---|---|
| Wird zur Identifikation benötigt. Darf keine Leerzeichen enthalten und muss eindeutig sein. |
Elemente
Text
<Text Name="Footer" />Picture
<Picture Name="PartnerLogo" />YesNo
GlobalDefinitions
Über das Element GlobalDefinitions kann eine global abgelegte Platzhalterdefinition geholt werden.
Mehr Informationen zu den Globalen Konfigurationen sind hier zu finden: Globale Konfigurationen | Umgang mit typisierten Feldern.
Ein konkretes Beispiel zum Erkennen des Zusammenhangs zwischen dem globalen Eintrag und der Referenz auf einen globalen Eintrag gibt es hier: Globale Konfigurationen | Globale Einträge in den Vorlagen referenzieren.
Attribute für GlobalDefinitions
Die Referenz auf einen globalen Eintrag passiert mittels dem Key-Attribut. Wählt man dieses aus, wird einem automatisch eine Liste mit allen zur Verfügung stehenden globalen Einträgen angezeigt.
Attributname | Beschreibung |
|---|---|
| Die ID des globalen Eintrags, der referenziert werden soll. |
Beispiel-XML-Konfiguration
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland