Define the Mail Message Definition
The Mail Message Definition tab enables you to define the mail message.
The following table describes the parameters that you can define in the mail message that you want to send from your iProcess procedure to the SMTP server:
|
Field |
Description |
||||||
|
Headers |
Message headers provide a list of technical details, such as who sent the mail message, the software used to compose it and the e-mail servers it passed through to get to the recipient. You can supply a list of headers in a single string, using a semi-colon as a delimiter. |
||||||
|
From |
The mail address of the sender. Select Use Server Configuration to use the address defined in the global SMTP parameter file, or select Use Custom Configuration to enter an address specific to this step; the text field then becomes available for you to enter the address. |
||||||
|
To |
The mail address of the recipient. You can supply a list of recipients in a single string, using a semi-colon as a delimiter. You can also use an array; see Using iProcess Array Fields in Mail Message Parameters. |
||||||
|
Cc |
Cc stands for carbon copy. Adding a recipient’s name to this field means that a copy of the message is sent to the recipient. The recipient’s name is visible to the other recipients of the message. You can supply a list of recipients in a single string, using a semi-colon as a delimiter. You can also use an array; see Using iProcess Array Fields in Mail Message Parameters. |
||||||
|
Bcc |
Bcc stands for blind carbon copy. Adding a recipient’s name to this field means that a copy of the message is sent to the recipient but the recipient’s name is not visible to the other recipients of the message. You can supply a list of recipients in a single string, using a semi-colon as a delimiter. You can also use an array; see Using iProcess Array Fields in Mail Message Parameters. |
||||||
|
Reply To |
The reply mail address for the mail message. You can supply a list of reply mail addresses in a single string, using a semi-colon as a delimiter. |
||||||
|
Priority |
Priorities enable you to prioritize some mail messages over others. You can select one of High, Normal or Low from the drop-down list in this field; or you can use an iProcess case data field. |
||||||
|
Attachments |
The attachments you want to insert with the mail message. You can attach an external file or the case data from an iProcess field of type MEMO. You can supply a list of attachments, using a semi-colon as a delimiter. Each attachment can be the name of an iProcess field of type MEMO or an array or pathname to a file; see Specify the Attachments. |
||||||
|
Subject |
The subject of the mail message. |
||||||
|
Body |
The body of the message. This can be either:
Click the Load From File button if you want to load the body of the message from an existing file. The contents of the file are displayed in this field, where you can amend it. |
Using iProcess Fields in Mail Message Parameters
You can insert iProcess fields into the mail message parameters. To do this:
| 1. | From the Case Data Fields box, scroll down the list of iProcess fields until you find the one that you want. The list of iProcess fields contains the iProcess fields that are available for the procedure where you are defining your iProcess Email step. |
| 2. | Drag the iProcess field to the mail message parameter. The iProcess field is inserted in the mail message parameter in the following format: |
%fieldname%
where fieldname is the name of the iProcess field.
The following table describes the types of iProcess field that will be accepted in each mail message parameter. Normally, however, only text fields would be useful for the various email address parameters (From, To, Cc, Bcc and Reply To).
|
Mail Field |
iProcess Data Type |
|
Headers |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
From |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
To |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
Cc |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
Bcc |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
Reply To |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
Priority |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
Attachments |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE, MEMO |
|
Subject |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE |
|
Body |
TEXT, NUMERIC, CSN, DATE, TIME, COMPOSITE, MEMO |
For more information about field types, see "Defining a Field" in the TIBCO iProcess Modeler Basic Design Guide.
Using iProcess Expressions in Mail Message Parameters
%expression%
where expression is the iProcess expression.
Shown below is an example of an expression that could be entered in a mail message parameter:
%EMPLOYEE:SALUTATION + “ “ + EMPLOYEE:FNAME + “ “ + EMPLOYEE:LNAME%
For more information about iProcess expressions, see the TIBCO iProcess Expressions and Functions Reference Guide.
Using iProcess Array Fields in Mail Message Parameters
You can insert iProcess array fields into the mail message parameters. How you enter the array field depends on the mail message parameter where you want to insert the array field. The following table describes how array fields should be entered for each mail message parameter:
|
Mail Message Parameter |
Array Field Notation |
||||||
|
To, Cc, Bcc, Reply To, Attachments and Header |
%arrayfield% where arrayfield is the name of the iProcess array field. Each item in the array is listed as a separate address, attachment or header. This enables you for example to specify all the addresses in a mailing list, or to send the same set of attachments with each message. |
||||||
|
Subject, Priority |
In these mail message parameters you must specify a specific element in an array. Whereas a message can be sent to many addresses, it will only have one subject and one priority; so if, for example, an array field lists the priorities Urgent, High, Standard, and Low, specifying one element enables you to select the priority for the message. Enter the array field in the following format: %arrayfield[elementreference]% where:
|
For more information on array fields, see "Using Array Fields" in the TIBCO iProcess Modeler Advanced Design Guide.