EmailPlus 全局脚本函数

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" );@#


Feedback