特殊関数
これらの関数は、さまざまな特殊なアクションを実行します。すべての データ型 で使用できます。
Coalesce
Coalesce(v1,v2,v3,…,vn)
: Returns the first non-null value.
重要
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)
: 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を返します。