A Role_Email collaboration object allows the contents of the Retail_Item attributes that specify email message text, subject text, and recipients to contain the names of files.
The collaboration object distinguishes whether the content of the Retail_Item attributes are actual values or filenames through use of its configuration property FILE_NAME_PREFIX. If the value of the Retail_Item attribute specified in the MSG_TEXT_ATTRIBUTE, MSG_SUBJECT_ATTRIBUTE, or MSG_RECIPIENT_ATTRIBUTE property is prefixed with the String specified in FILE_NAME_PREFIX, the Role_Email collaboration object interprets the rest of the value as a filename. The collaboration object reads the value of the file into a String variable in preparation for further processing. Files must be identified by their fully qualified names.
@c:\Email_Files\CategoryManagerRole.txt
If the values of the Retail_Item attributes specified in the MSG_TEXT_ATTRIBUTE, MSG_SUBJECT_ATTRIBUTE, and MSG_RECIPIENT_ATTRIBUTE properties do not start with the String specified in FILE_NAME_PREFIX, the Role_Email collaboration object obtains the email values directly from the attributes. If the Retail_Item attributes for message text or subject text contain no values, the Role_Email collaboration object supplies default values for them.
Parent topic: Controlling e-mail