Modify a custom subfield for an A2iA Zone Locator

The A2iA Zone Locator is now deprecated and no longer supported. However, if you have used an A2iA Zone Locator in a previous release, it is possible to continue to use these locators at your own risk. The A2iA Zone Locator and the Check and Cursive Recognition engine remain for reference purposes only and are not meant for use in production.

Alternatively, you can migrate these locators to a supported locator method. To use or migrate an A2iA Zone Locator it is necessary to install the Check and Cursive Recognition Add-On.

When you migrate an A2iA Zone Locator, the following behavior occurs:

  1. If an A2iA Zone Locator is configured to use the CheckReader functionality, then it is migrated to a Check Locator.

  2. If an A2iA Zone Locator is configured to use the FieldReader functionality, it is migrated to an Advanced Zone Locator that uses the FormXtra recognition engine . If a single A2iA Zone Locator has multiple zones then multiple FormXtra zone profiles are created, one for each zone. This enables you to configure unique settings for each zone.

If a custom subfield is not performing as expected, or if you want to change a predefined subfield, it is possible to make the necessary changes by following these steps:

  1. Open the locator properties.
  2. Click the Custom Subfields tab.
  3. In the Subfields section, in the Name list, select the custom subfield to be modified.
  4. To rename the custom subfield, click Rename and type a new name.
  5. To change the output path for the selected custom subfield, do the following.
    1. In the A2iA Output Path column, double-click the output path to change.

      The A2iA Output Path for Custom Subfield window is displayed so that you can select or enter the output path.

    2. In the A2iA Output Path for Custom Subfield window, select the node in the tree containing the desired output path.

      The complete path is displayed in the A2iA Output Path field. You can also type or edit the path in the field.

      If you select a node for an array, a placeholder ([?]) is displayed for the array index number. Replace the question mark inside the brackets with the correct array index, such as [1].

      If the path you selected is invalid, an icon is displayed in the window. Mouse over the icon to view a description of the error.

    3. If the path you selected is correct, click OK.

      The A2iA Output Path for Custom Subfield window closes, and the selected path is displayed in the field in the A2iA Output Path column.

    4. Optionally, change the Prefix field to enter characters to append to the beginning of the output string before it is processed by the regular expressions. Click the field and enter characters.
    5. Optionally, change the RegEx Match and RegEx Replace fields as needed. Click the field to enter characters.

    If you need to delete an output path, select the row in the Properties table and click the Delete button in the Subfields section because it deletes a custom subfield.

  6. If the custom subfield uses multiple output paths, do the following:
    1. Add output paths by repeating the previous step.
    2. Set the output paths in the order they should be concatenated. Select an output path and click Move Up or Move Down to change the order.
    3. In the Delimiter field, enter the characters used as a delimiter between the output paths.
  7. In the Location field, select or enter the location of the subfield data.
    1. Click Browse to the right of the field.

      The Location for Custom Subfield window is displayed.

    2. In the Location for Custom Subfield window, select the node in the tree containing the location of the subfield data. A location node must contain the following child nodes: x_tl, x_br, y_tl, y_br, and pageIndex.

      The complete path is displayed in the Location field. You can also type or edit the path in the field.

      If you select a node for an array, a placeholder ([?]) is displayed for the array index number. Replace the question mark inside the brackets with the correct array index, such as [1].

      If the path you selected is invalid, an icon is displayed in the window. Mouse over the icon to view a description of the error.

    3. If the path you selected is correct, click OK.

      The Location for Custom Subfield window closes, and the selected path is displayed in the Location field.

  8. In the Confidence field, select or enter the path for the confidence value of the subfield data.
    1. Click Browse to the right of the field.

      The Confidence for Custom Subfield window is displayed.

    2. In the Confidence for Custom Subfield window, select the node in the tree containing the location of the subfield data.

      The complete path is displayed in the Confidence field. You can also type or edit the path in the field.

      If you select a node for an array, a placeholder ([?]) is displayed for the array index number. Replace the question mark inside the brackets with the correct array index, such as [1].

      If the node is invalid, an icon is displayed. Mouse over the icon for more information.

    3. If the path you selected is correct, click OK.

      The Confidence for Custom Subfield window closes, and the selected path is displayed in the Confidence field.

  9. Click Close to close the locator properties window.
  10. Save the changes to your project.