Welcome > Set up extraction > Advanced Evaluator > Define input locators for a subfield

Define input locators for a subfield

You can define up to three input locators for each subfield. These input locators can be any kind of locator that returns a simple field or subfield. For example, define a standard locator, such as the Format Locator; an evaluator, such as the Relation Evaluator; or a trainable locator, such as an Amount Group Locator or Order Group Locator. The Input Locator list shows all locators that are defined above the current Advanced Evaluator.

To define evaluation steps for a subfield, select the subfield from the tab list on the left, then select one or more input locators from the Input Locator list. Next, configure evaluation steps for the subfield.

Note If you select multiple trainable locators as input locators and the mapped extraction field is displayed on the Edit Document window, the extraction field is trained for all trainable locators although the field is displayed only once for training.

If you select a trainable locator as an input locator and the Advanced Evaluator subfield is mapped to an extraction field, the field has to be trained for extraction. Then it is displayed for training on the Edit Document window. As needed, clear the "Show in training dialog" option in the Field Properties window. This prevents the field from being displayed for training.

Important If you select an input locator subfield as an input locator and you rename the subfield in the locator properties, the settings in the Advanced Evaluator for the input locator and evaluation step are deleted because the original field no longer exists.

To define input locators for a subfield by following these steps:

  1. Open the locator properties.
  2. Click the Evaluation Settings tab.
  3. Select the vertical subfield tab to configure.

    A list of evaluation steps is displayed for the selected subfield.

  4. From the Input Locator 1 list, select the locator that provides input for this evaluation.
    Note Only those locators defined above the Advanced Evaluator in the Project Tree for the selected class are listed. If needed, close the properties window, change the order of the locators within the Project Tree and re-open the Advanced Evaluator properties window.

    Several buttons and options are available.

  5. To the left of the evaluation step, select Use this evaluation step for processing.

    A green check appears to the left of Input Locator 1 to indicate that this evaluation step is used.

  6. Optionally, select an Input Locator 2.
  7. Optionally, select an Input Locator 3.
  8. Configure the behavior of the input locators.
  9. Optionally, add an evaluation step.
  10. Open a test document and click Test to test your settings.
  11. Optionally, click Close to close the locator properties window.
  12. Save the changes to your project.