Applies to: Ephesoft Transact 2020.1.02 to 2020.1.04

Issue

Email import intermittently fails to pick up emails at random intervals.

Root Cause

One reason this issue may occur is due to conflicts with email import-related JAR files.

Solution

This workaround should not be applied to versions prior to 2020.1.02. If you require TLS 1.2, see note at the bottom of this article.

Important: If you are running Transact 2020.1.04, confirm that the javax.mail-1.6.2.jar file exists in the [Ephesoft_Directory]\Application\WEB-INF\lib folder. If this JAR file is missing, do not proceed with this workaround. Do not remove this JAR file.

Otherwise, the following workaround may resolve this issue. Refer to the instructions specific to your operating system.

Windows

The steps in this section vary by version. Refer to the file paths and file names applicable to your version.

1. Stop Ephesoft Transact.
2. Go to the following directory, depending on your version:

2020.1.04: [Ephesoft_Directory]\SharedFolders\customPluginsJars
2020.1.02 and 2020.1.03: [Ephesoft_Directory]\Application\WEB-INF\lib*

3. Make a backup copy of and delete the following JAR files, if they exist:
   • javax.mail-1.6.1.jar
   • mail-1.4.jar
   • nimbus-jose-jwt-9.1.1.jar**

^{*For upgraded versions, these JAR files may not exist in the lib folder. If so, check the customPlugisJars folder (above).
**Applies to Transact 2020.1.04}

4. Start Ephesoft Transact.

Linux

1. Stop Ephesoft Transact.
2. Go to [Ephesoft_Directory]/Application/WEB-INF/lib.
3. Make a backup copy of and delete the following JAR files, if they exist:
   • javax.mail-1.6.1.jar
   • mail-1.4.jar
   • nimbus-jose-jwt-9.1.1.jar*

^{*Applies to Transact 2020.1.04}

4. Start Ephesoft Transact.

TLS 1.2 Protocol

If you require TLS 1.2 (Transport Layer Security), you will need to upgrade to Transact 2020.1.04 or above. These versions already contain the updated javax.mail-1.6.2.jar file that is necesssary for this security protocol to work with Transact email import.