Please enable JavaScript to view this site.

CopiaFacts Reference

Specify types of file to be Preconverted to Fax Format

$convert_types *|nodename|\\machinename|keyword [keyword..]

This command specifies the types of files which are to be converted to fax format using FFEXTERN and the FXCVRT process. File types specified on this command do not require an explicit $pre_process or $fax_pre-process command.

FFEXTERN controls 'external' pre-processing and can be run on one or more machines which can see the CALLBACK directories. FFEXTERN does not have to be run on a node running COPIAFACTS.

FFEXTERN includes a dialog to simplify the selection and configuration of all the options below.

In each case the appropriate application must be running on the machine(s) running FFEXTERN in order for the conversions to be performed. See the description of the Document Conversion feature and the Supported Document Formats.  Also see New Document Converter Features.

Note that some conversions, as noted below, can now be done in the COPIAFACTS engine at transmit time, and that omitting the corresponding keyword below (pdf, html, gif, png, jpg) selects this type of conversion without the need to use external processing.  You should be aware that this may tie up fax channels for several seconds and could result in incoming calls not being received if configured on the same channels.
If you expect to have to convert large PDF documents, it is best to use the CopiaFacts document converter and add the corresponding keyword (pdf) on this command.  However you can also use a modifier on the pdf keyword, as described below.  For example pdf2 selects the document converter for all PDF files except single- and two-page PDFs which will be converted on-the-fly in the COPIAFACTS engine at transmit time.

The parameters on this command are used as follows:

*As the first parameter, indicates that the command is to be applied to all nodes and machines. If the first parameter is not one of the two keywords below, this is the default.
nodename If the first parameter is not one of the keywords below, this parameter specifies the name of the COPIAFACTS node (e.g. M1_1234) to which the command is to be applied.
\\machinenameIf the first parameter is not one of the keywords below, this parameter specifies the name of the machine running COPIAFACTS on which the command is to be applied.
keyword one of the following keywords:
urlhttp indicates that remote files using a URL starting 'http://' are to be pre-processed.  This setting also selects files with a filename starting 'www.' and will automatically prepend 'http://' to the name.  For historical reasons, this setting will always select for conversion files with extension '.htm' or '.html' and the htm and html keywords do not need to be specified.  You also need to provide this keyword in addition to the filetype keyword if you wish to select remote files such as .PDF for conversion.
urlftp indicates that remote files using a URL starting 'ftp://' are to be pre-processed.  You also need to provide this keyword in addition to the filetype keyword if you wish to select remote files such as .PDF for conversion.
urlfile(obsolete, treated as html)
htm, htmleach keyword indicates that files with either .HTM or .HTML extension are to be pre-processed. It need not be specified if urlhttp is also included in the list. This keyword can be omitted if you prefer to have HTML documents converted in the COPIAFACTS engine at transmit time.
tif indicates that files with extensions .TIF and .TIFF are to be pre-processed by FFEXTERN if they are not already faxable TIFF files. This option selects both files that need to be re-rasterized (tifn) and also pre-convert job files that can be fixed on-on-the fly (tiff).  It is the same as entering both tiff and tifn keywords.
tiffindicates that files with extensions .TIF and .TIFF are to be pre-processed by FFEXTERN if they are fixable on-the-fly and if they originate as a job document in a 'pre-convert' or 'singledoc' job. Such files that are not job documents are converted to faxable format in the COPIAFACTS engine at transmission time, not in FFEXTERN. Note that this keyword does not relate to the file extension.
tifnindicates that files with extensions .TIF and .TIFF are to be pre-processed by FFEXTERN if they are non-faxable files that require re-rasterizing. Note that this keyword does not relate to the file extension.
xif indicates that image files with extension .XIF are to be pre-processed.
doc, rtf, docx indicate that Word files with extension .DOC, .DOCX or .RTF are to be pre-processed. Any one of these keywords selects all three extensions. By default, such files will be validated to ensure that they are really Word files; otherwise many hundreds of pages can sometimes be produced by Word.
xls, xlsx indicate that Excel files with extensions .XLS and .XLSX are to be pre-processed.  Either of these keywords selects both extensions.
xlsmindicates that Excel files with extension .XLSM are to be pre-processed. Excel 2013 or later must be installed.
pdf indicates that files with extension .PDF are to be pre-processed. This keyword can be omitted if you prefer to have PDF documents converted in the COPIAFACTS engine at transmit time.
pdfnAs an alternative to the simple pdf keyword (with no number), this keyword indicates that .PDF files are to be pre-processed if they have more than n pages, and are otherwise converted in the COPIAFACTS engine at transmit time. as if the pdf keyword had been omitted.  
For example, pdf3 can be used to specify that PDFs with no more than three pages will be converted on-the-fly at transmit time, and other PDF files will be pre-processed by the Document Converter.
ppt, ppts indicate that Powerpoint files with extensions .PPT and .PPTX are to be pre-processed. Either of these keywords selects both extensions.
gif indicates that graphics files with extension .GIF are to be pre-processed. This keyword can be omitted if you prefer to have GIF documents converted in the COPIAFACTS engine at transmit time.
png indicates that graphics files with extension .PNG are to be pre-processed. This keyword can be omitted if you prefer to have PNG documents converted in the COPIAFACTS engine at transmit time.
jpg, jpeg both indicate that graphics files with .JPG and .JPEG extensions are to be pre-processed. If such a file is identified as a color fax file and a board for which color fax formats are supported is present in the system, the file is not marked for pre-processing. This keyword can be omitted if you prefer to have JPG documents converted in the COPIAFACTS engine at transmit time.

The keyword must be one of the pre-defined set shown above. It is not sufficient just to put any file extension on this command. If the FS file already has a $fax_pre-process command specifying processing by FFEXTERN/FXCVRT on a specific non-zero queue number, the auto-conversion command is not generated.

Default: Any preprocessing required must be selected explicitly using $pre_process or $fax_pre-process commands.

Example:

$convert_types URLHTTP ; pre-convert HTTP files of type HTM and HTML

$convert_types DOC XLS ; pre-convert local Word and Excel files

$convert_types URLHTTP PDF ; pre-convert local and remote HTML and PDF files