EmailPlus 具有可用于创建 EmailPlusRule 高级规则的全局脚本函数。
- OneOf($list, $item)
- 搜索字符串值数组以确定是否存在指定的项目。$list 参数是对数组的引用。$item 参数是一个字符串。如果找到该项目,那么该函数将返回 TRUE,否则将返回 FALSE。以下示例将返回 1 或 TRUE,这是因为字符串 value2 位于以下数组中:OneOf( ['value1', 'value2', 'value3'], 'value2' )
- Gfv($fieldName)
- IBM Rational ClearQuest API 调用 GetFieldValue 的简单封装,等价于以下语句:GetFieldValue($fieldName)->GetValue()。
- Gfov($fieldName)
- ClearQuest API 调用 GetFieldOriginalValue 的简单封装,将返回字段在进行更改之前的原始值。
- Gfvs($fieldName)
- ClearQuest API 调用 GetFieldValueStatus 的简单封装,等价于以下语句:GetFieldValue($fieldName)->GetValueStatus()。
- FChg($list)
- 对 $list 参数中定义的所有字段进行求值,以确定是否已更改任何字段值。如果已更改一个或多个字段值,那么它将返回 ANY。如果已更改所有字段值,那么它将返回 ALL。如果一个字段值也未更改,那么它将返回 NONE。$list 参数是对数组的引用。
- StoDT($dateString)
- 将 ClearQuest DATE_TIME 字段中采用“YYYY-MM-DD hh:mm:ss”格式的日期字符串值转换为 UTC 日期/时间表达式(以秒计)。返回值为自戳记开始的非闰秒数。在大多数系统上,戳记为 1970 年 1 月 1 日 00:00:00 UTC。
- DTtoS($timestamp)
- 将 UTC 日期/时间表达式(以秒计)转换为采用 YYYY-MM-DD hh:mm:ss 格式的日期字符串。
- EMP_ReFormatDateString($dateString, $template, $timezone)
- 将 ClearQuest DATE_TIME 字段从 YYYY-MM-DD hh:mm:ss 格式转换为您所选择的格式。$template 参数是使用程序语言环境的
LC_TIME 类别(例如,“%d-%m-%Y %H:%M:%S”)定义的模板。可选 $timezone 参数用于定义时区。如果未定义时区,那么将使用发送通知的主机的缺省时区。如果传递给此函数的日期字符串值为空,那么将返回空字符串。此函数利用了包含在 CQPerl 中的 Date::Format Perl 模块,例如:
#@EXPRESSION::EMP_ReFormatDateString(
Gfv("DueDate"), "%d-%m-%Y %H:%M:%S", "UTC" );@#
此示例生成了采用 ctime 格式的日期:#@EXPRESSION::EMP_ReFormatDateString(
Gfv("DueDate"), "%C", "UTC" );@#。