Ribbon-Gruppen für die Vorlagenbearbeitung
Wird eine Vorlage aus dem Vorlageneditor heraus geöffnet, blendet primedocs in der Registerkarte primedocs zusätzliche Gruppen ein: die Werkzeuge, mit denen eine Vorlage bearbeitet wird — Felder binden, Platzhalter und Ausfüllhinweise setzen, in PowerPoint zusätzlich Formen taggen.
Diese Seite nennt zu jeder Schaltfläche die Beschriftung, unter der sie im Ribbon erscheint, das erzeugte Tag und die Bedingung, unter der sie aktiv ist.
Die Gruppen gehören zum Office-Add-In des Desktop Clients (Windows). Outlook hat keine Gruppe für die Vorlagenbearbeitung.
Wann die Gruppen erscheinen
Voraussetzung in allen drei Anwendungen: Das Dokument wurde aus dem Vorlageneditor heraus zur Bearbeitung geöffnet. In einem regulär generierten Dokument erscheinen die Gruppen nicht. In PowerPoint kommt hinzu, dass die Präsentation nicht schreibgeschützt sein darf.
Die Word-Gruppe Vorschau folgt einer anderen Bedingung: Sie erscheint im generierten Testdokument — also im Ergebnis eines Testlaufs, nicht in der zur Bearbeitung geöffneten Vorlage.
| Anwendung | Registerkarte | Gruppe | Schaltflächen |
|---|---|---|---|
| Word | primedocs | Vorlagenbearbeitung | 4 — Felder, Platzhalter, Hinweise |
| Word | primedocs | Werkzeuge | 3 — Word-Inhaltssteuerelemente, Diagnose |
| Word | primedocs | Vorschau | 2 — nur im Testdokument |
| Excel | primedocs | Vorlagenbearbeitung | 2 |
| PowerPoint | primedocs | Vorlagenbearbeitung | 8 — Tags und Inhaltsverzeichnis |
| PowerPoint | Folienmaster | Vorlagenbearbeitung | 5 — Layoutnamen und Tags |
| Word / Excel / PowerPoint | Entwicklertools | Vorlagenbearbeitung | Diagnosewerkzeuge |
Word
Word trennt die Vorlagenarbeit auf drei Gruppen: Vorlagenbearbeitung setzt primedocs-Bedeutung ins Dokument, Werkzeuge enthält, was ohne primedocs-Bindung auskommt, und Vorschau erscheint nur im generierten Testdokument.
«Platzhaltertext definieren» und «Tracked setzen» sind hier ausgegraut, weil die Cursor-Position sie nicht zulässt.
Gruppe «Vorlagenbearbeitung»
| Schaltfläche | Erzeugtes Tag | Zweck |
|---|---|---|
| Feld binden / Feld/Platzhalter binden | primedocs.Field=<Feldname> bzw. primedocs.Placeholder=<Name> | Öffnet die Leiste mit den bindbaren Einträgen der Vorlage |
| Textbaustein-Platzhalter einfügen | primedocs.Snippet…Placeholder=<Name> | Platzhalter, den zur Laufzeit ein Snippet befüllt |
| Hinweis einfügen | primedocs.HintText=<Text> oder primedocs.HintField=<Feldname> | Setzt einen Ausfüllhinweis |
| Platzhaltertext definieren | primedocs.PlaceholderField=<Feldname> | Setzt den Text, den Word im leeren Inhaltssteuerelement anzeigt |
Die Farbgebung der erzeugten Inhaltssteuerelemente unterscheidet sich je nach Typ; die Zuordnung ist unter Zugriff auf primedocs-Felder beschrieben.
Die drei rechten Schaltflächen sind nur aktiv, wenn die aktuelle Auswahl die Aktion zulässt — ob an der Cursor-Position ein Inhaltssteuerelement eingefügt werden kann beziehungsweise ob dort eines steht, das einen Platzhaltertext anzeigen kann. Ausgegraut heisst deshalb «an dieser Stelle nicht möglich», nicht «in dieser Vorlage nicht vorhanden».
Feld binden
Feld binden ist ein Umschalter: Er öffnet und schliesst die gleichnamige Leiste am rechten Rand, die während der ganzen Vorlagenarbeit offen bleiben kann. Sie ersetzt den früheren Dialog, der sich nach jedem Feld schloss. Beim nächsten Öffnen einer Vorlage erscheint die Leiste wieder, wenn sie beim letzten Mal offen war.
Die Leiste enthält:
- Die Liste der bindbaren Felder mit Name und Feldtyp. Hinweisfelder und Ja/Nein-Felder erscheinen nicht.
- Eine zweite Liste «Layout-Platzhalter», aber nur in einer Layoutvorlage, die mindestens einen bindbaren Platzhalter definiert. Nur dann heissen Schaltfläche und Leiste Feld/Platzhalter binden; in einer Inhaltsvorlage steht dort Feld binden.
- Ein Filterfeld über beiden Listen und einen Zähler darunter.
- Eine Statuszeile, die vor dem Klick sagt, was passieren wird: einfügen, eine bestehende Bindung ändern oder «an der aktuellen Auswahl kann kein Feld eingefügt werden».
- Felder neu laden — holt den Feldkontrakt erneut vom primedocs Client, ohne Word zu blockieren. Damit werden Felder sichtbar, die erst nach dem Öffnen der Vorlage angelegt wurden.
Eingefügt wird per Doppelklick, mit der Eingabetaste oder über die Schaltfläche. Danach steht der Cursor hinter dem erzeugten Inhaltssteuerelement, sodass direkt weitergeschrieben werden kann.
Mehrere Felder auf einmal: Mit Strg oder Umschalt lassen sich mehrere Einträge markieren; sie werden in der Reihenfolge der Auswahl nacheinander eingefügt. Zwischen Feldern im Textfluss setzt primedocs ein Leerzeichen, Blockinhalte (Bild, WordContent, Tabellenzeilen) folgen direkt aufeinander.
Bindung ändern statt einfügen: Steht der Cursor in einem bereits gebundenen Inhaltssteuerelement, ändert die Leiste dessen Bindung. Felder eines anderen Typs sind dann ausgegraut — der Tooltip nennt den Grund. Übernommen wird nur eine Einfachauswahl; sind mehrere Einträge markiert, bleibt die Schaltfläche inaktiv.
Eine Auswahl liegt immer nur in einer der beiden Listen: Wird in der einen ausgewählt, leert sich die andere.
Für Felder vom Typ WordTableRows muss die Auswahl genau eine vollständige Tabellenzeile umfassen — andernfalls bricht die Aktion mit einer Meldung ab.
Textbaustein-Platzhalter einfügen
Erzeugt einen Platzhalter, der ein Snippet zur Laufzeit befüllbar macht. Es gibt vier Arten; die Art wird im Dialog gewählt, nicht über vier verschiedene Schaltflächen:
| Auswahl im Dialog | Erzeugtes Tag | Zulässige Werte |
|---|---|---|
| Textbaustein – im laufenden Text | SnippetPlaceholder | Text; Feldreferenzen ausser WordContent/FormattedText |
| Block – ein oder mehrere ganze Absätze | SnippetBlockPlaceholder | WordContent, FormattedText, InlineWordContent, Text |
| Inline – innerhalb eines Satzes, ohne den Absatz zu brechen | SnippetInlinePlaceholder | nur InlineWordContent |
| Tabellenzeilen – ersetzt ganze Zeilen einer Tabelle | SnippetTableRowsPlaceholder | nur WordTableRows |
Der Ablauf: Die Zielstelle markieren, die Schaltfläche anklicken, im Dialog Textbaustein-Platzhalter einfügen die Art wählen, einen Namen eingeben und mit Einfügen bestätigen. Der Name ist obligatorisch — er ist später der Schlüssel im Mapping-Objekt von $.snippets.getWordContent(...).
Die Art ist aus dem Kontext vorbelegt: Umfasst die Auswahl genau eine vollständige Tabellenzeile, steht Tabellenzeilen bereits da, sonst Textbaustein.
Der Titel des erzeugten Inhaltssteuerelements trägt den Tag-Namen in Klammern, etwa Anrede (SnippetBlockPlaceholder); als Inhalt erscheint der Name in eckigen Klammern, also [Anrede]. Tabellenzeilen erhalten ein Rich-Text-Inhaltssteuerelement, die übrigen drei ein Text-Inhaltssteuerelement.
Was die Platzhalter im Snippet bewirken und wie sie befüllt werden, beschreibt Snippets.
Enthält die Auswahl bereits ein Inhaltssteuerelement — oder liegt sie innerhalb eines bestehenden —, bricht das Einfügen mit der Meldung «Dieses Inhaltssteuerelement kann nicht eingefügt werden, da die aktuelle Auswahl mindestens ein Inhaltssteuerelement enthält» ab. Ein bestehender Snippet-Platzhalter lässt sich auf diesem Weg nicht in eine andere Art umwandeln; dazu ist er zu löschen und neu zu setzen.
Hinweis einfügen
Setzt einen Ausfüllhinweis an der Auswahl, den der Quick Check beim Ausfüllen anzeigt. Der Dialog Hinweis Content Control einfügen verlangt einen Titel und den Hinweis selbst.
Der Hinweis stammt entweder aus einem Feld oder aus einem festen Text — beides zusammen geht nicht. Beides wird im selben Eingabefeld erfasst: Beim Tippen schlägt es die Hinweisfelder der Vorlage vor. Wird ein Vorschlag gewählt, entsteht primedocs.HintField=<Feldname>, sonst primedocs.HintText=<Text>. Ein Symbol im Feld zeigt an, welcher der beiden Fälle gerade gilt.
Platzhaltertext definieren
Setzt den Text, den Word im Inhaltssteuerelement am Cursor anzeigt, solange dieses leer ist — als festen Text oder aus einem Textfeld der Vorlage, das der Dokumentsprache folgt. Was dabei ins Tag geschrieben wird, was beim Generieren passiert und warum gebundene Felder ohne eigenen Platzhaltertext trotzdem einen bekommen, beschreibt Platzhaltertexte.
Die Schaltfläche ist aktiv, wenn der Cursor genau ein Inhaltssteuerelement adressiert, das einen Platzhaltertext anzeigen kann — gebundene Felder, Layout-Platzhalter, Tracked-Inhaltssteuerelemente und Inhaltssteuerelemente ohne Tag. Ausgegraut bleibt sie bei Bild- und Kontrollkästchen-Inhaltssteuerelementen, bei Hinweisen sowie bei Inhaltssteuerelementen, deren Tag primedocs nicht interpretieren kann.
Gruppe «Werkzeuge»
Diese Gruppe enthält, was ohne primedocs-Bindung auskommt. Sie ist in beiden Modi sichtbar — beim Bearbeiten der Vorlage und im generierten Testdokument —, damit die Entwicklerwerkzeuge an einer einzigen Stelle liegen. Die beiden Inhaltssteuerelement-Schaltflächen erscheinen nur beim Bearbeiten der Vorlage.
| Schaltfläche | Zweck |
|---|---|
| Content Control einfügen | Legt ein gewöhnliches Word-Inhaltssteuerelement an, ohne primedocs-Bindung |
| Tracked setzen | Markiert das Inhaltssteuerelement am Cursor als offene Stelle für den Quick Check |
| Entwicklerwerkzeuge | Diagnoseansicht (siehe unten) |
Einfügen und Markieren sind zwei getrennte Schaltflächen, damit vor dem Klick feststeht, welcher der beiden Fälle eintritt. Beide sind unter Quick Check beschrieben.
Gruppe «Vorschau» (Testdokument)
Wird aus einer Vorlage ein Testdokument generiert, erscheint statt der Vorlagenbearbeitung die Gruppe Vorschau mit den beiden Vorschau-Aktionen:
- Sprachunabhängige Vorschau generieren — erzeugt eine Vorschau ohne Sprachbindung.
- Vorschau für Sprache generieren — erzeugt die Vorschau für eine auszuwählende Dokumentsprache.
Excel
In Excel entsteht die Datenbindung über benannte Bereiche, nicht über Inhaltssteuerelemente. Die Gruppe ist deshalb schmal:
| Schaltfläche | Zweck |
|---|---|
| Feld binden | Schreibt die Feldreferenz in die markierte Zelle |
| Entwicklerwerkzeuge | Diagnoseansicht (siehe unten) |
Feld binden öffnet in Excel weiterhin eine Auswahlliste der Felder — die Leiste aus Word gibt es hier nicht — und trägt in die markierte Zelle die Formel =<Feld-ID> ein, dieselbe Referenz, die auch von Hand geschrieben werden kann. Angeboten werden nur Felder vom Typ Text und Datum. Eine leere Auswahl löscht den Zellinhalt.
Vor der Ausführung wird der Schutz der Arbeitsmappe geprüft: Ist die Mappe geschützt, passiert nichts und das Ribbon wird neu ausgewertet.
Wie benannte Bereiche, Feld-IDs und die Sonderform {Feld-ID} in Kopf- und Fusszeilen zusammenspielen, beschreibt Excel-Vorlage.
PowerPoint
In PowerPoint werden keine Inhaltssteuerelemente gesetzt, sondern Tags an Formen und Folien. Ein Tag ist ein Name-Wert-Paar, das primedocs bei der Generierung auswertet. Welche Tags es gibt und was sie bewirken, listet PowerPoint-Tags auf; diese Seite beschreibt nur die Schaltflächen, mit denen sie gesetzt werden.
| Schaltfläche | Registerkarte | Aktiv wenn |
|---|---|---|
| Tags der Selektion verwalten | primedocs, Folienmaster | immer (bei sichtbarer Gruppe) |
| Alle Formen mit Tags selektieren | primedocs, Folienmaster | immer |
| Tagübersicht der Selektion | primedocs, Folienmaster, Entwicklertools | immer |
| Layoutnamen festlegen | Folienmaster | nur in einer Master-Vorlage |
| Agenda Titel definieren | primedocs | nur in einer Inhaltsverzeichnis-Vorlage |
| Agenda Foliennummern definieren | primedocs | nur in einer Inhaltsverzeichnis-Vorlage |
| Agenda Höhenbereich definieren | primedocs | nur in einer Inhaltsverzeichnis-Vorlage |
| Agenda Abstand definieren | primedocs | nur in einer Inhaltsverzeichnis-Vorlage |
Tags der Selektion verwalten
Öffnet den Dialog Tags für die markierte Form. Er führt die primedocs bekannten Tag-Typen als eigene Auswahlfelder — je mit sprechendem Namen und Beschreibung:
- Feld-Tags — Auswahl aus den Feldern der Vorlage.
- Platzhalter-Tags — Auswahl aus den definierten Platzhaltern.
- Tags mit festem Wertebereich — Auswahl aus den für diesen Tag zulässigen Werten.
Darunter steht das mehrzeilige Feld Zusätzliche Tags für alles, was nicht über die Auswahlfelder abgedeckt ist. Es folgt der Regel, die der Dialog selbst nennt: tagname=value fügt einen Tag hinzu, ein leerer Eintrag entfernt ihn.
Alle Formen mit Tags selektieren
Markiert auf der aktuellen Folie beziehungsweise im aktuellen Folienmaster jede Form, die mindestens einen Tag trägt. Nützlich, um in einem fremden oder gewachsenen Layout zu sehen, welche Formen überhaupt an primedocs gebunden sind.
Tagübersicht der Selektion
Zeigt die Tags der aktuell markierten Formen als Übersicht. Anders als Tags der Selektion verwalten ist die Übersicht rein lesend und funktioniert über mehrere Formen hinweg.
Layoutnamen festlegen (Folienmaster)
Nur in einer Master-Vorlage aktiv, und nur in der Registerkarte Folienmaster. Der Dialog Folienlayouts listet jedes Folienlayout der Präsentation mit einem Auswahlfeld auf; zur Wahl stehen die Layoutnamen, die die Dokumentfunktion Folienlayout (SlideLayout) definiert. Damit wird jedes PowerPoint-Layout einem primedocs-Folienlayout zugeordnet — ohne diese Zuordnung kann primedocs beim Generieren kein Layout auswählen.
Die vier Agenda-Schaltflächen
Nur in einer Inhaltsverzeichnis-Vorlage aktiv. Sie weisen der jeweils markierten Form ihre Funktion im generierten Inhaltsverzeichnis zu:
| Schaltfläche | Funktion der Form |
|---|---|
| Agenda Titel definieren | Eintrag (Titel) |
| Agenda Foliennummern definieren | Seitenzahl |
| Agenda Abstand definieren | Abstand zwischen den Einträgen |
| Agenda Höhenbereich definieren | Verfügbarer vertikaler Platz |
Der vollständige Ablauf inklusive Formatierung der Formen steht unter PowerPoint Inhaltsverzeichnis.
Diagnosewerkzeuge
Entwicklerwerkzeuge öffnet eine Diagnoseansicht auf die primedocs-Daten des geöffneten Dokuments. Sie dient der Fehlersuche im Support-Fall; die angezeigten Inhalte sind kein unterstützter Vertrag und können sich ohne Ankündigung ändern.
In allen drei Anwendungen steht die Schaltfläche zusätzlich in der Word-, Excel- beziehungsweise PowerPoint-Registerkarte Entwicklertools. In PowerPoint liegen dort ausserdem Tagübersicht der Selektion und der Idx-Editor, ein Hilfsmittel im Umfeld der Design-Conversion. Für die normale Vorlagenarbeit werden diese Werkzeuge nicht benötigt.
Ribbon anpassen
Welche Gruppen und Schaltflächen der primedocs-Registerkarte sichtbar sind, lässt sich organisationsweit konfigurieren. Die zugehörigen IDs und das XML-Format sind unter primedocs Ribbon-Elemente konfigurieren beschrieben.
Mit dem Umbau der Word-Gruppen sind mehrere Element-IDs entfallen. Einträge in <HiddenRibbonElements>, die darauf zeigen, laufen ohne Fehlermeldung ins Leere und blenden nichts mehr aus:
PrimeDocsTemplating.WordInsertSnippetBlockPlaceholderAction
PrimeDocsTemplating.WordInsertSnippetInlinePlaceholderAction
PrimeDocsTemplating.WordInsertSnippetTableRowsPlaceholderAction
PrimeDocsTemplating.WordInsertOrSetTrackedContentControlAction
PrimeDocsTemplating.WordDisplayDeveloperToolsAction
PrimeDocsTemplating.PrimeDocsTemplating.InsertPlaceholder
PrimeDocsTemplatingInDocumentMode.WordDisplayDeveloperToolsActionInDocumentMode
Die Entwicklerwerkzeuge sind nicht entfallen, sondern unter PrimeDocsTooling.WordDisplayDeveloperToolsAction erreichbar.