Technical information

INSTALLATION AND ADMINISTRATION GUIDE
74
Setting up add-on formatters
For some file types, you must use an add-on formatter to image the document. (For a list of formatter types and the
file types they process, see the table on File extensions
). To set up add-on formatters to work, you must:
1. Stop the VSI-FAX server.
2. Set the VSI-FAX server service to log in as an existing user. (See VSI-FAX Fax Server service properties
if
you want to understand why.)
3. Load your VSI-FAX CD-ROM into your CD-ROM drive.
4. If the autorun does not start automatically, run autorun.exe located in the root directory of your VSI-FAX
CD-ROM.
The VSI-FAX CD browser appears.
5. Select Add-On Formatters under Fax Server.
6. The Welcome screen appears. Click Next to proceed with the installation.
The program files are copied to the local hard drive. This may take several seconds.
7. When the Setup Complete screen appears, click Finish.
8. Restart the VSI-FAX server.
Setting up user-defined formatters
For some file types, VSI-FAX appropriately images your files using an internal or native formatter (imaged "right out
of the box," so to speak), with no additional setup on your part. (If you are not sure what type of formatter you need,
see Types of formatters
for an explanation of format types.)
However, to image document types formatted by a user-defined formatter, you must install a tool for formatting the
document type and create an association between the file type extension and the tool it should use to format it. To do
this:
1. Stop the VSI-FAX server.
2. Set the VSI-FAX server service to log in as an existing user. (See VSI-FAX Fax Server service properties
if
you want to understand why.)
3. Install either the program that created this document or a viewer appropriate to the document type.
4. Open the %VSIFAX%\lib\formatters.lst file in a text editor, and add a line associating the file type with
the program or viewer. The construction of the line is as follows:
type:program:options:description:
Where type is the file extension of the files you want to fax (for example, .xls),
program is the file (and path, if necessary) you launch to run the program you want to use to image the files
(if not fully-qualified, it is interpreted as being in <VSIFAX>\lbin)
andoptions can take various values listed in the table below (usually you only need the "O" option):
Option Description
U The program can use the option "-U clientid" to get user-specific info. If not specified, the clientid is
not passed to the program
E The program can use the option "-E std|fine" to specify output resolution. If not specified, output
resolution will be processed externally to the program
l The program can use the option "-l letter|legal|a4" to specify the page size. If not specified, any page
size specification is ignored
p The program can use the option "-p <page-range> to specify the pages to be processed. If not
specified, any page-range information is processed externally to the program
Z The program can use the option"-Z <options>" to specify program-specific options. If not specified,
any file-conversion options are ignored