KB00020677: Email Import Intermittently Failing

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

If you require TLS 1.2, this workaround should not be applied, instead please contact support at tickets@ephesoft.com for help. This workaround should not be applied to versions prior to 2020.1.02.

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*

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

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

  1. Start Ephesoft Transact.