Platzhalterzuordnung (PlaceholderMapping)

Owned by Robert Mühsig
Last updated: Jan 22, 2024 by Dinah Bolli (Unlicensed)Version comment
2 min read

Zweck und Einsatz

Damit in Layouts dynamische Daten angezeigt werden können, benötigen sie Platzhalter.

Über die Platzhalterzuordnung werden in der Inhaltsvorlage resp. einer PowerPoint-Vorlage Platzhalter mit den gewünschten Daten abgefüllt, die zuvor in einer übergeordneten Vorlage - z. B. einem Layout oder einer Master-Vorlage - mittels https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/57081866-Funktion “versprochen” wurden.

Die Daten können dabei aus der https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/57081857-Dokumentfunktion oder über die https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/56918029-Dokumentfunktion (Benutzerdaten, JavaScript-Funktionen) kommen.

Folgendes Beispiel weist dem Platzhalter mit Name Footer das Field FooterGeneral aus der Dokumentfunktion https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/56918029 zu:
<Text Name="Footer" SourceField="FooterGeneral" />

Jeder Platzhalter, der im Layout definiert wurde muss gemappt werden, sonst erscheint eine Fehlermeldung.

Grundaufbau

<PlaceholderMappingConfiguration> <Mappings> <!-- Platzhalter --> </Mappings> </PlaceholderDefinitionConfiguration>

Attribute

Folgende Attribute müssen bei allen verfügbaren Elementarten (Text, Picture) gesetzt werden:

Attributname

Beschreibung

Attributname

Beschreibung

Name
(erforderlich)

Wird zur Identifikation benötigt, darf gleich heissen wie das Feld aus Forms oder Fields. Darf keine Leerzeichen enthalten.

SourceField (erforderlich)

Wird benötigt, um das Feld aus Forms oder Fields zu mappen. Entsprechend kommt hier die Id des entsprechenden Feldes rein.

Es gibt drei Quellen für Platzhalter, die im Attribut SourceField angesprochen werden können:

  • ein Benutzerfeld: Profile.User.FirstName

  • ein Forms-Feld: Forms.MyTextfield / Forms.MainSigner.FirstName

  • ein Field: MyField (Achtung: der Name eines Field darf keinen Punkt enthalten, weil Gruppierungen nur mittels Objects und ObjectCollections möglich sind).

In den weitaus meisten Fällen wird ein Field erstellt, das dynamisch Inhalte kombiniert und ausgibt - und dann einem Platzhalter zugewiesen wird.
Benutzerfelder werden praktisch nie ohne Umweg über ein Field zugewiesen.

Elemente

Text

<Text Name="CreateDate" SourceField="Forms.Date" />

Picture

<Picture Name="PartnerLogo" SourceField="PartnerLogo" />

GlobalMappings

Über das Element GlobalMappingskann eine global abgelegte Platzhalterzuordnung geholt werden.

Mehr Informationen zu den Globalen Konfigurationen sind hier zu finden: https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/31457334/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: https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/31457334/Globale+Konfigurationen#Globale-Eintr%C3%A4ge-in-den-Vorlagen-referenzieren.

Attribute für GlobalMappings

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

Attributname

Beschreibung

Key
(erforderlich)

Die ID des globalen Eintrags, der referenziert werden soll.

Beispiel-XML-Konfiguration

 

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland