Call-Flow Entwickler - Variablen und Funktionen
Dieses Thema führt die unterstützten Variablen und Funktionen im Pier4Voice Call Flow Designer ein.
Variablen
Variablen werden verwendet, um Daten während eines CallFlows dynamisch abzurufen und zu übergeben. Es gibt zwei Arten von Variablen im Pier4Voice Call Flow Designer:
- Sitzungsvariable: Sitzungsvariablen speichern Informationen über die aktuelle Anrufsitzung. Diese Variablen sind global im gesamten CallFlow zugänglich und hängen nicht von bestimmten Komponenten ab. Weitere Informationen findest du unter Sitzungsvariablen.
- Komponentenvariable: Komponentenvariablen enthalten die Werte, die von bestimmten Komponenten zurückgegeben werden. Diese Variablen werden verfügbar, nachdem die entsprechenden Komponenten zu einem CallFlow hinzugefügt wurden. Weitere Informationen findest du unter Komponentenvariablen.
Sitzungsvariablen
|
Variable |
Typ |
Beschreibung |
Beispielwert |
|
$Session.ani |
Zeichenfolge |
Die Nummer des Anrufers. |
"15812340987" |
|
$Session.callid |
Zeichenfolge |
Eine eindeutige ID für einen Anruf. |
"1751336277.2" |
|
$Session.did |
Zeichenfolge |
Die DID-Nummer, die mit dem CallFlow verknüpft ist, den der Anrufer erreicht hat. |
"5503301" |
|
$Session.flowNum |
Zeichenfolge |
Die Nebenstellennummer, die mit dem CallFlow verknüpft ist, den der Anrufer erreicht hat. |
"6900" |
|
$Session.transferingNum |
Zeichenfolge |
Die Nummer, von der der Anruf weitergeleitet wurde. |
"1000" |
Komponentenvariablen
Hinweis: Da dieselbe Komponente mehrmals in einem CallFlow hinzugefügt werden kann, wird jeder Komponente ein Index angefügt (z. B. Menu 1, Menu 2), basierend auf der Reihenfolge, in der die Komponenten hinzugefügt werden. Um Daten aus der richtigen Komponente abzurufen, muss die Komponentenvariable den entsprechenden Index enthalten.
|
Variable |
Typ |
Beschreibung |
Beispielwert |
|
Menükomponente |
|||
|
$Menu{index}.result |
Zeichenfolge |
Das Ergebnis der Menü-Komponente. - MenuResult.Timeout: Der Anrufer hat vor dem Timeout keine DTMF-Ziffer gedrückt und wurde zum Timeout-Ziel weitergeleitet. - MenuResult.ValidOption: Der Anrufer hat eine gültige Taste gedrückt und wurde zum entsprechenden Ziel weitergeleitet. - MenuResult.InvalidOption: Der Anrufer hat eine ungültige Taste gedrückt und wurde zum Ziel für ungültige Eingabe weitergeleitet. |
$Menu1.result |
|
$Menu{index}.userInput |
Zeichenfolge |
Die vom Anrufer gedrückte DTMF-Ziffer, ausgenommen die Endtaste (# oder *). |
"2" |
|
Komponente Benutzereingabe |
|||
|
$UserInput{index}.result |
Zeichenfolge |
Das Ergebnis der Benutzereingabe-Komponente. - UserInputResult.Timeout: Der Anrufer hat vor dem Timeout keine DTMF-Ziffer gedrückt und wurde zum Timeout-Ziel weitergeleitet. - UserInputResult.ValidOption: Der Anrufer hat eine gültige Taste gedrückt und wurde zum entsprechenden Ziel weitergeleitet. |
$UserInput1.result |
|
$UserInput{index}.userInput |
Zeichenfolge |
Die vom Anrufer gedrückte DTMF-Ziffer, ausgenommen die Endtaste (# oder *). |
"2" |
|
Komponente Anwesenheitsstatus der Nebenstelle abrufen |
|||
|
$GetExtensionStatus{index}.currentProfileName |
Zeichenfolge |
Name des aktuellen Anwesenheitsstatus der Nebenstelle. Hinweis: Bei der Verwendung von Funktionen zur Bewertung des Anwesenheitsstatus einer Nebenstelle stelle sicher, dass die Statuskonstante mit einem der in Einstell. Tel.-Anlage > Einstellungen > Anwesenheit definierten Werte übereinstimmt. |
"Verfügbar" |
|
$GetExtensionStatus{index}.currentProfile |
Zeichenfolge |
Name und zusätzliche Informationen des aktuellen Anwesenheitsstatus der Nebenstelle. |
"Verfügbar,Arbeit" |
|
$GetExtensionStatus{index}.isInCall |
Boolescher Wert |
Ob die Nebenstelle gerade in einem Anruf ist. |
True |
|
$GetExtensionStatus{index}.isInRing |
Boolescher Wert |
Ob die Nebenstelle gerade klingelt. |
False |
|
Komponente Warteschlangen-Agent abrufen |
|||
|
$GetQueueAgent{index}.agentList |
Objekt |
Die Liste der Agenten mit einem bestimmten Status in einer bestimmten Warteschlange, die die Nebenstellennummer jedes Agenten sowie seinen aktuellen Status zurückgibt. |
"1001,Abgemeldet; |
|
$GetQueueAgent{index}.agentNumberList |
Objekt |
Die Liste der Agenten mit einem bestimmten Status in einer bestimmten Warteschlange, die die Nebenstellennummer jedes Agenten zurückgibt. |
"1001,1003,1004" |
|
Komponente Warteschlangen-Info abrufen |
|||
|
$GetQueueInfo{index}.availableAgents |
Ganzzahl |
Die Anzahl der Agenten, die derzeit für Anrufe verfügbar sind. |
5 |
|
$GetQueueInfo{index}.unavailableAgents |
Ganzzahl |
Die Anzahl der Agenten, die derzeit nicht für Anrufe verfügbar sind. |
1 |
|
$GetQueueInfo{index}.callsActive |
Ganzzahl |
Die Anzahl der Anrufe, die derzeit von Warteschlangen-Agenten beantwortet werden. |
2 |
|
$GetQueueInfo{index}.callsWaiting |
Ganzzahl |
Die Anzahl der Anrufe, die derzeit in der Warteschlange warten. |
10 |
|
Komponente Agentenstatus abrufen |
|||
|
$GetAgentStatus{index}.currentProfile |
Zeichenfolge |
Name und zusätzliche Informationen des aktuellen Status des Agenten. |
"Abmelden" |
|
$GetAgentStatus{index}.isInCall |
Boolescher Wert |
Ob der Agent gerade in einem Anruf ist. |
True |
|
$GetAgentStatus{index}.isInRing |
Boolescher Wert |
Ob die Nebenstelle des Agenten gerade klingelt. |
True |
|
Komponente Datenbankzugriff |
|||
|
$DatabaseAccess{index}.queryResult |
Objekt |
Die Tabelle, die von einer SQL-Abfrage zurückgegeben wird. |
"demo%40 |
|
$DatabaseAccess{index}.nonQueryResult |
Ganzzahl |
Die Anzahl der Zeilen, die von einer Nicht-Abfrage-SQL-Anweisung betroffen sind. |
99 |
|
$DatabaseAccess{index}.scalarResult |
Zeichenfolge |
Der einzelne Wert, der von einer skalaren SQL-Abfrage zurückgegeben wird. |
"10" |
|
Komponente HTTP-Anfrage |
|||
|
$HttpRequest{index}.responseContent |
Zeichenfolge |
Der Hauptinhalt, der von der HTTP-Antwort zurückgegeben wird. |
{"authenticated": |
|
$HttpRequest{index}.responseStatusCode |
Zeichenfolge |
Der HTTP-Statuscode, der von der Anfrage zurückgegeben wird. <br> Hinweis: Bei der Verwendung von Funktionen zur Bewertung des HTTP-Statuscodes stelle sicher, dass die Konstante eine numerische Zahl ohne begleitenden Text ist. |
"200" |
Funktionen
Funktionen werden zur Bedingungsbewertung und Datenverarbeitung verwendet, was eine flexible Steuerung des CallFlows ermöglicht. Die unterstützten Funktionen sind wie folgt.
Boolesche Funktionen
- AND: Führt eine logische Operation über zwei oder mehr Bedingungen durch und gibt True zurück, nur wenn alle Bedingungen gleichzeitig erfüllt sind.
- Syntax: FX_AND(bedingung1, bedingung2, ...)
- Anfragetyp: Boolescher Wert
- Antworttyp: Boolescher Wert
- Beispiel: FX_AND(FX_EQUAL($UserInput1.userInput,"1"), FX_EQUAL($Session.ani,"1001"))
- In diesem Beispiel gibt die Funktion True zurück, nur wenn die Benutzereingabe 1 ist und die Nummer des Anrufers 1001 ist.
- OR: Führt eine logische Operation über zwei oder mehr Bedingungen durch und gibt True zurück, wenn eine der Bedingungen erfüllt ist.
- Syntax: FX_OR(bedingung1, bedingung2, ...)
- Anfragetyp: Boolescher Wert
- Antworttyp: Boolescher Wert
- Beispiel: FX_OR(FX_EQUAL($Session.ani,"1001"), FX_EQUAL($GetAgentStatus1.isInCall,False))
- In diesem Beispiel gibt die Funktion True zurück, wenn entweder die Nummer des Anrufers 1001 ist oder der Agent nicht in einem Anruf ist.
- NOT: Führt eine logische Operation an einer einzelnen Bedingung durch, um das Gegenteil ihres Booleschen Ergebnisses zu erhalten.
- Syntax: FX_NOT(bedingung)
- Anfragetyp: Boolescher Wert
- Antworttyp: Boolescher Wert
- Beispiel: FX_NOT($GetExtensionStatus1.isInCall)
- In diesem Beispiel gibt die Funktion True zurück, wenn die Nebenstelle nicht in einem Anruf ist.
- EQUAL: Führt eine logische Überprüfung durch, um festzustellen, ob zwei Werte gleich sind.
- Syntax: FX_EQUAL(wert1, wert2)
- Anfragetyp: Beliebig
- Antworttyp: Boolescher Wert
- Beispiel: FX_EQUAL($Session.ani,"1001")
- In diesem Beispiel gibt die Funktion True zurück, wenn die Nummer des Anrufers 1001 ist.
- NOT_EQUAL: Führt eine logische Überprüfung durch, um festzustellen, ob zwei Werte nicht gleich sind.
- Syntax: FX_NOT_EQUAL(wert1, wert2)
- Anfragetyp: Beliebig
- Antworttyp: Boolescher Wert
- Beispiel: FX_NOT_EQUAL($GetAgentStatus1.isInRing,True)
- In diesem Beispiel gibt die Funktion True zurück, wenn der Agent nicht im Klingelzustand ist.
- CONTAINS: Führt eine logische Operation durch, um zu überprüfen, ob die erste Zeichenfolge die zweite Zeichenfolge enthält.
- Syntax: FX_CONTAINS(wert1, wert2)
- Anfragetyp: Zeichenfolge
- Antworttyp: Boolescher Wert
- Beispiel: FX_CONTAINS($GetExtensionStatus1.currentProfile,"Verfügbar")
- In diesem Beispiel gibt die Funktion True zurück, wenn der aktuelle Anwesenheitsstatus der Nebenstelle "Verfügbar" enthält.
- GREATER_THAN: Führt eine logische Überprüfung durch, um festzustellen, ob der erste Wert größer als der zweite Wert ist.
- Syntax: FX_GREATER_THAN(wert1, wert2)
- Anfragetyp: Ganzzahl
- Antworttyp: Boolescher Wert
- Beispiel: FX_GREATER_THAN($GetQueueInfo1.callsWaiting,5)
- In diesem Beispiel gibt die Funktion True zurück, wenn die Anzahl der in der Warteschlange wartenden Anrufe 5 überschreitet.
- GREATER_THAN_OR_EQUAL: Führt eine logische Überprüfung durch, um festzustellen, ob der erste Wert größer oder gleich dem zweiten Wert ist.
- Syntax: FX_GREATER_THAN_OR_EQUAL(wert1, wert2)
- Anfragetyp: Ganzzahl
- Antworttyp: Boolescher Wert
- Beispiel: FX_GREATER_THAN_OR_EQUAL($GetQueueInfo1.callsWaiting,5)
- In diesem Beispiel gibt die Funktion True zurück, wenn die Anzahl der in der Warteschlange wartenden Anrufe 5 oder mehr beträgt.
- LESS_THAN: Führt eine logische Überprüfung durch, um festzustellen, ob der erste Wert kleiner als der zweite Wert ist.
- Syntax: FX_LESS_THAN(wert1, wert2)
- Anfragetyp: Ganzzahl
- Antworttyp: Boolescher Wert
- Beispiel: FX_LESS_THAN($GetQueueInfo1.callsWaiting,5)
- In diesem Beispiel gibt die Funktion True zurück, wenn die Anzahl der in der Warteschlange wartenden Anrufe weniger als 5 beträgt.
- LESS_THAN_OR_EQUAL: Führt eine logische Überprüfung durch, um festzustellen, ob der erste Wert kleiner oder gleich dem zweiten Wert ist.
- Syntax: FX_LESS_THAN_OR_EQUAL(wert1, wert2)
- Anfragetyp: Ganzzahl
- Antworttyp: Boolescher Wert
- Beispiel: FX_LESS_THAN_OR_EQUAL($GetQueueInfo1.callsWaiting,5)
- In diesem Beispiel gibt die Funktion True zurück, wenn die Anzahl der in der Warteschlange wartenden Anrufe 5 oder weniger beträgt.
- TO_BOOLEAN: Führt eine logische Operation durch, um einen Wert in einen Booleschen Wert umzuwandeln.
- Syntax: FX_TO_BOOLEAN(wert)
- Anfragetyp: Beliebig
- Antworttyp: Boolescher Wert
- Beispiel: FX_TO_BOOLEAN($GetExtensionStatus1.currentProfile)
- In diesem Beispiel wandelt die Funktion den von der Komponente Anwesenheitsstatus der Nebenstelle abrufen zurückgegebenen Wert in einen Booleschen Wert um. Wenn der Wert beispielsweise "Verfügbar" ist, gibt die Funktion True zurück.
Zeichenfolgenfunktionen
- CONCATENATE: Führt eine Zeichenfolgenoperation durch, um jeden Zeichenfolgenparameter zu verketten und die resultierende Zeichenfolge zurückzugeben.
- Syntax: FX_CONCATENATE(zeichenfolge1, zeichenfolge2, ...)
- Anfragetyp: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_CONCATENATE("Anrufer",$Session.ani,"hat angerufen",$Session.flowNum)
- In diesem Beispiel kombiniert die Funktion die Anrufernummer und die CallFlow-Nummer zu einer Zeichenfolge, z. B. "Anrufer1001hat angerufen6900".
- TRIM: Führt eine Zeichenfolgenoperation durch, um führende und nachgestellte unsichtbare Zeichen (z. B. Leerzeichen, neue Zeilen usw.) aus dem angegebenen Wert zu entfernen.
- Syntax: FX_TRIM(wert)
- Anfragetyp: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_TRIM(" Hallo ")
- In diesem Beispiel entfernt die Funktion Leerzeichen aus dem Wort und gibt "Hallo" zurück.
- LEFT: Führt eine Zeichenfolgenoperation durch, um eine angegebene Anzahl von Zeichen vom Anfang des angegebenen Textes zu extrahieren.
- Syntax: FX_LEFT(text,anzahl)
- Anfragetyp: text: Zeichenfolge, count: Ganzzahl
- Antworttyp: Zeichenfolge
- Beispiel: FX_LEFT("13800138000",3)
- In diesem Beispiel extrahiert die Funktion die ersten drei Zeichen aus dem angegebenen Text und gibt "138" zurück.
- MID: Führt eine Zeichenfolgenoperation durch, um eine Teilzeichenfolge aus einem bestimmten Text zu extrahieren, die an einer angegebenen Position mit einer angegebenen Länge beginnt.
- Syntax: FX_MID(text,start_position,länge)
- Anfragetyp: text: Zeichenfolge, start_position: Ganzzahl, länge: Ganzzahl
- Antworttyp: Zeichenfolge
- Beispiel: FX_MID("13800138000",4,4)
- In diesem Beispiel extrahiert die Funktion 4 Zeichen ab dem 4. Zeichen des Textes und gibt "0013" zurück.
- RIGHT: Führt eine Zeichenfolgenoperation durch, um eine angegebene Anzahl von Zeichen vom Ende (rechte Seite) eines bestimmten Textes zu extrahieren.
- Syntax: FX_RIGHT(text,anzahl)
- Anfragetyp: text: Zeichenfolge, count: Ganzzahl
- Antworttyp: Zeichenfolge
- Beispiel: FX_RIGHT("13800138000",4)
- In diesem Beispiel extrahiert die Funktion die letzten 4 Zeichen aus dem angegebenen Text und gibt "8000" zurück.
- UPPER: Führt eine Zeichenfolgenoperation durch, um alle Zeichen im angegebenen Text in Großbuchstaben umzuwandeln.
- Syntax: FX_UPPER(text)
- Anfragetyp: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_UPPER("Cloudanlage")
- In diesem Beispiel wandelt die Funktion alle Buchstaben im Text in Großbuchstaben um und gibt "CLOUDANLAGE" zurück.
- LOWER: Führt eine Zeichenfolgenoperation durch, um alle Zeichen im angegebenen Text in Kleinbuchstaben umzuwandeln.
- Syntax: FX_LOWER(text)
- Anfragetyp: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_LOWER("Cloudanlage)
- In diesem Beispiel wandelt die Funktion alle Buchstaben im Text in Kleinbuchstaben um und gibt "cloudanlage" zurück.
- REPLACE: Führt eine Zeichenfolgenoperation durch, um eine angegebene Teilzeichenfolge durch eine andere Teilzeichenfolge im angegebenen Text zu ersetzen.
- Syntax: FX_REPLACE(text,ziel,ersatz)
- Anfragetyp: text: Zeichenfolge, target: Zeichenfolge, replacement: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_REPLACE("+8613800138000","+86","")
- In diesem Beispiel entfernt die Funktion die Ländervorwahl +86 aus der Telefonnummer und gibt "13800138000" zurück.
- REPLACE_REG_EXP: Führt eine Zeichenfolgenoperation durch, um Teilzeichenfolgen, die einem regulären Ausdrucksmuster entsprechen, durch eine angegebene Ersatzzeichenfolge zu ersetzen.
- Syntax: FX_REPLACE_REG_EXP(text,ausdruck,ersatz)
- Anfragetyp: text: Zeichenfolge, expression: Zeichenfolge, replacement: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_REPLACE_REG_EXP("Anruf123", "[0-9]", "X")
- In diesem Beispiel findet die Funktion alle numerischen Zeichen mit dem regulären Ausdruck [0-9] und ersetzt sie durch X, und gibt "AnrufXXX" zurück.
- JSON_GET_STRING: Führt eine Operation durch, um einen Zeichenfolgenwert aus einem JSON-Objekt basierend auf dem angegebenen Schlüssel abzurufen.
- Syntax: FX_JSON_GET_STRING(JSONObject,schlüssel)
- Anfragetyp: JSONObject: Zeichenfolge, key: Zeichenfolge
- Antworttyp: Zeichenfolge
- Beispiel: FX_JSON_GET_STRING($HttpRequest1.responseContent,"status")
- In diesem Beispiel gibt die Funktion den Wert des status-Schlüssels aus dem JSON-Inhalt zurück, der von der Komponente HTTP-Anfrage 1 zurückgegeben wurde.
- TO_STRING: Führt eine Operation durch, um einen Wert in eine Zeichenfolge umzuwandeln.
- Syntax: FX_TO_STRING(wert)
- Anfragetyp: Beliebig
- Antworttyp: Zeichenfolge
- Beispiel: FX_TO_STRING(10086)
- In diesem Beispiel wandelt die Funktion 10086 in einen Zeichenfolgenparameter um und gibt "10086" zurück.
Datum/Uhrzeit-Funktionen
- NOW: Gibt das aktuelle Datum und die aktuelle Uhrzeit als DateTime-Objekt zurück.
- Syntax: FX_NOW()
- Anfragetyp: Null. Diese Funktion nimmt keine Parameter entgegen.
- Antworttyp: Datum/Uhrzeit
- Beispiel: FX_NOW()
- In diesem Beispiel gibt die Funktion das aktuelle Systemdatum und die aktuelle Systemuhrzeit zurück - "2025-07-01 17:29:08".
Zahlenfunktionen
- LEN: Führt eine Zeichenfolgenoperation durch, um die Anzahl der Zeichen im angegebenen Text zurückzugeben.
- Syntax: FX_LEN(text)
- Anfragetyp: Zeichenfolge
- Antworttyp: Ganzzahl
- Beispiel: FX_LEN("13800138000")
- In diesem Beispiel gibt die Funktion 11 zurück, was die Länge des Textes angibt.
- SUM: Führt eine Operation durch, um zwei oder mehr 32-Bit-Ganzzahlwerte zu summieren.
- Syntax: FX_SUM(wert1, wert2, ...)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_SUM(100,200,300)
- In diesem Beispiel summiert die Funktion die drei Werte und gibt 600 zurück.
- SUM_LONG: Führt eine Operation durch, um zwei oder mehr 64-Bit-Ganzzahlwerte zu summieren.
- Syntax: FX_SUM_LONG(wert1, wert2, ...)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_SUM_LONG(1000000000,2500000000)
- In diesem Beispiel summiert die Funktion die beiden Werte und gibt 3500000000 zurück.
- NEGATIVE: Führt eine Operation durch, um den negativen Wert einer 32-Bit-Ganzzahl zurückzugeben.
- Syntax: FX_NEGATIVE(wert)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_NEGATIVE(100)
- In diesem Beispiel gibt die Funktion -100 zurück.
- NEGATIVE_LONG: Führt eine Operation durch, um den negativen Wert einer 64-Bit-Ganzzahl zurückzugeben.
- Syntax: FX_NEGATIVE_LONG(wert)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_NEGATIVE_LONG(1000000000)
- In diesem Beispiel gibt die Funktion -1000000000 zurück.
- MULTIPLY: Führt eine Operation durch, um zwei oder mehr 32-Bit-Ganzzahlwerte zu multiplizieren.
- Syntax: FX_MULTIPLY(wert1, wert2, ...)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_MULTIPLY(10,20,3)
- In diesem Beispiel gibt diese Funktion 600 zurück.
- MULTIPLY_LONG: Führt eine Operation durch, um zwei oder mehr 64-Bit-Ganzzahlwerte zu multiplizieren.
- Syntax: FX_MULTIPLY_LONG(wert1, wert2, ...)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_MULTIPLY_LONG(100000,20000)
- In diesem Beispiel gibt die Funktion 2000000000 zurück.
- DIVIDE: Führt eine Operation durch, um den ersten 32-Bit-Ganzzahlwert durch den zweiten 32-Bit-Ganzzahlwert zu dividieren.
- Syntax: FX_DIVIDE(wert1, wert2)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_DIVIDE(100,20)
- In diesem Beispiel dividiert die Funktion 100 durch 20 und gibt 5 zurück.
- DIVIDE_LONG: Führt eine Operation durch, um den ersten 64-Bit-Ganzzahlwert durch den zweiten 64-Bit-Ganzzahlwert zu dividieren.
- Syntax: FX_DIVIDE_LONG(wert1, wert2)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_DIVIDE_LONG(10000000000,2000000000)
- In diesem Beispiel dividiert die Funktion 10000000000 durch 2000000000 und gibt 5 zurück.
- ABS: Führt eine Operation durch, um den absoluten (nicht negativen) Wert einer 32-Bit-Ganzzahl zurückzugeben.
- Syntax: FX_ABS(wert)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_ABS(-100)
- In diesem Beispiel gibt die Funktion 100 zurück.
- ABS_LONG: Führt eine Operation durch, um den absoluten (nicht negativen) Wert einer 64-Bit-Ganzzahl zurückzugeben.
- Syntax: FX_ABS_LONG(wert)
- Anfragetyp: Ganzzahl
- Antworttyp: Ganzzahl
- Beispiel: FX_ABS_LONG(-10000000000)
- In diesem Beispiel gibt die Funktion 10000000000 zurück.
- GET_TABLE_ROW_COUNT: Führt eine Operation durch, um die Anzahl der Zeilen in einer Tabelle zurückzugeben.
- Syntax: FX_GET_TABLE_ROW_COUNT(tabelle)
- Anfragetyp: Beliebig
- Antworttyp: Ganzzahl
- Beispiel: FX_GET_TABLE_ROW_COUNT($DatabaseAccess1.queryResult)
- In diesem Beispiel gibt die Funktion die Anzahl der Zeilen aus dem Ergebnis zurück, das von der Komponente Datenbankzugriff 1 zurückgegeben wurde.
- GET_LIST_ITEM_COUNT: Führt eine Operation durch, um die Anzahl der Elemente in einer bestimmten Liste zurückzugeben.
- Syntax: FX_GET_LIST_ITEM_COUNT(liste)
- Anfragetyp: Beliebig
- Antworttyp: Ganzzahl
- Beispiel: FX_GET_LIST_ITEM_COUNT($DatabaseAccess1.queryResult)
- In diesem Beispiel gibt die Funktion die Anzahl der Elemente aus dem Ergebnis zurück, das von der Komponente Datenbankzugriff 1 zurückgegeben wurde.
- JSON_GET_INTEGER: Führt eine Operation durch, um einen Ganzzahlwert aus einem JSON-Objekt basierend auf dem angegebenen Schlüssel abzurufen.
- Syntax: FX_JSON_GET_INTEGER(JSONObject,schlüssel)
- Anfragetyp: JSONObject: Zeichenfolge, key: Zeichenfolge
- Antworttyp: Ganzzahl
- Beispiel: FX_JSON_GET_INTEGER($HttpRequest1.responseContent,"httpStatus")
- In diesem Beispiel gibt die Funktion den Wert des httpStatus-Schlüssels aus dem JSON-Inhalt zurück, der von der Komponente HTTP-Anfrage 1 zurückgegeben wurde.
- TO_INTEGER: Führt eine Operation durch, um einen Wert in eine 32-Bit-Ganzzahl umzuwandeln.
- Syntax: FX_TO_INTEGER(wert)
- Anfragetyp: Zeichenfolge
- Antworttyp: Ganzzahl
- Beispiel: FX_TO_INTEGER("12345")
- In diesem Beispiel wandelt die Funktion die Zeichenfolge "12345" in die Ganzzahl 12345 um.
- TO_LONG: Führt eine Operation durch, um einen Wert in eine 64-Bit-Ganzzahl umzuwandeln.
- Syntax: FX_TO_LONG(wert)
- Anfragetyp: Zeichenfolge
- Antworttyp: Ganzzahl
- Beispiel: FX_TO_LONG("1234567890123")
- In diesem Beispiel wandelt die Funktion die Zeichenfolge "1234567890123" in die Ganzzahl 1234567890123 um.
Objektfunktionen
- GET_TABLE_CELL_VALUE: Führt eine Operation durch, um den Wert aus einer Tabellenzelle an der angegebenen Zeile und Spalte abzurufen.
- Syntax: FX_GET_TABLE_CELL_VALUE(tabelle,zeile,spalte)
- Anfragetyp: tabelle: Beliebig, zeile: Ganzzahl, spalte: Ganzzahl
- Antworttyp: Objekt
- Beispiel: FX_GET_TABLE_CELL_VALUE($DatabaseAccess1.queryResult,0,1)
- In diesem Beispiel gibt die Funktion den Wert aus der ersten Zeile und der zweiten Spalte im Ergebnis zurück, das von der Komponente Datenbankzugriff 1 zurückgegeben wurde.
- GET_LIST_ITEM: Führt eine Operation durch, um den Wert aus einer Liste an der angegebenen Indexposition abzurufen.
- Syntax: FX_GET_LIST_ITEM(liste,index)
- Anfragetyp: liste: Beliebig, index: Ganzzahl
- Antworttyp: Objekt
- Beispiel: FX_GET_LIST_ITEM($DatabaseAccess1.queryResult,2)
- In diesem Beispiel gibt die Funktion das dritte Element im Ergebnis zurück, das von der Komponente Datenbankzugriff 1 zurückgegeben wurde.
- JSON_GET_OBJECT: Führt eine Operation durch, um ein verschachteltes JSON-Objekt aus einem übergeordneten JSON-Objekt basierend auf dem angegebenen Schlüssel abzurufen.
- Syntax: FX_JSON_GET_OBJECT(JSONObject,schlüssel)
- Anfragetyp: JSONObject: Zeichenfolge, key: Zeichenfolge
- Antworttyp: Objekt
- Beispiel: FX_JSON_GET_OBJECT($HttpRequest1.responseContent,"data")
- In diesem Beispiel gibt die Funktion das JSON-Objekt zurück, das dem data-Schlüssel aus dem JSON-Inhalt zugeordnet ist, der von der Komponente HTTP-Anfrage 1 zurückgegeben wurde.