Zum Hauptinhalt springen
Version: 4.1 (2026 H2)

WordContent-Snippet

Ein WordContent-Snippet ist ein wiederverwendbarer Block aus nativem Word-Inhalt — Text mit Formatierung, Tabellen, Bilder, Inhaltssteuerelemente oder beliebige andere Elemente, die in einem Word-Dokument vorhanden sein können. Es wird als Teil einer Vorlage gespeichert und bei der Dokumentgenerierung in das Dokument eingefügt.

WordContent-Snippets sind für Layouter bestimmt. Sie werden in der Kategorie Design (Vorlage) gespeichert und sind für Endbenutzer nicht sichtbar.

Wann WordContent-Snippets verwenden?​

Verwenden Sie ein WordContent-Snippet, wenn Sie:

  • Einen komplexen formatierten Block (z.B. eine Tabelle, einen Adressblock oder eine rechtliche Klausel) in mehreren Vorlagen wiederverwenden möchten.
  • Unterschiedliche Inhaltsblöcke dynamisch je nach Benutzereingabe oder Profildaten einfügen möchten.
  • Kopf- und Fusszeilen oder Abschnitte konsistent über mehrere Inhaltsvorlagen hinweg halten möchten, die dasselbe Layout verwenden.

Für einfachen formatierten Text (fett, kursiv, Zeilenumbrüche) verwenden Sie stattdessen ein FormattedText-Snippet — es ist leichtgewichtiger und HTML-basiert.

WordContent-Snippet erstellen​

WordContent-Snippets werden über die Snippet-Seitenleiste (Aufgabenbereich) in Word erstellt und verwaltet — nicht über eine Registerkarte im Vorlageneditor.

  1. Öffnen Sie in primedocs Desktop die Vorlage, in der das Snippet abgelegt werden soll.
  2. Öffnen Sie die Snippet-Seitenleiste.
  3. Legen Sie ein neues Snippet vom Typ Word Content an.
  4. Geben Sie dem Snippet einen Namen und bearbeiten Sie den Inhalt in Word.
  5. Speichern Sie das Snippet.

WordContent-Snippet in einer Vorlage verwenden​

Ein WordContent-Snippet wird über die Dokumentfunktion Fields eingebunden: Ein Field vom Typ WordContent ruft das Snippet über die Snippets-API ab. Das Ergebnis wird dort eingefügt, wo das Field in der Vorlage platziert ist.

$.snippets.getWordContent("SnippetName")

So kann das Snippet auch bedingt anhand von Formulareingaben oder Profildaten ausgewählt werden:

const snippetName = $("Forms.Department") === "Legal" ? "LegalDisclaimer" : "StandardDisclaimer";
$.snippets.getWordContent(snippetName);
hinweis

primedocs.SnippetBlockPlaceholder=… und die übrigen Snippet-Platzhalter sind keine Vorlagen-seitige Referenz auf ein Snippet, sondern Platzhalter innerhalb eines Snippets. Sie werden beim Abruf über getWordContent(...) gefüllt — siehe unten.

Platzhalter im Snippet füllen​

Enthält das Snippet Platzhalter, werden diese über ein Mapping-Objekt als zweites Argument befüllt. Der Schlüssel ist jeweils der Platzhaltername, der Wert der einzusetzende Inhalt (ein Text, eine Feldreferenz via $.getReference(...) oder ein anderer Snippet-/Field-Wert):

$.snippets.getWordContent("SnippetName", {
  "Profile.User.LastName": $.getReference("Profile.User.LastName"),
  "Anrede": "Sehr geehrte Damen und Herren"
});

Für Profil-, Forms- und Data-Felder erzeugt $.createAutoMapping() das Mapping automatisch. Details zu den Platzhalter-Typen und zur Snippets-API: Snippets.

Fremde Inhaltssteuerelemente​

Wird Word-Inhalt eingefügt, der Inhaltssteuerelemente aus einem anderen Dokument enthält (z.B. fremde primedocs.Field-Tags aus einem Teildokument), blockiert das die Generierung nicht: Beim Bereinigen werden nicht von primedocs stammende Inhaltssteuerelemente entfernt. Fremde Tabellenzeilen-Inhaltssteuerelemente bleiben dabei erhalten, damit Tabellenstruktur und gesperrte Inhalte unverändert bestehen.

Berechtigungen​

WordContent-Snippets werden in der Kategorie Design gespeichert. Nur Template Admins und Sys Admins können sie erstellen oder bearbeiten. Weitere Details finden Sie unter Snippet-Berechtigungen.