Custom domains in IQ Bot

A domain contains information about the language of the documents and the data fields that the system extracts from the documents. The IQ Bot environment includes seven domains; users with the AAE_IQ Bot Admin role can also create and import custom domains to the Domains tab.

If your documents contain specialized fields, you can create a custom domain with these fields to make learning instance creation quicker. Otherwise, the learning instance creator must manually define each specialized field, every time they create a new learning instance.

For example, for documents from the pharmaceutical industry, you might add fields like prescription name, dose, or delivery format to the custom domain. Likewise for financial industry documents, you might add fields for margin, call price, or limit order.

The Domains tab displays all available domains for use in the system and their associated languages. Besides out-of-box domains offered by IQ Bot, you can also create a custom domain and import it into IQ Bot.

Create a custom domain (A-people login required)

For information on creating a custom domain, see: How to create a Custom Domain

When creating a learning instance using a custom domain:

  • The languages assigned to the domain when creating the domain is displayed and is available for selection from the Primary language of documents drop-down list.
  • The fields that were selected when creating the custom domain are displayed in the Fields to extract section of the create New instance page.
You can import or export a domain using the Import or Export option in the Domains tab.
Note: Domains are created and saved with the .dom extension in the system.
Tip: Troubleshoot classification issue with Chinese language documents:

Classification issue with Chinese Invoices (A-People login required)

Import a domain

You import a domain for the following scenarios:

  • Import a new domain.
  • Import an existing domain from another system to your current system.

When you are ready to import a domain into your system:

  1. Go to the system where you want the domain to be imported.
  2. Click Import new domain in the Domains tab and select the .dom domain file in your local machine that you want to import.

    The domain import success message is displayed in the Domains tab.

    The imported domain appears for the selection in the Document type drop-down list of the create New instance page and is displayed in the domains list in the Domains page.

Export a domain

When you click the Export option next to a domain, it is exported to an output folder on your local drive. The exported domain is encrypted and is created with a .dom filename extension.

You export an existing domain from one IQ Bot system to import to another.

To export a domain from your IQ Bot system, do this: In the Domains list page, click the Export option next to the domain you want to export.

The system displays a success message for the exported domain.

The file is exported to a local output folder on your machine with a .dom filename extension.

Note: The domain files are encrypted for security.

Current limitations to the domain import and export actions

Important: Import or export of domains is independent of the migration action in the Migration Utility feature.

When you migrate learning instances that were created using a custom domain from one system to another, the field names and IDs must be the same in the target machine as well. Otherwise, even though the learning instances are imported, the custom domain will not be imported and the associated field names and IDs for the custom domain will not work in the imported learning instance. If you run the imported learning instance on documents, the documents will not be classified.

Even if you import the custom domain to your new system, the field names and IDs will still not match as these are automatically generated by the system. Hence classification will fail. This is the current limitation of the Migration Utility feature using a custom domain.

Workaround: First import the .dom file to the target machine, then migrate the learning instances. Move all learning instances to the staging environment, and test them before moving the learning instance to the production environment.

Custom domain enhancements

Import custom domains in any order

When you migrate learning instances (created using a custom domain) from the staging server to the production server, migration fails unless you import the different versions of the custom domain in the same order as they were created.

As the capability to edit a custom domain to add additional fields and aliases was not available, the user had to create a new domain and add the additional fields and aliases to it. Then the user had to assign that new domain to the learning instance. So when the user wanted to use the new domain, they had to re-import the original and the new domain to the production server in the order they were created in.

Importing custom domain to IQ Bot production (A-People login required)

From release Automation 360 Build 5322, this restriction does not exist.

  • You can edit and update an existing custom domain multiple times, and import them to the production server multiple times as well.
  • You can import the custom domains in any order. The system successfully migrates the updated fields (form or table), and field aliases (variations of field values found in the training documents, associated with a field) to the production server.
Important: Perform all edits or updates to a custom domain in the staging server before importing it to the production server to avoid errors.

IQ Bot performs document classification based on the defined fields and aliases of the version of custom domain used when the learning instance was created.

Editing the same custom domain (with additional fields) changes the version of the custom domain. For new learning instances created using the new version of the custom domain, classification occurs on the updated fields as well. The edited fields (whether form or table fields) are displayed in the learning instance with a double asterisk next to them to help identify them.