特殊関数
これらの関数は、さまざまな特殊なアクションを実行します。すべての データ型 で使用できます。
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を返します。