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?​

Ein WordContent-Snippet verwenden, um:

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

Für einfachen formatierten Text (fett, kursiv, Zeilenumbrüche) stattdessen ein FormattedText-Snippet verwenden — 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. In primedocs Desktop die Vorlage öffnen, in der das Snippet abgelegt werden soll.
  2. Die Snippet-Seitenleiste öffnen.
  3. Ein neues Snippet vom Typ Word Content anlegen.
  4. Dem Snippet einen Namen geben und den Inhalt in Word bearbeiten.
  5. Das Snippet speichern.

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.

Quick-Check-Felder im Snippet​

Ein WordContent-Snippet darf Inhaltssteuerelemente mit dem Tag primedocs.Tracked enthalten. Damit lässt sich ein Quick-Check-Block einmal aufbauen und in mehreren Vorlagen wiederverwenden. Das Tag muss exakt primedocs.Tracked lauten — mit einem Zusatz wie =Wert lässt sich das Snippet nicht speichern.

Der Platzhaltertext eines Inhaltssteuerelements bleibt im Snippet erhalten und wird beim Einfügen in das erzeugte Dokument übernommen. Solange ein Feld seinen Platzhaltertext zeigt, wertet der Quick Check es als nicht ausgefüllt.

Ausfüllhinweise

Im Snippet ist nur primedocs.HintText=[TEXT] zulässig. primedocs.HintField=[FieldId] ist in Snippets nicht erlaubt; mehrsprachige Hinweistexte über ein Field funktionieren dort also nicht.

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 unter Snippet-Berechtigungen.