特殊な関数
これらの関数は、さまざまな特殊なアクションを実行し、すべてのデータ型で使用できます。
EscapeXMLMetacharacters (文字列): XML メタ文字をエスケープされたバージョンに置き換えます。エスケープされる5つの文字があります。
| 文字 | エスケープされたバージョン |
|---|---|
| " | " |
| ' | ' |
| < | |
| > | > |
| & | & |
例
エスケープXMLメタ文字("2>1&1は2>1&1<2を返します。
GetVal(インデックス、v0,...vn): 0 から始まる [index] で指定された値 (v0,..., vn) を返します。
GetEnvironmentVariable (名前): name に指定された環境変数を返します。環境変数の一覧を取得するには、[コントロール パネル] > [システム] > [高度なシステム設定] > [環境変数]の順に移動します。システム変数のリストが表示されます。これからの任意の値を使用できます。
ギャラリーサポート
Alteryx は、ギャラリーに保存されたアプリでGetEnvironmentVariableをサポートしていません。
例
Get環境変数(共通プログラムファイル)はC:\プログラム ファイル\共通ファイルを返します
GetEnvironment変数(OS) はWindows_NT を返します。
メッセージ (messageType、メッセージ、returnValue): 条件付きステートメントを使用してメッセージ・ログにメッセージを出力し、条件が満たされたときに指定された値を持つ列データを更新します。
メッセージタイプとテキストが結果ウィンドウに表示されます。ロギングが有効な場合、出力ログファイルもこの情報に似ています。結果-ERR:REF-NOT-FOUND-ウィンドウと-ERR:REF-NOT-FOUND-出力ログ ファイルを参照してください。
パラメーター
messageType: メッセージの種類に対応する番号。
- 1 = メッセージ
- 2 = 警告
- 3 = エラー
- 5 = 変換エラー（フィールド変換エラー）
- 8 = ファイル（入力）
- 9 = ファイル（出力）
メッセージ: 引用符の間の文字列として表されるメッセージのテキスト。
returnValue: 列データに出力する値。これは数値（例えば、0）、Null、引用符の間のテキスト文字列（例えば、"False"）です。
例
この例では、条件式内でメッセージ関数を使用してフィールド変換エラーメッセージを出力し、所定の日付/時刻値に有効な時刻データが含まれていない場合は列データを "False" の値で更新します。
[時間] = "0" と [分] = "0" の場合
メッセージ(5,「日付時刻の無効な時刻」、「偽」)
他
真
Endif
NULL(): NULL 値を返します。
RangeMedian(...): 一連の集計範囲から中央値を計算します。範囲-ERR:REF-NOT-FOUND-中央値を参照してください。
読み取りレジストリ文字列 (キー、値名、既定値="): レジストリから値を返します。
サウンドエクスックス(文字列): 文字列のサウンドexを返します。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文字目以降の文字はすべて無視されます。たとえば、パトリックという名前では、P、t、r、c、および k は変換 (Ptrck) できますが、結果として得られる Soundex コードは、P362 の4文字になります。
Soundex_Digits(文字列): 最初の 4 桁の数字を返し、何も指定されていない場合は Soundex を返します。文字列に数字（数値）がある場合、最初の4桁が返されます。数字がない場合、Soundexコードが返されます。
| 文字列 | Soundex_Digits |
|---|---|
| 3825 Iris | 3825 |
| 55555 Main | 5555 |
| 14L Broadway | 14 |
| Commerce Street | C562 |
| L Street | L236 |
TOPNIDX(N、v0、v1、...、vn): リストの最大値から N 番目の 0 ベースのインデックスを返します。N==0の場合、MaxIdx(...) と同じです。
Nは開始点、v0はインデックス付きフィールド (後続の変数は省略可能)、vn は目標です。
例
TOPNIDX(0、[インデックスフィールド]、5)はストリームの上位 5 を返します。
UrlEncode(文字列):文字列を Web の有効な URL としてエンコードします。
例
C:\temp\Alteryx URL エンコードはC:/temp/Alteryx%20URL%20エンコードを返します。