変数
変数とは、値を一時的に格納する場所です。 変数には対応する ID があり、これを使ってコンピューターのメモリに格納されている値を参照、使用できます。
ACLScript 内で変数を使用する方法
変数の作成とそれへの値の代入
ACLScript は、ASSIGN コマンドを使って、変数を作成すると同時にそれに値を代入します。
ASSIGN v_age_in_years = 3
簡略化するために、ASSIGN キーワードを省略することもできますが、ASSIGN は暗黙に使用されて実行されます。
v_age_in_years = 3
メモ
ACLScript ではヌル値はサポートされていません。 すべての変数には、サポートされているいずれかのデータ型を持つ、対応する値を設定する必要があります。 スクリプトのインタープリターは、値の代入に使用されたデータ形式およびデータ修飾子を使ってデータ型を評価します。 詳細については、データ型を参照してください。
変数の使用
変数は作成後、フィールド名や変数を参照する任意の場所で参照できます。 また、ASSIGN コマンドを使って、それに新しい値を代入することもできます。
EXTRACT RECORD TO 'result.fil' IF age > v_age_in_years v_age_in_years = 5
また、文字列補間または変数代入を使用して、文字列リテラルを含めるには、% 文字に変数をラッピングできます。 代入される変数が Analytics で検出されると、プレースホルダーが対応する値に置換されます。
ASSIGN v_table = erp_data OPEN %v_table%
変数のタイプ
Analytics では次の種類の変数が使用されます。
- システム生成変数:この変数は、コマンドを実行すると自動的に生成されます。
- 永久変数:この変数は、削除されるまで、コンピューターのメモリに残り、Analytics プロジェクトを閉じた後にも永続します。
メモ
永久変数を定義するには、識別子の前に '_' を付けます: _v_company_name = 'Acme'.
- セッション変数:この変数は、削除されるまで、また、Analytics プロジェクトを閉じるまで、コンピューターのメモリに残ります。
変数 ID
変数 ID は大文字と小文字を区別せず、変数の種類に関連した特定の規約に従います。
- システム生成変数 ID では OUTPUTFOLDER のようにすべて大文字が使用されます。
- 永続的変数 ID には、_v_permanent のように、'_' を接頭辞として付ける必要があります。
- セッション変数 ID では規則により v_varname という書式が使用されますが、この命名規則に制限されることはありません。
変数値の表示
スクリプト開発中またはデバッグ中にスクリプトを実行する際、変数値を追跡すると有益な場合があります。 スクリプトのログ ファイルに変数値を収集するには、DISPLAY コマンドを使用します。
DISPLAY v_age_in_years
ACLScript はこのコマンドに遭遇すると、そのコマンドをログ ファイルに記録します。 スクリプト実行のこの段階で変数値を表示するには、ログに記録されたそのエントリをクリックします。
ヒント
変数を使って、デバッグを支援することもできます。それには、スクリプト内にブレークポイントを挿入したうえで、ナビゲーターの[変数]タブで変数値を調べます。