{"id":35572,"date":"2019-11-21T17:08:23","date_gmt":"2019-11-22T00:08:23","guid":{"rendered":"https:\/\/ephesoft.com\/docs\/?page_id=35572"},"modified":"2020-07-22T13:28:31","modified_gmt":"2020-07-22T20:28:31","slug":"multidimensional-classification","status":"publish","type":"docs","link":"https:\/\/ephesoft.com\/docs\/products\/transact\/features-and-functions\/administrator\/moduleplugin-configuration\/page-process-module\/multidimensional-classification\/","title":{"rendered":"Multidimensional Classification Plugin"},"content":{"rendered":"
Available:\u00a0<\/strong>on-premises, cloud<\/p>\n Multidimensional Classification is a plugin within the Page Process<\/strong> module. This patented plugin classifies documents across various dimensions and combines the score of each dimension. This results in improved accuracy and confidence in document learning. This document applies to Ephesoft Transact 2019.1 and above.<\/p>\n For the following reasons, Multidimensional Classification is a better approach to classifying documents, as compared to the older Search Classification method:<\/p>\n This section describes how to configure, enable, or disable the MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/strong> in the Page Process<\/strong> workflow module and in a batch class. Ensure that you have administrator rights to perform these tasks. These configurations are made from the Batch Class Management <\/strong>screen.<\/p>\n Notes:<\/strong><\/p>\n The following figure summarizes the plugin configurations for the MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/strong>.<\/p>\n <\/p>\n Plugin requirements for Multidimensional Classification<\/em><\/span><\/p>\n <\/a><\/a><\/a> You have the option of leaving both plugins in the module, only if you disable the SEARCH_CLASSIFICATION<\/strong> plugin.<\/p>\n Note<\/strong>: If you plan to use the Multidimensional Classification plugin to create classification results from document learning and to perform document assembly, Ephesoft recommends disabling or removing the SEARCH_CLASSIFICATION <\/strong>plugin. Refer to Removing or Disabling the Search Classification Plugin<\/a>.<\/p>\n Perform the following to configure the Multidimensional Classification plugin:<\/p>\n <\/p>\n Associated Plugins<\/strong> for the Page Process module<\/em><\/span><\/p>\n b. Use the up and down arrows to rearrange the position of this plugin in relation to the other plugins of this module as needed. The following figure illustrates common plugins that are used in the Page Process<\/strong> module.<\/p>\n <\/p>\n Selected Plugins \u2014 A typical sequence is shown above<\/em><\/span><\/p>\n c. Click Deploy<\/strong> to activate the plugin and save the changes made in step b and click Close<\/strong> to complete the configuration. The following message displays upon successful configuration:<\/p>\n <\/p>\n Confirmation prompt<\/span><\/em><\/p>\n This plugin displays in the Page Process<\/strong> module and is ready to be activated.<\/p>\n <\/p>\n Page Process<\/strong> module with MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/strong><\/em><\/span><\/p>\n 5. Enable the MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN <\/strong>for the batch class by selecting this plugin within the Page Process<\/strong> module. The Plugin Configuration<\/strong> screen displays on the right.<\/p>\n 6. Review or configure this plugin by opening a batch class from the Batch Class Management<\/strong> screen, and navigate as shown below:<\/p>\n <\/p>\n MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/em><\/span><\/p>\n The following figure illustrates the Plugin Configuration<\/strong> screen for the MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/strong>.<\/p>\n <\/p>\n Plugin Configuration for the MULTIDIMENSIONAL_CLASSFICATION_PLUGIN<\/em><\/span><\/p>\n 7. Enable the plugin by setting the Multidimensional Classification Switch<\/strong> to ON<\/strong>. The Multidimensional Classification Switch<\/strong> contains the following two options in the drop- down list:<\/p>\n 8. Set the Multidimensional Classification Max Results<\/strong> to your desired number. The Multidimensional Classification Max Results<\/strong> field controls how many alternate value elements will be generated in the batch.XML file produced within the workflow. The default setting for max results is 5<\/strong> to keep the overall size of the batch.xml smaller. Adjust this setting as required. The size of the batch.xml could increase or decrease based on your setting.<\/p>\n a. Click Deploy<\/strong> to enable the changes. <\/a><\/a> Once configured, the Ephesoft Transact administrator must train at least one document for each document type with the Multidimensional Classification plugin. Refer to Document Learning with Multidimensional Classification<\/a>.<\/p>\n Note<\/strong>: Refer to Removing or Disabling the Search Classification Plugin<\/a> as recommended by Ephesoft after the Multidimensional Classification configuration.<\/p>\n This topic describes how to select Multidimensional Classification as the classification type in the DOCUMENT_ASSEMBLER<\/strong> plugin in the Document Assembly<\/strong> module. The MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/strong> must first be configured and enabled.<\/p>\n Note:<\/strong> If this has not been completed, refer to the steps under Configuring the Multidimensional Classification Plugin in the Page Process Module<\/a>.<\/p>\n Perform the following steps:<\/p>\n <\/p>\n Document Assembly Module<\/span><\/em><\/p>\n 4. The Plugin Configuration <\/strong>screen for DOCUMENT_ASSEMBLER<\/strong> plugin displays.<\/p>\n <\/p>\n DOCUMENT_ASSEMBLER Plugin Configuration, Release 4.5<\/em><\/span><\/p>\n 5. Select MultidimensionalClassification<\/strong> from the DA Classification Type<\/strong> drop-down list. The user must have Administrator rights to perform this task.<\/p>\n This topic describes how to disable or remove the Search Classification plugin which the administrator should do when you configure and enable the Multidimensional Classification plugin.<\/p>\n Note: <\/strong>If you have any scripts that rely on results from the Search Classification plugin, leave it in the module.<\/p>\n Perform these steps to add, enable, disable, or remove the SEARCH_CLASSIFICATION<\/strong> plugin within the Page Process <\/strong>module for the batch class that uses MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN<\/strong>.<\/p>\n <\/p>\n SEARCH_CLASSIFICATION Plugin in the Page Process Module<\/em><\/span><\/p>\n 4. Perform one of the following steps to remove or disable the Search Classification plugin: <\/p>\n Search Classification Switch<\/span><\/em><\/p>\n \u00a0 \u00a0 \u00a0 c. Click Deploy<\/strong> to activate this change.<\/p>\n 5. Retrain Ephesoft Transact with Learn Files<\/strong> for the document type, as applicable. When you disable the Search Classification plugin, you must retrain the batch class with the documents using the Multidimensional Classification plugin, which generates its own model for classifying the data.<\/p>\n The standard method of training a batch class for a document type applies to both Search Classification and Multidimensional classification.<\/p>\n The Multidimensional Classification mechanism works on supervised learning.<\/p>\n Within an open batch class, use the Learn File(s) <\/strong>button in the Batch Class Management <\/strong>screen. When a document type is trained with at least one file, the plugin creates a new file with the following name in the Batch Class folder:<\/p>\n BC<ID>-dimensions Click Learn File(s) <\/strong>to update the learning that occurs during classification. <\/p>\n Learn Files<\/strong> in the Document Types<\/strong> screen for a sample batch class, Ephesoft Transact Release 4.1.1.0<\/em><\/span><\/p>\n <\/p>\n Learn Files<\/strong> in the Document Types <\/strong>screen for a sample batch class, Ephesoft Transact Release 4.5<\/span><\/em><\/p>\n The MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN feature is supported by machine learning for document types. In this case, if classification is done incorrectly during the initial process job, the plugin can learn the change that is required to correct the classification and ensure it performs classification correctly with ensuing batch processing jobs.<\/p>\n This topic describes how to learn a new document to test for classification of a new document type. Ensure that the following prerequisites are complete before performing this task:<\/p>\n Perform the following steps to test classification of a document type, for the batch class with the Multidimensional Classification plugin enabled:<\/p>\n The following message displays and notifies you when the test file upload is complete. You can also drag and drop the sample image file to the Drag and Drop Files Here <\/strong>area below the Upload Test Classification File(s) <\/strong>link. The system provides the following confirmation message for a sample upload.<\/p>\n <\/p>\n Success confirmation dialog<\/span><\/em><\/p>\n \u00a0 \u00a0Note<\/strong>: You can also drag and drop the sample image file to the Drag and Drop Files Here <\/strong>area below the Upload Test Classification File(s) <\/strong>link. <\/p>\n Test Classification<\/strong> screen<\/span><\/em><\/p>\n \u00a0 \u00a0 5. Select an option from the Workflow <\/strong>drop-down list as described in the following summary:<\/p>\n<\/a>Overview<\/h2>\n
<\/a>Comparing Multidimensional Classification and Search Classification<\/h3>\n
\n
<\/a>Configuring the Multidimensional Classification Plugin<\/h2>\n
\n
\n
\na. Select the MULTIDIMENSIONAL_CLASSIFICATION_PLUGIN <\/strong>from the Associated Plugins <\/strong>section of the Plugin Configuration<\/strong> screen and click the right-pointing arrow. This moves the plugin to the Selected Plugins<\/strong> section.<\/li>\n<\/ol>\n\n
\n
\n
\nb. Click Close<\/strong> to exit the Plugin Configuration<\/strong> screen.<\/p>\n<\/a>Setting the Classification Type for the Document Assembler Plugin<\/h2>\n
\n
\n6. Click Deploy<\/strong>. Confirmation windows display when both Apply<\/strong> and Deploy<\/strong> are clicked.
\n7. Click Close<\/strong> to return to the Batch Class Management<\/strong> screen.<\/p>\n<\/a><\/a>Removing or Disabling the Search Classification Plugin<\/h2>\n
\n
\na. Remove the SEARCH_CLASSIFICATION<\/strong> plugin by selecting it from the Selected Plugins<\/strong> field on the right. Use the left-facing arrow button to move this plugin to the Associated Plugins<\/strong> field on the left.
\nb. Disable the SEARCH_CLASSIFICATION<\/strong> plugin, select (highlight) this plugin. The Plugin Configuration<\/strong> screen displays. Select OFF from the dropdown menu.<\/p>\n\n
\n
<\/a><\/a><\/a><\/a>Document Learning with Multidimensional Classification<\/h1>\n
\n
\nExample:<\/strong> BC8-dimensions<\/p>\n
\nThe following two figures illustrate the Learn File(s)<\/strong> button from an open batch class from the Batch Class Management <\/strong>screen.<\/p>\n<\/a><\/a>Multidimensional Classification and Machine Learning<\/h3>\n
<\/a>Testing Classification of a Document Type with Multidimensional Classification<\/h2>\n
\n
\n
\n
\n
\na. For each document type, click Learn Files<\/strong>.
\nb. Select the document type. Then, click the Upload Test Classification File(s) <\/strong>link to select and upload a test image file for the document type.<\/li>\n<\/ol>\n
\n4. Navigate to the document type screen where you uploaded the test image file (in the previous step) and click Test Classification <\/strong>from the toolbar on top of the screen.
\nThe Test Classification <\/strong>screen displays.<\/p>\n\n\n