Variablenformatierung

Einige Variablen verfügen über Formatierungsoptionen, mit denen Sie das Ausgabeformat festlegen können.

Datum

Mit der Option für das Datumsformat können Sie festlegen, in welcher Form das Datum ausgegeben werden soll.

{variable | date:'format'}

Dabei ist variable eine der oben genannten Variablen, und format legt das Datumsformat fest. Beispiel:

{rfq.createdAt | date:'MM DD, YYYY'}

Weitere Datumsformate finden Sie in der Datei Moment.js.

Boolesche Operationen

Die boolesche Formatoption ermöglicht die Verwendung eines booleschen Operators zur Ausgabe von benutzerdefiniertem Text.

{variable | bool:'true value': 'false value': 'N/A value'}

Dabei ist variable eine der Variablen, z. B.:

{rfq.properties['is approved'] | bool:'Y': 'N'}
{rfq.properties['is approved'] | bool:'GOOD': 'BAD': 'NA'}

Beispiel zum Erstellen eines Kontrollkästchens für benutzerdefinierte Attribute:

{rco.properties["checkbox3-1"] | bool: “☒”:”☐”}

Nummer

Mit der Option für das Zahlenformat können Sie das Format der numerischen Ausgabe festlegen.

{variable | number:'decimal points': 'group separator': 'fraction separator'}

Dabei ist variable eine der Variablen. decimal points legt die Anzahl der Nachkommastellen nach dem Bruchtrennzeichen fest, group separator legt das für das Gruppentrennzeichen zu verwendende Symbol fest, fraction separator legt das für das Bruchtrennzeichen zu verwendende Symbol fest. Beispiel:

{rco.approved | number:'2': ',': '.'}

würde eine Zahl wie 10.050,89 zurückgeben.

Sie können eine geschriebene Währung zu den Zahlenformatvariablen hinzufügen, indem Sie das Format writtenCurrency:'USD' verwenden. Beispiel:

{contract.awarded | writtenCurrency:'USD'}

Hier können Sie USD durch die tatsächliche Währung des erteilten Auftrags ersetzen.

Mathematikfunktionen

Auf Variablen in Dokumenten können mathematische Funktionen und Rundungen angewendet werden. Addieren, Subtrahieren, Multiplizieren und Dividieren werden unterstützt.

Beispiele:

{rfq.approved | add: 1}

{rfq.approved | minus: 2} 

{rfq.approved | multiply: 1.13} 

{rfq.approved | divide: 1.1}

Beispiel für mathematische Funktionen und Rundungen:

{rfq.approved | divide: 1.5 | rounding: '0.1': 'half-up'}

Sie können auch erweiterte mathematische Variablen erstellen, die bei der Arbeit mit Dokumentvorlagen für Zahlungsanwendungen hilfreich sein können. Beispiel:

Variablen Beschreibung
{previousQuantity | add: quantity | rounding: '0.01': 'half-up'} Gibt die Gesamtsumme des Zahlungsantrags bis heute zurück.
{previousAmount | add: amount | rounding: '0.01': 'half-up'} Gibt den Gesamtbetrag des Zahlungsantrags bis heute zurück.
{payment.lineView.totalPreviousAmount | add: payment.lineView.totalAmount | rounding: '0.01': 'half-up'} Gibt den Gesamtbetrag des Zahlungsantrags zurück.

Text

Mit der Option für das Textformat können Sie die Klein- und Großschreibung der Wortausgabe durch die Variable steuern.

{variable | case}

Dabei ist variable eine der Variablen, und case stellt eine der folgenden Optionen dar:

Beispiel:

{owner.name | uppercase}

Gibt den Firmennamen des Auftraggebers in Großbuchstaben zurück.

Rich Text Format

Um eine Rich-Text-Formatierung (z. B. fett oder kursiv) in eine Word-Dokumentvorlage zu übernehmen, müssen Sie ein "@"-Symbol zur benutzerdefinierten Variable hinzufügen.

Beispiel:

Bei einer Anmerkungsvariablen {rco.note} sieht das Hinzufügen eines "@"-Symbols wie folgt aus: {@rco.note}. Durch diese Änderung wird sichergestellt, dass die Rich-Text-Formatierung aus den Änderungsauftragsanmerkungen enthalten ist.

Kürzen

Sie können die Dateierweiterungen aus generierten Dokumenten entfernen. Wenn Sie beispielsweise die Variable {{{-w contract.exhibits}{targetName}{/contract.exhibits}}} verwenden, kann diese die Dateinamenerweiterung .docx oder .pdf im generierten Dokument enthalten.

Wenn alle Ihre Dateien im DOCX-Format vorliegen, können Sie die Erweiterung entfernen, indem Sie die Funktion trimEnd verwenden:

{targetName | trimEnd:'.docx'}

Wenn Sie sowohl DOCX- als auch PDF-Dateien haben und beide Erweiterungen entfernen möchten, können Sie die trimEnd-Funktion wie folgt verketten:

{targetName | trimEnd:'.docx' | trimEnd:'.pdf'}

Zusammengesetztes Element

Die Formatierungsoption für zusammengesetzte Elemente ermöglicht das Kombinieren von zwei anderen Formaten.

{variable | format1 | format2}

Dabei ist variable eine der Variablen, und format1 und format2 stellen zwei verschiedene, oben aufgeführte Formatierungsoptionen dar.

Beispiel:

{rco.approved | written | uppercase}

Teilen

Mit der Funktion split können Sie eine Zeichenfolge anhand eines bestimmten Zeichens oder einer Reihe von Zeichen, auch Trennzeichen genannt, in verschiedene Teile trennen.

Hier sehen Sie ein Beispiel:

{ number | split:'-' | get:'1' }

Dieser Befehl teilt die in der Variablen number gespeicherte Zeichenfolge an jedem - und ruft dann den zweiten Teil der Teilungszeichenfolge ab (da die Zählung bei 0 beginnt).

Angenommen, die Variable number enthält die Zeichenfolge "1.1-001-ABC 01-CD EF 00FF-1.9G". Die folgenden Ergebnisse werden mit den einzelnen get-Befehlen erzielt:

Alternativ können Sie die Funktion slice oder den Befehl last verwenden, um Teile der Zeichenfolge zu extrahieren:

Sortieren

Wenn Sie über eine Liste oder Datensammlung verfügen, können Sie diese nach Nummer entweder aufsteigend (asc) oder absteigend (desc) sortieren.

Verwenden Sie folgendes Format:

{#variable | sortBy:'number':'order'}{/variable | sortBy:'number':'order'}

Beispiel:

{#oco.pco | sortBy:'number':'asc'}{/oco.pco | sortBy:'number':'asc'}