Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Theorie zu Inhaltssteuerelemente pro Office-App hinzugefügt

...

Ü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
languagexml
<FieldsConfiguration>
  <Fields>
    <!-- Formularelemente und Gruppen hier einfügen -->
  </Fields>
</FieldsConfiguration>

...

Attribute, die bei allen Elementen angeboten werdenerforderlich sind:

Attributname

Beschreibung

Name
(erforderlich)

Wird zur Identifikation benötigt. Darf keine Leerzeichen enthalten und muss eindeutig sein.

...

Code Block
languagexml
<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