Send Fax

This Email step sends a fax file retrieved with a Get Fax File step and sends it to one or more recipients as an attachment to an Email. Because this tool sends a message asynchronously, it only queues a message for sending and does not wait to verify that the message was actually sent or if the recipient's address is correct. As a result, this tool takes the Success exit path, even if the message is not sent.

Note: If you want to send a fax that you have converted to a format other than .I3F, including .TIF, use the Send Email tool.

Inputs

To Recipients

Specifies the recipient of the email. Separate multiple email addresses with a semicolon. Separate email addresses with a semicolon. Separate multiple email addresses with a semicolon. This input can accept a string of the email address or a string of the display name with the email address.

Examples:

bojo@xyz.com

bojo@xyz.com;tsmith@abc.com

Boris Johnson|bojo@xyz.com

Boris Johnson|bojo@xyz.com;tsmith@abc.com

If you leave the To and CC parameters empty, the message is sent to the address specified in the Unaddressed Mail Recipient server parameter.

Note: In Directory Services, each user's Exchange address is stored in that user's User key in the emailAddress attribute. This applies to MS Exchange users only.

CC Recipients

Specifies who should receive a copy of this email. Separate multiple email addresses with a semicolon. This input can accept a string of the email address or a string of the display name with the email address.

Examples:

bojo@xyz.com

bojo@xyz.com;tsmith@abc.com

Boris Johnson|bojo@xyz.com

Boris Johnson|bojo@xyz.com;tsmith@abc.com

BCC Recipients

Optionally specifies recipients who should receive a "Blind Carbon Copy" of the reply message. Separate multiple email addresses with a semicolon. This input can accept a string of the email address or a string of the display name with the email address.

Examples:

bojo@xyz.com

bojo@xyz.com;tsmith@abc.com

Boris Johnson|bojo@xyz.com

Boris Johnson|bojo@xyz.com;tsmith@abc.com

Reply To

Optionally specifies one or more email addresses to which the recipients of the reply message should direct their own replies. Separate multiple email addresses with a semicolon. This input can accept a string of the email address or a string of the display name with the email address.

Examples:

bojo@xyz.com

bojo@xyz.com;tsmith@abc.com

Boris Johnson|bojo@xyz.com

Boris Johnson|bojo@xyz.com;tsmith@abc.com

Sender

Optionally specifies a local email address from which this reply message should be sent. This input can accept a string of the email address or a string of the display name with the email address.

Examples:

bojo@xyz.com

Boris Johnson|bojo@xyz.com

The email system will generate the reply message in the outbox folder of the mailbox associated with this address, so that it will appear to the recipients as if the message originated from the owner of that mailbox. The transmission of the reply message will fail if the mailbox associated with this address is not accessible by the email system. If no From address is specified, the message will originate in the outbox folder of the mailbox belonging to the account under which the CIC email system is running. Separate multiple email addresses with a semicolon.

Subject

Specifies the text to appear on the subject line of the email message. You may enter a literal value like "Caller disconnected without leaving a voice mail message" or build a complex expression using the Expression Editor Assistant.

Importance

Specifies the importance of the message as either "Low", "Normal", or "High".

Sensitivity

This parameter is a string that can have the value of "Normal", "Personal", "Private", or "Confidential". The default is "Normal", and this will also be used in the event that something other than one of the other three valid values is entered.

Body

A List of Email Body type. Specifies the text to appear in the body of the email message. You may enter a literal value or build a complex expression using the Expression Editor Assistant.

Fax ID

The variable that will indicate the name of the Fax File to be attached to the email.

Messages Attachments

A list of email cookies containing any attached messages.

Attachment Files

A list of string value containing zero or more complete file paths. You must assign the attachment files (and their paths) as the elements of a list of string variable. You cannot just type the filename and path in this parameter. You can use a Send Email tool step to send a message with a .WAV attachment as a Voice Mail message. Just specify "Voice" as the Content Type of the message. Further, if you check the "Delete Attachments After Sending" checkbox on the Inputs page, CIC will delete the .WAV file from the file system after the message has been successfully transmitted.

Delete Attachments

When set to True, all files in the Attachments List will be deleted after they have been attached (copied) to the email message and successfully sent. It is sometimes the case, especially when replying to or forwarding a message, that you need to create a temporary file and attach it to the message being sent. After the message has been sent the temporary file needs to be deleted, but since outgoing mail is handled asynchronously in IP, the handler can't delete the file immediately after the tool returns, because the message most likely hasn't yet been processed. This checkbox simply passes the responsibility for deleting the file(s) on to the asynchronous service thread that actually sends the message since that thread is the only one that actually knows when it's safe to delete it (or them.

Delivery Receipt

Set to True to prompt the recipient for a delivery receipt upon receiving this email. If the underlying mail system does not support this feature, it will be ignored.

Read Receipt

Set to True to prompt the recipient for a read receipt upon opening this email. If the underlying mail system does not support this feature, it will be ignored.

Saved Copy

String designating the mailbox cookie in which copies of the email are saved.

Timeout

The number of seconds the tool will wait for a return value.

Scheduled

The DateTime variable for the future delivery of a message.

Attachment Files

A list of attached file objects output from another tool, such as Make Attached File.

Output

Result

The results of the operation.

See Email Tool Result Codes for more information.

Exit Path

Success

This step takes the Success exit path if the message was successfully queued for sending. This tool does not verify that the message was actually sent or verify that the recipient's address.

Failure

This step takes the Failure exit path if the CIC server is out of memory, indicating a much larger an unrelated problem.