› Batch Class Management › Batch class › Import and export batch classes

Import and export batch classes

Transact supports transferring batch class configurations and rules from one environment to another. You can import and export batch classes to build and configure in a test environment before transferring to a production environment. This helps to reduce interruptions that affect document processing in a production environment.

Refer to the following table for key terms used throughout this topic.

Term

Definition

Batch class

Document types, associated fields, extraction rules, monitored folders, and ingestion methods for a specified workflow in Transact.

Document type

The structure and elements that define a document

Export a batch class

Exporting a batch class efficiently transfers rules, configurations, and learned files from one environment to another. Exported batch class data includes:

  • Batch class folder

  • Local and global document types

  • Page types

  • Regular expressions

Follow these steps to export a batch class:

  1. Go to the Batch Class Management screen.
  2. Select a batch class.
  3. Click Export.

    An Export Batch Class dialog box appears.

  4. Select the following as applicable:

    • With learned files: Export the batch class with the learned files in the lucene-search-classification-sample and image-classification-sample folders.

    • Without learned files: Export the batch class without the learned files in the lucene-search-classification-sample and image-classification-sample folders.

    These folders are required to replicate the source environment and classification results for processing documents in batches. By default, the configuration is set to export learned files.

  5. Click OK. The batch class is exported as a .zip file.

Import a batch class

Importing a batch class creates a new batch class with the same configuration and rules defined in the source batch class being imported. This includes local and global document types, related HTML, XML and TIFF files, learned indexes, and more.

To import a batch class, ensure an exported batch class .zip file is available.

Perform the following steps to import a batch class:

  1. Go to the Batch Class Management screen.
  2. Click Select Files or drag and drop exported .zip file in the bottom panel.
  3. The Import Batch Class dialog box appears.
  4. Enter the Batch Class Name.

    This must be unique and cannot contain any special characters that are defined in the properties file.

  5. Enter a description in Batch Class Description to describe the batch class.
  6. Drag the slider to indicate the Priority level.

    By default, the level is 1. The value can range from 1 to 100 where 1 is the most urgent priority and 100 is the lowest priority.

  7. Select either option for the Use Existing check box to determine the Drop Folder field:

    • Clear Use Existing to create a new batch class with a unique folder path. Enter this folder path for the batch class in Drop Folder. An example is D:\\Shared Folders\\new-public-unc-folder.

    • Select Use Existing to create a new batch class with an existing folder. Click the Drop Folder field to select an existing folder. This creates a new version of the existing batch class.

  8. Select the Import Method.

    This controls how global document types in the imported batch class are linked to the global batch class in the destination system. See Global document types and batch classes for more information about global document types.

    • Import as Local Document Types: Create local document types for the global document types in the imported batch class. By default, Create In Global is automatically selected for Imported Global Doc Types.

    • Link to Global Batch Class: Link the global document types from the imported batch class to the global batch class.

  9. Select one of the following options as applicable for Imported Global Doc Types. These options are available if Link to Global Batch Class is selected.

    • Create Global: Create document types in the global batch class (BC0) if the global document types in the imported batch class are not defined in the global batch class. The global document types in the imported batch class are linked to the global document types in the global batch class.

    • Create Locally: Define imported document types in the imported batch class as non-global document types if the imported global document types do not exist in the global batch class (BC0).

    • Ignore Missing: Exclude any global document types from the imported batch class that do not exist in the global batch class.

    • Abort Import: End the import process if global document types in the imported batch class are not available in the global batch class of the destination environment.

  10. Select either option for Import Batch Class.

    • With Learned Files: Include the learned document images and data from the imported batch class. By default, learned data is imported in the imported batch class.

    • Without Learned Files: Exclude the learned document images and data from the imported batch class.

  11. Select the following for CMIS Mappings as applicable:

    • Export Plugin Properties: Transfer the available plugin properties of the imported batch class.

    • Import Configuration: Include the CMIS credentials and configurations defined under the CMIS Import screen in the batch class.

    • Export Mappings: Import and overwrite the mapping files defined in the Ephesoft_Installation_DirectorySharedFolders{Batch Class}cmis-plugin-mapping folder.

    Note the following:

    • These mapping files are used for document and aspect mapping in Alfresco. See CMIS Export plugin for more information.

    • Export Plugin Properties and Import Configuration are automatically copied into the imported batch class if the Use Existing check box for the Drop Folder field is not selected.

  12. Select the following as applicable:

    • Roles: Apply the roles from the imported batch class.

    • Email Accounts: Include email account configurations from the imported batch class.

    • Import Connections: Import DB Export and Fuzzy DB connections if they are configured in any exported batch class.

  13. Select one of the following options for Encryption to determine the encryption algorithm:

    • Clear Use Existing Key to apply a new encryption algorithm for the batch class. Enter a Batch Class Key and Algorithm according to the requirements and data.

    • Select Use Existing Key to include the same encryption algorithm for the imported and exported batch class.

  14. Click OK to create a new batch class.

    A dialog box appears in the top-right corner of the screen.

Troubleshooting

Refer to the following table for common workarounds.

Issue

Workaround

Batches are not visible on the Batch Instance Management, Review, and Validation screens.

This may happen when roles are not assigned or if the Roles check box is cleared when importing the batch class.

Do the following to resolve the issue:

  1. Navigate to the Batch Instance Management screen.

  2. Edit the corresponding batch class.

  3. Assign roles to the batch class.

Batches enter an error state in the Page Processing module, which is used when importing a batch class.

Two possible reasons for this issue are:

  • The exported zipped batch class file does not contain Lucene and image classification samples.

  • After importing, sample images are in these folders, but the learning is not complete.

Use either of the following solutions:

  • Select the image-classification-sample and lucene-search-classification-sample check boxes when exporting the batch class.
  • Include sample images in the image-classification-sample and lucene-search-classification-sample folders in the ephesoft-data folder. Click Learn Files.