Adding PDF Attachments to Email Messages

Overview

".pdf" (Portable Document Format, PDF) files are documents that can be viewed and/or printed using Adobe Acrobat Reader, a free program you can download at www.adobe.com. Beginning with version 4.306 (Beta), the Order Manager allows you to attach certain reports as .pdf files to some of its email messages.

Following are the Order Manager reports that can be sent as PDF attachments:

 

 

To attach a .pdf file to an email, you must include a special tag in the email template. The tags only work in the appropriate email types, as detailed above. For example, a purchase order PDF tag is ignored if you are sending a quote. In certain cases, you may also have to set up your reports to generate the .pdf files. (See the section Creating Custom Report PDFs with Access 2000, below.)

 

Attaching .pdf files does not work everywhere. It is limited to places where the Order Manager can reasonably figure out what data needs to be sent. It is currently supported when sending email at the following locations in the Order Manager:

 

 

When you send an email that includes a PDF attachment, the program prints the report to a .pdf file and attaches it to the email message before sending the message. Then, it deletes the .pdf file. Note: The system parameter DeletePDFFiles is set to True by default; if you do not wish for the program to delete the .pdf files after they are sent, set it to False.

 

IMPORTANT: This feature is only available if you have the system parameter EmailSendMethod set to Order Manager or Stack Controller. If you have the system parameter EmailSendMethod set to Order Manager, attachments can only be used with plain text email; they cannot be used with HTML email messages. (If you use the Stack Controller setting, you can use attachments with HTML messages.)

 

Setting Up the Reports

There are five system parameters that tell the Order Manager which report formats to use when creating the .pdf files. The parameters are the following:

 

Each parameter is pre-set with a default report format, however for Invoices and Packing Slips, you can go into System Parameters and select from any of the standard formats included with the Order Manager. (The program uses a report format called “Invoice pdf” that automatically re-configures itself to implement the appearance and features you want.) For Quotes, Purchase Orders, and Drop Ship Purchase Orders, the default report format is the only option for printing .pdf files, so there are no System Parameters to set for these reports -- unless you are using a custom report (see below).

Choosing a Report Format

To choose from the report format options to generate .pdf files for Invoices, Packing Slips, or custom reports:

  1. Go to Quick Clicks> System Parameters.

  2. Select Reports from the Parameter Group (for purchase orders, select the Purchase Orders group).

  3. Select the template you wish to use:

    1. For Invoices and Packing Slips, select a template from the drop down list.

    2. For Custom Reports, type the name of the report in the field in the lower left corner.

  4. Click Save.

  5. Click Close to exit the Set System Parameters dialog box.

 
Creating Custom Report PDFs with Access 2000

To use a custom report, if you are using Access 2000, you must configure the report to print to a “virtual printer” that is now installed with the Order Manager. The virtual printer is called “OM2PDF," which stands for “Order Manager to .pdf file”. (If you are using Access XP/2002, Access 2003 or later, you do not have to do this -- the Order Manager will take care of it for you.)

  1. To configure a report to print to OM2PDF, open the report in Design View.

  2. Go to File> Page Setup> Page tab.

  3. Select Use Specific Printer.

  4. Click the Printer button.

  5. From the drop-down list, select OM2PDF and click OK.

  6. Click OK.

  7. Save the report format.

Insert Tags into the Email Template

Follow these steps to insert the "include" tag into your email template, which will attach the report to the email as a .pdf file.

  1. Go to Maintenance Menu> Maintenance> Email Template Editor.

  2. Either select an existing template from the drop-down list or click on New.

  3. Insert the appropriate tag(s) into your email template. The tags are:

 

    1. If you selected an existing template, click at the end of the body of the email, select the appropriate tag, and click Insert into Template.

    2. If you clicked on New, you can add text to the body of the email and then insert the appropriate tag OR you can insert the tag by itself, thereby sending a blank email with the report attached.

  1. Click Save> OK> Close.

 

As long as the "include" tag is appropriate to the email template (i.e., IncludeQuotepdf in a Quote email), the report (or reports) will be attached as a .pdf file(s) when you send the email.

 

Updated 7/23/08

Modified 11/14/11