Tungsten Automation

Kofax Import Connector 2.10.0 Fix Pack 13

Build date: July 30, 2024

© 2024 Tungsten Automation. All rights reserved.
Use is subject to license terms.

Introduction

You can install Kofax Import Connector 2.10.0.13 to apply the features added and resolve the issues listed below.

Note: To install Kofax Import Connector 2.10.0.13 successfully, an existing full installation of Kofax Import Connector 2.10.0 is required.

If you need to perform a full product installation, see Help for Kofax Import Connector Installation for instructions.

Feature added in this fix pack

2128995: PDF files with Unicode names are supported.

Issue resolved in this fix pack

ID Issue Solution
2128918 PDF/A-2b to PDF/A-3b conversion failed sometimes when the third-party component reported post-analysis errors. Enhanced the conversion to ignore post-analysis errors.

Do the following to allow conversion with post-analysis errors:

  1. Open the KFXConverter_Default.ini file in a text editor.

    By default, the KFXConverter_Default.ini file for the first instance of Message Connector is available at:

    C:\Program Files (x86)\Kofax\KIC-ED\MC\bin\KFXConverter.

  2. Copy the "//131072 = allow post analysis errors" value from the [PDF2PDFA] section.

  3. Paste it after the "//65536 = remove logical structure information" value under the [PDF2PDFA] section in the KFXConverter.ini file available at:

    C:\Program Files (x86)\Kofax\KIC-ED\MC\bin\KFXConverter.

  4. Change the value of the "AllowedErrors" parameter to 131200 to allow conversion with post-analysis errors.

  5. Save and close the KFXConverter.ini file.

Features added in previous fix packs

Fix pack 12

2111572: A new parameter, Flag, is added to the DecompressConversions section in the Create_config.xslt file. You can use this parameter to modify the order of the documents extracted from the portfolio PDF. You can set the order to ascending or the order in which the input files were added to the portfolio PDF. For more details, see Additional Information.

2123887: Additional conversion engines are added for EML, HTML, and MHT conversions using Document Conversion. The newly added engines produce output with better formatting. However, the processing time may be more than expected. For more details, see Additional Information.

Fix pack 11

2098731: Acro form PDF files are supported for conversion.

Fix pack 8

1989600: A new flag, RetainPDFFormState, has been added to retain the PDF form state during PDF flattening.

Values

Note: If the input file contains watermarks or buttons, they are removed from the flattened output file.

Fix pack 7

1981010: The new Leave messages unread option is available in the MS Graph mailbox settings. Default = clear.

1975932: The ZIP files that contain folders and files with names longer than 250 characters can be imported.

1974730: The following flags are added or updated in Destination Configuration > Advanced conversion and import > Advanced Conversion settings:

For more information about these flags, see the Advanced conversion parameters topic in Kofax Import Connector Help.

1938658: Document Conversion passwords support more than 350 characters.

Fix pack 6

1964603: You can activate page numbers in the combined PDF when concatenating PDF files. The page number is displayed as "current page of total pages", For example, "4 of 20".

Additionally, all the PDF files in the batch are numbered individually. For example, if four PDFs are concatenated, each PDF file in the combined (concatenated) PDF is numbered individually.

For example, if the first PDF file contains 40 pages, the pages are numbered as "25 of 40", and for the second PDF file with 100 pages, the page number starts afresh, such as "20 of 100".

1964601: You can generate bookmarks when you concatenate PDFs. The first page of each PDF in the batch is bookmarked as Document 1, Document 2, and Document 3 in the concatenated PDF.

Additionally, the existing bookmarks if any in each PDF file are retained in the concatenated PDF.

1961529: The following Microsoft Office file formats are supported for PDF conversion:

However, the .mpp files created using Microsoft Project 98 or earlier are not supported by the Aspose engine.

1944274: While importing messages into Kofax Capture, the .msg files are converted to .eml files and then imported into Kofax Capture.

1938658: Document conversion supports passwords up to 350 characters while converting password-protected files.

1934765: Tracing of MIME messages received via EWS and MS Graph input sources is supported.

1931450: The OXPS to PDF conversion is supported.

Fix pack 5

1887136: In addition to the list of attachments from the messages imported, the KfxMessageAttachmentList variable also contains the list of attachments from the messages that were not imported.

1884546: Microsoft Office 2021 is supported.

1847320: While archiving, the folder path and file name are shortened if they exceed the maximum characters allowed by Windows.

1846987: The following options are added to the Import settings > Import mode section in the Destination configuration:

Fix pack 3

1838732: The Allow importing files with formats option in the Advanced Conversion and Import tab supports the KfxMessageRemovedAttachmentList message field.

1838727: Messages with empty attachments are imported.

1825737: Excel files with tab-separated or comma-separated formats are supported for conversion.

1825720: The IMAP and POP3 mailboxes support OAuth 2.0 authorization to connect with Gmail.

1822356: The Kofax Import Connector help has been updated to add more information about the quality control parameters that convert PDF to TIFF. For more information, see the Advanced Conversion and Import tab topic in the help.

1821570: A new flag "RemoveBlankPages" has been added to the General section in the KFXConverter.ini file to remove the blank pages in a converted PDF.

Flag values:

1816134: You can extract the hidden text from MS Word while converting it to PDF or PDFA.

1816062: SMTP supports OAuth 2.0 authentication to send emails.

Fix pack 2

1809103: The Internet Explorer based Authorization Code grant pop-up window is replaced with Microsoft Edge based pop-up window as support for Internet Explorer ends on June 15, 2022.

1801477: Conversion of a .vcf file is supported. The content in the converted PDF or TIFF file appears the same as the content in the input VCF file when viewed using Microsoft Outlook.

1801475: A new “IncludeSheetName” flag is added to the [EXCEL2PDF] section in KFXConverter.ini. You can use this flag to include the Excel sheet name in the converted document.

Flag values:

For more details, see Additional Information.

1785331: Support for certificate-based authentication for OAuth 2.0 authorization. For more details, see Additional Information.

Note: Certificate-based authentication only applies to Authorization Code and Client Credentials grant types.

Fix pack 1

1698295: The mails are listed in ascending order with the older mails listed first followed by the latest ones in the Mailbox.

Issues resolved in previous fix packs

Fix pack 12

ID Issue Solution
2111578 Fax import took longer than expected when RightFax did not retain the DID/DNIS of the delayed faxes. The DID/DNIS of the delayed faxes are retained, and the remaining faxes are imported.
2109146 Attachment names with special characters, such as a colon (:), were not displayed in the message body of the imported mail when the mail subject was used as an EML/MSG attachment name. Special characters are now supported in the attachment names.

Fix pack 11

ID Issue Solution
2099480

Document conversion failed with an error message similar to the following when unknown tags were detected:

Convert: Unknown field with tag 32934 (0x80a6) encountered. `TIFFReadDirectory' @ warning/tiff.c/TIFFWarnings/964.

 Unknown tags are ignored during the conversion.
2096426

Messages that failed due to an unknown error were not archived, and notification was not sent for the same.

 Enhanced the functionality to detect messages that fail due to unknown errors and send notifications.
2094101

Sometimes, email import failed using MS Graph, and an error message similar to the following was displayed:

"The message has no content"

Functionality is updated to verify if there are any attachments in an email for import.

Fix pack 10

ID Issue Solution
2084029 When multiple Document Converter instances were run concurrently, some instances were unable to create an intermediate folder and failed. Now, each Document Converter instance creates an intermediate folder when multiple instances are run concurrently.
2082146 There was an error opening a PDF attachment with base64 encoding. The issue with PDF base64 encoding is fixed.
2074215 Document conversion failed if the file extension was case-sensitive. The file extension is made case-insensitive.

Fix pack 9

ID Issue Solution
2069352, 2067523 Some permissions listed for the OAuth Authorization Code grant and Client Credentials grant in KC Plug-In Help are no longer required. The list of permissions for the OAuth Authorization Code grant and the Client Credentials grant is updated to remove the permissions that are no longer required.
2067651 The RightFax REST API did not retrieve the recipient's fax number when forwarding a fax from one user to another. Now, the Fax Number (extension) is retrieved from the tag "FromFaxNumber" of the received fax object.
2065963 An issue with MS Graph multi-instance mode caused duplicate emails to be imported. Fixed message locking mechanism in MS Graph multi-instance mode to avoid duplicate emails being imported.
2065930 PDF conversion failed if the PDF contained the Code-39-25 font. Upgraded a third-party component with this fix pack. To get the expected output and fix this issue, install the Code-39-25 font.
2065920 Message conversion failed using IMAP if the Include message header of email and embedded email(s) option was selected in Import settings. Upgraded a third-party component with this fix pack.
2065914 The embedded content was missing in the emails forwarded from an Android device. Upgraded a third-party component with this fix pack.
2065565 The MS Graph ROPC connection was successful when you clicked the Test Mailbox button, even after entering an invalid password and client secret. This issue occurred as the application was fetching the values from the memory cache. Now, a new request is sent every time the user clicks the Test Mailbox button instead of picking the values from the memory cache.
2062485 KFXConverter returned an incorrect error code to TNC DocConv when the PDF to PDF/A conversion failed. Now, the correct error code is fetched from the ConvertDocFile config file.

Fix pack 8

ID Issue Solution
2015015 The KC Plug-In online help contained incorrect scope values for Gmail OAuth. Now, the documentation has been updated to provide the correct scope values.
1997825 The RightFax REST Web API connection did not import the faxes in multi-instance mode, leaving them in a reserved state on the RightFax server. The faxes are now imported successfully.
1996441 The status of the polled messages was 'unread' even after moving them to the processed folder using EWS. The status of the messages is now updated correctly after moving them to the processed folder.
1989733 The 7-Zip version used with Kofax Import Connector 2.10.0 had security vulnerabilities. Now, 7-Zip version 23.0 is used with Kofax Import Connector 2.10.0 to fix the vulnerabilities.
1988396, 1984210 The conversion of German characters failed, and the characters were displayed as question marks (?). Now, the German characters are converted successfully.
1947805 There was an error in parsing an XML file with the default namespace. You can now parse an XML file with the default namespace.

Fix pack 6

1967163: MC_Email.exe occasionally failed during document conversion.

1966802: The conversion of portfolio PDFs failed using the SampleExtractPortfolioPdf.cs script.

1959619: It took longer than expected to fetch the user list from the RightFax server.

1943977: The German umlauts were not displayed correctly in the converted .log or .txt files.

1942672: An unknown error resulted in empty messages in the Message Connector storage while using MSGraph to import messages.

1938565: Image conversion resulted in the "Exit code 1" error if the .jpeg file contained negative coordinates.

1938557: The ODS to PDF or TIFF conversion resulted in data loss.

Fix pack 5

1924191: The KfxMessageRemovedAttachmentList message field did not work when .xml was added to the Allow importing files with formats list.

1921733: Document conversion failed if the Enable Portfolio PDF extraction option was enabled.

1900105: Large-sized emails caused issues with client timeout and the client request loop using the MS Graph ROPC grant.

1891465: PDF import failed if the downloaded BLOB size did not match the configured BLOB size.

1887646: MC_Email.exe failed and did not run until Message Connector was restarted.

1884549, 1826394: The Kofax Import Connector Technical Specifications guide did not list VRS 5.2 as a prerequisite and IPv6 as a supported protocol.

1861426: PDF to TIFF conversion failed with the conversion error: "Input PDF file contains corrupt pages".

1871413: The From address and Subject were blank in Message Connector Monitor for some emails imported using MS Graph.

1867312: MS Graph polled duplicate emails in multi-instance mode.

Fix pack 4

1864226: While processing an EML file, if the Include original content and Normalize PDF documents to PDF/A options were selected, an error message similar to the following was displayed:

"A message attachment has no content"

1862599: Document conversion failed while converting a 200 DPI TIFF file to a 300 DPI TIFF file.

1861247: The French characters were displayed incorrectly in the converted PDF document after converting a text file to PDF.

1859614: The Skip importing files feature did not work when you tried to skip .xml files.

1857402: When using the Message Connector security settings, an error message similar to the following was displayed:

"HTTP status 401: Unauthorized"

1857360: When polling emails from different folders to a single folder, an error message similar to the following was displayed:

"Access token has expired or is not yet valid"

1849026: PDF conversion failed using the Aspose engine when you tried to convert a PDF that contained an edit password.

1848657: There was no access to the Message Connector configuration file as Message Connector does not support Internet Explorer.

1848637: Even if a mailbox had more than ten subfolders, MS Graph polled only the first ten.

1846757: The non-SMTP authentication failed for SMTP Outbound even if the Override Kofax Message Connector SMTP Outbound Configuration option was selected.

Fix pack 3

1844141: Document conversion resulted in the following error: "NullReferenceException: Object reference not set to an instance of an object".

1836894: Sometimes, KFXConverter failed while processing a .docx file.

1830633: In KC Plug-In, even though you enabled the "Operating time" option in the "Connection configuration" dialog box, the option was disabled upon saving the settings.

1828183: Sometimes, the email body was not converted while processing a .eml file using the Aspose engine.

1828119: Sometimes, Message Connector failed with an error message similar to the following:

"Connection has been disconnected by target 7(email)".

1823798: The Kofax Import Connector 2.10 Fix Pack 2 installation failed when there was no internet connection.

1823772: While authorizing the MS Graph mailbox, KC Plug-In incorrectly checked for "Client secret."

1821097: The whitespaces in the email body were removed while converting a .eml file using the Aspose engine.

1821088: While converting the emails received before daylight saving time, the time of the email in the converted file was displayed as per daylight saving time and did not match the actual email received time. For more details, see Additional Information.

For example, if you received an email before daylight saving time at 09.05 AM, after conversion, the time in the converted file is displayed as 10.05, considering daylight saving time.

Fix pack 2

1811506: Sometimes, an error message similar to the following was displayed while importing XML files:

"Error adding Xml fields from container 'Pages' Illegal characters in path"

1808207: While converting a .eml file, the value set for images in the "ResizeLargeImages" flag was applied incorrectly to HTML tables.

1807938: Sometimes, KFXConverter failed while processing a .eml file.

1807473: Even if a mailbox had more than ten subfolders, MS Graph polled only the first ten.

1804503: The command shell window did not close automatically after the execution of KCSImportConnectorConfigExe.exe.

1801642: While creating a new destination, the Cancel button was not available to close the XML rendering preview pop-up window.

1796749: Sometimes, after converting an Excel file, the values in the converted file were different from the values in the original file. This issue occurred when the functions in the Excel cells were executed during the conversion. For more details, see Additional Information.

1796737, 1795773: While converting an email, the images embedded in the email body were not loaded if the "LoadExternalResources" flag was set to False.

1796678: An error message similar to the following was displayed while installing Message Connector on a system that did not contain .bat in the PathExt environment variable.

"Service 'Kofax Message Connector' (KIC-ED-MC) failed to start. Verify that you have sufficient privileges to start system services.".

1796420: While converting an email, the images embedded in the email body were replaced with a placeholder (a red X).

1796417: Document conversion failed using KFXConverter if the file name contained a colon (:) in it.

Fix pack 1

1788317: The document conversion failed if an email contained the .eml attachment.

1786126: The status of the processed emails was displayed as Unread instead of Read when MS graph was selected as the input source type.

1785749: While converting an email, the .eml attachment in the email was converted to a blank page.

1783540: KFXConverter failed to convert an Excel file to TIFF or PDF.

1770125: KFXConverter could not convert emails that contained JPG images in the email body.

1762171: While importing a folder in Kofax Import Connector, if VRS was enabled in the destination, the file properties, such as file creation and modification dates, were recorded incorrectly in the KC Plug-In debug logs.

Applies to

This fix pack is cumulative and includes the features added and issues resolved in previous Kofax Import Connector 2.10.0 fix packs.

Apply this fix pack to update any of the following versions:

Files included

This fix pack includes the following files:

File name Version
KCPlugin-{FILE_VERSION}.msp version {FILE_VERSION}
KCPlugin-{FILE_VERSION}.bat NA
MC-{FILE_VERSION}.msp version MC-{FILE_VERSION}
MC-{FILE_VERSION}.bat NA
ReadMe-KofaxImportConnector-2.10.0.13.htm NA

Install this fix pack

For best results, install the fix pack during off-peak processing hours.

  1. Verify that the following applications/services are not running.
  2. Extract the contents of the .zip file on the computer where Kofax Import Connector is installed.

  3. Run MC-{FILE_VERSION}.bat and follow the on-screen instructions.

    Note: To update a single instance or multiple instances of Message Connector on a cluster node:

    1. Open Command Prompt and navigate to the directory containing the update.
    2. Execute the following commands:
      • Instance 1: msiexec /update MC-{FILE_VERSION}.msp KOFAXPRODUCTVERSION=2.10.0.13.{BUILD_NUMBER} /qb /l*vx MC-2.10.0.13.{BUILD_NUMBER}-Inst1.log /n {D48ABCB4-3900-4CE8-8CF0-80FDA400DE3B}
      • Instance 2: msiexec /update MC-{FILE_VERSION}.msp KOFAXPRODUCTVERSION=2.10.0.13.{BUILD_NUMBER} /qb /l*vx MC-2.10.0.13.{BUILD_NUMBER}-Inst2.log /n {66F292F3-3080-4A3C-9540-8A2889950558}
      • Instance 3: msiexec /update MC-{FILE_VERSION}.msp KOFAXPRODUCTVERSION=2.10.0.13.{BUILD_NUMBER} /qb /l*vx MC-2.10.0.13.{BUILD_NUMBER}-Inst3.log /n {DAFD304F-9953-4F30-98B9-58F4B46437A4}

  4. On the computers where KC Plug-In is installed:

    1. Close Kofax Capture Administration.
    2. Run KCPlugin-{FILE_VERSION}.bat and follow the on-screen instructions.
  5. Restart any applications or services that were stopped prior to installing the fix pack.
  6. Verify that the KC Plug-In and the Message Connector services are running.

Remove this fix pack

For best results, remove the fix pack during off-peak processing hours.

  1. Verify that the following applications/services are not running.
  2. To uninstall Message Connector:
    1. In Control Panel, select Programs and Features > View installed updates.
    2. On the list of updates, in the Name column, select MC fix pack MC-{FILE_VERSION}.
    3. Right-click and select Uninstall.
  3. To uninstall KC Plug-In:

    You cannot uninstall the fix pack for KC Plug-In. You must uninstall Kofax Import Connector and install it again, without the fix pack.

  4. Restart any applications or services that were stopped prior to removing the fix pack.

Additional information

2111572

Do the following to modify the order of the documents:

  1. Open the Create_config.xslt file from the following location:

    C:\Program Files (x86)\Kofax\KIC-ED\MC\xcd

  2. Go to the DecompressConversions\Conversion section. By default, the value of the Flag parameter is set to 1 in the pdf conversion section (the order in which the files were added to the portfolio PDF).

  3. Change the Flag value to 0 to set the order to ascending.

    Example

    <DecompressConversions>

    <Conversion>

    <!-- extract portfolio pdf -->

    <Extension>pdf</Extension>

    .....

    .....

    <Flag>0</Flag>

    </Conversion>

    </DecompressConversions>

  4. Run the configure.bat file from the below location:

    C:\Program Files (x86)\Kofax\KIC-ED\MC

  5. Restart the Message Connector and KC Plug-In services.

2123887

The following parameters are added to the KFXConverter.ini file:

Note:

1801475

To make sure that the Excel sheet names are included in the converted document, do the following.

  1. Open the KFXConverter_Default.ini file in an editor.
  2. Copy the "IncludeSheetName" parameter from the [EXCEL2PDF] section.
  3. Paste the parameter into the KFXConverter.ini file under the [EXCEL2PDF] section.

  4. Make sure the value is set to False.

    Note: If the value is set to True, the Excel sheet names are included as page headers in the converted document.

  5. Save and close the KFXConverter.ini file.

1796749

To make sure that the functions of the Excel cells are not executed during the conversion, add the “RecalculateOnOpen” parameter in the [EXCEL2PDF] section of the KFXConverter.ini file.

  1. Open the KFXConverter_Default.ini file in an editor.
  2. Copy the "RecalculateOnOpen" parameter from the [EXCEL2PDF] section.
  3. Paste the parameter into the KFXConverter.ini file under the [EXCEL2PDF] section.

  4. Make sure the value is set to False.

    Note: If the value is set to True, the functions in the cells are executed. However, the user-defined functions are not supported.

  5. Save and close the KFXConverter.ini file.

1785331

To achieve certificate-based authentication, do the following:

Prerequisites

In the Configure OAuth dialog box:

  1. Enter the mandatory fields, such as Grant type, Tenant ID, and Client ID.
  2. Select Authentication Mode as Certificate Based.
  3. In the Certificate thumbprint box, enter the certificate thumbprint.

  4. Click Authorize.

    If all the values entered in the dialog are valid, a confirmation message, "Login successful" is displayed.

  5. Close the dialog box. The certificate thumbprint and authentication mode are saved to the configuration file.