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 及該範本參照的記錄類型來正確評估此函數。
可使用產生的欄位名稱陣列來擷取欄位值,因為它一律會傳回存在於現行實體中的欄位清單。