Diese Funktionen führen eine Vielzahl spezialisierter Aktionen aus. Sie können sie für alle Datentypen verwenden.
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).
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(String): ersetzt alle XML-Platzhalterzeichen durch ihre Escape-Version. Es gibt fünf Zeichen mit Escape-Version.
Zeichen | Escape-Version |
|---|---|
" | " |
' | ' |
< | < |
> | > |
& | & |
EscapeXMLMetacharacters("2>1&1<2") returns 2>1&1<2
GetVal(index, v0,...vn): gibt den Wert (v0, …, vn) zurück, der durch den 0-basierten Index angegeben wird.
GetEnvironmentVariable(Name): gibt die Umgebungsvariable zurück, die in „Name“ 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.
Alteryx unterstützt die GetEnvironmentVariable nicht in Apps, die in Server gespeichert sind.
GetEnvironmentVariable(CommonProgramFiles) gibt C:\Program Files\Common Files zurück.
GetEnvironmentVariable(OS) gibt Windows_NT zurück.
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.
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: Der Text der Meldung als Zeichenfolgenausdruck in Anführungszeichen.
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.
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.
Falls [Stunde] = "0" und [Minuten] = "0" dann Meldung(5, "Ungültige Uhrzeit in DateTime", "False") Sonst "True" Endif
NULL(): gibt einen Nullwert zurück.
RangeMedian(...): berechnet den Medianwert aus einer Reihe von aggregierten Bereichen. Weitere Informationen finden Sie unter Bereichsmedianwert.
ReadRegistryString(Key, ValueName, DefaultValue="): gibt einen Wert aus der Registrierung zurück.
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 |
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(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-Ziffern |
|---|---|
3825 Iris | 3825 |
55555 Main | 5555 |
14L Broadway | 14 |
Commerce Street | C562 |
L Street | L236 |
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
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(String): codiert eine UTF-16-Zeichenfolge mit einer nicht standardmäßigen UTF-16-basierten Prozentcodierung sowohl für die Original-Engine als auch für AMP.
Wichtig
Bitte beachten Sie, dass diese Methode nicht mehr empfohlen wird. Wir empfehlen stattdessen die neue UrlEncodeUTF8-Funktion.
UrlEncode("C:\temp\Alteryx URL Encode") gibt C:/temp/Alteryx%20URL%20Encode zurück.
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.
UrlEncodeUTF8("C:\temp\Alteryx URL Encode") gibt C%3A%5Ctemp%5CAlteryx%20URL%20Encode zurück.