FXCVRT Document Converter PreProcess

FXCVRT processes the CopiaFacts Document Converter function for HTML, Word, Excel, Powerpoint and Adobe PDF files. It scans for FS files in the PREPROC subdirectory. Files ($fax_filename lines) are processed if any of the following conditions apply:

there is a $fax_pre-process command for FXCVRT of type FFEXTERN, and with a non-zero queue number corresponding to that defined in FXCVRT setup.

the FAXFACTS.CFG file has a $convert_types command corresponding to the file type on a $fax_filename line, and the queue number defined in FXCVRT setup is 0.

there is an FS command of "$var_def TEST CONVERTER" present, and the queue number defined in FXCVRT setup is zero.

The CopiaFacts Document Conversion feature rasterizes the original document to an intermediate .TIF file, of which the name is then transferred to a replacement $fax_filename command. Details of the old and new filename are placed on $var_def CVRTn commands in the FS file for reference, where n is the index of the filename command in the FS file.

The name for the intermediate fax format file depends on what is given as the second parameter (following the filename) on the $fax_filename line, and is chosen as follows:

if no file reference appears as the second parameter, and the file is a remote Web URL, then the file is written in the WEBFAX\TEMP directory, with a filename consisting of the filename part of the FS file, with suffix based on the number of the file within the FS file (e.g. 12345_F2.TIF).

if no file reference appears as the second parameter, and the file is on a local filesystem, then the file created has the original extension appended to the filename and a new extension of .TIF added (e.g. myfile.XLS becomes myfileXLS.TIF).

if the second parameter is not a pathname (i.e. has no ':' or '\' in it), the file is created in the WEBFAX subdirectory with the supplied filename and an extension of .TIF.

if the second parameter is a pathname it is used without change. You should normally supply a .TIF extension in this case.

The 'WEBFAX' directory in the above descriptions is normally located under the CALLBACK directory. However for an FS file created in the JOBADMIN environment this directory is placed under the job owner directory.

Before converting HTML documents, there is an option (selected on the setup screen) to expand FS, USR and CFG file variables in the HTML text.  These variable names should be preceded by the open-quote character (`).  A similar option is available for expanding variable names in RTF files before conversion: in this case the variable names are preceded by an ampersand (&).

The Document Converter preprocessor requires the CopiaFacts Document Converter print driver (FFCVRT) to be installed.  FXCVRT is no longer implemented in a separate DLL but is built in to CVSINGLE, which is called by FFEXTERN.

Any errors which occur are shown in FFTRACE for as FXCVRT Errors and FFCVRT Errors.