Known Issues and Workarounds 2020.1.05
Known Issues and Workarounds
The following is a list of known issues discovered in this release for which a workaround is provided.
Category
Known Issue
Workaround
AI Table Rule Builder
When using the Manual mode of the AI Table Rule Builder with the Microsoft Edge browser, the row separators do not render properly.
Resize the manual mode pane or click somewhere else on the page.…
New Relic
Introduction
In Transact version 2020.1.04, we introduced support for New Relic. New Relic is a widely used third-party monitoring tool that allows you to gather data based on custom events in Transact. You can use custom events to measure and monitor the following information:
The number of documents processed.
The number of pages processed per minute.
The average size of the…
Known Issues and Workarounds 2020.1.04
The following is a list of known issues discovered in this release for which a workaround is provided.
Category
Known Issue
Workaround
Batch Class Fields
Unrelated batch class fields may appear when scanning pages.
To resolve this issue, close the browser tab with the Web Scanner page (<server_IP>:8080/dcma/WebScanner.html) and reopen it.
Cloud HyperExtender
When…
Linux Upgrade Guide 2020.1.04
Introduction
This document describes how to upgrade Ephesoft Transact 2020.1.04 in the following environments:
Environments — single or multi-server
Operating system — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.04 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer to…
Linux Installation Guide 2020.1.04
Introduction
This document describes how to install Ephesoft Transact 2020.1.04 in the following environments:
Environment types — single or multi-server
Operating System — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.04 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer…
Windows Upgrade Guide 2020.1.04
Introduction
This document describes how to upgrade to Ephesoft Transact 2020.1.04 in the following environments:
Environment types — single and multi-server
Operating System — Windows®
Important: Steps unique to a multi-server upgrade are identified where applicable in this document.
Upgrade Overview
The process of upgrading to Ephesoft Transact 2020.1.04 follows this general…
Windows Installation Guide 2020.1.04
Introduction
This document describes how to install Ephesoft Transact 2020.1.04 in the following environments:
Environment types — single and multi-server
Operating System — Windows®
Important: Steps unique to a multi-server installation are identified where applicable in this document.
Installation Overview
The process of installing Ephesoft Transact 2020.1.04 follows this general…
Software Updates 2020.1.04
Software updates provide enhancements to the latest version of Ephesoft Transact. This release includes compatibility enhancements and fixes for features.
In addition to the updates listed in the Ephesoft Transact 2020.1.03 Service Pack, the following issues have now been resolved:
Salesforce ID
Category
Problem Statement/Background
Solution
00019026
Activiti
Batches would…
Nuance Form Template Editor License Activation Error 48: “The server couldn’t activate license”
Applies to: All versions of Ephesoft Transact
Issue
When trying to activate a license for the Nuance Form Template Editor, you may receive the following error:
Error 48: Activate License: The server couldn't activate license 'XXXXX-XXX-XXXX-XXXX-XX'.
Root Cause
License activation may fail if the licensing database is corrupted, or because of invalid licensing server IP address information.…
Validating Documents
This document provides an overview of validating documents in Ephesoft Transact. This information is intended for Transact operators.
In this page:
Validate User Interface
Why Documents May Need Manual Validation
How to Validate Documents
How to Validate Table Data
Validate User Interface
This section describes different aspects of the Validate user interface (UI). Operators…
How to Setup and Configure SSO with Azure ADFS
This page describes how to configure and enable SSO in Ephesoft Transact when using Active Directory Federation Services (ADFS) in Azure.
Prerequisites
Before performing the steps on this page, ensure that you have created custom Users and Groups in Azure AD that will be used with your SSO configuration.
Configure Azure Active Directory
To configure SSO in Azure AD, perform the following…
Issue Accessing Application Logs
Applies to: Ephesoft Transact 2020.1.03 and above
Issue
If you use custom scripts or other automated processes to retrieve logs through the web server service, you may experience issues due to security enhancements introduced in 2020.1.03.
Root Cause
In 2020.1.03 and above, you must now log in before accessing log files within the Application folder. This includes files such as the…
Error Logged when Picking up Batches After Upgrade to 2020.1.03
Applies to: Ephesoft Transact 2020.1.03 and above
Issue
After upgrading from 2020.1.02 to 2020.1.03, the following error may be logged each time you pick up a batch, or when a batch finishes processing:
/dcma/ws/activity/pickup/notification access cannot be granted. com.ephesoft.dcma.authorization.exception.AuthorizationException: None of the rules granted access for the incoming request
Root…
Known Issues and Workarounds 2020.1.03
The following is a list of known issues for which a workaround is provided.
Category
Known Issue
Workaround
CMIS Export
When a batch class is imported with CMIS export configured, the CMIS mapping files are missing in the imported batch class, which results in failures at CMIS export.
To resolve this issue, you will need to manually copy the CMIS mapping files from the original…
Software Updates 2020.1.03
Software updates provide enhancements to the latest version of Ephesoft Transact. This includes security and compatibility enhancements, and fixes for features.
In addition to the updates listed in the Ephesoft Transact 2020.1.02 Feature Pack, the following issues have now been resolved:
Salesforce ID
Category
Problem Statement/Background
Solution
00011565
Batch Class Import…
Linux Installation Guide 2020.1.03
Introduction
This document describes how to install Ephesoft Transact 2020.1.03 in the following environments:
Environment types — single or multi-server
Operating System — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.03 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer…
Windows Upgrade Guide 2020.1.03
Introduction
This document describes how to upgrade to Ephesoft Transact 2020.1.03 in the following environments:
Environment types — single and multi-server
Operating System — Windows®
Important: Steps unique to a multi-server upgrade are identified where applicable in this document.
Upgrade Overview
The process of upgrading to Ephesoft Transact 2020.1.03 follows this general…
Windows Installation Guide 2020.1.03
Introduction
This document describes how to install Ephesoft Transact 2020.1.03 in the following environments:
Environment types — single and multi-server
Operating System — Windows®
Important: Steps unique to a multi-server installation are identified where applicable in this document.
Installation Overview
The process of installing Ephesoft Transact 2020.1.03 follows this general…
Linux Upgrade Guide 2020.1.03
Introduction
This document describes how to upgrade Ephesoft Transact 2020.1.03 in the following environments:
Environments — single or multi-server
Operating system — Red Hat Enterprise Linux (RHEL) 7.5 or 7.6
Note: Ephesoft Transact 2020.1.03 is only supported for these Linux distributions. Do not run the yum update command, as this updates RHEL to an unsupported version. Refer to…
Known Issue: Error Incorrectly Logged with saveMobileUpload API
Applies to: All versions of Ephesoft Transact
Issue
Calling the saveMobileUpload API gives the error “Image Count Allowed Reached”, even when the batch instance is created successfully.
This does not affect the functionality of the API.
Known Issue: Swagger UI Not Working with SSO
Applies to: All versions of Ephesoft Transact
Issue
When Ephesoft Transact is configured for Single Sign-On (SSO), the Swagger UI is not available. The following entry is logged in the catalina.log file when attempting to access the Swagger UI:
WARN org.apache.catalina.authenticator.FormAuthenticator- No login page was defined for FORM authentication in context
Migrating the Ephesoft SharedFolders Location
Applies to: Ephesoft Transact 4.x and above
This page provides instructions on how to migrate your Ephesoft SharedFolders location to a different path, either Network or Local.
Update Property Files
application.properties, located at \Application\WEB-INF\classes\META-INF\
Line 28: plugin_upload_folder_path=\\\\NEW_UNC_PATH\\SharedFolders/plugin-upload-folder…
Error Uploading Images Remotely
To resolve this issue, you will need administrator permissions.
Issue
When uploading supported images (PDF or TIFF) to KV Extraction or KV Page Process remotely (from the web interface), you may receive the following error, “Error while uploading image. Please try again.” This issue only occurs when accessing Ephesoft Transact remotely and does not occur on the localhost.
Figure 1. Error…
How to Add a New Translation to Transact
Applies to: All versions of Ephesoft Transact
If a language you’re looking for is not supported by Ephesoft, you can add your own translations to the Transact UI by editing the locale files.
What are locale files?
Where are the locale files?
How do I add a new translation?
What are locale files?
A locale file is a JavaScript (.js) file that contains a set of translations for the…
How to Enable CORS in Ephesoft Transact
In this article, you will learn how to enable Cross-origin Resource Sharing (CORS) in Ephesoft Transact. Enabling CORS will resolve Access Control Allow Origin Exception with your web application.
What is CORS?
CORS is a security feature that uses HTTP Headers that can be sent from the web server and interpreted by the browser to allow the browser to decide if it should proceed with a request…