使用表达式和元标记时保留 HTML 格式

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 和模板所引用的记录类型进行正确求值。

可以使用生成的字段名数组来检索字段值,这是因为它始终会返回当前实体上存在的字段列表。


反馈