Optional EMail Notification Variables

By default, all of the system fields necessary to supply required variable information are exposed in the Event log. If an optional field is not exposed in the Event log, that optional variable will be ignored.

While it is technically possible to expose any system field in the Event log, it is also possible for a predefined F_xxx system field to be recorded in the Event log record incorrectly or meaninglessly. For example, the F_Response field may contain a stale response string.

A user-defined field does not begin with "F_" and it must be exposed in the event log.

A given field variable obtains its values from the field that is named by the string following the "$" prefix in the field variable name, as indicated in the following table.

Field variable

Must be Exposed in Log

Description

$F_EMAILADDR emailAddr

 

String containing a secondary email address. The mail address specifies additional recipients for the message; separate multiple recipients with a semicolon (";"). Adding this variable allows the system to send a copy of the notification to a person, or list of people, who would not otherwise be notified.

Place the variable outside of the <HTML></HTML> tag set. For example, you might place the second address immediately after the line containing the $F_SUBJPREFIX variable. If you add the variable inside the <HTML></HTML> tag set, the additional email addresses are displayed as part of the notification message.

$USERFIELD

yes

String containing information from an exposed user-defined field. "USERFIELD" is actually the name of the user-defined field. You must place the variable inside the <HTML></HTML> tag set. If you place the variable outside the <HTML></HTML> tag set, the text will not be displayed as part of the notification message.

See Managing Event Logsfor additional information on managing or creating exposed system fields.

You can use the non-default variables listed in the following notification files; for details on available variables, refer to the specific file description.

Overdue Step Notification

stp_deadline.msg

Step Assignment Notification

stp_new.msg

Step Reminder Notification

stp_reminder.msg

Tracking Assignment Notification

trk_new.msg

Overdue Tracker Step Notification

trk_stp_deadline.msg

Workflow Exception Notification

trk_exception.msg

Workflow Overdue Notification

trk_wf_deadline.msg

Workflow Reminder Notification

trk_wf_reminder.msg

Workflow Milestone Notification

org_milestone.msg

Workflow Tracker Milestone Notification

trk_milestone.msg