document-understanding
2023.10
true
Document Understanding User Guide
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Nov 11, 2024

Create and configure fields

Fields can be renamed. Just click the Edit field button and simply edit the name of the field at the top of the window.

If there are fields that you later decide you do not want to use for training an ML model, you can either delete them or you can always hide them using the Hidden checkbox in the Edit field window.

Note: A maximum of 300 fields can be created.

Column fields

A line item Description or Unit Price on an invoice document would be examples of Column fields.

Create a new column field

  • Click docs image in the table section at the top of the page to add a new Column field. The Create Column Field window is displayed.
  • Fill in a unique name for the field in the Enter unique field name field. The field does not accept uppercase letters. It can only contain lowercase letters, numbers, underscore _ and dash -.
  • Click OK. The Edit Field window is displayed with the General tab open.

    docs image
  • From the Content Type drop-down, select the content type.
  • Click the Hotkey field and press a key on your keyboard to automatically populate it.
  • Select the Split items checkbox if you want this field to be used as a delimiter between line items or rows in a table. Any line on which this field appears is considered to be a new line item or row in the table. Most commonly this is used on Line Amount fields on Invoice line items.

  • Select the Hidden checkbox if you do not want this field to be part of exported datasets.
  • Click on the Advanced tab.
  • From the Scoring drop-down, select the measure used to determine accuracy when running evaluations of model predictions.
  • Fill in the hex code of the desired field color on the Color field.
  • Click Save to save your settings.

Edit a column field

Click the Edit field button. The available options for column fields can be found in the table below.

Option

Tab

Description

Field name

n/a

The unique name for the field.

The field does not accept uppercase letters. It can only contain lowercase letters, numbers, underscore _ and dash -.

Content type

General

The content type of a field:

  • string: appropriate for company names or addresses, as well as payment terms, or for any other field where the RPA developer prefers to build the parsing or formatting logic manually, in the RPA workflow.
  • number: appropriate for amounts or quantities, with intelligent parsing of the decimal/thousands separators.
  • date: the model parses, formats and unifies the output in a yyyy-mm-dd format. You can indicate how ambiguous dates should be parsed and returned. To do this, choose between Non-US style (yyyy-dd-mm) and US style (yyyy-mm-dd) from the Date format option.
  • phone: appropriate for phone numbers. Formatting removes letters and parentheses, and replaces spaces with dashes.
  • id-no: appropriate for alphanumeric codes, numbers of IDs, it is similar to the string content type, but includes cleaning of any characters coming before a colon :. If the id number you need to extract might contain colon : characters, please use string as content type instead to avoid data loss.

Shortcut

General

The shortcut key for the field. One or two keys allowed.

Split items

General

Select this checkbox if you want this field to be used as a delimiter between line items or rows in a table. Any line on which this field appears is considered to be a new line item or row in the table. Most commonly, this is used on Line Amount fields on Invoice line items.

Hidden

General

Select this checkbox if you do not want this field to be part of exported datasets.

Color

Advanced

The color for the field in hex format. If the value is not valid, a new one is generated.

Scoring

Advanced

The measure used to determine accuracy when running evaluations of model predictions. It can only be configured for string content type. All other content types use an Exact Match scoring strategy. Options:

  • exact match: a prediction is only deemed to be correct (score of 1) if it exactly matches the true value. If it differs by even a single character, then it is deemed to be incorrect (score of 0).
  • levenshtein: a prediction is deemed to be partially correct according to the Levenshtein distance between the prediction and the true value. If a 10-letter value is predicted correctly, except for the last 2 characters, then the score of that prediction will be 0.8.

Delete a column field

To delete a column field, follow these steps:

  1. Click the Edit fielddocs image button corresponding to the column field you want to delete.
  2. Click the Delete button.
  3. Type the exact name of the field.


  4. Click OK.
  5. The column field and its associated labeled data is deleted.

Regular fields

These are fields which appear only once on a given document. A line item Invoice Number or Total Amount on an invoice document would be examples of Column fields.

Create a new regular field

  • Click docs image on the right pane in the Regular Fields section. The Create Regular Field window is displayed.
  • Fill in a unique name for the field in the Enter unique field name field. The field does not accept uppercase letters. It can only contain lowercase letters, numbers, underscore _ and dash -.
  • Click OK. The Edit Field window is displayed with the General tab open.
  • Select the content type from the Content Type drop-down.
  • Click the Shortcut field and press a key on your keyboard to automatically populate it.
  • Select the Multi line checkbox if the field to be checked against might span across multiple text lines, such as addresses or descriptions. If this option is not selected, only the first line is returned.
  • Select the Multi-value checkbox for all the values detected in the document to be displayed as a list. You can either select the multi-line or the Multi-value checkbox.
  • Select the Hidden checkbox if you do not want this field to be part of exported datasets.
  • Click on the Advanced tab.
  • Select the post processing mechanism in case the model predicts more than one instance of a field on a given page from the Post processing drop-down.
  • From the Scoring drop-down, select the measure used to determine accuracy when running evaluations of model predictions.
  • In the Color field, fill in the hex code of the desired field color.
  • Click Save to save your settings.

Edit a regular field

Click the Edit field button. The available options for regular fields can be found in the table below.

Option

Tab

Description

Field name

n/a

The unique name for the field.

The field does not accept uppercase letters. It can only contain lowercase letters, numbers, underscore _ and dash -.

Content type

General

The content type of a field:

  • string: appropriate for company names or addresses, as well as payment terms, or for any other field where the RPA developer prefers to build the parsing or formatting logic manually, in the RPA workflow.
  • number: appropriate for amounts or quantities, with intelligent parsing of the decimal/thousands separators.
  • date: the model parses, formats and unifies the output in a yyyy-mm-dd format. You can indicate how ambiguous dates should be parsed and returned. To do this, choose between Non-US style (yyyy-dd-mm) and US style (yyyy-mm-dd) from the Date format option. This option has no impact when the date is not ambiguous and is only supported by ML Packages version 22.10.2 or later.
  • phone: appropriate for phone numbers. Formatting removes letters and parentheses, and replaces spaces with dashes.
  • id-no: appropriate for alphanumeric codes, numbers of IDs, it is similar to the string content type, but includes cleaning of any characters coming before a colon :. If the id number you need to extract might contain colon : characters, please use string as content type instead to avoid data loss.

Post processing

Advanced

The post-processing mechanism. If the model predicts more than one instance of a field on a given page, the model returns:

  • highest_confidence: the value with the highest confidence.
  • first_span: the first value.
  • largest_value: the largest numeric value. This is only displayed for number content type and is appropriate for Total Amount fields.
  • longest_value: the value consisting of the largest number of characters.

Shortcut

General

The shortcut key for the field. One or two keys allowed.

Multi line

General

Select this checkbox for fields which may span across multiple text lines (addresses or descriptions), otherwise, only the first line is returned.

Multi value

GeneralSelect this checkbox for all the values detected in the document to be displayed as a list. You can either select the multi-line or the Multi-value checkbox.

Hidden

General

Select this checkbox if you do not want this field to be part of exported datasets.

Scoring

Advanced

The measure used to determine accuracy when running evaluations of model predictions. It can only be configured for string content type. All other content types use an Exact Match scoring strategy. Options:

  • exact match: a prediction is only deemed to be correct (score of 1) if it exactly matches the true value. If it differs by even a single character, then it is deemed to be incorrect (score of 0).
  • levenshtein: a prediction is deemed to be partially correct according to the Levenshtein distance between the prediction and the true value. If a 10-letter value is predicted correctly, except for the last 2 characters, then the score of that prediction will be 0.8.

Color

Advanced

The color for the field in hex format. If the value is not valid, a new one is generated.

Delete a regular field

To delete a regular field, follow these steps:

  1. Click the Edit fielddocs image button corresponding to the regular field you want to delete.
  2. Click the Delete button.
  3. Type the exact name of the field.


  4. Click OK.
  5. The regular field and its associated labeled data is deleted.

Classification fields

Data points which refer to a document as a whole. For instance, the Expense Type of a receipt (Food, Hotel, Airline, Transportation) or the Currency of an invoice (USD, EUR, JPY) would be examples of Classification fields.

Create a new classification field

  1. Click docs image on the right pane in the Classification Fields section. The Create a new classification field window is displayed.
  2. Fill in a unique name for the field in the Enter unique field name field. The field does not accept uppercase letters. It can only contain lowercase letters, numbers, underscore _ and dash -.
  3. Click OK. The Edit Field window is displayed.
  4. In the text area, fill in the list of classes and type the names as a comma separated list.
  5. Click Save to save your settings.

Edit a classification field

Click the Edit fielddocs image button. Define a list of possible values. Commas must separate values. An optional description of the value may be included after colon : (option 1 : description 1).


Delete a classification field

To delete a classification field, follow these steps:

  1. Click the Edit fielddocs image button corresponding to the classification field you want to delete.
  2. Click the Delete button.
  3. Type the exact name of the field.


  4. Click OK.
  5. The classification field and its associated labeled data is deleted.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.