Delivery Tags
(Associated Files)
What are Delivery Tags
Delivery Tags are a powerful facility within FormTrap designed to allow document-specific information to be extracted from a FormTrap XML file. For Version 7 forms, this is done at run-time, using Associated File entries in the form. Most often, the facility is used to extract delivery details such as the fax number or email address of the recipient, but can be used in conjunction with any user process, either embedded (File, Archive and Output Filter processes) or external (written to output and used by external programs).
How Delivery Tags Work
Delivery Tags are entries in a name=value syntax. The name is simply a field name used to identify the data contained in the value. For example, EmailTo=support@formtrap.com identifies the value support@formtrap.com as being an EmailTo field.
- Delivery Tags may direct processes:
archive=yes - may provide data to a process
DocNum=PO60803 - or may both direct and provide data to a process
EmailTo=support@formtrap.com
Within FTSpooler, there are a number of reserved names that are recognised and used for delivery and archiving purposes.
See the full list of Reserved Names.
For example, at run time, a print stream may be split into five documents; three with email addresses, four with with fax numbers and one with no special delivery (ie printed). Delivery tags are prioritized, so output would be three with Email Delivery Tags, one with a Fax Delivery Tag and one with no Delivery Tags. FTSpooler recognizes the Delivery Tag reserved names and delivers the document accordingly, however, all Delivery Tags are recorded automatically in the successful or unsuccessful jobs archives with their documents. You can carry out meaningful index data searches using Delivery Tag names.
You can also utilize user-defined names in any post-processing operations you may wish to perform (usually in the optional write to file or output filter facilities). For example, you may create index keys for long term archiving, or FTP details to aid in automated delivery of large files to alternative printing facilities (e.g. mailing bureau) or even direct delivery to the recipient.