Platzhalterdefinition (PlaceholderDefinition)

---

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
Name (erforderlich)	Wird zur Identifikation benötigt. Darf keine Leerzeichen enthalten und muss eindeutig sein.

---

Elemente

Text

<Text Name="Footer" />

Picture

<Picture Name="PartnerLogo" />

Bildmodus in PowerPoint

Wie ein Bild in ein PowerPoint-Shape eingepasst wird (exakte Masse oder Einpassung), wird nicht hier in der Platzhalterdefinition festgelegt, sondern über das Shape-Tag PRIMEDOCS.PICTUREMODE (Werte Fit/Exact) am Ziel-Shape. Details unter Bildgrösse festlegen.

YesNo

<YesNo Name="ShowClassification" />

GlobalDefinitions

Über das Element GlobalDefinitions kann eine global abgelegte Platzhalterdefinition geholt werden.

<GlobalDefinitions Key="Placeholders.DefNeutral" />

Mehr Informationen zu den Globalen Konfigurationen sind hier zu finden: Global Configurations.

Ein konkretes Beispiel zum Erkennen des Zusammenhangs zwischen dem globalen Eintrag und der Referenz auf einen globalen Eintrag gibt es hier: Global Configurations.

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
Key (erforderlich)	Die ID des globalen Eintrags, der referenziert werden soll.

DefinitionMappings

Optional kann eine Platzhalterdefinition einen DefinitionMappings-Block enthalten. Er hat keinen Einfluss auf die Platzhalter selbst, sondern liefert der Aktion «+ Insert layout configuration» in der Inhaltsvorlage die Vorgabe, welche globalen Zuordnungen beim Übernehmen zusätzlich in die Platzhalterzuordnung (PlaceholderMapping) eingefügt werden sollen.

<PlaceholderDefinitionConfiguration>
  <DefinitionMappings>
    <GlobalMappings Key="Placeholders.Map.Footer" />
  </DefinitionMappings>
  <Definitions>
    <GlobalDefinitions Key="Placeholders.Def.Footer" />
    <Text Name="CreateDate" />
  </Definitions>
</PlaceholderDefinitionConfiguration>

Beim Ausführen der Aktion werden die hier gelisteten GlobalMappings in die Mappings der Inhaltsvorlage übernommen; bereits vorhandene Schlüssel werden übersprungen.

Elementname	Beschreibung
GlobalMappings	Verweist über das erforderliche Key-Attribut auf eine global abgelegte Platzhalterzuordnung. Beliebig oft wiederholbar.

---

Beispiel-XML-Konfiguration

<PlaceholderDefinitionConfiguration>
  <Definitions>
    <!-- Daten für Kopfzeile -->
    <Text Name="Footer" />
    <Picture Name="PartnerLogo" />
    <YesNo Name="ShowClassification" />
    <!-- Daten für Fusszeile (global abgelegt) -->
    <GlobalDefinitions Key="Placeholders.Def.Footer" />
  </Definitions>
</PlaceholderDefinitionConfiguration>