ASSIGN コマンド
変数を作成し、変数に値を割り当てます。
構文
ASSIGN 変数名 = 値 <IF テスト>
ヒント
Analytics は、次の構文を自動的に割り当て操作として解釈するので、ASSIGN キーワードは省略できます。
変数名 = 値
パラメーター
| 名前 | 説明 |
|---|---|
| 変数名 |
値を割り当てる変数の名前。 変数自体が存在していない場合は、変数が作成されます。 変数が既に存在する場合は、新しい値で更新されます。 変数の名前に、é のような英語以外の文字は使用しないでください。 変数名に英語以外の文字が含まれていると、スクリプト エラーになります。 メモ 変数の名前は、31 文字までの英数字に制限されます。 名前にはアンダースコア文字（_）を使用できますが、他の特殊文字やスペースは使用できません。 名前の先頭を数字にすることはできません。 |
| 値 |
変数に割り当てる値。 新しい変数が作成される場合、変数の型は値のデータ型に基づいて決定されます。 |
| IF テスト 省略可能 |
変数を作成したり変数に値を割り当てたりするには true となる必要のある条件式。 |
例
変数に値を割り当てる
現在のレコード内の Amount フィールドの値を変数 v_current_amount に割り当てるとします。 v_current_amount は変数であるため、その値は別の ASSIGN コマンドによって変更されない限り変わりません。
ASSIGN v_current_amount = Amount
変数に条件付きで値を割り当てる
変数 v_counter が 10 未満の場合にのみ、変数 v_quantity の値を 1 に更新する必要があるとします。
v_counter が 10 以上の場合は割り当てが行われず、v_quantity の値は変わりません。
オプションの ASSIGN キーワードは省略されている点に注目してください。
v_quantity = 1 IF v_counter < 10
備考
変数の期間
アンダースコアが先頭に付けられていない変数は現在の Analytics セッションの間のみ有効です。
変数を Analytics プロジェクトで永続的に保存する場合は、変数名の先頭にアンダースコア（_）を付けてください。
ASSIGN 値 = _変数名
演算フィールドまたは GROUP で使用される変数の再割り当て
以下の場合に既存の変数に値を割り当てると、その新しい値は割り当てられるものの、前の値の長さおよび小数点以下桁数は保持されます。
- 変数が演算フィールド内で使用されている場合
- GROUP 内で変数に値が再度割り当てられる場合
必要に応じて、新しい値の長さを伸ばしたり切り詰めたり、小数点以下桁数が調整されます。
上記以外の場合に変数に値を再度割り当てると、前の値、その長さおよび小数点以下桁数は上書きされます。
Analytics コマンドによって作成される変数
Analytics のダイアログ ボックスで情報を入力する、またはスクリプトを実行することで、特定のコマンドが実行されると、Analytics によってシステム変数が自動的に作成されます。 これらの変数とそれに含まれる値は、後続の Analytics コマンドを処理する際に利用できます。
システム変数の値は、同じコマンドを再度実行すると、更新された値に置き換わります。
詳細については、Analytics コマンドによって作成される変数を参照してください。
