KB00022586: KV Page Process Error from Upgrade Issue from Ephesoft Transact 4.5.X.X to

Component: KV Page Process

Impact: High

Version: Ephesoft Transact


After upgrading from Ephesoft Transact 4.5.X.X to Ephesoft Transact, the page level fields in the Field Name column may get replaced with KV Page Process if there are KV_PAGE_PROCESS rules step up in the batch class. This impacts classification because of the changes in the field name.


Perform the following steps in either workaround below.

Workaround 1:

  1. Install Ephesoft Transact 4.5.X.X or a current version.
  2. Configure page level fields in the KV_PAGE_PROCESS plugin as necessary.
  3. Upgrade to Ephesoft Transact or a new version as applicable.
    Note: A hotfix is needed when the newer version is before Ephesoft Transact This issue has been fixed in Ephesoft Transact and newer versions.
  4. Before starting the server, on the first time after upgrading, navigate to the following folder: <installation-directory>\Ephesoft\Application\WEB-INF\classes\META-INF\dcma-data-access
  5. Replace the existing pre-schema.sql with the following:

Workaround 2:

  1. Instead of replacing the files, edit the following file: <installation-directory>\Ephesoft\Application\WEB-INF\classes\META-INF\dcma-data-access\pre-schema.sql
  2. Remove and comment the following query: update kv_page_process set page_level_field_name=(select plugin_config_value from batch_class_plugin_config where batch_class_plugin_config.id=kv_page_process.batch_class_plugin_config_id);”
  3. Start the Ephesoft Transact server.