使用表示式及 meta 標籤時保留 HTML 格式

EmailPlus 會處理 meta 標籤、表示式及自訂 meta 標籤的所有輸出,使 HTML 電子郵件訊息保留格式。在 EmailPlus 2.1 產生的 HTML EmailPlusTemplate 輸出可能與 EmailPlus 2.0 的輸出不同。純文字電子郵件範本不受影響。

EMP_Verbatim 函數及 EMP_EscapeHTML 函數可對表示式和自訂 meta 標籤的輸出提供更大的控制權。這些函數可在 EmailPlusTemplate 表示式中呼叫,或包括在自訂 meta 標籤的自訂綱目程式碼中。

小心: 當您使用 EmailPlus 表示式及 meta 標籤時,請注意,$entity 是 IBM® Rational® ClearQuest® 中的一個特殊 Perl 變數。此變數會參照正在處理的現行實體。如果您在 EmailPlusTemplate 或 EmailPlusRule 表示式中使用 $entity,表示式中的 $entity 變數將會參照您目前正在修改的記錄類型。如果呼叫 $entity->GetFieldValue($fieldName)->GetValue(),但 $fieldName 是不存在於現行 EmailPlusTemplate 或 EmailPlusRule 記錄中的欄位名稱,則無法正確評估該表示式。為了補救這個問題,EmailPlus 函數 Gfv()Gfov() 會從 EmailPlusRule 相關的記錄中傳回欄位值(即使該欄位並不在現行記錄中)。如需 Gfv() 函數及 Gfov() 的相關資訊,請參閱EmailPlus 廣域 Script 函數
Gfv($fieldName)
此函數相當於呼叫 $entity->GetFieldValue($fieldName)->GetValue()。當評估 EmailPlusTemplate 時,可正確評估此函數。
Gfov($fieldName)
此函數相當於呼叫 $entity->GetFieldOriginalValue($fieldName)->GetValue()。當評估 EmailPlusTemplate 時,可正確評估此函數。
在某些情況下,可在 EmailPlusTemplate 中使用 $entity 變數來處理不相依於 RecordType 的非特定呼叫。例如,您可以使用 $entity 變數來呼叫 $entity->GetFieldsUpdatedThisEntireAction(),可根據 EmailPlusTemplate 及該範本參照的記錄類型來正確評估此函數。

可使用產生的欄位名稱陣列來擷取欄位值,因為它一律會傳回存在於現行實體中的欄位清單。


Feedback