Configure a Table Locator

Use the procedure in this topic to configure a Table Locator.

Procedure
  1. Open the Table Locator Properties icon Properties.

    The properties for the Table Locator are displayed.

  2. On the Settings tab, configure the following settings.

    Setting

    Description

    General Settings group

    Table model

    Select a table model from the list. (Default: none)

    Select Table Models to open the Tables tab on the Project Settings window where you can define or edit table models.

    Detection mode

    There are two methods that can be used to locate tables on a document:

    • Automatic. (Default: Selected)

    • Manual.

    Depending on the selected detection mode, different settings are enabled or disabled.

    Enable training

    Uses this locator as a trainable locator. You need to create a training set for it from sample documents or documents that are returned by the Validation module. Available only if the detection method is set to Automatic. (Default: Cleared)

    This setting is available only for the Automatic detection mode.

    Automatic Table Extraction group

    Available only if the detection method is set to Automatic.

    Locator that finds amounts

    The locator used here must return all amount alternatives available on a document. The best locator for this is a Format Locator that is configured to locate all of the amounts on a document. (Default: empty)

    Alternatively, you can create a script locator that also locates all amounts available on a document. You cannot use a locator or locator subfield that returns a single piece of information only. For example, you cannot use a group locator subfield.

    Line Item Matching Locator

    Select a Line Item Matching Locator that is configured to extract and match line items on the invoice or invoice-related document. (Default: none)

    To use the Line Item Matching Locator as input, you need to configure and position this locator above the Table Locator in the Project Tree window.

    Manual Table Extraction

    Available only if the detection method is set to Manual.

    Select a sample image

    Select a sample image from a document set. The master line item is defined on the Master Item tab using this image. (Default: none)

    Beginning and End of Table

    Table header packs

    If you want to use a table header pack to help find the start of a table, select one or more of the available table header packs. (Default: Cleared)

    If the table Detection mode is set to Manual, the start of table and the table header pack have the same functionality, to ignore extracted rows above the beginning of the table. In Manual mode, the header pack result is more important, so takes precedence over a start of table result.

    If the table Detection mode is set to Automatic, the table header pack is very important because it not only detects the top of the table, it also segments the columns. The start of table dictionary is only used in this mode if the table header pack fails to located the top of the table.

    Find the start of the table

    Select one of the following ways to find the start of a table:

    Use a dictionary

    Uses a dictionary to find the start of a table. Once selected, the list of available dictionaries is enabled for your selection. (Default: Cleared)

    When selected, the list is enabled for you to select a dictionary. Click Refresh Dictionary icon Refresh selected dictionary to update the dictionary.

    Use a locator

    Uses a locator to find the start of a table. Once selected, the list of available locators is enabled for selection. (Default: Cleared)

    You cannot use a Classification Locator as input to help find the start of a table.

    Although it is more difficult to add a table header pack than a locator or dictionary, the header pack yields better results when detecting the start of a table.

    If you use a table header pack as well as either the locator or dictionary methods to detect the start of a table, the table header pack always gets evaluated first. If a result is detected, the start-of-table dictionary or locator are never evaluated. If the table header pack cannot locate the start of a table, the dictionary or locator is evaluated.

    The locator or dictionary provide alternative solutions for detecting the start of a table if the header pack fails for any reason. As a result, you should always use a table header pack and a dictionary or locator, if available, to ensure the start of a table is detected.

    Find the end of the table

    Select one of the following ways to find the end of a table:

    Use a dictionary

    Uses a dictionary to find the end of a table. Once selected, the list of available dictionaries is enabled for your selection. (Default: Cleared)

    When selected, the list is enabled for you to select a dictionary. Click Refresh Dictionary icon Refresh selected dictionary to update the dictionary.

    Use a locator

    Uses a locator to find the end of a table. Once selected, the list of available locators is enabled for selection. (Default: Cleared)

    You cannot use a Classification Locator as input to help find the end of a table.

    Dictionaries

    Opens the Project Settings - Dictionaries tab where you can manage dictionaries.

  3. For automatic detection mode, skip to step 4.

    For manual detection mode, see Define a master item and Define model column mappings to configure the settings on the Master Item and Cells tab. Return here for step 4 to configure the Advanced tab.

  4. On the Advanced tab, configure the following settings.

    Setting

    Description

    Interleaving Order Numbers group

    Search for interleaved order numbers

    Select if you want the Table Locator to find and identify numbers interleaved in the table. If you have a collective invoice that is an invoice referring to several orders, line items in the table might be grouped by order or delivery note numbers, interleaved in the table. (Default: Cleared)

    When selected, the following settings are also available:

    Select one of the following types of interleaved numbers based on the type of documents you are processing:

    • Order numbers. (Default: Selected)

    • Delivery note numbers.

    Locator:

    Select an appropriate Locator to find order or delivery note numbers. (Default: empty)

    The list of available locators exclude locators that use table models.

    Threshold:

    Specify a minimum threshold for the results. Only results from the selected locator with a confidence higher than this threshold is used. (Default: 80)

    Embedded Columns

    This lists any table columns that are mapped to specific locators. The following are available:

    Column:

    In the list, select a column from the table model. This is the column where the Format Locator searches for its configured regular expression.

    Locator:

    In the list, select a Format Locator. The locator needs to are displayed before the Table Locator in the list of class locators, otherwise it does not are displayed in this list.

    Threshold:

    Select a threshold for the Format Locator confidence. Only alternatives from the locator that have a confidence above this threshold is used.

    Destination Column:

    If the Format Locator finds a match in the search column, the result is copied to the destination column.

    Use the Add icon Add and Delete icon Delete to manage the embedded columns.

Next steps
More info