User`s manual

ActFax User’s Manual 93
5. Data Fields
5.1. Why do I need Data Fields?
Each parameter of a fax message (i.e. fax number, priority, subject, ...) is stored by the fax
server in data fields with unique field numbers. That way it is possible to set the value for such
data fields (i.e. the recipients fax number) already from within an application. The user does
not need to enter this information again when the fax is created.
5.2. Syntax of Data Fields
Data fields are always formed using the same syntax and can always be written in plain text.
The following sections describe how data fields are used and include a reference for all data
fields made available by ActiveFax.
Syntax: @Fnnn xxxxxx@
Examples: @F307 Purchase Order 123456@
@F211 800-123-4567@
A data field always starts with the character sequence @F followed by the 3-digit field number
(nnn). The field number is followed by an optional space character and the content of the data
field (xxxxxx). The end of a data fields is always marked with the @ character. The character
set used for data fields depends on the character set used in the fax message and is automat-
ically set by ActiveFax.
5.2.1. Masking Data Fields
If the content of a data field contains the @ character, you have to “mask” the @ character
with a backslash (\). Otherwise the @ character would be treated as the end of the data field
and the content of the data field would be truncated. It is not necessarily required to mask
the @ sign for the email data fields @F111, @F212 and @F607, since ActiveFax automatically
detects the @ sign of the email address for such data fields.
Example: @F212 michael.miller\@gmail.com@
Please note that it is only required to mask the @ character. Other characters (including the
backslash itself) do not need to be masked.
5.3. Overview of the Data Fields
Since ActiveFax supports a total number of more than 50 different data fields, the fields have
been subdivided into three groups (sender fields, recipient fields and common fields). Depend-
ing on the group, the data fields start with different field numbers.