Platzhalterzuordnung (PlaceholderMapping)
- Robert Mühsig
- Dinah Bolli (Unlicensed)
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 Platzhalterdefinition (PlaceholderDefinition)-Funktion “versprochen” wurden.
Die Daten können dabei aus der Formulare (Forms)-Dokumentfunktion oder über die Felder (Fields)-Dokumentfunktion (Benutzerdaten, JavaScript-Funktionen) kommen.
Folgendes Beispiel weist dem Platzhalter mit Name Footer das Field FooterGeneral aus der Dokumentfunktion Felder (Fields) 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 |
|---|---|
| Wird zur Identifikation benötigt, darf gleich heissen wie das Feld aus Forms oder Fields. Darf keine Leerzeichen enthalten. |
| 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.FirstNameein Forms-Feld:
Forms.MyTextfield/Forms.MainSigner.FirstNameein 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: 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 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 |
|---|---|
| Die ID des globalen Eintrags, der referenziert werden soll. |
Beispiel-XML-Konfiguration
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland