Technische Details des Ausdruckseditors

Übersicht

Hier finden Sie eine Liste aller Datentypen und Funktionen des Ausdruckseditors.

Diese Liste wird Ihnen helfen, alle Funktionen und Datentypen des Ausdruckseditors zu verstehen.

Hier finden Sie einen Leitfaden zur Verwendung des Ausdruckseditors im App-Editor und einen Leitfaden zur Verwendung im Analytic-Editor.

Typen

Jedes Feld, jeder Wert und jeder Unterausdruck hat einen Datentyp, mit dem das Tulip-System prüfen kann, ob Ihr Ausdruck gültig ist. Dies verhindert, dass der Ausdruck Operationen wie das Hinzufügen von 3 zu einem Wochentag ausführt. Solange Ihr Ausdruck einen logischen Sinn ergibt, sollten Sie auf keine Typfehler stoßen; falls doch, zeigt der Editor eine Fehlermeldung mit der Regel an, die Sie verletzt haben. Der Ausdruckseditor verwendet die folgenden Typen:

• Text: Eine Folge von Zeichen, wie "foo" oder "abc123".
• Ganzzahl: Eine ganze Zahl (eine Zahl ohne Nachkommastellen), z. B. -3, 0 oder 5.
• Zahl: Jede reelle Zahl, z. B. -3,2, 0, 3 oder 4,2345.
• Intervall: Eine Zeitspanne, gemessen in Sekunden.
• Boolescher Wert: wahr oder falsch.
• Wochentag: Ein Wochentag, z. B. Montag oder Samstag.
• Datum: Ein Datum, z. B. Mittwoch, 29. November 2017.
• Datetime: Eine Uhrzeit und ein Datum, z. B. Mittwoch, 29. November 2017 um 1:05 PM EST.
• Woche: Eine Woche, z. B. die Woche, die am Montag, 27. November 2017, beginnt.
• Monat: Ein Monat, z.B. November 2017.
• Benutzer: Jeder Benutzer im Tulip-System, wie hier beschrieben.
• Station: Eine beliebige Station in der Werkstatt, wie hier beschrieben.
• App: Jede Tulip-App.
• App-Version: Eine Version einer App, wie hier beschrieben.

Bediener

!

Logisches NICHT. Gibt wahr zurück, wenn und nur wenn sein Argument falsch ist.

Beispiel: @variable.arbeitsauftrag_nummer != 123456

=

Prüft, ob der Wert von zwei Operanden gleich ist oder nicht. Wenn ja, wird die Bedingung wahr.

Bsp: (A = B)

>

Prüft, ob der Wert des linken Operanden größer ist als der Wert des rechten Operanden, wenn ja, dann wird die Bedingung wahr.

Bsp: (A > B) ist nicht wahr.

<

Prüft, ob der Wert des linken Operanden kleiner ist als der Wert des rechten Operanden, wenn ja, dann wird die Bedingung wahr.

Beispiel: (A < B) ist wahr.

>=

Prüft, ob der Wert des linken Operanden größer oder gleich dem Wert des rechten Operanden ist; wenn ja, ist die Bedingung erfüllt.

Beispiel: (A >= B) ist nicht wahr.

<=

Prüft, ob der Wert des linken Operanden kleiner oder gleich dem Wert des rechten Operanden ist, wenn ja, dann wird die Bedingung wahr.

Beispiel: (A <= B) ist wahr.

&

Logisches UND. Wenn beide Operanden ungleich Null sind, dann ist die Bedingung erfüllt.

Beispiel: (A & B) ist wahr.

|

Wenn einer der beiden Operanden ungleich Null ist, ist die Bedingung erfüllt.

Beispiel: (A | B) ist wahr.

+

Addiert zwei Operanden

Beispiel: A + B ergibt 30

-

Subtrahiert den zweiten Operanden vom ersten

Beispiel: A - B ergibt -10

*

Multipliziert beide Operanden

Bsp: A * B ergibt 200

/

Dividieren des Zählers durch den Nenner

Beispiel: B / A ergibt 2

%

Gibt den Rest einer ganzzahligen Division aus

Beispiel: B % A ergibt 0

Funktionen

Dies sind alle Funktionen, die sowohl im Analytics Editor als auch im App Editor zur Verfügung stehen. Beachten Sie, dass alle Beispiele auf App-Abschlüssen basieren. Wenn Sie also z. B. eine MAXIMUM()- oder MINIMUM()-Funktion verwenden, suchen Sie nach dem Maximal- oder Minimalwert einer Variablen über alle Abschlüsse einer App.

Analyse-Editor und App-Editor

TEXTTOBOOLEAN()

Analysiert Text in einen Booleschen Wert.

"y", "yes", "t", "true" und "on" und alle großgeschriebenen Varianten werden als wahr erkannt, und "n", "no", "f" "false" und "off" werden als falsch erkannt.

Beispiel. TEXTTOBOOLEAN("ja")

TEXTTONUMMER()

Wandelt Text oder Zeitstempel in eine Zahl um

Beispiel. TEXTTONUMBER("2.4")

TEXTZUGANZZAHL()

Wandelt einen Text oder ein Intervall in eine ganze Zahl um.

Beispiel. TEXTZUGANZZAHL("123")

TOTEXT()

Analysiert irgendetwas in Text.

Bsp. TOTEXT(2)

RUNDEN()

Rundet eine Zahl auf die angegebene Anzahl von Dezimalstellen. Maximal 3 Dezimalstellen.

Beispiel. 1 - ROUND(123.123456, 1)

Das Ergebnis ist 123,1

Bsp. 2 - RUNDEN(123,12)

Dies gibt 123 zurück

SEKUNDEN_IN_INTERVALL()

Wandelt Sekunden in ein Intervall um.

SECONDS_TO_INTERVAL(Sekunden: Integer oder Zahl) => Intervall

Beispiel. SEKUNDEN_ZUM_INTERVALL(20) => 0:00:20

CEIL()

Rundet auf die nächste Ganzzahl auf

FLOOR()

Rundet auf den nächsten Integer ab

LINK()

Gibt das erste der Argumente zurück, das nicht null ist.

Beispiel. LINK(Gewicht, 70)

Dies gibt den Wert von Gewicht zurück, wenn Gewicht einen Wert hat

SUBSTITUTE()

Ersetzt innerhalb einer Zeichenkette, die im ersten Argument angegeben ist, alle Beispiele des zweiten Arguments durch das dritte Argument

Beispiel. ERSATZ("A734", "7", "3")

Dies gibt "A334" zurück.

WENN()

Gibt auf der Grundlage des ersten Arguments das zweite Argument zurück, wenn das erste Argument wahr ist, oder das dritte Argument, wenn das erste Argument falsch ist.

Beispiel. WENN(wahr, 1, 2)

ROUNDDATETIME()

Rundet einen Datetime-Wert auf eine bestimmte Einheit ab, wie Monat oder Tag.

Bsp. ROUNDDATETIME*(datetime_variable*, "Monat", "Amerika/New_York")

Dies konvertiert eine Datetime-Variable nur in den Monat in Eastern Standard Time.

Hinweis: Der letzte Parameter, die Zeitzone, muss aus einem der hier aufgeführten tz-Datenbanknamen stammen.

DATETIMETOTEXT()

Konvertiert einen Datetime-Wert in einen Text, der von einem Menschen leicht gelesen werden kann.

Beispiel. DATETIMETOTEXT*(datetime_variable*, "MMMM TT, JJJJ", 'Amerika/New_York')

Dies konvertiert einen Datumswert in Eastern Standard Time und zeigt ihn in der traditionellen Datumsformatierung wie "1. Januar 2019" an.

Hinweis: Der letzte Parameter, die Zeitzone, muss aus einem der hier aufgeführten tz-Datenbanknamen stammen.

TEXTTODATETIME()

Konvertiert einen Textwert in einen Datetime-Wert mit den angegebenen Parametern. Wird häufig verwendet, wenn Sie eine Connector-Funktion haben, die einen Datetime-Wert im Textformat bereitstellt und Sie diesen konvertieren müssen.

LEFT()

Gibt eine Teilzeichenkette eines Textwertes zurück, beginnend an der durch das zweite Argument angegebenen Position.

RECHTS()

Gibt eine Teilzeichenkette eines Textwerts zurück, die an der durch das zweite Argument angegebenen Position endet.

MITTE()

Gibt eine Teilzeichenkette eines Textwertes zurück, die an der durch das zweite Argument angegebenen Position beginnt. Das dritte Argument gibt die Länge der Rückgabe an.

SPLIT()

Teilt einen Textwert durch ein angegebenes Trennzeichen in ein Array auf.

FIND()

Gibt die Position zurück, an der das erste Argument innerhalb des zweiten Arguments vorkommt.

LEN()

Gibt die Länge eines Textwertes zurück.

TRIM()

Entfernt eine Teilzeichenkette (angegeben durch das zweite Argument) vom Anfang und Ende des ersten Arguments.

REGEX_MATCH()

Gibt ein Array von Übereinstimmungen eines regulären Ausdrucks mit einem Textwert zurück. Die Übereinstimmungen basieren auf dem angegebenen regulären Ausdruck und den Modifikatoren.

ISNULL()

Gibt true zurück, wenn das Argument null ist, andernfalls false.

Nur App Editor

ARRAYCONTAINS()

Ermittelt, ob ein Wert in einem Array enthalten ist

Beispiel. ARRAYCONTAINS([1,2,3], 1)

Dies gibt "wahr" zurück

ARRAY_MIN()

Ermittelt das Minimum eines gegebenen Arrays

Beispiel. ARRAY_MIN([1,2,3])

Dies würde 1 zurückgeben

ARRAY_MAX()

Gibt das Minimum eines gegebenen Arrays zurück

Beispiel. ARRAY_MAX([1,2,3])

Dies würde 3 zurückgeben

ARRAY_AVG()

Gibt den Durchschnitt aller Zahlen in einem Array zurück

Beispiel. ARRAY_AVG([1,2,3])

Dies würde 2 zurückgeben

ARRAY_STDEV_POPULATION()

Gibt die Standardabweichung der Grundgesamtheit eines gegebenen numerischen Arrays zurück

Beispiel. ARRAY_STDEV_POPULATION([1,2,3])

Dies würde 0.816496580927726 zurückgeben

ARRAY_STDEV_SAMPLE()

Gibt die Standardabweichung der Stichprobe eines gegebenen numerischen Arrays zurück

Beispiel. ARRAY_STDEV_SAMPLE([1,2,3])

Dies würde 1 zurückgeben

ARRAY_CONCAT()

Gibt ein einzelnes Array mit allen Elementen aus den Arrays zurück, die in den Argumenten enthalten sind. Funktioniert nur mit Arrays desselben Typs, d. h. mit allen Text-Arrays.

Beispiel. ARRAY_CONCAT([1,2],[3,4],[5,6])

Dies würde [1,2,3,4,5,6] zurückgeben.

HEX_TO_INT()

Gibt die numerische Darstellung einer gegebenen hexadezimalen Zeichenkette zurück.

Beispiel. HEX_TO_INT('0xAB18') = '43800

INT_TO_HEX()

Gibt die hexadezimale Darstellung einer gegebenen Zahl zurück.

Beispiel. INT_TO_HEX('43800') = '0xAB18'

RANDOMSTRING()

Gibt eine zufällige 17-Zeichen-Zeichenkette zurück. Dient der Erstellung einer ID für einen neuen Tabellendatensatz.

MAX()

Nur App-Editor

Gibt das Argument mit dem höchsten Wert zurück.

Beispiel. MAX(var1, var2)

Dies gibt den Wert von var1 zurück, wenn er größer ist als der Wert von var2

MIN()

Nur App-Editor

Gibt das Argument mit dem höchsten Wert zurück

Beispiel. MIN(var1, var2)

Dies gibt den Wert von var1 zurück, wenn er kleiner ist als der Wert von var2

GROSSBUCHSTABE()

Konvertiert eine Zeichenkette in Großbuchstaben

LOWERCASE()

Konvertiert eine Zeichenkette in Kleinbuchstaben

SIN()

Gibt den Sinus der gegebenen Eingabe zurück

COS()

Gibt den Kosinus der gegebenen Eingabe zurück

TAN()

Gibt den Tangens der gegebenen Eingabe zurück

ABS()

Gibt den absoluten Wert einer Zahl zurück

SQRT()

Gibt die Quadratwurzel einer Zahl zurück

POW()

Gibt das erste Argument hochgerechnet auf das zweite Argument zurück

Beispiel. POW(3,2)

Dies gibt 9 zurück

ENTHALTEN()

Gibt zurück, ob eine Zeichenkette eine bestimmte Teilzeichenkette enthält

Bsp. ENTHÄLT("123ABC", "123")

Dies würde "wahr" zurückgeben

RAND()

Erzeugt eine zufällige Dezimalzahl zwischen 0 und 1

RANDBETWEEN()

Erzeugt eine zufällige Ganzzahl zwischen zwei angegebenen Zahlen

Beispiel. RANDBETWEEN(5,10)

RANDOM_COLOR()

Erzeugt eine zufällige Farbe

Beispiel. RANDOM_COLOR() = ##c537a5

RGB(r: Ganzzahl, g:Ganzzahl, b:Ganzzahl) => Farbe

Gibt eine Farbe mit den angegebenen Rot-, Grün- und Blaukomponenten zurück

Beispiel. RGB(255, 255, 0) = ##ffff00

RGA(r: Ganzzahl, g:Ganzzahl, b:Ganzzahl, a:Ganzzahl) => Farbe

Gibt eine Farbe mit den angegebenen Rot-, Grün-, Blau- und Alpha-Komponenten zurück

Beispiel. RGA(255, 255, 0, 0.5) = ##ffff00 (50% Deckkraft)

MAP_TO_BOOLEAN_LIST*(a:* {} array, b: text) => array

Konvertiert ein Objekt-Array in ein Basis-Array für den angegebenen Schlüssel

Beispiel. MAP_TO_BOOLEAN_LIST([{Schlüssel: Wert}], 'Schlüssel') = [Wert]

MAP_TO_NUMBER_LIST*(a:* {} array, b: text) => array

Konvertiert ein Objekt-Array in ein Basis-Array für den angegebenen Schlüssel

Beispiel. MAP_TO_NUMBER_LIST([{Schlüssel: Wert}], 'Schlüssel') = [Wert]

MAP_TO_INTEGER_LIST*(a:* {} array, b: text) => array

Konvertiert ein Objekt-Array in ein Basis-Array für den angegebenen Schlüssel

Beispiel. MAP_TO_INTEGER_LIST([{Schlüssel: Wert}], 'Schlüssel') = [Wert]

MAP_TO_TEXT_LIST*(a:* {} array, b: text) => array

Konvertiert ein Objekt-Array in ein Basis-Array für den angegebenen Schlüssel

Beispiel. MAP_TO_TEXT_LIST([{Schlüssel: Wert}], 'Schlüssel') = [Wert]

USER_ID_TO_USER(id: Text) => Benutzer

Konvertiert eine Benutzerkennung in ein Benutzerobjekt

Beispiel. Benutzer_id_to_user("abc") = Benutzer

ENCODE_URI(component: Text) => Text

Gibt eine URL-kodierte String-Version eines URI zurück.

Beispiel. ENCODE_URI("http://example.com/a=foo&b=a test") ="http://example.com/a=foo&b=a%20test"

ENCODE_URI_COMPONENT(component: Text) => Text

Gibt eine URL-kodierte String-Version einer URI-Komponente zurück.

EX. ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"

**TEXTTOIMAGEURL(**url:Text) => Bild-URL

Konvertiert eine Zeichenkette in eine Bild-URL.

EX. TEXTZUBILDURL("https://example.com/photo.jpg")

INTERVAL_TO_SECONDS(interval: Intervall) => Zahl

Gibt die Länge eines Intervalls in Sekunden zurück.

EX. INTERVAL_TO_SECONDS(Sekunden_bis_Intervall(30.0))

ADD_TIME()

Erhöht einen Datetime-Wert um einen bestimmten Betrag und eine bestimmte Intervalleinheit.

Beispiel. ADD_TIME*(datetime_variable,* 2, 'Jahre')

SUBTRACT_TIME()

Verringert einen Datetime-Wert um einen bestimmten Betrag und eine bestimmte Intervalleinheit.

Beispiel. SUBTRACT_TIME(datetime_variable, 3, 'Monate')

REGEX_REPLACE()

Gibt ein geändertes Array mit den im Ausdruck definierten Zeichenfolgenersetzungen zurück.

Beispiel. REGEX_REPLACE("BaNaNa", "N", "n", "g") = "Banane"

FILETOTEXT("url: Datei") => Text

Konvertiert File in einen Textstring der URL

Beispiel: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")

Nur Analytics-Editor

COUNT()

Gibt die Anzahl der Vervollständigungen zurück, die der Bedingung entsprechen.

Beispiel. ZAEHLEN(Temperatur > 70)

COUNTOFCOMPLETIONS()

Gibt die Gesamtzahl der Fertigstellungen zurück. Nimmt kein Argument an.

Beispiel. COUNTOFCOMPLETIONS()

SUMME()

Gibt die Summe der Argumente über alle Vervollständigungen zurück.

Beispiel. SUM(Gewicht)

SUMFILTERED()

Gibt die Summe der Argumente über alle Vervollständigungen zurück, gefiltert nach einer Bedingung

Beispiel. SUMFILTERED(gewicht, temperatur > 70)

MITTELWERT()

Gibt den Durchschnitt der Argumente über alle Vervollständigungen zurückVervollständigung.

Beispiel. MITTELWERT(Gewicht)

AVG()

Alias für AVERAGE()

MITTELWERTGEFILTERT()

Gibt den Durchschnitt der Argumente über alle Vervollständigungen zurück, gefiltert, um einer Bedingung zu entsprechen

Beispiel. AVERAGEFILTERED(Gewicht, Temperatur > 70)

AVGFILTERED()

Alias für AVERAGEFILTERED()

MAXIMUM()

Nur Analytics-Editor

Gibt das Maximum der Argumente über alle Vervollständigungen zurück

EX. MAXIMUM(Gewicht)

MAX()

Nur Analytik-Editor

Alias für MAXIMUM()

MINIMUM()

Nur Analytik-Editor

Gibt das Minimum der Argumente über alle Vervollständigungen zurück

EX. MINIMUM(Gewicht)

MIN()

Nur Analytik-Editor

Alias für MINIMUM()

MAXIMALGEFILTERT()

Gibt das Maximum der Argumente über alle Vervollständigungen zurück, gefiltert, um einer Bedingung zu entsprechen

Beispiel. MAXIMUMFILTERED(Gewicht, Temperatur > 70)

MAXFILTERED()

Alias für MAXIMUMFILTERED()

MINIMUMGEFILTERT()

Gibt das Minimum der Argumente zurück, gefiltert nach einer Bedingung

Beispiel. MINIMUMFILTERED(Gewicht, Temperatur > 70)

MINFILTERED()

Alias für MINIMUMFILTERED()

NULLIF()

Die Funktion NULLIF gibt einen Nullwert zurück, wenn argument_1 gleich argument_2 ist, andernfalls gibt sie argument_1 zurück.

Beispiel. NULLIF(argument_1, argument_2)

Dies würde null zurückgeben, wenn argument_1 gleich 1 und argument_2 gleich 1 ist.

Haben Sie gefunden, wonach Sie gesucht haben?

Sie können auch auf community.tulip.co Ihre Frage stellen oder sehen, ob andere eine ähnliche Frage hatten!