Word-Vorlage erstellen

Eine Vorlage ist eine gewöhnliche Word-Datei mit Befehlen der Form {# … #} im Text. Angelegt wird sie entweder direkt im Vorlagen-Editor im Browser oder als Word-Datei, die Sie hochladen. Beides beginnt am selben Ort: Reiter Im- und Export, unter Export der Knopf Word Berichte. Es öffnet sich das Fenster Word-Report exportieren mit der Vorlagenbibliothek.

Im Vorlagen-Editor anlegen

1. Neue Vorlage anklicken und einen Namen eingeben. Der Editor öffnet ein leeres Word-Dokument im Browser.

2. Das Dokument wie in Word gestalten: Kopfzeile, Tabellen, Absatzformate.

3. Den Cursor an die Stelle setzen, an der ein Wert stehen soll, und im Panel Moliri · Einfügen & Bearbeiten links unter Felder ein Feld wählen. Bei Feldern mit Ausgabe-Formatter wählen Sie dort zwischen Rohwert und den Formatierungen, mit Beispielwert. Einfügen setzt den Baustein an den Cursor.

4. Mit Strg+S speichern. Prüfung und Vorschau laufen danach von selbst. Einen eigenen Speichern-Knopf gibt es nicht.

5. Vorschau in der Leiste über dem Editor öffnet daneben die Bericht-Vorschau mit den Reitern Vorschau und Prüfung. Wie viele Objekte die Vorschau verwendet, stellen Sie dort unter Objekte ein, oder Sie schalten Alle Objekte ein.

Menüs und Werkzeugleiste des Editors erscheinen in der Sprache, die Sie in Moliri eingestellt haben, auch bei einer deutschen Vorlage. Die Sprache des Dokuments, die unten in der Statusleiste steht, bleibt die der Vorlage.

Einfügen und Bearbeiten im linken Panel

Das linke Panel Moliri · Einfügen & Bearbeiten folgt dem Cursor. Die Zeile oben sagt, was der nächste Klick tut. Steht dort Neu, entsteht ein neuer Baustein; dahinter steht sein Bezug, außerhalb einer Schleife Dieses Objekt. In einer Schleife wählen Sie dort zwischen Jede Zeile der Schleife und Dieses Objekt.

Steht der Cursor in einem vorhandenen Baustein, nennt die Zeile ihn mit Namen, etwa Feld »Datierung«, und das Panel zeigt sein Formular. Übernehmen schreibt die Änderung in den Baustein, Verwerfen nimmt sie zurück, Löschen entfernt ihn. Unter Code bearbeiten steht der Befehl als Text. Ein Baustein ohne passendes Formular heißt Eigener Ausdruck und lässt sich nur als Code bearbeiten. Neuen Baustein einfügen verlässt den Baustein, ohne den Cursor zu bewegen.

Neben dem Reiter Felder liegen unter Strukturen fertige Muster in vier Gruppen:

Jedes Muster trägt eine Marke: Feld heißt, ein Klick auf den fertigen Baustein öffnet wieder sein Formular, Code heißt, er wird danach als Code bearbeitet.

Das Muster Verknüpfungen fügt die Verknüpfungen einer Art ein, etwa alle Nachweise „dokumentiert in“. Unter Ausgabe stehen Liste (eine Zeile je Verknüpfung), Alle in einer Zeile, Nur die erste und Anzahl; Mit Zusatzangaben hängt Angaben wie die Seite an. Anzahl zählt wie Ansicht und Excel-Export auch die Verknüpfungen mit, die Sie nicht lesen dürfen; von ihnen erscheint nur die Zahl, nie der Inhalt.

Prüfung im rechten Panel

Das rechte Panel Moliri · Prüfung hat die Reiter Prüfung, Aufbau und Einstellungen. Die Prüfung sammelt, was beim Export schiefgehen würde: unter Fehler nicht geschlossene Schleifen und Bedingungen und Ausdrücke, die nicht laufen; unter Hinweise Felder, die es im aktuellen Projekt nicht gibt (Fehlt im Projekt), und alte Feldnamen; unter Nur Text (nicht verknüpft) Befehle, die als bloßer Text in der Vorlage stehen. Bausteine erkennen macht aus solchem Text Bausteine. Dazu kommt die Feldzuordnung, siehe unten . Ein Klick auf einen Eintrag setzt den Cursor auf den Baustein, und das linke Panel zeigt sein Formular.

Aufbau listet alle Befehle in der Reihenfolge des Dokuments, getrennt nach Haupttext, Tabellen und Kopf- und Fußzeilen; Nach Art ordnet sie stattdessen nach Feldern, formatierten Werten, Zahlen, Bildern, Schleifen, Bedingungen und Definitionen. Unter Nicht verwendet stehen die Felder des Projekts, die in der Vorlage nicht vorkommen.

Unter Einstellungen legen Sie im Abschnitt Ergebnis fest, ob ein Dokument je Objekt oder eines für alle entsteht (Aufteilung), wie Einzeldokumente aneinanderschließen (Übergang zwischen Objekten) und ob die Werte im Bericht Als normaler Text stehen. Diese Einstellungen reisen in der Vorlage mit, siehe Vorlagen-Syntax . Im Abschnitt Bearbeiten schaltet Bausteine entsperren die Bausteine zum Formatieren frei, und Code im Dokument zeigt die Befehle zwischen {# und #} in normaler Größe, kleiner oder mit lesbaren Namen. Am Ergebnis ändert das nichts.

Eine Word-Datei hochladen

Wer lieber in Microsoft Word schreibt, mit oder ohne Word-Add-in , lädt die fertige Datei hoch. Moliri fragt dann, was mit der Datei geschehen soll:

Zum Ausprobieren eignet sich Direkt verwenden: Fehler zeigen sich, ohne dass die Bibliothek sich füllt.

Steht in der Datei noch ein Feldname aus der Zeit vor der Umstellung auf englische Namen, etwa p.projektname statt p.name, nennt der Dialog darüber unter Alte Namen in der Vorlage die gefundenen Paare. Solche Namen bleiben im Bericht leer. Umschreiben setzt die heutigen Namen in die Datei ein, bevor Sie eine der drei Möglichkeiten wählen; was sich nicht umschreiben ließ, zählt der Hinweis danach auf.

Eine Vorlage entwerfen lassen

Neben Neue Vorlage liegt das Symbol Prompt für eine Vorlage kopieren (Sternchen). Es legt eine fertige Anfrage für ein Sprachmodell Ihrer Wahl in die Zwischenablage. Darin stehen die Regeln der Vorlagensprache aus diesem Bereich und der Feldkatalog des Projekts, also Namen, Feldarten und Unterfelder der Felder, die Sie lesen dürfen. Objektdaten enthält sie nicht.

Ganz oben im kopierten Text steht eine leere Zeile AUFGABE. Dort beschreiben Sie in ein bis zwei Sätzen, was die Vorlage leisten soll, etwa „Objektblatt mit Bild, Titel, Datierung und Maßen, ein Objekt je Seite“. Moliri schickt nichts an ein Sprachmodell. Den Vorlagentext, den das Modell zurückgibt, übernehmen Sie von Hand in den Vorlagen-Editor oder in Word. Danach zeigt die Prüfung wie bei jeder anderen Vorlage, ob die Befehle laufen und die Felder stimmen.

Feldnamen

Befehle sprechen Felder über ihren Feldnamen an, die Bezeichnung des Feldes, nicht die Beschriftung auf dem Layout (Eingabemaske). Im Vorlagen-Editor und im Word-Add-in stehen die Felder zur Auswahl. Wer von Hand schreibt, findet den Namen in den Feld-Metadaten eines Objekts.

Feldnamen gelten je Projekt. Eine Vorlage aus einem anderen Projekt funktioniert so weit, wie die Namen übereinstimmen. Ein Feld, das es im Projekt nicht gibt, bleibt im Bericht leer, bis Sie es einem vorhandenen Feld zuordnen.

Wird ein Feld unter Datenmodell › Felder umbenannt, schreibt Moliri die gespeicherten Vorlagen auf den neuen Namen um. Was sich dabei nicht umschreiben ließ, meldet eine Warnung; die betroffenen Stellen stehen im Bericht des Laufs.

Fehlende Felder je Projekt zuordnen

Im Vorlagen-Editor listet der Reiter Prüfung unter Feldzuordnung jedes Feld der Vorlage, das es im aktuellen Projekt nicht gibt, mit einer Feldauswahl daneben. Wählen Sie dort das Feld, aus dem der Export stattdessen lesen soll. Die Wahl wird in der Vorlage gespeichert und gilt nur für dieses Projekt. Die Befehle der Vorlage ändern sich nicht, in anderen Projekten wirkt die Zuordnung nicht. Der Reiter Prüfung der Vorschau führt solche Felder unter Zugeordnet.

Beim Export ist die Zuordnungstabelle mit dieser Wahl vorbelegt, gekennzeichnet mit aus der Vorlage. Für einen einzelnen Bericht lässt sie sich dort noch ändern, siehe Word-Bericht erstellen .

Befehle von Hand schreiben

Ein Feldwert mit leerem Rückfall:

{#$o[`RegNr`] ?? ``#}

Der Teil nach ?? ist ein leerer Rückfall. Ohne ihn kann ein leeres Feld Folgefehler auslösen; er gehört an jedes Feld.

Word ersetzt gerade Anführungszeichen gern durch typografische. Moliri toleriert das, trotzdem sind Backticks die sichere Wahl, weil Word sie nie verändert:

{#$o[`Objekthöhe`] ?? ``#}     empfohlen: Backticks
{#$o["Objekthöhe"] ?? ""#}     riskant

Die Befehle für den Anfang

Beispiel: ein Objektblatt

Bild, Kerndaten und Maße eines Objekts. Die Feldnamen stammen aus einem Beispielprojekt:

{#IMAGE img(($o[`Titelbild`] ?? null), { width: 8, height: 6 })#}

{#$o[`RegNr`] ?? ``#}, {#$o[`Originaltitel`] ?? ``#}

Künstler:  {#[$o[`Kuenstler_Vorname`], $o[`Kuenstler_Zuname`]].filter(Boolean).join(` `)#}
Datierung: {#fdate($o[`Datierung`], `JJJJ`) ?? `o. J.`#}
Material:  {#$o[`Material`] ?? ``#}
Maße:      {#ffmt($o, `Maße`) ?? ``#}

Das ?? null beim Bildfeld sorgt dafür, dass Objekte ohne Bild einen Platzhalter bekommen statt eines Fehlers.

In einer Schleife heißt die Laufvariable mit $ davor, $file statt file. Das ist die häufigste Fehlerquelle, siehe Vorlagen-Syntax .

Ein Dokument oder eines je Objekt

Die Vorlage entscheidet das, nicht der Exportdialog:

Testen und ablegen

Zum Testen die Objektauswahl auf zwei oder drei Objekte eingrenzen. Fehler zeigen sich genauso, und der Durchlauf dauert Sekunden. Erst wenn die Vorlage stimmt, mit allen Objekten exportieren.

In der Bibliothek hat jede Vorlage Bearbeiten, Kopie bearbeiten und Kategorie ändern. Kategorien gruppieren die Liste, die Suche findet Vorlagen auch mit Tippfehlern.

Weiterlesen

• Rezepte : Leihvertrag, Objektliste, Zustandsprotokoll
• Word-Add-in : Vorlagen in Microsoft Word schreiben
• Word-Bericht erstellen : aus der Vorlage den Bericht erzeugen
• Vorlagen-Syntax , Variablen , Funktionen