Funktionen in Dokumentvorlagen

Aus Planfix
Wechseln zu: Navigation, Suche

Funktionen können beim automatischen Formatieren von documents mit Vorlagen verwendet werden. Funktionen vereinfachen, wie Daten in Ihren Dokumenten dargestellt werden. Sie können zum Beispiel Formeln verwenden, um Zahlen automatisch als Wörter anzuzeigen oder Bestellkosten zu berechnen.

Formeln

Um eine Formel in ein Dokument einzufügen, verwenden Sie die folgende Syntax: %%%FORMULA%%%.

EINE FORMEL ist ein Ausdruck zur Berechnung des Wertes eines Feldes, genauso wie in einem calculated field.

Beispiel:

%%%TEXT({{DataTag.Service.Quantity}}*{{DataTag.Service.Cost}};".2f")%%%

Im obigen Beispiel werden Daten aus dem Daten-Tag "Service" mittels der entsprechenden Variablen in die Formel eingebunden. Die beiden Werte werden multipliziert, und das Ergebnis ist der Gesamtpreis für eine bestimmte Dienstleistung oder ein Produkt. Die TEXT()-Funktion formatiert den Wert als menschenlesbare Textzeichenfolge.

Wichtig

Beispielsweise:

  • Formeln müssen als ein zusammenhängender String geschrieben werden und dürfen nicht durch Drücken der Eingabetaste geteilt werden. Wenn Sie einen Zeilenumbruch einfügen müssen, verwenden Sie die Sequenz "\n".
  • Ohne Zeilenumbruch
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{Datatag.Service calculation.Quantity}} + " " + {{Datatag.Service calculation."Unit"}} + " (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Mit Zeilenumbruch
%%%IF({{Datatag.Service calculation.Service}}=""; ""; {{Datatag.Service calculation.Service}} + " - " + {{atatag.Service calculation.Quantity}} + " " + {{{Datatag.Service calculation."Unit"}} + "\n (" + {{Datatag.Service calculation.Comment}} + ")" )%%%
  • Variablen in der Formel dürfen nicht formatiert werden, z. B. fett oder kursiv.
  • Wenn das Ergebnis der Formel fett dargestellt werden soll, wenden Sie die Formatierung auf die gesamte Formel an, einschließlich der Prozentzeichen.

Funktionen

Alle in Dokumentvorlagenformeln verfügbaren Funktionen:

Die SUM-Funktion

SUM() ist eine Funktion, die alle Werte aufsummiert, die bei der Berechnung einer Formel erhalten werden. Sie wird auf jedes Element einer multiplizierenden Variable angewendet.

Beispiel: Angenommen, Sie haben ein Daten-Tag "Service" und möchten die Gesamtkosten aller Leistungen in einem Dokument berechnen. Sie würden folgende Funktion verwenden: 

SUM({{DataTag.Service.Cost}})

Um die Gesamtkosten der erbrachten Leistungen zu erhalten, müssen Sie den Preis der Leistung mit der Anzahl multiplizieren, in der sie bestellt wurde. Verwenden Sie hierfür folgende Formel in Ihrem Dokument: 

SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}))

Beachten Sie, dass die SUM()-Funktion jede beliebige aus Funktionen zusammengesetzte Formel enthalten kann.

Die PLURALFORM-Funktion

Wird verwendet, um eine Endung an ein Wort anzufügen oder das Wort selbst zu verändern, falls es sich um ein unregelmäßiges Substantiv handelt, basierend auf der vor dem Wort stehenden Zahl in der Dokumentvorlage.

Format: 

PLURALFORM(number; "text1"; "text2";)

Abhängig vom berechneten Wert der Zahl wählt die Funktion einen der beiden Parameter aus. Die Parameter müssen in strenger Reihenfolge entsprechend dem Algorithmus angegeben werden.

Beispiel: Sie müssen das Wort "dollar" flektieren. Folgen Sie dem Algorithmus:

Schreiben Sie zuerst das gewünschte Wort mit der Zahl 1:

  • 1 dollar

Das bedeutet, dass der erste Parameter in der Funktion "dollar" statt "text1" sein sollte.

Dann schreiben Sie das Wort mit der Zahl 2:

  • 2 dollars

Das bedeutet, dass der zweite Parameter in der Funktion "dollars" statt "text2" sein sollte.

Schließlich können Sie folgende PLURALFORM()-Funktion im Dokument angeben:

PLURALFORM(SUM({{Datatag.Service.Cost}}*{{Datatag.Service.Quantity}}); "dollar"; "dollars")

Die NUMBERASWORDS-Funktion

Dies ist eine Funktion, die eine Zahl als Wörter zurückgibt. Es wird nur der ganzzahlige Teil der Zahl ausgeschrieben.

Format: 

NUMBERASWORDS(number; Output; "language")

Wobei:

  • number — eine Zahl oder Formel
  • Output — definiert, wie das Numeral dargestellt wird (von 0 bis 6)
  • language — Zeichenfolge, die die Ausgabesprache angibt. Wenn leer gelassen (""), wird die Sprache des Benutzers verwendet, der das Dokument erzeugt.

Sprachen und ihre Output-Methoden:

  • Englisch ("en")
    • 0-3 — Standard (Kardinalzahl)
    • 4-6 — großgeschriebene Standardform
  • Deutsch ("de")
    • 0 — Standard (geschlechtsneutral)
    • 1 — in weiblicher Form geschrieben
    • 2 — in männlicher Form geschrieben
    • 3 — in sächlicher (neutrum) Form geschrieben
    • 4 — in weiblicher Form großgeschrieben
    • 5 — in männlicher Form großgeschrieben
    • 6 — in sächlicher Form großgeschrieben
  • Französisch ("fr")
    • 0 — Standard (Kardinalzahl)
    • 1 — in weiblicher Form geschrieben
    • 2 — in männlicher Form geschrieben
    • 4 — in weiblicher Form großgeschrieben
    • 5 — in männlicher Form großgeschrieben

Beispiel: Um eine Zahl in einem Dokument als Wörter anzuzeigen, verwenden Sie folgende Funktion: 

NUMBERASWORDS(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2; "en")

Die FRACTIONALPART-Funktion

Diese Funktion zeigt den Bruchteil einer Zahl an. Sie können die Anzahl der Nachkommastellen angeben, die angezeigt werden sollen.

Format: 

FRACTIONALPART(number; NumberOfDigitsAfterDecimal)

Beispiel: Um die Anzahl der Cents für die Kosten einer Leistung in einem Dokument auszugeben, verwenden Sie folgende Funktion: 

FRACTIONALPART(SUM({{DataTag.Service.Cost}}*{{DataTag.Service.Quantity}}); 2)

Diese Funktion zeigt die zwei Stellen nach dem Dezimalpunkt an:

  • 176.03 — Funktion gibt 3 zurück.
  • 15.15 — Funktion gibt 15 zurück.
  • 16.156 — Funktion rundet die ersten beiden Dezimalstellen auf 16.

Gehe zu