Skip to main content

特殊関数

これらの関数は、さまざまな特殊なアクションを実行します。すべての データ型 で使用できます。

Coalesce

Coalesce(v1,v2,v3,…,vn): 最初のNull以外の値を返します。

重要

Coalesce関数に渡される値は、すべて同じ型(すべて文字列、すべて数値、またはすべて空間)である必要があります。

Coalesce(null, "oranges", "apples", null, "grapes")はオレンジを返します。

Coalesce(oranges, apples, grapes)はエラーを返します。

Coalesce("1", "2", "3")は1を返します。

Coalesce(null, null, null)はNullを返します。

Coalesce(toDateTime("apples"), toDateTime(1))は1899-12-31 00:00:00を返します。これは、toDateTime("apples")がNullを返すためです。

EscapeXMLMetacharacters

EscapeXMLMetacharacters(String): XML メタ文字をエスケープされた文字に置き換えます。エスケープされるのは5文字です。

文字

エスケープされたバージョン

"

"

'

'

<

&lt;

>

&gt;

&

&

EscapeXMLMetacharacters("2>1&1<2") 2&gt;1&1&lt;2を返します。

GetVal

GetVal(index, v0,...vn): 0ベースのインデックスで指定された値 (v0、...、vn) を返します。

GetEnvironmentVariable

GetEnvironmentVariable(Name): Name で指定された環境変数を返します。環境変数のリストを取得するには、[コントロールパネル] > [システムとセキュリティ] > [システム] > [システムの詳細設定] > [環境変数]の順に進みます。システム変数のリストが表示されます。このリストの中から任意の値を使用できます。

Serverサポート情報

Alteryxは、Serverに保存されたアプリでGetEnvironmentVariableをサポートしていません。

GetEnvironmentVariable(CommonProgramFiles) C:\Program Files\Common Filesを返します。

GetEnvironmentVariable(OS) Windows_NTを返します。

Message

Message(messageType, message, returnValue): 条件文を使用してメッセージログにメッセージを出力し、条件が満たされたときに列データを指定された値で更新します。

メッセージタイプとテキストが 結果 ウィンドウに表示されます。ロギングが有効な場合、出力ログファイルもこの情報に似ています。詳細については、[結果ウィンドウ] および [出力ログファイル] を参照してください。

パラメーター

messageType: メッセージの種類に対応する以下の番号。

  • 1: メッセージ

  • 2: 警告

  • 3: エラー

  • 5: 変換エラー (フィールド変換エラー)

  • 8: ファイル (入力)

  • 9: ファイル (出力)

message: メッセージのテキスト。引用符で囲んだ文字列で表されます。

returnValue: 列データに出力する値。これは数値(例えば、0)、Null、引用符の間のテキスト文字列(例えば、"False")です。

この例では、条件式内でメッセージ関数を使用して、所定の日付/時刻値に有効な時刻データが含まれていない場合はフィールド変換エラーメッセージを出力し、列データを「False」の値で更新します。

If [Hour] = "0" and [Minutes] = "0" then Message(5, "Invalid time in DateTime", "False") Else "True" Endif

NULL

NULL(): Null 値を返します。

RangeMedian

RangeMedian(...): 一連の集計範囲から中央値を計算します。詳細については、範囲の中央値 を参照してください。

ReadRegistryString

ReadRegistryString(Key, ValueName, DefaultValue="): レジストリから値を返します。

Soundex

Soundex(String): 文字列のSoundexを返します。Soundexは、文字列の最初の文字と、それに続く、次の項目に基づく3文字を基にコードを作成します。

文字

Soundex

アルファベット以外の文字 (数字と句読点)

-1

a、e、i、o、u、y、h、w

文字列内で最初の文字でない限り無視されます。

b、f、p、v

1

c、g、j、k、q、s、x、z

2

d、t

3

l

4

m、n

5

r

6

結果のコードが 2 または 3 文字のみの場合、Soundex は 0 で埋めてコードを 4 文字にします。たとえば、Lauren という名前では、L、r、n のみが変換され (Lrn)、Soundex コードは L650 になります。

結果のコードの長さが 4 文字を超える場合、4 番目の文字より後の文字はすべて無視されます。たとえば、Patrickという名前では、P、t、r、c、kが変換できますが(Ptrck)、結果のSoundexコードは4文字のみのP362になります。

Soundex_Digits

Soundex_Digits(String): 最初の4桁の数字を返します。数字がない場合はSoundexを返します。

  • 文字列に数字 (数値) がある場合、最初の 4 桁が返されます。

  • 数字がない場合、Soundex コードが返されます。

文字列の例

Soundex_Digits

3825 Iris

3825

55555 Main

5555

14L Broadway

14

Commerce Street

C562

L Street

L236

TOPNIDX

TOPNIDX(N, v0, v1, ..., vn):インデックス化されたフィールド(v0からvn)を降順にソートしたときに、最大値から0ベースでN番目のインデックス位置を返します。Null 値は無視され、N は Null 以外のパラメータ数より小さくなければなりません。N==0で、MaxIdx(...) と同じになります。

  • N - インデックス化フィールドの最大値からN番目

  • v0, v1, ..., vnはインデックス付きフィールド

TOPNIDX(1, [IndexedField1], 5, 7) 以下を返します。

  • 5<[IndexedField1]<7なら0

  • [IndexedField1] < 5 または [IndexedField1] が null なら 1

  • [IndexedField1] > 7 なら 2

UrlEncode

UrlEncode(String): UTF-16文字列を、従来のEngineとAMPの両方で使用できるWebの有効なURLとしてエンコードします。

C:\temp\Alteryx URL EncodeはC:/temp/Alteryx%20URL%20Encodeを返します。