Zweck und Einsatz

Über diese Dokumentfunktion können Inhalte verknüpft werden, um diese im Dokument zu integrieren. Angenommen Sie nutzen die Formulare (Forms) Funktion, um ein Datum und ein Titel abzufragen und wollen diese Daten gemeinsam in einer Fusszeile platzieren, können Sie über diese Funktion die beiden Textfelder in ein eigenes Textfeld zusammenbringen.

Grundaufbau

<FieldsConfiguration>
  <Fields>
    <!-- Formularelemente und Gruppen hier einfügen -->
  </Fields>
</FieldsConfiguration>

Elemente

Attribute, die bei allen Elementen angeboten werden:

Attributname	Beschreibung
`Name` (erforderlich)	Wird zur Identifikation benötigt. Darf keine Leerzeichen enthalten und muss eindeutig sein.

Text

<FieldsConfiguration>
  <Fields>
    <Text Name="Page" translate-Value="Content.Page" />
  </Fields>
</FieldsConfiguration>

Attribute für `Text`

Attributname	Beschreibung
`Value` (optional)	Vordefinierter Text, den der Benutzer bearbeiten kann.

Date

<FieldsConfiguration>
  <Fields>
    <Date Name="CreateDate" />
  </Fields>
</FieldsConfiguration>

Attribute für `Date`

Keine weiteren Attribute

YesNo

<FieldsConfiguration>
  <Fields>
    <YesNo Name="InsertPartnerLogo" Value="true" />
  </Fields>
</FieldsConfiguration>

Attribute für `YesNo`

Attributname	Beschreibung
`Value` (optional)	Vordefinierter Wert des Eintrags, den der Benutzer bearbeiten kann.

Picture

<FieldsConfiguration>
  <Fields>
    <Picture Name="PartnerLogo" Asset="\\fileshare\PartnerLogo.png" />
  </Fields>
</FieldsConfiguration>

Attribute für `Picture`

Attributname	Beschreibung
`Asset` (erforderlich)	Angabe des Laufwerkpfades zum Bild. Dabei muss sichergestellt sein, dass jede Benutzer-Maschine auf das Bild zugreifen kann.

GlobalFields

Über das Element GlobalFields kann ein global abgelegtes Field geholt werden.

<FieldsConfiguration>
  <Fields>
    <GlobalFields Key="Fields.Report" />
  </Fields>
</FieldsConfiguration>

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 `GlobalFields`

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.

Beispiel

<FieldsConfiguration>
  <Fields>
    <!-- Platzhalter befüllen vom Layout -->
    <Picture Name="PartnerLogo" Asset="\\e165\User\Bolli\04_Testing-Bilder\BeispielLogo.PNG" />
    <Text Name="Page" translate-Value="Texts.Page" />
    <!-- Daten nur in der Inhaltsvorlage -->
    <Text Name="Greeting" translate-Value="Greetings.KindRegards1" />
    <!-- Globaler Eintrag referenzieren -->
    <GlobalFields Key="Letters.Subject" />
  </Fields>
</FieldsConfiguration>

Felder (Fields)