The Email tab specifies whether a notification email should be generated and to whom it should be sent and what it should contain.
- CN_Send_Email - Specifies email notification should be sent if Yes
- CN_Email_Group - Lists the groups to which the user making the change must be a member in order for an email to be sent. If the list is empty, then the email will be sent regardless of who made the change.
- CN_Email_To - List of email addresses to which the email is to be sent.
- CN_Email_Subject - Subject line for the email.
-
CN_Email_Body - Message body in the email.
The To, Subject and Body fields can have literal text, references to attributes (or external attributes) surrounded by double-pipe characters. They can also include special fields including the ones defined under the Update Tab as well as the ones below.
- CHANGE_DETAIL_PLAIN – replaces the reference with the list of changes
in the format:
<attribute1Name>: old=<oldValue>, new=<newValue>;<attribute2Name>: old=<oldValue>, new=<newValue> - CHANGE_DETAIL_CSV – replaces the reference with a CSV-formatted list:
<attribute1Name>,<oldValue>,<neValue> <attribute2Name>,<oldValue>,<newValue> - CHANGE_DETAIL_HTML – replaces the reference with a block of HTML
table rows:
<tr><td><attribute1Name></td><td><oldValue></td><td><newValue></td></tr> <tr><td><attribute2Name></td><td><oldValue></td><td><newValue></td></tr>The HTML reference should be surrounded by
<table></table>tags as well as<html></html>tags. By default the generated email is in plain text unless the body contains the literal value<html>then HTML formatting will be processed.For example, the following
CN_Email_Bodyvalue:<html> <pre> The Product Group with ID=||Product Group ID|| has the following changes: ||CHANGE_DETAIL_PLAIN|| In CSV Form: Attribute Name,Old Value,New Value ||CHANGE_DETAIL_CSV|| </pre> In HTML Form: <table border="1"> <tr><th>Attribute Name</th><th>Old Value</th><th>New Value</th></tr> ||CHANGE_DETAIL_HTML|| </table> </html>Produces the following email message:
The Product Group with ID=9916 has the following changes: Prod Grp Hdr: old=Oil Burner Combustion Test Kit, new=Oil Burner Combustion Test Kits; Prod Grp Subhdr: old=headers here, new=headers here with more text; Applications: old=apps here, new=applications list here; Specifications: old=specs here, new=specifications; Features: old=features here, new=list of features In CSV Form: Attribute Name,Old Value,New Value Prod Grp Hdr,Oil Burner Combustion Test Kit,Oil Burner Combustion Test Kits Prod Grp Subhdr,headers here,headers here with more text Applications,apps here,applications list here Specifications,specs here,specifications Features,features here,list of features In HTML Form:Attribute Name Old Value New Value Prod Grp Hdr Oil Burner Combustion Test Kit Oil Burner Combustion Test Kits Prod Grp Subhdr headers here headers here with more text Applications apps here applications list here Specifications specs here specifications Features features here list of features Email messages generated in rapid succession with the same recipient list and subject line may be combined into a single email message with the contents of the message bodies concatenated into a single body.
In general, it is recommended to only use e-ail notification when the frequency of change is relatively low.
- CHANGE_DETAIL_PLAIN – replaces the reference with the list of changes
in the format: