Technical information

153
Customization Techniques
Customization Techniques
This section describes ways to customize VSI-FAX.
Customizing the fax header
Note
This section does not apply to the Fax on Demand (or FoDC) device. To learn how to customize the page
headers of faxes sent using FoDC, please refer to Customizing the header in outgoing faxes
, in the Fax on
Demand Connector section.
Fax header places information at the top of each faxed page in what would normally be the blank top margin.
A default fax page header is used for all outbound faxes sent by VSI-FAX. This header is a combination of fixed text
and variables values:
<date> <time> <TSI string> via VSI-FAX Page <Current page number> of <Total number of
pages> #%<JobID>
By default, the date format is "%m/%d/%y"like in 06/22/06, and the time format is "%I:%M %p"like in 11:22 AM.
You can customize outbound faxes' page headers at various levels and by various ways in the product:
In VSI-FAX Server Administration on Windows platforms, you can customize the date and time formats, the
advertisement string entry (by default, via VSI-FAX) and the left-justififed part of the header, both at the
device's level and in the profiles. For more information, refer to the VSI-FAX Server Administration help.
In the $VSIFAX/lib/vsisrv.ini configuration file, you can overwrite the date and time formats by
changing the DateFormat and TimeFormat entries, you can overwrite the advertisement string by changing
the adstring entries (by default, via VSI-FAX), you can overwrite the left-justified part of the header by
changing the PagehdrString entry and the right-justified part if the header by changing the PagehdrEnd
entry. For more information, refer to Configuration Files in the Reference Addendum
documentation.
In VSI-FAX Outlook client and LanFax Windows Client, you can overwrite the default fax page header or the
custom page header set on the profile and on the device on the server. For more information, refer to the VSI-
FAX LanFax Windows Client help.
Setting the upg tag to true and using the pgh tag, you can overwrite the left-justified part of the header for a
single fax request. For more information, refer to Tag Reference in the Reference Addendum
documentation.
Template files
Template files serve as an integration and site customization tool. They allow you to:
Customize email transport (routing) messages sent by the fax server
Customize notification email messages sent by the fax server
Customize the way fax status is displayed with vfxstat
Retrieve fax envelope information from the fax server and use it as part of a group faxing strategy
This topic describes how to use template files for these purposes.
See also