Please enable JavaScript to view this site.

CopiaFacts Reference Manual

 

The changes listed below for components named CF8... have all been carried forward to the version 9 equivalents named CF9.  Build numbers later than 353 are now version 9 builds and appear in the main topic for version 9 in this Appendix.

Version 8.3.1.353 2023.10.11

FFCLIENTAdded a FAXFACTS.CFG variable No_FFCLENT_EMail which when set to a non-empty value will prevent the use of FFCLIENT for initiating e-mail transactions.
CVSINGLEImproved the reporting of some conversion errors in Office Document files.

Version 8.3.1.352 2023.09.01

CFGATEWAYFixed 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.

Version 8.3.1.351 2023.06.03

COPIAFACTSFixed an issue where values * and # could not be dialed on the TE-Systems XCAPI interface.

Version 8.3.1.350 2023.05.04

COPIAFACTSFixed a problem which could cause an exception on some uses of the $display_box command.
CF8IMAGEFixed a problem which could cause memory allocation fragmentation and failure when converting to TIF very large documents with many pages
CF8SUPPORTFixed a problem which could cause some conversions to fail in the ConvertFile application support function.
COPIAFACTSFixed a regression which caused $action_phone actions with codes in the 300 range not to be performed.

Version 8.3.1.348 2023.03.13

COPIAFACTSFixed a problem which could cause an exception on some uses of the $display_box command.
CF8IMAGEFixed a problem which could cause memory allocation fragmentation and failure when converting to TIF large documents with many pages.
CF8SUPPORTFixed a problem which could cause some conversions to fail in the ConvertFile application support function.
COPIAFACTSFixed a regression which caused $action_phone actions with codes in the 300 range not to be performed.

Version 8.3.1.345 2023.02.04

DocumentationImproved the documentation of some XCAPI outcome codes, and added links to details of how to resolve the causes.
ScriptsMade 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.
CF8IMAGEModified the handling of at-send-time HTML document conversions to reduce the likelihood of occasional conversion failures under heavy load.
CF8SUPPORTImproved the error reports from the CreateThumbnail function.
ScriptsFixed a regression in the script changes in build 343.
CFGATEWAYModified the loading of received messages to accommodate those with large numbers (hundreds) of lines of header messages.

Version 8.3.1.343 2023.01.29

DocumentationImproved the documentation of some XCAPI outcome codes, and added links to details of how to resolve the causes.
ScriptsMade 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.
CF8IMAGEModified the handling of at-send-time HTML document conversions to reduce the likelihood of occasional conversion failures under heavy load.
CF8SUPPORTImproved the error reports from the CreateThumbnail function.

Version 8.3.1.342 2023.01.06

CF8IMAGEModified 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.
CF8JOBADMUpdated the lists of telephone Area Codes and Country Codes used for 'timed delivery by destination location'.
(multiple)Built executable programs and libraries using an updated code-signing certificate.

Version 8.3.1.341 2022.12.12

FFEXTERNFixed some field-alignment issues on the process-setup screens.
FFMERGEImproved the ability to add an extra document to be sent to all FFMERGE items in a task.
COPIAFACTSImproved the tracing of $type fsfile infoboxes, to show the full pathname of the generated FS file, and its originating FS or MCF file.
DocumentationAdded more advice on avoiding spam blocks in Appendix O.
GWMANAGERAdded the ability on the Error Handling tab to select a queue for the FS files which initiate a report to the sender of an e-mail rejected by the Gateway. Such FS files contain a FORCE_FAIL definition so may be processed on any free COPIAFACTS channel other than inbound-only.
CFUTIL CFUTILITYFixed a serious bug which could in the wrong files being concatenated by TIFCAT.
FFEXTERNModified the FXPDFSCAN special process to rename the processed PDF with a changed file extension, instead of deleting it.
FFEXTERN Fixed some special process configuration screens where the existing scan folder name could not be edited.
FFEXTERNFixed a regression in the FXPDFSCAN special process which resulted in mis-positioning the overwrite blank text box used to remove text detected in regular-expression scans.
COPIAFACTSAdded a USE_TIFCAT environment variable to specify that the concatenation of multiple TIF files is to be performed outside the COPIAFACTS process.
CF8JOBADMBuilt with the IANA 2022g Timezone database.
JOBADMINFixed a problem which could occasionally cause a crash on selecting a column filter on the overview tab which shows only a very small number of entries.

Version 8.3.1.340 2022.10.

CFJOURNALAdded 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.
COPIAFACTSFixed 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.
COPIAFACTSFixed a rare issue where repeated attempts to change tab without saving channel or queue changes could cause a crash.
COPIAFACTSChanged initialization error 1746 to use message 1734.
COPIAFACTS 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.
ScriptsMade 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.
GWMANAGERReverted a change which prevented disabling the MatchEnvRecip check (that the SIP To: header must match the SMTP recipient of an incoming message). Disabling this check can result in multiple replicated messages being sent and retaining the check is strongly recommended.
CFGATEWAYFixed an issue which in some circumstances could fail to extract a phone number from the e-mail subject of an e-mail retrieved from a POP3 mailbox.

Version 8.3.1.339 2022.11.15

FFCLIENTAdded an option to use the DNIS number of an FFCLIENT user to set an override ANI for their outbound faxes.
FFCLIENTFixed a problem which resulted in incorrect syntax when adding custom user variables to generated FS files.
CFCLIENTADMINChanged 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.
COPIAFACTSFixed 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.

Version 8.3.1.338 2022.09.22

CF8IMAGEAdded support for the latest PDFIUM release.
CF8IMAGEFixed an issue where trace output was sometimes corrupted when displaying image options. This did not impair conversion operations.
CFGATEWAYFixed an issue where e-mail image attachments with a Content-ID header were only processed if referenced from an HTML body file.
CF8EXCELImproved the handling of XLS and XLSX files not created using Excel.

Version 8.3.1.337 2022.09.16

COPIAFACTSFIxed 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.
TRCVIEWAdded 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'.
COPIAFACTSImproved the processing of XCAPI events when handling a high volume of inbound calls.

Version 8.3.1.335 2022.08.30

EMSETUPAdded 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.

Version 8.3.1.334 2022.08.11

DocumentationAdded links to XCAPI tutorial videos on YouTube.
COPIAFACTSAdded 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).
COPIAFACTSFixed 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.
COPIAFACTSImproved the handling of call-time document conversion errors.
CF8JOBADMBuilt with the IANA 2022b Timezone database.

Version 8.3.1.332 2022.07.27

TRCVIEWFixed 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.
CFTESTChanged 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.
COPIAFACTSFixed a problem which could cause some voice operations to be performed on XCAPI channels configured in CFHWL for fax only.

Version 8.3.1.331 2022.07.17

COPIAFACTSFixed the truncation of warning message 6053.
COPIAFACTSFixed 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.
COPIAFACTSChanged the handling of environment variable BUGREPORT_FREEZE_SECONDS so that it can be set in the Windows system environment as well as using $environment.

Version 8.3.1.330 2022.07.07

CFUTIL, CFUTILITYFixed a problem where the FFVOX2WAV utility was not picking up the registry settings from the last use of FFPLAY.
COPIAFACTS, FFEXTERNFixed 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.

Version 8.3.1.327 2022.06.30

CF8IMAGEFixed a regression which caused some types of text annotation to be omitted when converting a PDF to TIF in the default PDF converter.  At the same time an issue was fixed which could cause a part of a converted PDF document to appear less crisp than the remainder.
COPIAFACTS, CFINFOImproved the collection of system information to reduce the start-up time for an engine session in a large-system environment.

Version 8.3.1.326 2022.06.14

CFCERTINFOChanged the manifest to require 'run as administrator'. Some versions of Windows may require this to read certificates.
MultipleIn some cases, a numeric 'spin-edit' control failed to respond to the mouse-wheel to increment or decrement the value: this has been fixed.
CF8EMAILFixed 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).
CF8EMAIL 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.
COPIAFACTSAdded 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).

Version 8.3.1.325 2022.05.23

CF8IMAGEExtended the tolerances for document sizes so that slightly undersized US-Letter landscape pages are correctly rotated in a PDF being converted for faxing.
TRCVIEWFixed 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.
GWMANAGER, CFGATEWAY 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).
CFGATEWAYAdded 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.
CF8IMAGEAdded support for the latest PDFIUM release.
CF8EMAILFixed 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.
DocumentationExpanded the documentation for XCAPI trace files.

Version 8.3.1.324 2022.04.27

DocumentationAdded documentation for setting the SIP response to be sent on XCAPI Failover and Overflow.
CFGATEWAYFixed and improved the handling of inbound e-mails addressed to multiple recipients.
CFGATEWAYChanged the default to 'enabled' for the sender template option 'Only use a recipient matched in message envelope'.
CFGATEWAY Fixed an issue where for some of the 'message errors' to be reported back to the sender, the message might not have been sent.
CFGATEWAYAdded the ability to override the GW_RECIP_LIMIT environment variable with a GW_RECIP_LIMIT sender template (.FST) variable.
SERCONFAdded more suggested settings for new users.  Existing users can open SERCONF to view the default new-user settings.
DocumentationAdded the missing ranges 801-811 and 1201-1229 to CF8.SMR.

Version 8.3.1.323 2022.04.04

CFINFOModified the display of logical disk drives to show the percentage of free space in addition to the capacity.
COPIAFACTSAdded a report of XCAPI license information in the trace file, when Debug Configuration and Startup is enabled in the options.
EMSETUPAdded a notification trigger to warn of an approaching XCAPI Software Update Service expiration date. 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. If not already configured, this warning will be automatically enabled after upgrading to this CopiaFacts build.
EMSETUPImproved configuration of trigger notifications by allowing the interval between repeats of the same notification to be specified in days, not only in minutes.
COPIAFACTSFixed an issue where in some circumstances trigger notifications were repeated at shorter intervals than specified.
DocumentationAdded descriptions of the current list of trigger notifications to the documentation topic.
DocumentationStarted adding syntax-examples to the configuration variables normally set using $var_def and $environment variables. These command examples in purple color are intended to show only the syntax; they do not represent recommended settings.
DocumentationImproved 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.
CF8JOBADMBuilt with the IANA 2022a Timezone database.
COPIAFACTSChanged the operation of $trace_line so that it no longer requires the trace option Trace IIF actions to be set.
COPIAFACTSFixed 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.

Version 8.3.1.322 2022.02.15

FFVIEWERFixed 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).
CVSINGLEAdded 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.
CFCERTINFOImproved the validation of certificates to avoid very occasional marking of a valid certificate as invalid.
DocumentationImplemented new, more legible skins for the on-line web help and the 'eWriter' context-sensitive help.
DocumentationModified the $run topic to update the considerations for running a batch file in current Windows environments.
ScriptsModified PRI_INIT10 to better handle AD option settings for inbound fax.

Version 8.3.1.321 2022.01.26

DocumentationCorrected the documentation for $ad_get_user.
ScriptsModified PRI_INIT10 to better handle AD option settings for inbound fax.
FFEXTERN, CFINFOFixed a problem where some newer versions of Acrobat were reported incorrectly as a 'not supported' version.
CF8IMAGEModified the built-in PDF converter to handle certain types of PDF form field for which the contents were rendered incorrectly.
COPIAFACTSClarified the differences between Diva and XCAPI error outcome codes in the built-in descriptions and in CF8.SMR.
CVSINGLEAdded support for LibreOffice 7.2.5
CVSINGLE, CFINFOAdded support for Microsoft Office 2021
COPIAFACTSIncreased the maximum allowable $active_life value to accommodate sending faxes with hundreds of pages.
COPIAFACTSFixed an issue which could cause the checkboxes not to appear on the Options/Options tab on some systems with high-DPI monitors.
DocumentationCorrected the topic for $user_limit.
CFGATEWAYAdded a report of the CopiaFacts version number on starting a new day's gateway trace file.

Version 8.3.1.319 2022.01.05

CFGATEWAYFixed a problem which could allow an incoming e-mail for faxing to be accepted without a valid sender template file.