特殊関数
これらの関数は、さまざまな特殊なアクションを実行します。すべての データ型 で使用できます。
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文字です。
文字 | エスケープされたバージョン |
|---|---|
" | " |
' | ' |
< | < |
> | > |
& | & |
例
EscapeXMLMetacharacters("2>1&1<2") 2>1&1<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を返します。