Zum Hauptinhalt springen

Operator - Formula

Formeln sind eine spezielle Art von Operationen

Hauptsächlich werden Formeln zur Verarbeitung von Variablen eingesetzt, um einfache bis komplexe Berechnungen von Variablenwerten durchzuführen. Ebenfalls können sie zum Beschneiden oder Umschreiben von Werten, sowie zum Manipulieren von Zeichenfolgen genutzt werden.

Anleitung​

Zunächst wird eine Zielvariable per Drag and Drop festgelegt.

Dann wechselt man im linken Bereich auf den Reiter "Operationen" und trägt per Drag and Drop "Formula" ein.

Im Folgenden erscheint ein neues Feld für den Value(Wert), wo die Formel eingetragen werden kann.

Über den Plus-Button können beliebig viele Parameter ergänzt werden.

Screenshot Operator "Formula"

In den Parameter-Feldern können konstante Werte eingetragen werden oder man verwendet Variablen aus dem Variablen-Reiter auf der linken Seite.

Wichtig: Werte sind JSON-Strings. Das bedeutet, Texte müssen in Anführungszeichen geschrieben werden. Für den Text Hallo Welt, muss man also "Hallo Welt" eingeben.

Die nummerierten Input-Felder können selbst keinen Formelcode enthalten und sind somit für Konstanten limitiert auf valide JSON Werte: string/number/boolean.

Beispiele​

Multiplizieren von zwei Werten​

Screenshot Beispiel Multiplizieren von zwei Werten

Bei aktiviertem Typecasting wird die Nachkommastelle gerundet und in die Ziel-Variable geschrieben.

Einen Text durch einen anderen ersetzen​

$[1].replace($[2], $[3])

Screenshot Beispiel Text ersetzen

Ergebnis: "Ich bin ein Text!"

Komplexes Beispiel: Lineare Umrechnung zwischen Wertebereichen​

($[3] - $[2]) * ($[1] - $[4]) / ($[5] - $[4]) + $[2]

Screenshot Lineare Umrechnung zwischen Wertebereichen

In diesem Beispiel bekommt man einen Lautstärkewert von einem Audio DSP in dB, also einen Wert zwischen -60 und 0. Dieser Wert wird in der Variable "Volume_in_DB" gespeichert.

Dieser Wert soll beispielsweise auf einem Dasboard in Prozent angezeigt werden. Dafür verwenden wir die Zielvariable "Volume_in_Percent"

Beträgt der dB Wert z. B. -20, soll auf dem Dashboard "66%" angezeigt werden.

$\[1\] = Ausgangswert in DB
$\[2\] = 0 = Zielwertebereich Anfang
$\[3\] = 100 = Zielwertebereich Ende
$\[4\] = -60 = Ausgangswertebereich Anfang
$\[5\] = 0 = Ausgangswertebereich Ende

Will man von Prozent in dB umrechen, können die Wertebereiche einfach vertauscht werden.

Über eine erweiterte Formel wäre auch eine logarithmische Umrechnung möglich.

Weitere Beispiele​

  • $[1].trim() zum Entfernen von Whitespace um einen String
  • $[1].toUpperCase() / $[1].toLowerCase() Alle Buchstaben in Groß- bzw. Kleinbuchstaben wandeln
  • $[1].length um die Länge eines Textes zu bestimmen
  • Math.floor((Math.random() * 10``) + 1``) Eine zufällige Zahl zwischen 1 und 10 generieren
  • Math.log($[1]) Logarithmus einer Zahl berechnen
  • Math.PI Für den Pi Wert
  • new Date().toISOString() Erstellt einen ISO String zur aktuellen Uhrzeit