Skip to main content

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): Returns the first non-null value.

Wichtig

Values passed to the Coalesce function must all be the same type (all string, all numeric, or all spatial).

Example

Coalesce(null, "oranges", "apples", null, "grapes") returns oranges.

Coalesce(oranges, apples, grapes) returns an error.

Coalesce("1", "2", "3") returns 1.

Coalesce(null, null, null) returns Null.

Coalesce(toDateTime("apples"), toDateTime(1)) returns 1899-12-31 00:00:00 because toDateTime("apples") returns null.

EscapeXMLMetacharacters

EscapeXMLMetacharacters(String) : Diese Funktion ersetzt alle XML-Platzhalterzeichen durch ihre Escape-Version. Es gibt fünf Zeichen mit Escape-Version.

Zeichen

Escape-Version

"

"

'

'

<

&lt;

>

&gt;

&

&

Beispiel

EscapeXMLMetacharacters("2>1&1<2") returns 2&gt;1&1&lt;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.

Message

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 .

Parameters

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 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] <7

  • 1 zurück, wenn [IndexedField1] < 5 oder [IndexedField1] Null ist

  • 2 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.

Beispiel

C:\temp\Alteryx URL Encode gibt C:/temp/Alteryx%20URL%20Encode zurück

In diesem Abschnitt: