Troubleshooting
This section lists some of the error messages that you can encounter while using Kofax Import Connector.
Error message |
Description |
---|---|
Could not login for a ADFS (Active Directory Federation Services) federated user. Steps For a ADFS (Active Directory Federation Services) federated user:
The login page remains intact and login does not happen. |
Do the following:
Note This error occurs only on server SKU operating systems, such as, Windows Server.
|
The token contains no permissions, or permissions can not be understood. |
If you get this error when configuring mailboxes using Client Credentials Grant, verify that you have assigned Mail.ReadWrite (application) API permission to your application in Microsoft Azure Active Directory portal. |
Could not create batch |
Configured batch class does not exist in the Kofax Capture. For example, this error occurs if a batch class is renamed or removed while Kofax Import Connector is running and Kofax Import Connector tries to send message to the destination which is configured to use this particular batch class.
Note Kofax Import Connector
acknowledges the changes in the batch only when they are published in
Kofax Capture.
Any other eventual exceptions thrown by the KC import API. Check log files for exception details. |
Could not create document |
Configured document class does not exist in the batch. For example, this error occurs if a document class is renamed or removed while Kofax Import Connector is running and Kofax Import Connector tries to send message to the destination which is configured to use this particular batch.
Note Kofax Import Connector
acknowledges the changes in the batch only when they are published in
Kofax Capture.
Any other eventual exceptions thrown by the KC import API. Check log files for exception details. |
Could not create folder |
Configured folder class does not exist in the batch. For example, this error occurs if a folder is renamed or removed while Kofax Import Connector is running and Kofax Import Connector tries to send message to the destination which is configured to use this particular batch.
Note
Kofax Import Connector
acknowledges the changes in the batch only when they are published in
Kofax Capture.
Any other eventual exceptions thrown by the KC import API. Check log files for exception details. |
Configured batch class does not exist Configured document class does not exist Configured folder class does not exist |
Kofax Import Connector checks for the existence of all the batch, document, and folder classes when the service starts. If it does not find the configured batch, document, or folder classes, it displays the error message. Note This error is displayed in
KC Plug-In
main window (in the bottom pane).
|
Could not login to Kofax Capture |
Incorrect user ID or password. Refer to the General settings window of Kofax Import Connector. Any other eventual exceptions thrown by the KC import API, for example, insufficient permissions. |
Out of Kofax Capture scan licenses |
When the number of pages to import exceeds the license limit supported by Kofax Capture, Kofax Import Connector throws this error. |
Kofax capture could not close the batch |
Any condition that would prevent the KC import API to close the batch, for example when the message is empty (when all pages were blank and VRS removed them) and there is nothing to import into Kofax Capture. |
Delayed due to shut down |
When Kofax Import Connector service is stopped while there are messages in the queue, Kofax Import Connector shows this status message. |
Empty folder can't be created |
Folder with the folder class does not contain any documents. |
Could not import image Could not import images |
When Kofax Capture rejects importing of an image, for example, if the image is not in supported format. |
Custom script execution failed |
When there is an exception thrown other than ScriptException and ScriptIgnoreMessageException while executing a custom script. |
Xml input contains more than 1 batches |
When AutoXML is configured and the incoming XML contains more than one batch tag. Note that the current Kofax Import Connector limitation is one batch per imported XML file. |
Xml mapping Xslt transformation failed |
When there is an error in performing XSLT transformation for XML mapping, for example, XmlMapping.xslt provided for the transformation file is not correct. |
Xslt stylesheet missing (deactivate Xml mapping or create the mapping stylesheet) |
XmlMapping.xslt is missing in schemas/destination folder. |
Stylesheet files for Xml mapping missing |
For each configured destination, a folder with the respective files is created with the destination name at the location C:\ProgramData\Kofax\KIC-ED\KCPlugIn\config\Schemas. When any of these destination folders are deleted and Kofax Import Connector tries to access the location, this error is thrown. |
Xml import failed |
XML import failed due to any unexpected issue. Check log files for exception details. |
Could not populate batch fields Could not populate folder fields Could not create table row Could not populate document table field Could not populate expected total field |
An unexpected error occurred when filling the data to the respective field in the batch. For example, the mapping field is of different data type and is not compatible with the field that is configured in the batch |
Batch / folder / table row / table / expected total / document field mapping failed. Mismatched configuration |
If Kofax Import Connector tries to import a specific field and if the respective field doesn't exist in Kofax Capture, it throws errors related to the missing fields. For example, table does not exist in Kofax Capture. Auto import XML tries to import a table but the definition does not exist in the batch class in Kofax Capture. |
Received <ImportSession> element corrupted (no batch element available) |
The AutoXML is invalid. The batch element is missing in the XML document. |
Could not create batch with XmlAutoImport or generic Xml mapping Batch class required for XmlAutoImport or generic Xml mapping does not exist FormType required for XmlAutoImport or generic Xml mapping does not exist Folder class required for XmlAutoImport or generic Xml mapping does not exist |
BatchClassName or folderclass or FormType which is specified in XML file (for autoXML or generic XML) is not defined in the batch class in KC. Any other eventual exceptions thrown by the KC import API. Check log files for exception details. |
Attachment is missing. The message could not be imported into Kofax Capture due to message reception error code. |
When Kofax Import Connector is configured for Auto Import XML, KC Plug-In tries to check the file list in XML to the files that are imported from Message Connector. If it finds any file is missing, it throws this error. |
Could not create duplicate batch |
Kofax Import Connector rejects messages when a batch with same name already exists in Kofax Capture. The following settings must be configured so that Kofax Import Connector rejects messages in this case:
|
Cannot create batch. File name is too long |
If the file name is too long (more than 260 characters), Kofax Import Connector tries to rename the file to "Renamed.ext". If the file name length still exceeds 260 characters, the operating system cannot create the file.
Note The file name here refers to absolute folder path + file name. Workaround: Try to reduce the temp folder
path.
|
The message could not be imported into Kofax Capture due to a document conversion error. The error is: Root Xml document could not be converted as Xml rendering is disabled. |
Message rendering option should be enabled for importing XML file as PDF/TIFF. For example, if you configure XML Import Connector compatible mapping, include original content, and conversion to PDF/TIFF, message rendering option should be enabled. If not, Kofax Import Connector throws this error. |
The message could not be imported into Kofax Capture due to message reception error code. |
When Kofax Import Connector is configured for AutoImport XML, KC Plug-In tries to check the file list in XML to the files that are imported from Message Connector. If it finds any file is missing, it throws this error. This error can be thrown also in other cases of reception error, for example incomplete fax received. |
The message could not be imported into Kofax Capture due to message reception error level 2 |
Message was not received completely and ended with an error. For example, if the received fax does not even contain a single page. Check log files for exception details. |
Reception error level 1 of message {0} |
Message was partially received and ended with an error. For example, if reception of a fax ended with an error, at least 1 page has been stored, but further pages may be missing. Check log files for exception details. |
The message has no content |
Empty message |
The message has no RootXml attachment |
The message has no RootXml attachment, but the destination expects it. |
The message has no body and no attachments |
Kofax Import Connector receives the message without any content. It could also be a configuration issue, for example, Kofax Import Connector is configured to process only attachments and to ignore the body, but the message contained only a body and no attachments. |
The message could not be imported into Kofax Capture due to a document conversion error |
This error appears if Kofax Import Connector is configured to Reject message and if the document conversion fails. Document conversion can fail due to the following reasons:
|