RelayFax online help

Attachment Faxing

Navigation:  Faxing Options & Exporting >

Attachment Faxing

Print this Topic Previous pageReturn to chapter overviewNext page

RelayFax has the ability to extract attachments and fax them automatically. For example, it is possible for you to send an email message to the RelayFax Server which contains an Excel or Word document as an attachment and then have the RelayFax server extract the document, invoke the associated application to print it to a special print driver, and then fax the resulting image. Any number of separate attachments can be attached and f

axed in this manner, and page breaks within any given document will be honored and cause multiple pages to be faxed. The settings on the Attachment Faxing pane allow you to control various aspects related to attachment faxing.

RelayFax Print Redirector

When the RelayFax server extracts an attached document from an email message it must convert that document to a faxable image format. This is accomplished by invoking the application associated with the listed document type and then printing it to a special print driver called, "RelayFax Print Redirector." The RelayFax Print Redirector is installed as part of the RelayFax Server package. If "SHELL" is designated for the document type, then there must be a "print" registry association for that document type pointing to an application capable of printing the document. For example, Microsoft Word is associated with the "print" shell command for documents with the extension ".DOC". When a .DOC file is extracted from an email message, Microsoft Word is invoked and the attached document is printed to the RelayFax Print Redirector.

All documents printed to the RelayFax Print Redirector must be printed in "Fine FAX Resolution 204 x 196 DPI." This value is set automatically during installation and is located within the RelayFax Print Redirector's printing preferences, under Printers and Faxes on the Windows Start menu or Control Panel. Exercise caution in changing this value, since failure to set the correct resolution could result in improperly formatted fax images that appear out of scale or otherwise deformed.

The RelayFax Print Redirector logs its activities into a file called REDIRECT.LOG, located in the RelayFax\app\ directory.

The RelayFax Print Redirector must be set as the Default Printer because RelayFax invokes applications that will print to the Default Printer only.

Since it is possible for some applications to run macros when opening and printing certain types of documents, be aware of possible security concerns that you may have when choosing which application to associate with a given document type.

Further, it is possible to attach URL and HTML files to a message and have RelayFax invoke your browser to render the URL or HTML file to fax a completed document. However, when processing URL or HTML attachments, care must be taken since HTML documents can contain Java applets, JavaScript, and the like, which will be executed when the URL or HTML is rendered by the web browser. It is up to the administrator to determine if URL or HTML attachments should be processed through RelayFax.

Attachment Faxing

Convert and fax attached documents found within email messages

Click this switch to turn on the attachment faxing feature. Without this switch set RelayFax will not fax documents attached to email messages.

Reject fax completely if attachment conversion results in an error

Enable this option if you wish to reject a fax when an error occurs during an attachment's conversion. RelayFax will send a message to the sender to let him or her know that the fax couldn't be sent. Uncheck this box if you want RelayFax to send the fax anyway, even if an error occurs, as long as there are some other pages to be sent.

Wait this many minutes for printing applications to finish

For each attachment, this is the number of minutes that RelayFax will wait for notification that the RelayFax Print Redirector has finished converting the document. If no notification is received in this amount of time then the conversion fails and RelayFax will proceed accordingly based on your other settings. This setting is necessary because occasionally some applications require user input and would effectively wait forever for that input without printing or exiting. Also some documents can take a very long time to print, depending on the size of the document and the associated application.

Document types

When the Convert and fax attached documents... option above is enabled, the document types listed here will be extracted, converted, and faxed. Since black and white 2-color TIF, DCX, and TXT file attachments are native to RelayFax, those document types do not need to be listed, nor is any other software required for RelayFax to render them. They will be converted and faxed regardless of the Attachment Faxing dialog's settings.

Add new file extension / add

To add a new document type to the list, enter a new file extension, use the Print using drop-down list to choose the application that you wish to associate with it, and click Add.

Print using

When adding a new document type, use this drop-down list to choose the application that will be used to print documents of that type. If you choose SHELL then a "print" registry association must exist for that document type.


If you wish to delete a document type, select it from the list and then click Remove to delete it.