Please enable JavaScript to view this site.

CopiaFacts Reference Manual

Direct Links: CF9IMAGE CF9JOBADM CFGATEWAY COPIAFACTS CVSINGLE EMDIRECT FFBC FFEXTERN FFVIEWER

This topic currently shows version 8.3 changes from 2021 to 2023 (8.3.1.294 to 8.3.1.353) and the version 9 fixes since release in 2024 (in 9.1.0.354 and later).

New features and fixes in the version 9 release are in the main Appendix M topic)

CF9AD

8.3.1.308Fixed an issue which prevented connection to AD in some environments.
8.3.1.305Improved the Active Directory Integration feature to handle a wider set of user properties, and to handle a situation where multiple users share the same DID fax number and all require forwarding of incoming faxes. The parameters on some AD commands and variables have changed.

CF9CLIENT

8.3.1.303Fixed an issue which prevented operation in some cases in recent versions of Windows 10. This Explorer shell extension is currently only installed for 64-bit versions of Windows.

CF9EMAIL

8.3.1.326Fixed a recent regression which could cause e-mail MIME header text to be truncated if header-encoding keyword base64 was specified as the third parameter on an $email_charset command. This option is not recommended because the default of quoted-printable encoding is usually preferred (and is the default, when needed).
8.3.1.326 Fixed a problem which ignored 8bit as the header-encoding keyword when specified as the third parameter on an $email_charset command. This option is not recommended because some mail servers will reject the e-mail or append a warning on incoming e-mail if 8-bit characters are used on e-mail headers without encoding.
8.3.1.325Fixed a problem which could cause the base64-encoding of a multi-megabyte e-mail attachment to take a long time to complete, while building the message for transmission.
8.3.1.299Fixed an issue where the use of the $email_options keyword ignmiss could add an empty attachment when the attachment was missing.

CF9EXCEL

8.3.1.338Improved the handling of XLS and XLSX files not created using Excel.

CF9IMAGE

9.1.0.379Added support for the latest PDFIUM release.
9.1.0.379Updated to support Libre Office 25:8.
9.1.0.379Improved the accuracy of positioning PDF Annotations onto a PDF 'watermark' base document. This is still affected by rounding errors and depends on monitor resolution and location on the page, so requires testing and possible position adjustment in FFVIEWER.
9.1.0.379Added the ability to set CHECK_BLANK_TIF to check only short documents.
9.1.0.378Fixed a regression which caused a failure to process correctly some of the Image Option Keywords with a numeric suffix, for example DITHERn or SHARPENn.
9.1.0.375Fixed a regression on the creation of thumbnail KEEP_FAX images containing the pages of a multi-page transmission. The thumbnails (if more than one) were being rendered inverted left-right and top-bottom.
9.1.0.367Added support for the latest PDFIUM release.
9.1.0.367Added support for the latest Libre Office release.
9.1.0.367Added a new PDFLIBRE variable to support the conversion of some (rare) "problem" PDF documents by using LibreOffice for 'at run time' conversions.
9.1.0.367Enhanced the tracing of the principal DLL functions to show which channel number in COPIAFACTS is calling the function, when called from this process.
9.1.0.362Added support for LibreOffice 24.8
9.1.0.360Added support for the latest PDFIUM release.
8.3.1.350Fixed a problem which could cause memory allocation fragmentation and failure when converting to TIF very large documents with many pages
8.3.1.343Modified the handling of at-send-time HTML document conversions to reduce the likelihood of occasional conversion failures under heavy load.
8.3.1.342Modified the handling of certain unsupported PDF features in the default (PDFIUM) PDF Converter so that they do not cause the conversion to fail and trigger an automatic switch to the alternate (original) converter. These are the elements such as file attachments and non-text annotations (e.g. video and audio) which would not be rendered anyway in the output TIF file.
8.3.1.338Added support for the latest PDFIUM release.
8.3.1.338Fixed an issue where trace output was sometimes corrupted when displaying image options. This did not impair conversion operations.
8.3.1.325Added support for the latest PDFIUM release.
8.3.1.325Extended the tolerances for document sizes so that slightly undersized US-Letter landscape pages are correctly rotated in a PDF being converted for faxing.
8.3.1.321Modified the built-in PDF converter to handle certain types of PDF form field for which the contents were rendered incorrectly.
8.3.1.313Fixed an issue where some failed 'at transmit time' conversions done immediately before fax transmission could cause the failure of subsequent conversions on the same channel.
8.3.1.311Added support for the latest PDFIUM release, and fixed a regression which in some cases caused the 'original' built-in PDF converter to be selected when the $convert_options keyword orig was not present.
8.3.1.309 Fixed a problem which could cause a UTF8 Byte Order Mark in the header or footer sections of an HTML Cover Sheet to be retained and appear as a question-mark in the output.
8.3.1.309Enhanced the supported HTML subset for TIF annotations, including the ability to include monochrome images in formats other than BMP, for example SVG or PNG.
8.3.1.301Added a new custom image options PARM1 value.
8.3.1.300 Added the ability to generate QR codes on outgoing faxes and e-mailed PDF attachments.
8.3.1.295Changed the built-in processing of PDF documents so that those containing form fields are automatically converted with the original PDF converter. The default PDFIUM converter does not currently handle form-field contents.

CF9INFOTIP

8.3.1.303Fixed an issue which prevented operation in some cases in recent versions of Windows 10. This Explorer shell extension is currently only installed for 64-bit versions of Windows.

CF9JOBADM

9.1.0.367Built with the IANA 2024a Timezone database.
9.1.0.367Updated the lists of telephone Area Codes and Country Codes used for
'timed delivery by destination location'.
9.1.0.354Built with the IANA 2024a Timezone database.
8.3.1.334Built with the IANA 2022b Timezone database.
8.3.1.323Built with the IANA 2022a Timezone database.
8.3.1.314Built with the IANA 2021d Timezone database.
8.3.1.313Built with the IANA 2021b Timezone database.
8.3.1.294Built with the IANA 2020e Timezone database.

CF9SMS05

8.3.1.312Added a new SMS interface using the SINCH REST API. The existing interface using the legacy Sinch Atlas API remains available.

CF9SUPPORT

9.1.0.370Enhanced the CopyFile function so that it reports and fails if the specified source pathname is the same as the destination pathname. It also fails if both pathnames refer to the same file in different ways.
9.1.0.370If the destination folder does not exist, the CopyFile function will now attempt to create it before copying.
9.1.0.354Enhanced the CreateThumbNail application support function in order to allow simplification of the scripts that use it.
8.3.1.343Improved the error reports from the CreateThumbnail function.
8.3.1.309Added an option to enable a user-supplied custom output conversion method for the CreateThumbNail function.
8.3.1.296A new HTTP_CTO variable with a value in milliseconds allows override of the default one-minute connection timeout for the Application Support Library functions HTTPGet, HTTPGetFile, and HTTPPost.

CFCERTINFO

8.3.1.326Changed the manifest to require 'run as administrator'. Some versions of Windows may require this to read certificates.
8.3.1.322Improved the validation of certificates to avoid very occasional marking of a valid certificate as invalid.

CFCLIENTADMIN

8.3.1.339Changed the function to propagate settings from a UJP file to other destination UJP files, so that it retains an $outbound_ani command if already present in the destination.
8.3.1.296Fixed a problem where unchecking the "Forward to Email" option could fail to remove the $post_receive command from the MBX file.

CFCP

9.1.0.354Now reflects any overridden $display_box legends on the COPIAFACTS Status tab.
8.3.1.314Fixed an issue which could sometimes cause random characters to appear following the cache contents when displaying the CFMSG Status Cache.

CFGATEWAY

9.1.0.365Improved recovery if a customer-provided Gateway Template DLL fails while validating an incoming e-mail.
8.3.1.352Fixed an issue which caused the (rarely required) use of a $worker_box command in a Sender Template file to fail. This command is normally a Recipient Template command.
8.3.1.338Fixed an issue where e-mail image attachments with a Content-ID header were only processed if referenced from an HTML body file.
8.3.1.325 A session timeout in seconds can now be specified on the GWMANAGER Server tab, to override the default value of 30s. If you expect to receive very large attachments or are operating with a low bandwidth connection, a higher value can be set. Values should be between 5 and 600 ( = ten minutes).
8.3.1.325Added a new variable SMTP_MSGSIZE in the FS files written from the Gateway. This is an approximate aggregate size of the attachment and body parts of the message, after decryption and decoding, if needed.8.3.1.324        Fixed an issue where for some of the 'message errors' to be reported back to the sender, the message might not have been sent.
8.3.1.324Added the ability to override the GW_RECIP_LIMIT environment variable with a GW_RECIP_LIMIT sender template (.FST) variable.
8.3.1.324Fixed and improved the handling of inbound e-mails addressed to multiple recipients.
8.3.1.324Changed the default to 'enabled' for the sender template option 'Only use a recipient matched in message envelope'.
8.3.1.320Added a report of the CopiaFacts version number on starting a new day's gateway trace file.
8.3.1.319Fixed a problem which could allow an incoming e-mail for faxing to be accepted without a valid sender template file.
8.3.1.295Fixed an issue where an active POP3 mailbox would be polled continuously during the minute preceding a change to/from peak and normal polling rates.
8.3.1.295Fixed an issue that could sometimes cause incorrect characters to be added to the name used for a saved incoming signing certificate.

CFHELPVIEW

9.1.0.360Upgraded to version 5 of this help viewer; we also now install Webview2Loader.DLL which this version now uses to load Webview2 if available on your machine, to impove the performance of the CopiaFacts context-sensitive help.

CFHWL

9.1.0.379Improved the descriptions of the HDID and (legacy) SDID features to clarify the differences in the handling of the dialed number in inbound calls. This is also reflected in the help hints for these items in CFHWL.
9.1.0.354Added a warning when you double-click a .CopiaKey file in which the license end date is earlier than the end of the current license. This reduces the chance of an older file saved on the desktop (which will have an "HWL" icon) being accidentally installed.
8.3.1.318Fixed an issue with the configuration of XCAPI channels for voice.
8.3.1.302Added the ability to configure TE-Systems XCAPI in a system with no configured voice channels.
8.3.1.278 Fixed an issue where some sequences of unchecking and checking license options could cause an invalid license key to be reported, even when the original settings had been restored.

CFINFO

9.1.0.370Changed the system info at the top of the COPIAFACTS trace to avoid a delay if a referenced mapped drive was unavailable.
9.1.0.370The detection of some other session types (e.g. Azure, QEMU) has been added to the ‘Session Type’ value.
9.1.0.359Added a report of the 'bitness' (32-bit or 64-bit) of the installed version of Microsoft Office [32-bit Office is required when used for document conversion].
9.1.0.354Improved the information displayed about the monitor manufacturer. model name, and physical size.
9.1.0.354Updated the Adobe Acrobat detection to recognize recent releases.
9.1.0.354Enhanced the detection of running in a HyperV virtual machine.
9.1.0.354Added a display of the programs which will be started a boot time if specified in STARTCOPIA.
8.3.1.323Modified the display of logical disk drives to show the percentage of free space in addition to the capacity.
8.3.1.321Fixed a problem where some newer versions of Acrobat were reported incorrectly as a 'not supported' version.
8.3.1.320Added support for reporting Microsoft Office 2021
8.3.1.314Added reporting of running on Windows 11.
8.3.1.314Added reporting of TPM provider, version and status. This is only shown if CFINFO is run elevated, and only shown in the COPIAFACTS trace file header if running elevated or as a service.
8.3.1.303Fixed the Windows 10 Release ID display to show alphanumeric values such as 21H1.
8.3.1.302Added a list of installed ADODB data providers.
8.3.1.300Fixed an issue where the default browser and mail client might not be displayed.
8.3.1.299Added details in the Network Adapters section to show the driver provider, driver version, and install date, and also the power options for the adapter.
8.3.1.294Added further hardware and configuration details.
8.3.1.293If a snapshot of the COPIAFACTS thread CPU usage has been written to the registry within the previous 30 minutes, the values from the registry are shown at the end of the system information.

CFJOURNAL

8.3.1.340Added an option on the settings page to hide the entries for logging in/out relating to a 'local resource'. These entries are otherwise included with system login and log out.
8.3.1.295Added the ability to refresh the display with F5.
8.3.1.294Added a pop-up hint to show the event-ID and source for an item. For Windows events, searching on line for Event ID xxxx may provide some additional information.
8.3.1.287Fixed a regression which caused the checkboxes used to filter entries not to work.
8.3.1.283Fixed an issue which could cause the program not to save the visible content on exit to FAXFACTS\CFJOURNAL.csv.

CFSIPMON, CFSMSERVICE

8.3.1.303Added support for services using compact SIP headers (RFC 3261 section 7.3.3).
8.3.1.300Enhanced the sorting, selection and searching features. Added a web link to SIP response code explanations on the right-click pop-up display of call details.
8.3.1.299The filename for the saved file has been changed to include the CopiaFacts node name and omit the century.
8.3.1.299Fixed an issue where the datafile was not saved when the service was stopped on Windows EndSession (for example, on a reboot or shutdown).
8.3.1.296A new feature has been introduced in the form of a SIP monitoring service application, CFSMSERVICE, and a SIP network data viewer CFSIPMON. These allow collection, monitoring and analysis of SIP traffic for either FoIP or VoIP operations.

CFTEST

9.1.0.378In FFTESTTS, updated the TTS Implementation Checklist topic to match Microsoft's current download locations for TTS features and voices.
9.1.0.354The tests for Application Support Functions now show the defined date and time format in the syntax examples for functions which take these parameters, instead of the default formats.
9.1.0.354Corrected the syntax examples for Application Support Functions which take no parameters.
8.3.1.332Changed the TESTFS output for a speed test on a local drive accessed by means of a UNC path. This now shows separate totals for access directly to the local folder and access using the network redirector. Previously the times for the alternative methods were incorrectly added together as a single total.

CFUTIL, CFUTILITY

9.1.0.362Fixed a version 8 regression in GCSINGLE which could cause a failure to secure a PDF with a password, or to add a signature to a PDF.
8.3.1.329Fixed a problem where the FFVOX2WAV utility was not picking up the registry settings from the last use of FFPLAY.
8.3.1.295Enhanced the PIN utility to allow the use of a file containing 10-digit numbers in the North American Numbering Plan area, where numbers are usually 'normalized' to include a leading '1'.

COPIAEDIT

9.1.0.373Improved the saving of FS files into a TOSEND folder to avoid a potential warning if a COPIAFACTS node attempts to open the file while it it being written.
9.1.0.354Fixed a problem where authentication was requested even when a command using a SECRETx variable was commented-out.
9.1.0.354Enhanced the context-sensitive help links for infobox type commands so that double-clicking a $type command shows the sub-topic for the infobox type, if present, (for example $type FS) not the main help topic for all type commands.
9.1.0.354Added an F11 key operation to view or save a formatted version of an HTML file. This may be useful if the HTML you are viewing is particularly complex, to more clearly see its structure.
9.1.0.354Added a feature to allow column block selection using Alt--Drag or Alt-Shift-Arrow. Because this is incompatible with word-wrap, it must first be enabled in the Options menu, which will uncheck and disable the word-wrap option.
9.1.0.354Fixed an issue where the difference viewer vertical scrolling did not synch with the movement of the scroll bar with a mouse.
8.3.1.309Fixed the rendering (toggled by F12) of some HTML documents which contain an absolute width specification. These are now scaled down to fit the window.
8.3.1.305Fixed an issue where special syntax highlighting for type FS infoboxes might sometimes not be applied.

COPIAFACTS

9.1.0.375Fixed a timing issue which could very occasionally cause an exception to be reported while shutting down the program.
9.1.0.371Fixed a SIP INVITE formatting problem if a parameter value contained the semicolon character, which is used as the default delimiter to delimit multiple headers if defined in VOIP_SET_CUSTOM_PARMS. The delimiter can now be selected using a new configuration-file variable VOIP_PARM_DELIMITER.
9.1.0.371A space is no longer added (incorrectly) after each colon character used in a value of the VOIP_SET_CUSTOM_PARMS variable. "colon+space" should only follow each field-name.
9.1.0.370Fixed a regression in build 367 which caused the program not to start at some sites if 'freeze detection' was enabled.
9.1.0.370Fixed an issue where changes to some run-time options before starting CopiaFacts might not be automatically saved, despite a disabled 'Save' button saying that they would be. The Save button should now always be used when changes are made.
9.1.0.370Changed the system info at the top of the COPIAFACTS trace to avoid a delay if a referenced mapped drive was unavailable.
9.1.0.368Fixed a display glitch which truncated the options list on the Options/Options tab.
9.1.0.367The XCAPI interface has been modified to support an XCAPI version 4.1 interface. See the XCAPI topic for information about the 4.1 upgrade.
9.1.0.367A warning will now appear in the trace if ACTIVE_WORK is enabled when the COPIA share is not on an NTFS file system.
9.1.0.361Improved the shutdown sequence to avoid very occasional exceptions while closing the .STATS files which provide data for CALLMON.
9.1.0.361Improved the management of Windows sockets for systems using Copia VoIP Ports.
9.1.0.358Fixed an issue where a forced shutdown could occasionally fail to complete.
9.1.0.358Added options to control the handling of some rare errors on placing a call on a Copia VoIP port channel.
9.1.0.357Fixed a rare problem where an exception which caused an engine service shutdown could result in continuous warning messages being written to a trace file after CFESERVICE had detected the shutdown and restarted the engine.
9.1.0.357Added a feature which allows a right-click on any folder name on the 'FS Counts' tab to open the folder in Windows Explorer. You should be aware that if you open a folder shown as containing many thousands of files on a remote network share, this may take a while to load; but COPIAFACTS will continue processing while you wait, and Explorer can be closed if it takes too long.
9.1.0.354Enhanced the handling and reporting of tracing and option settings when using the application(s) in Service mode. This fixed some issues where settings made in management mode were not passed to the service.
9.1.0.354Improved the checking for the presence of the correct engine DLLs.
9.1.0.354Add new operator keywords $sw and $ew to the $if command, to test whether a value starts with or ends with a specified substring.
9.1.0.354Fixed an issue where $if treated integer values with leading zeros as needing alphanumeric comparison.
9.1.0.354Added a new feature to $display_box to handle extra counters.
9.1.0.354Fixed a problem where left-shift/right-click on a channel in the top row of the channels box would fail to initiate killing the call.
9.1.0.354Fixed an issue where an empty default 00000000.MBX file would be created when a Accept Fax operation found that this file was not present.  This caused subsequent Accept operations to fail also. This can be resolved by manually creating the file.
8.3.1.351Fixed an issue where values * and # could not be dialed on the TE-Systems XCAPI interface.
8.3.1.350Fixed a problem which could cause an exception on some uses of the $display_box command.
8.3.1.348Fixed a regression which caused $action_phone action codes in the 300 range not to be actioned.
8.3.1.347Fixed a problem which could cause an exception on some uses of the $display_box command.
8.3.1.341Added a USE_TIFCAT environment variable to specify that the concatenation of multiple TIF files is to be performed outside the COPIAFACTS process.
8.3.1.340Fixed an issue where the presence of a USE_CHANNEL_COMMANDS variable in FAXFACTS.CFG would in some circumstances cause commands using 'channel' as an alternative to 'line' to be omitted when a command file was written out.
8.3.1.340Fixed a rare issue where repeated attempts to change tab without saving channel or queue changes could cause a crash.
8.3.1.340Changed initialization error 1746 to use message 1734.
8.3.1.340 Changed the detection of an application main thread freeze to default to disabled, in order to reduce the incidence of false positive automated bug reports and restarts. To restore the original behavior set a value such as 30 in environment variable BUGREPORT_FREEZE_SECONDS.
8.3.1.339Fixed an issue which could under rare circumstances cause the engine to crash if its window was dragged from one monitor to another with a higher DPI setting.
8.3.1.337Fixed a regression in build 336 which caused the service/desktop mode to be omitted from the system information in the trace at the start of each session.
8.3.1.337Improved the processing of XCAPI events when handling a high volume of inbound calls.8.3.1.335        Fixed a problem which could delay handling of XCAPI events on some systems.
8.3.1.334Fixed a problem which for some conversion operations could cause the contents of the IMAGE_OPTIONS variable not to be applied to the $image_options value. This variable remains recommended for special purposes only.
8.3.1.334Improved the handling of call-time document conversion errors.
8.3.1.333Added an environment variable VOIP_Q931 to specify that failed Copia VoIP Port calls should be reported with an outcome code using the Q.931 ISDN equivalent cause value (with 6000 added).
8.3.1.332Fixed a problem which could cause some voice operations to be performed on XCAPI channels configured in CFHWL for fax only.
8.3.1.331Fixed the truncation of warning message 6053.
8.3.1.331Fixed a problem where some very complex scripts assigning many long values to variables could result in an exception instead of a run-time error 4038.
8.3.1.331Changed the handling of environment variable BUGREPORT_FREEZE_SECONDS so that it can be set in the Windows system environment as well as using $environment.
8.3.1.330Fixed a regression which caused trace output from some of the CF8 DLLs not to be included in the FTx trace file when running in service mode.
8.3.1.326Added a new variable XCAPI_RECEIVE_NEGOTIATE_MS to control the amount of time that is allowed for negotiating incoming fax settings. The default remains 45 seconds (45000ms).
8.3.1.323Fixed an issue where changes to queue and channel schedules from a COPIAFACTS instance running in Management mode from CFCP could fail to be saved for the service.  In addition, management mode can not now be terminated with the Close button or Windows Close icon while schedule changes remain unsaved.
8.3.1.323Changed the operation of $trace_line so that it no longer requires the trace option Trace IIF actions to be set.
8.3.1.323Added a report of XCAPI license information in the trace file, when Debug Configuration and Startup is enabled in the options.
8.3.1.323Fixed an issue where in some circumstances trigger notifications were repeated at shorter intervals than specified.
8.3.1.323Fixed an issue where changes to queue and channel schedules from a COPIAFACTS instance running in Management mode from CFCP could fail to be saved for the service.  In addition, management mode can now not be terminated with the Close button or Windows Close icon while schedule changes remain unsaved.
8.3.1.320Increased the maximum allowable $active_life value to accommodate sending faxes with hundreds of pages.
8.3.1.320Fixed an issue which could cause the checkboxes not to appear on the Options/Options tab on some systems with high-DPI monitors.
8.3.1.320Clarified the differences between Diva and XCAPI error outcome codes in the built-in descriptions and in CF8.SMR.
8.3.1.317Fixed a rare condition which could cause a freeze to be reported when closing a COPIA VoIP port at the end of a call.
8.3.1.317Added a warning if unprocessed files exist in the PREPROC folder which are more than a day old. This might indicate that FFEXTERN is not running or is not configured correctly. The warning only appears if you have visited the FS Counts tab.
8.3.1.317Fixed a regression which caused all variable names to be double-quoted in generated MCF files. This has no effect on the operation of CopiaFacts but broke a customer application which expected names to be quoted only if they had an embedded space (which very few would).
8.3.1.317Fixed an issue causing the CHANNEL_BUSY variable not to be set for Copia VoIP Ports.
8.3.1.314Added a display of the XCAPI driver version in the trace headings, in addition to the XCAPI SDK version The XCAPI service version has also been added in the CFINFO services list.
8.3.1.312Fixed an issue with the XCAPI_USE_PLUS variable.
8.3.1.312Fixed a problem which caused variables in the $sms_from parameter not to be expanded.
8.3.1.310Fixed a regression which could cause a memory leak if the original per-channel variable size limit (removed in build 306) was repeatedly exceeded.
8.3.1.309Fixed an issue where running on a machine with a monitor using 'larger text' settings could in some cases affect the size of text used by an 'at run time' HTML conversion to TIF.
8.3.1.309Fixed the OTF_USE_PLUS variable so that a $country_prefix value of 011 is substituted by +1, not by +.
8.3.1.309Added an XC_USE_PLUS variable to change a number starting with the defined $country_prefix value so that it is dialed with a leading plus in E.164 format, when this is required by a telco.
8.3.1.307Added environment variable XCAPI_HEADERS which allows specification of SIP INVITE header names for which the value is to be extracted into CopiaFacts variables.
8.3.1.307Added variable P_ASSERTED_ID which allows the retrieval and setting of the value of the P-Asserted-Identity header (see rfc 3325) in XCAPI SIP INVITE messages.
8.3.1.307Fixed an issue which could cause user variables whose variable name contains non-ASCII characters to be expanded incorrectly or copied incorrectly to output FS files.
8.3.1.305Fixed an issue where an extremely long variable value defined in a user profile could be truncated before use by an FS file which references the profile.
8.3.1.305Removed the character count limit (default 16k) on the total of user variable value sizes loaded in a call. The override on the Options/Options tab is now ignored.
8.3.1.304New environment variables DIVA_Q931 and XCAPI_Q931 can contain a non-empty value to cause outcome codes for dial failure on a Diva board or an XCAPI port to be reported as a Q.931-equivalent cause value plus 6000 instead of the default outcome code plus 8700.
8.3.1.304Fixed a regression in build 8.3.1.302 which could cause an exception while writing an FS file from a $type FS infobox on a heavily loaded system.
8.3.1.304Fixed an issue which could cause user variables whose names contain non-ASCII characters to be copied incorrectly to output FS files.
8.3.1.302Enabling the XCAPI SDK log file now requires two environment variables, XCAPI_SDK_LOGFILE and XCAPI_SDK_LOGCODE.
8.3.1.302Added a variable XCAPI_COMBINE_FAXFILES to control fax transmission options, which may be required at some sites. Copia support will advise if this setting is needed.
8.3.1.302Fixed an issue which could send an incorrect list of the active TOSEND queues to be displayed in CFCP.
8.3.1.302Fixed an issue which caused miscalculation of the time-interval during which a partial retry was considered.
8.3.1.302Added the ability to configure TE-Systems XCAPI in a system with no configured voice channels.
8.3.1.302Fixed an issue which could sometimes cause a recording on a Copia VoIP port not to be saved.
8.3.1.300Added support for XCAPI 4.0 (in addition to 3.6)
8.3.1.300Fixed an issue where a variable value such as a fax CSID might not be assigned correctly if it stared with a + sign.
8.3.1.300Added the ability to set variables containing the value of selected SIP headers, when using the XCAPI interface.
8.3.1.299Added an option to build a complete HTML fax cover sheet using the text/html body from an incoming e-mail in an email-to-fax operation.
8.3.1.295Added OpenDocument formats (.ODT, .ODS, .ODP) to the supported formats handled by the Document Converter. These extensions are automatically picked up when the DOCX keyword is present on $convert_types.
8.3.1.295Fixed an issue where a few registry key names might have a duplicated node name, such as COPIAFACTS_M1_M1.
8.3.1.295Fixed an issue where the conditional shutdown timeout (on the Options tab) could fail to convert a conditional timeout to an immediate timeout if calls on Copia VoIP Ports were active.
8.3.1.295Improved the reporting in the engine trace if the 'wait for service start' is unable to access the service to check its status.
8.3.1.294Monitoring of the BladeWare service start-up has been enhanced. If you currently use the BLADEWARESERVICE environment variable, please check the updated description of this variable.
8.3.1.294The MINUTESLIMIT environment variable need no longer be set to an extended interval if you use the enhanced BLADEWARESERVICE options to wait for BladeWare to start; the engine no longer blocks messages to the COPIAFACTS GUI while waiting for the service to start.
8.3.1.294Fixed a problem where the monitoring of active BladeWare processes did not include all of the processes on machines with larger numbers of channels.

COPIAHTML

9.1.0.357Added a WYSIWYG HTML editor to allow editing of custom notification e-mails, such as for received faxes or for outbound e-mail result reports; or for creating custom HTML fax cover sheets.

COPIAINSTALL9

8.3.1.367Fixed a problem which could cause the omission of some build dates in the 'check for updates' list.
8.3.1.356Improved the selection of XCAPI installer downloads to display the release dates of the XCAPI version they contain. When updating XCAPI, your software update service (SUS) must extend past this release date, in order to update to this version. For new installs, your initial allowed update period must extend past this release date in order to update to a new XCAPI version. The same release date is also displayed on the initial screen of the installer.
9.1.0.354No longer attempts to configure settings for CHM help files, and no longer checks for older Internet Explorer versions.
9.1.0.354Now offers to download On-Demand-Assist.exe for Remote Support. This can also be done from COPIACLIENTINSTALL9.

CVSINGLE

9.1.0.365Added a mechanism (as in COPIAFACTS) to send a notification message to Copia support on an unhandled exception in the program or in any of the conversion operations it calls.
9.1.0.357Added a feature to allow the Image Options Editor to save the selected image options in an alternate data stream of the original document file. For standard documents which you fax regularly, this allows the same settings to be used each time. This feature is enabled by specifying an EMBED_IMAGE_OPTIONS variable in FAXFACTS.CFG.
9.1.0.354Added support for LibreOffice version 24.2 (new Libre numbering method).
8.3.1.353Improved the reporting of some conversion errors in Office Document files.
8.3.1.322Added support for LibreOffice version 7.3. With this release we have re-tested the LibreOffice interface in CopiaFacts and have been able to remove some of the special workarounds that allowed operation with Libre version 6 and early version 7 releases. You should therefore upgrade LibreOffice to version 7.3 or later if you are using an earlier Libre release, to operate with 8.3.1.322 and subsequent versions of CopiaFacts. See also the LibreOffice topic.
8.3.1.320Added support for LibreOffice 7.2.5
8.3.1.320Added support for Microsoft Office 2021
8.3.1.309Added support for LibreOffice 7.2.
8.3.1.295Added OpenDocument formats (.ODT, .ODS. .ODP) to the supported formats handled by the Document Converter. These extensions are automatically picked up when the DOCX keyword is present on $convert_types.

EMDIRECT

8.3.1.312Expanded the log entry (in C:\FAXTEMP\EMDIRECT.LOG) to show the ZIP file name and its contents, when "Send Files to Copia" has been used.

EMSETUP

0.1.0.378Modified the Trigger warning for CopiaFacts Limited Period License expiry so that the warning notification can be set (by means of a configuration variable LPL_WARN_DAYS) to be sent earlier before the license expiry than the default two days.
9.1.0.354Improved the comments, field labels and field hints which describe the mail server settings.
8.3.1.335Added a notification trigger for the start of a controlled shutdown caused by $kill_group. At sites where faxes with large numbers of pages are sent and received, it can take a long time before the shutdown notification is sent.
8.3.1.323Added a notification trigger to warn of an approaching XCAPI license or software update service expiration date. This trigger is not enabled automatically and COPIAFACTS is not shut down automatically if the license has expired. The warning commences 4 weeks ahead of the expiration date, and is repeated daily or at the longer intervals specified in the trigger settings.
8.3.1.323Improved configuration of trigger notifications by allowing the interval between repeats of the same notification to be specified in days, not only in minutes.
8.3.1.295The "Send Files to Copia" right-click menu for Windows Explorer has been enhanced.  If a single FS file is selected, this will now automatically gather the trace and Gateway files to be send with the FS file, in the same way that this is already done in STATUS.

FFCLIENT

8.3.1.353Added a FAXFACTS.CFG variable No_FFCLIENT_EMail which when set to a non-empty value will prevent the use of FFCLIENT for initiating e-mail transactions.
8.3.1.339Added an option to use the DNIS number of an FFCLIENT user to set an override ANI for their outbound faxes.
8.3.1.339Fixed a problem which resulted in incorrect syntax when adding custom user variables to generated FS files.
8.3.1.302Improved the user interface for the address book feature and fixed some issues affecting the selection of multiple recipients.

FFEXTERN

9.1.0.361Improved the reporting of 'inactive' and 'suspended' modes to pause processing, which now match the actions in CFCP.
9.1.0.354Enhanced the dialogs for process configuration to allow the mouse wheel to be used to increment or decrement integer values, in addition to the up/down arrows beside the field. This now matches the UI in all other CopiaFacts programs.
9.1.0.354Enhanced the handling and reporting of tracing and option settings when using the application(s) in Service mode. This fixed some issues where settings made in management mode were not passed to the service.
9.1.0.354Improved the handling of PDF options in the Conversion Options dialog, and added a warning if 'at run time' conversion is selected for all PDFs (which is not recommended).
8.3.1.330Fixed a regression which caused trace output from some of the CF8 DLLs not to be included in the FTx trace file when running in service mode.
8.3.1.321Fixed a problem where some newer versions of Acrobat were reported incorrectly as a 'not supported' version.
8.3.1.318Fixed a problem where the legacy xif keyword on $convert_types was lost if the command was updated in the options dialog.
8.3.1.301Changed the FXEPIC special process to accommodate a change in the scanned XML syntax.
8.3.1.295Added OpenDocument formats (.ODT, .ODS, .ODP) to the supported formats handled by the Document Converter. These extensions are automatically picked up when the DOCX keyword is present on $convert_types.

FFTRACE

8.3.1.317Fixed an issue which caused an override node name set from 'File/Set Node Name' not to be used on the next run of the program.

FFVIEWER

9.1.0.357When loading a non-faxable TIF file, the program now attempts to convert the file to faxable (monochrome) TIF files and allows the Image Options editor to be used to change the conversion settings and reconvert the file. This feature is only enabled when such files are selected in FFEXTERN for automatic conversion. In earlier releases, non-faxable TIF files were reported as such by FFVIEWER and could not be loaded.
9.1.0.357Added a feature to allow the Image Options Editor to save the selected image options in an alternate data stream of the original document file. For standard documents which you fax regularly, this allows the same settings to be used each time. This feature is enabled by specifying an EMBED_IMAGE_OPTIONS variable in FAXFACTS.CFG.
9.1.0.354Fixed a regression which resulted in the font color selected for a PDF annotation not being saved to the GPT file or reloaded from a GPT file.
8.3.1.322Fixed a problem where the File Save Wizard dialog could in some circumstances get confused over whether to save annotations in TIF mode (GCT, GTT) or in PDF mode (GPT).
8.3.1.309Fixed a regression which caused the wrong font size to be set from a <font> tag in an HTML annotation.
8.3.1.309Enhanced the supported HTML subset for TIF annotations, including the ability to include monochrome images in formats other than BMP, for example SVG or PNG.
8.3.1.301Fixed the Image Options Editor so that on FFVIEWER startup a file for conversion is always loaded with the option set last used to load a file. It could previously sometimes load a new document with the default option set but display the last used options set.
8.3.1.300 Added the ability to generate QR codes on outgoing faxes and e-mailed PDF attachments.

FTPUPLOAD

9.1.0.354Now supports FTPS and SFTP secure upload protocols.

GWMANAGER

8.3.1.325 A session timeout in seconds can now be specified on the GWMANAGER Server tab, to override the default value of 30s. If you expect to receive very large attachments or are operating with a low bandwidth connection, a higher value can be set. Values should be between 5 and 600 ( = ten minutes).
8.3.1.305Fixed a problem where the Gateway settings for built-in deletion/archiving of saved messages might have been corrupted on saving in an earlier release. This is now detected on opening GWMANAGER, reverted to default settings, and disabled, with a warning pop-up. This issue does not affect CFHK settings.
8.3.1.295Skipped the warning on folder names in the GWRecipientDomains and GWTEMPLATES folders if the folder name does not appear to be a domain name (containing '.'). This allows folders to be created named for example BACKUP or SAVED without causing a warning to appear on opening the Validation dialog.
8.3.1.294Fixed an issue which prevented the program from managing an instance of CFGATEWAY which had been installed as a service using the /install command-line option rather than installing it from GWMANAGER.

OMACHECK

8.3.1.305Fixed a problem which caused the 'send to Copia' checkboxes on notification triggers not to be saved and restored correctly.
8.3.1.304Improved the selection of actions which will trigger a reboot.

OTFCONFIG

8.3.1.302Changed 'babyTel' to 'Cloudli', the new name of this SIP provider, in the program and the documentation.
8.3.1.294The start-up command file for testing COPIAFACTS has been improved, and a variable delay added.
8.3.1.294The value for $environment MINUTESLIMIT is no longer set; the default value is 1.

SERCONF

8.3.1.324Added more suggested settings for new users.  Existing users can open SERCONF to view the default new-user settings.
8.3.1.294The value for $environment BLADEWARESERVICE for new installations is now set to WAIT120.

STARTCOPIA

9.1.0.354Fixed an issue in some earlier releases where unchecking the OMACHECK checkbox could leave its 'run as administrator' checkbox checked. As a result STARTCOPIA could run at boot time, even if there was nothing for it to start,

STATUS

8.3.1.314Added a warning if a sender JCF file exceeds around 1000 FS-file entries. This can delay the STATUS display when STATUS is started from FFCLIENT.  In addition you can now click the 'ESCAPE to stop scan' message to stop the scan.
8.3.1.300Deleting files no longer requires a refresh, unless some of the selected files could not be deleted.
8.3.1.296The option (introduced in 8.3.1.295) to exclude all but a specific range of dates has been enhanced by including it in the settings that are persisted between activations of STATUS.  In addition if the end-date is the current date when STATUS is closed, it will be set to the current date when next opened.
8.3.1.296The Manual Refresh Only option has been extended to suppress scanning when the program is first opened.
8.3.1.296 The ability for users in administrator mode to save and restore named sets of columns and filter settings had been accidentally disabled and is now restored.
8.3.1.295Added a new Options menu item to suppress the automatic refresh when you change the filters for folders and dates to be scanned. This allows several filters (SENT/FAIL/PENDING and Earliest Date) to be set without a new search starting after each one. Instead the Refresh button flashes to remind you to refresh the required filters have been set.
8.3.1.295Added a new 'Hide before/after dates' menu item which allows you to select an individual date or date range to filter the files to be scanned. This can be very fast because STATUS does not need to open any unwanted files.
8.3.1.295An option has been added to highlight a specified text string throughout the grid. You may need to widen the window to see the entry field in the headings.

TRCVIEW

9.1.0.371Several programs which write trace files now replace newlines embedded in a trace line with a ¶ character, to avoid a newline breaking up the view of the trace.
9.1.0.364Fixed an issue where a right-click in the main window might bring up the 'copy' window with an incorrect size.
9.1.0.364Added the ability to select a border color from the Options menu, to help identify the window when viewing multiple trace files. The program opens with no colored border, unless 'Save bookmarks' is enabled to save bookmarks with the specific file. Border color save and restore is now added to the bookmark positions in the alternate data stream of the trace file.
9.1.0.358Fixed an issue where the items selected on the Applications menu in an 'FT' trace were not retained on a reload of the trace file.
9.1.0.354A horizontal scroll bar has been added to allow long displayed lines to be viewed more easily. In addition to dragging with the mouse, you can also use the mousewheel when the mouse cursor is on the scroll bar. There is a menu item in the Options menu to hide this scroll bar.
9.1.0.354A new keyboard option (control-R) toggles a temporary filter to show only the "Result:" lines in a trace file. Any existing filtering is disabled, then restored when you press control-R the second time.
9.1.0.354Fixed a problem where a trace file too big to process could be reported as 'file not found'. At the same time the maximum size limit was doubled.
8.3.1.337Added the ability to combine filter texts with 'and not' by adding a marker (default !) in front of the text, following the delimiter defined for 'and'.
8.3.1.332Fixed a problem where 'find next' (F3) and 'find previous' (shift-F3) failed to find a new instance when the string to be matched contained an 'and' operator (default &) to find lines with more than one matched string on a line.
8.3.1.325Fixed an issue where text copied from the 'select text' dialog to the 'search/filter dialog' was sometimes not added to the 'most recently used' filter list.
8.3.1.303Added the ability to filter multiple separate text items on a trace line, for example to show lines showing both "fax in" and "success". For syntax examples, click Delimiters in the highlighting/filtering pop-up dialog.

(documentation)

9.1.0.379Improved the descriptions of the HDID and (legacy) SDID features to clarify the differences in the handling of the dialed number in inbound calls. This is also reflected in the help hints for these items in CFHWL.
9.1.0.378For help topics which contain multiple sub-sections, the use of the Scroll icon (on the top bar, when needed) has been extended in more topics to show sub-sections not visible on the first topic page.
9.1.0.368Clarified the rules for using grouped variables together with regular variables of the same name.
9.1.0.366Changed some references to (discontinued) Terminal Services / Thin Client support to light green.
9.1.0.354Updated Appendix F (standard directory descriptions).
9.1.0.354The convention of using green for obsolete feature descriptions has occasionally given users the impression that the feature was good for use. It has been changed to light green instead.
9.1.0.354Made some small improvements to the readability and appearance of the web help and the context-sensitive help.
9.1.0.354Added hotspots to screen shots in most cases where a part of the image is documented in a topic other than the one containing the screen shot.
8.3.1.343Improved the documentation of some XCAPI outcome codes, and added links to details of how to resolve the causes.
8.3.1.333Added links to XCAPI tutorial videos on YouTube.
8.3.1.325Expanded the documentation for XCAPI trace files.
8.3.1.324Added documentation for setting the SIP response to be sent on XCAPI Failover and Overflow.
8.3.1.324Added the missing ranges 801-811 and 1201-1229 to CF8.SMR.
8.3.1.323Improved accessibility of the web help: when 'caret mode' is enabled in the browser (F7). you can use the keyboard to navigate with tab and shift-tab down and up in the contents area or between links in the text.
8.3.1.323Added descriptions of the current list of trigger notifications to the documentation topic.
8.3.1.322Implemented new, more legible skins for the on-line web help and the 'Ewriter' context-sensitive help.
8.3.1.322Modified the $run topic to update the considerations for running a batch file in current Windows environments.
8.3.1.321Corrected the documentation for $ad_get_user.
8.3.1.320Corrected the topic for $user_limit.
8.3.1.317Clarified the options for KEEP_FAX.
8.3.1.309Clarified the usage of the $country_prefix configuration-file command.
8.3.1.309Added a new topic summarizing actions for Viewing, Notifying and Printing Faxes.
8.3.1.303Improved the documentation of disabling the OS caches; and the XCAPI installation screen shots.
8.3.1.302Added screen shots showing XCAPI configuration.
8.3.1.302Clarified and corrected the documentation for the PREPARE_FAX variable.
8.3.1.301Improved the documentation of conditional commands to clarify the use of double-quotes in operands.

(installers)

9.1.0.369FIxed a typo in the XCAPI SUS date for 4.0.29.
9.1.0.354COPIAINSTALL9 no longer attempts to configure settings for CHM help files, and no longer checks for older Internet Explorer versions.
9.1.0.354COPIAINSTALL9 now offers to download On-Demand-Assist.exe for Remote Support. This can also be done from COPIACLIENTINSTALL9.
9.1.0.354CopiaServerInstall9.. improves the status display to show each component  installer as it runs at the end of the installation.
8.3.1.314Fixed a regression which caused large font sizes in the COPIAINSTALL buttons, with some monitor settings. This issue also affected COPIACLIENTINSTALL.
8.3.1.302The installation of the CopiaFacts infotip handler has been disabled while changes in Windows 10 prevent some of the custom hints from being shown.
8.3.1.301Included accidentally omitted HTML fax cover sheet sample files.
8.3.1.294Added a 'do not warn again' checkbox on the COPIAINSTALL dialog warning that Content Indexing is enabled.

(multiple programs)

9.1.0.354Signed using Sectigo code-signing certificate expiring 2026.01.01 23:59:59.
8.3.1.342Built executable programs and libraries using an updated code-signing certificate.
8.3.1.326In some cases, a numeric 'spin-edit' control failed to respond to the mouse-wheel to increment or decrement the value: this has been fixed.
8.3.1.294 Improved the context-sensitive help in all programs, especially those where different help topics are linked from separate pages of a tabbed dialog.  Please report any remaining incorrect topic links that you find when pressing F1 or clicking a Help button.

(print drivers)

 

(scripts)

Note that new scripts never automatically update files in your FAXFACTS\SCRIPTS folder: please update your copy from the SAMPLES\ScriptMasterCopies folder, using COPIAEDIT. 
9.1.0.354Fixed PRI_FAX2EMAIL20.IIF and PRIFAX2EMAILsecure20.IIF to specify keywords relating to e-mail, not to fax, on the $delete_option command.
8.3.1.343Made changes to the PRI_FAX2EMAIL, PRI_FAX2EMAIL20, and PRI_FAX2EMAILsecure20 scripts to create a thumbnail of the incoming fax document once only, not for each generated FS. On high-capacity systems, this avoids the possibility of self-induced file locks in cases where multiple e-mail recipients are specified.
8.3.1.340Made a change in IIF files PRI_INIT, PRI_INIT30, PRI_FAX2EMAIL20, PRI_FAX2EMAILsecure20, PRI_EMLINK, PRI_EM, PRI_EM2, PRI_EM3 to make it simpler to use different TOSEND queues for e-mail and workerbox FS files. If you apply these changes to your post-receive scripts, all should be applied.
8.3.1.322Modified PRI_INIT10 to better handle AD option settings for inbound fax.
8.3.1.314Corrected and improved the FaxNotify profile and scripting for processing alternate fax numbers.
8.3.1.300Fixed an issue where a variable value such as a fax CSID might not be assigned correctly if it stared with a + sign.
8.3.1.296In GW_EMFORWARD.IIF, the content type for a MSG or EML attachment has been changed to text/plain to avoid the special processing that some receiving mail clients apply to embedded e-mail attachments.

 

Direct Links: CF8GCOVER CF8JOBADM CF8GATEWAY COPIAFACTS CVSINGLE EMDIRECT FFBC FFEXTERN FFVIEWER