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, das leichtgewichtiger und HTML-basiert ist.

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. Zulässig sind alle Arten von Inhaltssteuerelementen, auch Datum und Kontrollkästchen. Ein Tracked-Inhaltssteuerelement darf nicht gesperrt sein, sonst liesse es sich nicht ausfüllen.

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, sodass mehrsprachige Hinweistexte über ein Field dort nicht funktionieren.

Kommentare im Snippet​

Word-Kommentare, die im Inhalt des Snippets verankert sind, werden beim Speichern des Snippets übernommen, samt Antworten und dem Status «erledigt». Bei der Dokumentgenerierung erscheinen sie im erzeugten Dokument an derselben Stelle.

Persönliche Angaben entfernt primedocs beim Speichern: Als Autor steht in jedem Kommentar der neutrale Wert «Author», Initialen und Datum fehlen. Erwähnte Personen (@-Erwähnungen) bleiben als reiner Text ohne E-Mail-Verknüpfung stehen. Der Kommentartext selbst und gewöhnliche Web-Links bleiben erhalten.

Nicht in Kopf- und Fusszeilen

Snippets mit Kommentaren lassen sich nicht in Kopf- oder Fusszeilen und nicht in Fuss- oder Endnoten einfügen. Die Generierung schlägt dort fehl, weil Word an diesen Stellen keine Kommentare zulässt.

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.