Ausgabe-Formatter in Vorlagen

Ein Feld kann in seiner Konfiguration einen Ausgabe-Formatter tragen, also eine Regel, die aus dem gespeicherten Rohwert eine lesbare Form macht: aus einem Maßfeld „118,5 × 64 × 21 cm“, aus einer Adresse eine Zeile. Für Vorlagen heißt das, die Formatierung steht einmal am Feld statt in jedem Befehl.

Der Rohwert bleibt immer erreichbar. $o[`Maße`] gibt ihn aus, ffmt($o, `Maße`) die Formatierung.

Maße ist in den Beispielen dieser Seite ein angenommenes Maßfeld mit Einträgen wie „Objekt“. Im Demo-Bestand gibt es kein Feld dieses Namens; dort heißen die Maßfelder Breite, Höhe und Tiefe, und ffmt($o, `Breite#einheit`) liefert etwa „118,5 cm“.

Die zwei Schreibweisen

Schreibweise	Gilt für	Bemerkung
ffmt(datensatz, `Schlüssel`)	Überall, auch in Schleifen	Der Vorlagen-Editor fügt immer diese Form ein
$fmt[`Schlüssel`]	Nur das aktuelle Objekt	In einer Schleife über `objects` falsch, siehe unten

{#ffmt($o, `Maße`) ?? ``#}
{#$fmt[`Maße`] ?? ``#}
{# FOR obj IN objects #}{#ffmt($obj, `Maße`) ?? ``#}{# END-FOR obj #}

Ist nichts formatiert, liefern beide null. Der Befehl bleibt dann leer, ein Rückfall mit ?? greift wie bei fdate und imask.

In Schleifen ffmt verwenden

$fmt gehört zum aktuellen Objekt. Eine Vorlage mit Schleife über objects rendert genau einmal, mit dem ersten Objekt als aktuellem. $fmt zeigt dort in jeder Zeile die Werte des ersten Objekts. ffmt($obj, …) nimmt das Objekt als Argument und ist deshalb auch in der Schleife richtig. Wer überall ffmt schreibt, kann es nicht falsch machen.

Der Schlüssel

Der Schlüssel beginnt mit dem Feldnamen. Ein Punkt wählt einen Eintrag, eine Raute eine Variante:

Schlüssel	Ergebnis
`Maße`	Basisvariante, ganzes Feld
`Maße.Objekt`	Basisvariante, nur der Eintrag „Objekt“
`Maße#kurz`	Variante „kurz“, ganzes Feld
`Maße#kurz.Objekt`	Variante „kurz“, nur der Eintrag „Objekt“

Einträge gibt es nur bei JSON-Feldern ; hinter dem Punkt steht die Beschriftung des Eintrags.

Als Basisvariante gilt die mit der Kennung standard, gibt es sie nicht, die erste in der Feldkonfiguration. Kommt später eine Formatierung dazu, gibt ffmt($o, `Maße`) in einer bestehenden Vorlage also weiter dasselbe aus. Eine unbekannte Kennung liefert null; auf die Basisvariante fällt sie nicht still zurück.

Ein Feldname darf einen Punkt enthalten: ffmt($o, `Inv.Nr.`) funktioniert, weil Moliri zuerst den ganzen Schlüssel gegen die Feldliste prüft. Eine Raute ist in Feldnamen nicht erlaubt, damit sie eine Variante nie verdecken kann.

Die Vorauswahl am Feld wirkt hier nicht

Am Formatter lässt sich einstellen, welche Variante in Ansichten und Exportdialogen vorausgewählt ist. Das betrifft nur diese Umschalter. In einer Vorlage entscheidet allein der Schlüssel, ohne Raute ist es immer die Basisvariante.

Mitgelieferte Formatierungen je Feldart

Jede Feldart bringt eine Formatierung mit (seit v1.4.23 auch 3D, HTML, Uhrzeit, Link, die Auswahlfelder, Schlagworte und Normdatensatz). Ein Feld kann eigene Varianten ergänzen oder eine mitgelieferte mit derselben Kennung ersetzen. Die Tabelle zeigt den Auslieferungsstand; was ein Feld in Ihrem Projekt tatsächlich trägt, steht in seiner Konfiguration.

Feldart	Variante (Kennung)	Ergebnis
Zahl (Dezimal, Ganzzahl)	Zahl (`standard`)	Nur die Zahl nach der Maske des Feldes
	Zahl mit Einheit (`einheit`)	Zahl und Einheit, etwa „118,5 cm“
Datum	Datum TT.MM.JJJJ	Unvollständige Daten verkürzt, etwa „03.2025“
Schalter	Beschriftung	Die Ein- oder Aus-Beschriftung des Feldes
Adresse	Adresse einzeilig	Einrichtung, Person, Straße und Nummer, PLZ und Ort
Geoposition	Ort einzeilig	Der Ort in einer Zeile
JSON	Einträge einzeilig	Alle Einträge in einer Zeile
Bild, Datei, Audio, Video, Panorama, 3D	Dateititel	Titel, sonst Beschreibung, sonst Kennung und Endung der Datei
HTML	Nur der Text	Der Text ohne Auszeichnung
Uhrzeit	Uhrzeit HH:MM	Stunden und Minuten
Link	Ohne Protokoll (`standard`)	Die Adresse ohne `https://`
	Nur die Domain (`domain`)	Nur der Rechnername
Auswahl mit Hierarchie	Nur die unterste Ebene	Der letzte Begriff des Pfads
Auswahl, Schlagworte	Mit Mittelpunkt getrennt	Mehrere Werte mit „·“ verbunden
Normdatensatz	Nur das Label (`standard`)	Die Bezeichnung des Begriffs
	Label mit Quelle (`quelle`)	Bezeichnung und Herkunft

Die Kennung ist nur dort angegeben, wo eine Feldart mehr als eine Variante mitbringt. Nur dann braucht der Schlüssel eine Raute: ffmt($o, `Breite#einheit`).

Zahlenfelder seit v1.4.23

Bei einem Zahlenfeld gibt die Basisvariante „Zahl“ nur noch die Maske aus. Die Einheit steht in der zweiten Variante „Zahl mit Einheit“. Vorlagen, die sich auf die Einheit in ffmt($o, `Breite`) verlassen haben, brauchen jetzt ffmt($o, `Breite#einheit`).

Formatierung beim Einfügen wählen

Im Vorlagen-Editor bietet das Autor-Panel beim Einfügen eines Feldes unter Ausgabe die Wahl zwischen Rohwert und den Formatierungen des Feldes, bei Breite etwa Zahl und Zahl mit Einheit. Die Auswahl erscheint nur, wenn das Feld einen Ausgabe-Formatter hat. Unter Das wird eingefügt steht der fertige Befehl, darunter ein Beispielwert, sofern einer vorliegt. Die Kennung schreibt das Panel selbst. Das Word-Add-in kennt diese Wahl nicht. Dort wird ffmt von Hand geschrieben.

Autor-Panel im Vorlagen-Editor mit dem Zahlenfeld Breite: Ausgabe Zahl mit Einheit statt Rohwert, darunter der Beispielwert und die Formatwahl

Formatter pflegen

Angelegt und geändert werden Formatter in der Feldverwaltung (Feld, Abschnitt Ausgabe-Formatter) und je Feldart in der Feldarten-Verwaltung. Das ist Aufgabe der Einrichtung, siehe Feldkonfiguration . Ein Formatter sieht nur den Wert des eigenen Feldes. Wer über mehrere Felder rechnen will, nimmt ein virtuelles Feld .

Die Vorab-Prüfung im Vorlagen-Editor erkennt Tippfehler in Formatter-Schlüsseln.

Weiterlesen

Vorlagen-Variablen : $o, $fmt und die übrigen Daten
Vorlagen-Funktionen : ffmt neben den anderen Hilfen
Feldarten : Rohwert und Formatierung aus Sicht der Erfassung