ASSIGN 命令

创建一个变量并为该变量分配值。

语法

ASSIGN 变量名称 = 值 <IF 测试>

说明

显式指定 ASSIGN 关键字是一种最佳做法，因为这使脚本更易于阅读和理解。但是，您可以省略 ASSIGN 并简单地指定：

变量名称 = 值

参数

名称	描述
变量名称	要为其分配该值的变量的名称。如果该变量不存在，则创建该变量。如果该变量已经存在，则其会随新值更新。在变量置换使用的变量名称中，请勿使用非英语字符（如 é）。包含非英文字符的变量名称会导致变量代入出故障。说明变量名称被限制为不超过 31 个字母数字字符。该名称可以包括下划线字符 ( _ )，但不能包括其他特殊字符或任何空格。该名称不能以数字开头。
值	要分配给该变量的值。如果创建新变量，则变量类型将基于值中的数据类型。
IF 测试可选	一个条件表达式，它必须为真以创建该变量或者将该值分配给该变量。

名称

描述

变量名称

要为其分配该值的变量的名称。如果该变量不存在，则创建该变量。如果该变量已经存在，则其会随新值更新。

在变量置换使用的变量名称中，请勿使用非英语字符（如 é）。包含非英文字符的变量名称会导致变量代入出故障。

说明

变量名称被限制为不超过 31 个字母数字字符。该名称可以包括下划线字符 ( _ )，但不能包括其他特殊字符或任何空格。该名称不能以数字开头。

值

要分配给该变量的值。如果创建新变量，则变量类型将基于值中的数据类型。

IF 测试

可选

一个条件表达式，它必须为真以创建该变量或者将该值分配给该变量。

示例

将值分配给变量

您将当前记录中金额域的值分配给一个名为 v_current_amount 的变量：

ASSIGN v_current_amount = 金额

将值有条件地分配给变量

您想要将名为 v_quantity 的变量的值更新为 1，但仅当另一个名为 v_counter 的变量中的值小于 10 时才这样做。

如果 v_counter 大于或等于 10，则不会进行分配，并且 v_quantity 的值保持不变。

请注意，可选的 ASSIGN 关键字被忽略：

v_quantity = 1 IF v_counter < 10

备注

有关使用变量的详细信息，请参阅在 ACLScript 中使用变量。

变量的持续时间

这些变量仅在当前 Analytics 会话期间保持有效。通常，当您关闭一个 Analytics 项目时，该项目中的所有变量都会被自动删除。

如果您希望将变量与 Analytics 项目一起永久保存起来，请在变量名称前加上一个下划线：

ASSIGN _变量名称 = 值

重新分配在计算域或 GROUP 中使用的变量

如果您在下列情况下将值分配给现有变量，则新的值将被分配，但先前值的长度和小数位数会被保留下来：

在计算域中使用的变量
在 GROUP 内部重新分配的变量

如果需要，会增加或减小新值的长度，并调整小数位数。

如果您在任何其他情况下重新分配变量，则先前的值及其长度和小数位规范都会被覆盖。

由 Analytics 命令创建的变量

在通过在 Analytics 的对话框中输入信息或者运行脚本来执行某些命令时，Analytics 会自动创建系统变量。处理后续 Analytics 命令时，您可以使用这些变量和它们包含的值。

如果再次执行相同的命令，则系统变量中的值会被用更新值替换。

有关详细信息，请参见由 Analytics 命令创建的系统变量。