Spezialfunktionen
Diese Funktionen führen eine Vielzahl spezialisierter Aktionen aus. Sie können sie für alle Datentypen verwenden.
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, nur numerische Werte oder nur Geodaten-Werte).
Beispiel
Coalesce(null, "oranges", "apples", null, "grapes") gibt „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): Diese Funktion 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 wurde.
GetEnvironmentVariable
GetEnvironmentVariable(Name): gibt die Umgebungsvariable zurück, die im Namen angegeben wurde. Eine Liste der Umgebungsvariablen finden Sie auf Ihrem Rechner unter Systemsteuerung > System und Sicherheit > System > Erweiterte Systemeinstellungen > Umgebungsvariablen. Es wird eine Liste mit Systemvariablen angezeigt. Sie können einen beliebigen Wert aus dieser Liste verwenden.
Server-Unterstützung
Alteryx unterstützt die GetEnvironmentVariable nicht in Apps, die in Server gespeichert sind.
Beispiel
GetEnvironmentVariable(CommonProgramFiles) gibt C:\Program Files\Common Files zurück.
GetEnvironmentVariable(OS) gibt Windows_NT zurück.
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. Wenn die Protokollierung aktiviert ist, werden diese Informationen auch in die Ausgabeprotokolldatei geschrieben. Weitere Informationen finden Sie unter Ergebnisfenster und Ausgabeprotokolldatei.
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.
ReadRegistryString
ReadRegistryString(Key, ValueName, DefaultValue="): gibt einen Wert aus der Registrierung zurück.
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– N-te vom Höchstwert aus den indizierten FeldernV0, v1, …, vnsind 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
UrlEncode
UrlEncode(String): kodiert eine UTF-16-Zeichenfolge als web-zulässige URL sowohl für die Original-Engine als auch für AMP.
Wichtig
Please note that this method is no longer recommended. We recommend the new UrlEncodeUTF8 function instead.
Beispiel
C:\temp\Alteryx URL Encode gibt C:/temp/Alteryx%20URL%20Encode zurück
UrlEncodeUTF8
UrlEncodeUTF8(String): Encodes a string using the RFC 3986-compliant* percent-encoding. The function converts characters into UTF8-based units and it skips characters defined in the unreserved character set. Unlike the above UrlEncode function, this function doesn't skip the common URL delimiters like "/", so it's not suitable for encoding full path URLs. You should use this function to encode specific URL components, like query component parameters.
Anmerkung
*RFC 3986 is the standard for URL encoding and defines a method for encoding Unicode characters by converting them into a UTF-8 byte sequence and then representing each byte with a % (percent) sign followed by two hexadecimal digits.
Example
UrlEncodeUTF8("C:\temp\Alteryx URL Encode") returns C%3A%5Ctemp%5CAlteryx%20URL%20Encode.