Workflow: Spezialfunktionen
Diese Funktionen führen eine Vielzahl spezialisierter Aktionen aus und sind für alle unterstützten Datentypen einsetzbar.
Anmerkung
Not all functions are supported between Standard mode and Cloud Native mode tools. For a list of supported functions, go to the respective Standard mode and Could Native mode function lists found on the Formula tool page.
Coalesce
Coalesce(v1,v2,v3,…,vn)
: gibt den ersten Nicht-Nullwert zurück.
Wichtig
An die Coalesce-Funktion übergebene Werte müssen alle vom gleichen Typ sein (nur Zeichenfolgen oder nur numerische Werte).
Beispiel
Coalesce(null, "oranges", "apples", null, "grapes")
gibt „oranges“ (Orangen) zurück.
Coalesce(oranges, apples, grapes)
gibt einen Fehler zurück.
Coalesce("1", "2", "3")
gibt „1“ zurück.
Coalesce(null, null, null)
gibt „Null“ zurück.
Coalesce(toDateTime("apples"), toDateTime(1))
gibt 1899-12-31 00:00:00 zurück, da toDateTime("apples") „Null“ zurückgibt.
EscapeXMLMetacharacters
EscapeXMLMetacharacters(String)
: ersetzt alle XML-Platzhalterzeichen durch ihre Escape-Version. Es gibt fünf Zeichen mit Escape-Version.
Zeichen | Escape-Version |
---|---|
" | " |
' | ' |
< | < |
> | > |
& | & |
Beispiel
EscapeXMLMetacharacters("2>1&1<2")
returns 2>1&1<2
GetVal
GetVal(index, v0,...vn)
: gibt den Wert (v0, …, vn) zurück, der durch den 0-basierten Index angegeben wird.
Meldung
Message(messageType, message, returnValue)
: Verwenden Sie diese bedingte Anweisung, um eine Meldung im Meldungsprotokoll auszugeben und die Spaltendaten mit einem spezifischen Wert zu aktualisieren, wenn eine Bedingung erfüllt ist.
Der Meldungstyp und -text werden im Fenster Ergebnisse angezeigt.
Parameter
messageType
: Eine Nummer, die sich auf den Meldungstyp bezieht:
1: Meldungen
2: Warnungen
3: Fehler
5: Konvertierungsfehler (Feldkonvertierungsfehler)
8: Dateien (Eingabe)
9: Dateien (Ausgabe)
message
: The text of the message, expressed as a string between quotes.
returnValue
: Ein Wert, der in die Spaltendaten ausgegeben wird. Dies kann ein numerischer Wert (z. B. „0“), „null“ oder eine Textzeichenfolge in Anführungszeichen (z. B. „False“) sein.
Beispiel
In diesem Beispiel wird die Message-Funktion mit einer bedingten Anweisung verwendet, um eine Meldung über einen Feldkonvertierungsfehler auszugeben und die Spaltendaten mit dem Wert „False“ zu aktualisieren, wenn Datum/Uhrzeit-Werte keine gültigen Uhrzeitdaten enthalten.
If [Hour] = "0" and [Minutes] = "0" then Message(5, "Invalid time in DateTime", "False") Else "True" Endif
Null
Null()
: Gibt einen Nullwert zurück.
RangeMedian
RangeMedian(...)
: berechnet den Medianwert aus einer Reihe von aggregierten Bereichen. Weitere Informationen finden Sie unter Bereichsmedianwert.
Soundex
Soundex(String)
: gibt den Soundex von String zurück. Soundex erstellt einen Code anhand des ersten Zeichens in der Zeichenfolge und drei weiteren Zeichen, die auf den folgenden Elementen basieren:
Zeichen | Soundex |
---|---|
Nicht-alphanumerische Zeichen (Zahlen und Interpunktion) | -1 |
a, e, i, o, u, y, h und w | Wird ignoriert, es sei denn, es ist das erste Zeichen in der Zeichenfolge. |
b, f, p und v | 1 |
c, g, j, k, q, s, x und z | 2 |
d und t | 3 |
l | 4 |
m und n | 5 |
r | 6 |
Beispiel
Wenn der resultierende Code nur zwei oder drei Zeichen lang ist, verwendet Soundex Nullen, um den Code auf vier Zeichen aufzufüllen. Beispiel: Im Namen „Lauren“ werden nur die Buchstaben L, r und n übersetzt (Lrn), und der Soundex-Code lautet L650.
Wenn der resultierende Code mehr als vier Zeichen lang ist, werden alle Zeichen nach dem vierten Zeichen ignoriert. Beispiel: Im Namen „Patrick“ können die Buchstaben P, t, r, c und k übersetzt werden (Ptrck), doch der resultierende Soundex-Code besteht nur aus vier Zeichen: P362.
Soundex_Digits
Soundex_Digits(String)
: gibt die ersten vier Ziffern zurück oder, falls nicht vorhanden, den Soundex-Code.
Wenn in der Zeichenfolge Ziffern (Zahlen) vorkommen, werden die ersten vier Ziffern zurückgegeben.
Wenn keine Ziffern vorhanden sind, wird der Soundex-Code zurückgegeben.
Beispiel für eine Zeichenfolge | Soundex_Digits |
---|---|
3825 Iris | 3825 |
55555 Main | 5555 |
14L Broadway | 14 |
Commerce Street | C562 |
L Street | L236 |
TOPNIDX
TOPNIDX(N, v0, v1, ..., vn)
: Gibt die 0-basierte ursprüngliche Indexposition des N-ten vom Maximalwert zurück, nachdem die indizierten Felder (v0 bis vn) in absteigender Reihenfolge sortiert wurden. Nullwerte werden ignoriert und N muss kleiner als Nicht-Null-Parameter sein. Bei N==0 entspricht dies MaxIdx(...).
N
– das N-te vom Höchstwert aus den indizierten Feldern.v0, v1, …, vn
sind die indizierten Felder.
Beispiel
TOPNIDX(1, [IndexedField1], 5, 7)
gibt...
0 zurück, wenn 5<
[IndexedField1]
<71 zurück, wenn
[IndexedField1]
< 5 oder[IndexedField1]
Null ist2 zurück, wenn
[IndexedField1]
> 7 ist
UrlEncode
UrlEncode(String)
: codiert eine UTF-16-Zeichenfolge mit einer nicht standardmäßigen, UTF-16-basierten Prozent-Codierung.
Wichtig
Bitte beachten Sie, dass diese Methode nicht mehr empfohlen wird. Wir empfehlen stattdessen die neue UrlEncodeUTF8-Funktion.
Beispiel
UrlEncode("C:\temp\Alteryx URL Encode")
gibt C:/temp/Alteryx%20URL%20Encode zurück.
UrlEncodeUTF8
UrlEncodeUTF8(String)
: codiert die Zeichenfolge mit RFC-3986-konformer* Prozentcodierung. Die Funktion wandelt Zeichen in UTF8-basierte Einheiten um und überspringt die im nicht reservierten Zeichensatz definierten Zeichen. Im Gegensatz zur oben genannten UrlEncode-Funktion überspringt diese Funktion die allgemeinen URL-Trennzeichen wie „/“ nicht, sodass sie nicht für die Codierung von vollständigen Pfad-URLs geeignet ist. Sie sollten diese Funktion verwenden, um bestimmte URL-Komponenten zu codieren, wie Abfragekomponentenparameter.
Anmerkung
* RFC 3986 ist der Standard für die URL-Codierung und definiert eine Methode für die Codierung von Unicode-Zeichen, indem diese in eine UTF-8-Byte-Sequenz konvertiert werden und dann jedes Byte mit einem Prozentzeichen (%) gefolgt von zwei Hexadezimalziffern dargestellt wird.
Beispiel
UrlEncodeUTF8("C:\temp\Alteryx URL Encode")
gibt C%3A%5Ctemp%5CAlteryx%20URL%20Encode zurück.