Skip to main content

特殊関数

これらの関数は、さまざまな特殊なアクションを実行します。すべての データ型 で使用できます。

EscapeXMLMetacharacters

EscapeXMLMetacharacters(String) : XML メタ文字をエスケープされた文字に置き換えます。エスケープされるのは5文字です。

文字

エスケープされたバージョン

"

"

'

'

<

&lt;

>

&gt;

&

&amp;

EscapeXMLMetacharacters("2>1&1<2") 2&gt;1&1&lt;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を返します。