EmailPlus 操纵元标记、表达式和定制元标记的所有输出,以便在 HTML 电子邮件消息中保留格式。EmailPlus 2.1 与 EmailPlus 2.0 中所生成的 HTML
EmailPlusTemplates 的输出可能有所不同。纯文本电子邮件模板不会受影响。
EMP_Verbatim 函数和 EMP_EscapeHTML 函数能够更好地控制表达式和定制元标记的输出。这些函数可以在 EmailPlusTemplate 表达式中调用,也可以包括在定制元标记的定制模式代码中。
注意: 在处理 EmailPlus 表达式和元标记时,请注意,
$entity 是 IBM® Rational® ClearQuest® 中的特殊 Perl 变量。此变量引用正在处理的当前实体。如果您在 EmailPlusTemplate 或 EmailPlusRule 表达式中使用
$entity,那么表达式中的
$entity 变量将引用您当前正在修改的记录类型。如果您对
$entity->GetFieldValue($fieldName)->GetValue() 进行调用,并且
$fieldName 是当前 EmailPlusTemplate 和 EmailPlusRule 记录中不存在的字段名,那么将不会对该表达式进行正确求值。为纠正此问题,EmailPlus 函数
Gfv() 和
Gfov() 将返回与 EmailPlusRule 相关的记录中的字段值,即使当前记录中不存在这些字段也是如此。请参阅
EmailPlus 全局脚本函数以了解有关函数
Gfv()和
Gfov() 的更多信息。
- Gfv($fieldName)
- 此函数等价于调用 $entity->GetFieldValue($fieldName)->GetValue()。对 EmailPlusTemplate 进行求值时,将对此函数进行正确求值。
- Gfov($fieldName)
- 此函数等价于调用 $entity->GetFieldOriginalValue($fieldName)->GetValue()。对 EmailPlusTemplate 进行求值时,将对此函数进行正确求值。
在某些情况下,可以在 EmailPlusTemplates 中使用
$entity 变量,以进行不依赖于记录类型的非特定调用。例如,可使用
$entity 变量来调用
$entity->GetFieldsUpdatedThisEntireAction(),将会针对 EmailPlusTemplate 和模板所引用的记录类型进行正确求值。
可以使用生成的字段名数组来检索字段值,这是因为它始终会返回当前实体上存在的字段列表。