...
Ü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 einen Titel vom Benutzer abzufragen und wollen möchten diese Daten gemeinsam in einer Fusszeile platzieren, .
Dann können Sie über diese Funktion die beiden Textfelder in ein eigenes Textfeld zusammenbringenDokumentfunktion das Datumsfeld und das Textfeld in einem Field zusammen ausgeben. So können Sie auch handhaben, was geschieht, wenn nicht beide Forms-Felder vom Benutzer ausgefüllt werden.
...
Grundaufbau
Code Block | ||
---|---|---|
| ||
<FieldsConfiguration> <Fields> <!-- Formularelemente und Gruppen hier einfügen --> </Fields> </FieldsConfiguration> |
...
Attribute, die bei allen Elementen angeboten werdenerforderlich sind:
Attributname | Beschreibung |
---|---|
| Wird zur Identifikation benötigt. Darf keine Leerzeichen enthalten und muss eindeutig sein. |
...
Code Block | ||
---|---|---|
| ||
<FieldsConfiguration> <Fields> <!-- Platzhalter befüllen vom Layout --> <Picture Name="PartnerLogo" Asset="\\e123\User\Muster\BeispielLogo.PNG" /> <Text Name="Page" Value="Seite" /> <!-- FormattedText holen --> <FormattedText Name="Title"> <Code>$.translations.getFormattedText("FormattedTexts.FormattedTitle")</Code> </FormattedText> <!-- Daten im Inhalt der Vorlage --> <Text Name="Greeting" translate-Value="Greetings.KindRegards1" /> <!-- Globaler Eintrag referenzieren --> <GlobalFields Key="Letters.Subject" /> <!-- WordContent-Textbaustein holen --> <WordContent Name="Introduction"> <Code>$.snippets.getWordContent("Introduction")</Code> </WordContent> </Fields> </FieldsConfiguration> |
Fields in Vorlagen in Office
Wie bereits in https://primesoft-group.atlassian.net/wiki/x/EgDCAQ erläutert, werden die Fields anschliessend manuell in die Vorlage eingefügt. Dabei werden sie je nach Typ als bestimmtes Inhaltssteuerelement eingefügt, wodurch zwischen primedocs und dem Dokument ein DataBinding hergestellt wird. DataBindings werden in Dokumenten von primedocs nachverfolgt und die Fields bei der Dokumentgenerierung und bei einer Dokumentaktualisierung laufend validiert.
Folgende Tabelle zeigt, welcher Field-Typ als welches Inhaltssteuerelement in die Vorlage eingefügt wird:
Field-Typ | Inhaltssteuerelement |
---|---|
Text | PlainText (Nur-Text) |
FormattedText | RichText |
WordContent | RichText |
Date | Date |
YesNo | Kann nicht eingefügt werden. |
Picture | Image |
Als Ergänzung zeigt folgende Matrix, welcher Field-Typ in welchen Office-Anwendungen verwendet werden kann:
Word | Outlook (web) | PowerPoint | Excel | |
---|---|---|---|---|
Text | ✔️ | ✔️ | ✔️ | ✔️ |
FormattedText | ✔️ | ✔️* | ✔️ | ❌ |
WordContent | ✔️ | ❌ | ❌ | ❌ |
Date | ✔️ | ❌ | ❌ | ❌ |
YesNo | ❌ | ❌ | ❌ | ❌ |
Picture | ✔️ | ✔️ | ✔️ | ✔️ |
* Outlook-E-Mails und -Signaturen werden in der webfähigen Outlook-Version nur noch in HTML gespeichert. Daraus folgt:
Globale Übersetzungen vom Typ FormattedText
können über das FormattedText
-Field in Outlook-Vorlagen beliebige HTML-Elemente enthalten und sind somit flexibler als globale Übersetzungen, die in Word- oder PowerPoint-Vorlagen eingefügt werden.
Eine Liste der erlaubten HTML-Elemente in Word und PowerPoint-Vorlagen finden Sie hier: https://primesoft-group.atlassian.net/wiki/spaces/PDT/pages/398327828/FormattedText#M%C3%B6gliche-HTML-Elemente