Associated File Names



Associated File Names are embedded into special format text objects via FTDesign. Full coverage is provided there, but in summary, one Associated File Name is contained per line in this Text Object.

In the last line, SMTPTo is the Associated File Name and implies delivery via SMTP to the email address, which comes from Data.

  • Associated File Names may direct processes:
    "Archive"="yes"
  • may provide data to a process
    "InvoiceNo"="Inv60803"
  • or may both direct and provide data to a process
    "SMTPTo"="John.Smith@FormTrap.com"


FormTrap Server delivers documents using the delivery engine, activated by Associated File reserved names. Each delivery engine implements a different way of outputting formatted documents.

The standard delivery engines are:
  • Print
  • E-mail using MAPI (Outlook) or SMTP
  • Windows Fax Service
  • Output to directory

A complete list of Associated File Names is displayed below. Entry names are not case sensitive.

Notes:
1. Delivery Tag Reserved Names with no following values ARE IGNORED. Hence an "SMTPTo=" will NOT be delivered to SMTP, it will be ignored.
2. Recipients on Delivery Tags are accumulated. This is in contrast to non-recipients where the first value only is used.
Examples:

Smtpto=paul <paul@formtrap.com>, joe <joe@formtrap.com> Smtpto=adam <adam@formtrap.com> Emails to all three recipients
   
Non-recipient are different - only the first value is used  
   
Smtpfrom=paul <paul@formtrap.com>
Smtpfrom=adam <adam@formtrap.com>
Email is from paul only

Top

Associated File Names

Reserved Name
Delivery Engine Type Description
Directory Recipients OutFolder
Path for write to file option. This entry is used to set the directory path for the write to file option in FormTrap Server. This is a Version 7 example:

##A#OutFolder#C:\FolderName#

Print Recipients Print Windows Printer name. This entry tells FormTrap Server to print the formatted FormTrap document using the specified windows PCL/PS printer. Ensure the Windows printer name is used and NOT the printer's network path.
    ##A#Print#HP LaserJet 4100N PCL6#
Delivery Options PrintDoc This entry tells FormTrap Server to add the named print-ready file to the end of the formatted document. Print-ready files are stored in the same place as substitution files. Print-ready files MUST be pre-tested on the nominated printer.
    ##A#PrintDoc#Terms-and-Conditions.prn#
FormTrap Server does NO CHECKING on the ability of the printer to print the named file, if the file is an incorrect or unhandled format you will kill trees and/or disable the printer.
Prodocom
(fax service)
Recipients NetFax Recipient fax number, this is the only entry for Prodocom Fax Service.
    ##A#NetFax#1 222 333 4444#
e-Fax
(email fax service)
Recipients efax Recipient fax number (numbers only, no spaces - check with your e-fax provider for exact content), this is the only entry for e-Fax Service.
    ##A#efax#0112223334444#
MAPI Recipients EmailTo Email address of the primary recipient. This entry tells FormTrap Server to email the formatted FormTrap document to the specified email address. This can either be fully qualified (username@domain.com) or a Windows address book name. Multiple entries may be specified, separated by a semi-colon.
    ##A#EmailTo#userA@domain.com;userB@domain.com#
EmailCC Email address of the secondary recipient. This entry tells FormTrap Server to email a copy of the formatted FormTrap document to the specified email address. This can either be fully qualified (username@domain.com), or a Windows address book name. Multiple entries may be specified, separated by a semi-colon.
    ##A#EmailCC#username@domain.com#
    ##A#EmailCC#userA@domain.com;userB@domain.com#
EmailBCC Email address of the blind carbon copy recipient. This entry tells FormTrap Server to email a copy of the formatted FormTrap document to the specified email address. This email address will NOT be appear on the message. This can either be fully qualified (username@domain.com), or a Windows address book name. Multiple entries may be specified, separated by a semi-colon.
    ##A#EmailBCC#username@domain.com#
    ##A#EmailBCC#userA@domain.com;userB@domain.com#
VSIFAXTo VSI Fax number. This entry tells FormTrap Server that the formatted document is sent to a Esker VSI-FAX Fax engine installed and configured.VSI-FAX provides a comprehensive, multi-platform fax solution for users who requires faxing of any document from any application running on Unix, or Windows 2000/NT/XP. The VSIFAXTo entry can only have one fax number as its value.
    ##A#VSIFAXTo#1 222 333 4444 #
FaxTo Fax number. This entry tells FormTrap Server that the formatted FormTrap document is sent to the MAPI fax engine for faxing. To use this entry you must have a MAPI fax engine installed and configured. The FaxTo entry can only have one fax number as its value
    ##A#FaxTo#1 222 333 4444#
Delivery Options Subj Subject line for emails and faxes with a cover page. These specified subject line will be added to the email message or to the cover page of the fax.
    ##A#Subj#Invoice#
This Associated File field may contain one or many fields.
More information on Using Multiple Associated File Fields
EmailTitle This option names the attached file.
    ##A#EmailTitle#Invoice Form#
EmailBody Body text for the email message. The entry must use the full path of the text file that contains the body of the email message.
    ##A#EmailBody#C:\FolderName\File Name.txt#
EmailFrom Return email address. This entry can be used to set the return email address for each email message being sent.
    ##A#EmailFrom#username@domain.com#
EmailFromName Return email name. This entry can be used to set the name that appears next to the return email address for each email message being sent.
    ##A#EmailFromName#Accounts Department#
MailDoc This entry tells FormTrap Server to add the named document file to the email. Document files are stored in the same place as substitution files and are normally original documents such as Word or Excel documents, or PDFs.
    ##A#MailDoc#Terms-and-Conditions.pdf#
SMTP Recipients SMTPTo SMTP emailing address of the primary recipient. This entry tells FormTrap Server to email the formatted FormTrap document to the specified email address. This must be fully qualified (username@domain.com), Windows address book names cannot be used. Multiple entries may be specified, separated by a semi-colon.
    ##A#SMTPTo#username@domain.com#
    ##A#SMTPTo#userA@domain.com;userB@domain.com#
SMTPCC SMTP emailing address of the secondary recipient. This entry tells FormTrap Server to email a copy of the formatted FormTrap document to the specified email address. This must be fully qualified (username@domain.com), Windows address book names cannot be used. Multiple entries may be specified, separated by a semi-colon.
    ##A#SMTPCC#username@domain.com#
    ##A#SMTPCC#userA@domain.com;userB@domain.com#
SMTPBCC SMTP emailing address of the blind carbon copy recipient. This entry tells FormTrap Server to email a copy of the formatted FormTrap document to the specified email address. This email address will NOT be appear on the message. This must be fully qualified (username@domain.com), Windows address book names cannot be used. Multiple entries may be specified, separated by a semi-colon.
    ##A#SMTPBCC#username@domain.com#
    ##A#SMTPBCC#userA@domain.com;userB@domain.com#
Delivery Options Subj Subject line for emails and faxes with a cover page. The subject line will be added to the email message or to the cover page of the fax.
    ##A#Subj#Invoice#
The Associated File field may contain one or many fields.
More information on Using Multiple Associated File Fields
EmailBody Body text for the email message. Data may be either the full path of the text file that contains the body of the email message, or the text itself.
    ##A#EmailBody#C:\FolderName\File Name.txt#
EmailTitle This option names the attached file.
    ##A#EmailTitle#Invoice Form#
SMTPFrom Return SMTP email address. This entry can be used to set the return SMTP email address for each email message being sent.
    ##A#SMTPFrom#username@domain.com#
SMTPFromName Return SMTP email name. This entry can be used to set the name that appears next to the return email address for each email message being sent.
    ##A#SMTPFromName#Accounts Department#
This and the above SMTPFrom concatenate to form this (from the two examples): Accounts Department [username@domain.com] where various bracket styles are used.
Note: Do NOT include names with punctuation (comma and semi-colon are treated as delimiter), such as "Company, Inc.". This is treated by SMTP as "Company" and "Inc" where neither will be found.
MailDoc This entry tells FormTrap Server to add the named document file to the email. Document files are stored in the same place as substitution files and are normally original documents such as Word or Excel documents, or PDFs
    ##A#MailDoc#Terms-and-Conditions.pdf#
Windows Fax Service Recipients W2KFAX Recipient Fax Number, Name and Company. This is the only mandatory entry for Windows Fax Service in the Associated File. This entry tells FormTrap Server that the document is to be sent to Windows Fax Service for faxing. Name and/or Company are optional entries, separated by a comma. Multiple recipients may be specified, separated by a semi-colon.
    ##A#W2KFAX#1 222 333 4444#
    ##A#W2KFAX#1 222 333 4444,Name#
    ##A#W2KFAX#1 222 333 4444,Name,Company#
    ##A#W2KFAX#1 222 333 4444,,Company#
    ##A#W2KFAX#1 222 333 4444;1 222 333 5555#
Delivery Options W2KFAX Schedule Schedule the fax. If omitted, the fax is scheduled immediately. Values allowed are:
  • off peak - scheduled off peak (use message manager to set)
  • hold - hold the message in Outlook
  • parseable date and time - format according to local settings
  • parseable time - sent today at the time, format to local time settings

These are examples:
    ##A#W2KFAXSchedule#offpeak#
    ##A#W2KFAXSchedule#hold#
    ##A#W2KFAXSchedule#25/01/01 19:30:00#
    ##A#W2KFAXSchedule#08:30:00 AM#

W2KFAXSubj Subject line for the cover page.
    ##A#W2KFAXSubj#Purchase Order#
This Associated file field may contain one or many fields.
More information on Using Multiple Associated File Fields
W2KFAXBody Body text for the cover page. It is ignored if there is no Cover Page specified. The entry may quote a full file name or directly contain the body text:
    ##A#W2KFAXBody#message text#
    ##A#W2KFAXBody#C:\FolderName\filename.cvp#

Top