业务对象变量

业务对象变量表示一个 CA SDM 对象，如一个问题或一个请求。要访问对象，您需要提供变量名称，并在该名称后面添加一个句点 (.)，再加上任何您需要显示的属性名称。例如，按惯例，在用变量 args 表示对象的问题中，您可以显示描述、打开日期、受理人的电话号码、问题的活动数、第一个活动的描述，如下所示：

$args.description
$args.open_date
$args.assignee.phone_number
$args.act_log.length
$args.act_log.0.description

如果变量名称前后没有空格，您可以用大括号分隔变量名称。例如，“$foo bar”和“${foo}bar”都是有效的。您还可以使用变量 args 访问非属性值（例如，支持的操作中描述的 $args.KEEP.name）。

非属性变量可能不能定义。例如，可以从两个不同的位置到达一个表单，而其中仅一个位置为 $args.KEEP.foo 提供值。您可以使用以下语法为 $args 引用提供默认值，如果未定义 variable，冒号后面的字符串将替换引用：

${args.variable:default}

时区日期变量

时区日期变量是业务对象变量的一个特殊情况。这些变量提供用于将表示为整数的全球日期 (UTC) 转换成字符串日期的方法，调整为当前用户浏览器所属的时区。表示整数日期的变量是：

$args.attr_name_INT_DATE

示例：$args.open_date_INT_DATE

工厂数据变量

工厂数据变量是业务对象变量的一个特殊情况。有关引用对象的信息会替换工厂数据变量。其中可供使用的变量共有 7 个：

$args.attr_name.COMMON_NAME

属性引用的表的公用名称（外部可读字符串）。例如，在“请求详细信息”表单上，$args.assignee.COMMON_NAME 的值是受理人的组合名称（“姓氏，名字，中间名”）。

$args.attr_name.COMMON_NAME_ATTR

公用名称在属性引用的表中的属性名称。例如，在“请求详细信息”表单上，$args.assignee.COMMON_NAME_ATTR 的值是“combo_name”。

$args.FACTORY_attr_name

与指定属性关联的工厂的名称。例如，在“请求详细信息”表单上，$args.LENGTH_summary 的值为“agt”。

$args.LENGTH_attr_name

属性的最大长度。例如，在“请求详细信息”表单上，$args.LENGTH_summary 的值是 240。

$args.attr_name.REL_ATTR

属性的相关属性（外键）。例如，在“请求详细信息”表单上，$args.assignee.REL_ATTR 的值是受理人 ID 字段的值。

$args.attr_name.REL_ATTR_ATTR

相关属性在属性引用的表中的属性名称。例如，在“请求详细信息”表单上，$args.assignee.REL_ATTR_ATTR 的值是“id”。

$args.REQUIRED_attr_name

字符串，可能是“0”或“1”，表示引用的属性是否必需。

$args.attr_name.SELECTIONS

attr_name 的有效选择的列表。如果 attr_name 不是其他表的引用，或者 attr_name 引用的表大小超过配置文件属性 SelListCacheMax 的值，则此值是空字符串。否则，SELECTIONS 变量是包含引用表中所有条目的公用名称和相关属性的字符串。用字符串 “@,@”分开个连续的值，这样变量值的形式为：

"cname1@,@rel_attr1@,@cname2@,@rel_attr2"

$args.factory_SEL_UNDER_LIMIT

字符串，可能是“0”或“1”，表示与 factory 对应的表中当前行数是否少于配置文件属性 SelListCacheMax 的值。废弃此变量有利于 SELECTIONS 变量，后者在所有新表单中都应使用。

含有点引用（COMMON_NAME、REL_ATTR 和 SELECTIONS）的工厂数据变量可与任何长度的点引用一起使用。例如，在“请求详细信息”表单上，$args.assignee.organization.COMMON_NAME 被替换为受理人组织的外部名称。