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