Document Understanding
latest
false
Banner background image
Document Understanding User Guide for Modern Experience
Last updated May 9, 2024

Build

This section provides the following experiences:
  • Upload documents and classify them automatically.
  • Upload documents straight into document types.
  • Manage files from the project (add, remove files and add, change tags).
  • Annotate documents.
  • Add or remove fields.
  • Add or remove business rules.
  • Have a guided experience on training classification and extraction models using the recommendations.

Upload Documents

After successfully creating your project, you can upload your documents from the Build section.
  1. Open your project.
  2. Drag and drop the first batch of your sample documents in the Upload sample documents section.
    Tip: You can use the suggestions from the Recommendations sections. These suggestions will guide you through the process.
    The uploaded files are automatically processed (uploaded, digitized, classified, annotated).
  3. Upload the next batch of your sample documents by clicking Upload.
    Tip: You can check the Recommendations sections for suggestions on what more is useful to upload. For example, if there are too few utility_bills documents, a suggestion is displayed:

    utility_bills has too few samples. Add at least 150 documents for an optimal data set size.

    There are two types of recommendations, one for classification and one for extraction models.


  4. Review the uploaded documents.
    1. Expand the needed section (for example, invoices, receipts).
    2. Click on a document name.
    3. Check if the Document type filled in automatically is correct. You can change the document type using the drop-down list.

Annotate Documents

After successfully creating your project and uploading your documents, you can annotate them from the Build section.

You can start annotating documents from a document type section by clicking Annotate.

You can also annotate a specific document by clicking the three-dot icon next to the document name and selecting Annotate.
Tip: Uploaded documents are automatically processed (uploaded, digitized, classified, including annotated). For a performant model, follow the suggestions from the Recommendations section. These recommendations help you improve the overall performance of your model.
Note: Custom document types are not automatically annotated. You need to manually pre-label documents part of a custom document type.


Validating Pre-Labeled Documents

Uploaded documents part of a known document type are automatically pre-labeled. You can validate this from the Annotate view.

During validation, you can have the following situations:
  • Pre-labeling is correct and should to be validated.
  • Pre-labeling is missing and should be marked as such.
  • Pre-labeling is not correct and should be edited.

If all fields from a document are labeled correctly, click Confirm to validate all the fields at once.

Once a document is validated, it will be marked with a green shield in the document list.



Correct pre-labeling

If the field is correct, mark the checkbox next to the field. In our example, the first field is Vendor Name and is marked correctly. To validate, click the checkbox next to the field.


Missing pre-labeling

If there is no pre-label related to that field, click the three-dot icon next to the field name and select Mark as missing
Important: You can also mark wrong fields as missing. For example, if you do not have a Vendor Address in your document but during processing a different field was pre-labeled as Vendor Address, you can just mark it as missing during validation.


Incorrect pre-labeling

If the pre-labeling is not correct, you can correct the field manually.

You can manually label the field by creating a new field. To do this, you can select the needed information by dragging and dropping a selection box straight on the document and selecting the desired Field Name from the drop-down list.

Note: All fields that are annotated manually get validated automatically.

Document Type Settings

You can change the document type settings from the Annotate view.

To do so, click on the three-dot icon on the right side of the document type name and select Settings.



You can change the following settings:
  • Base model: Dataset size estimations used in the Recommended Actions depend on the base model used to train. Using the most similar base model to your Document Type will reduce the amount of annotation work required.
  • Number of layouts: Dataset size estimations used in the Recommended Actions depend on the number of layouts in the dataset. More layouts generally require annotating more data.
  • Number of languages: Dataset size estimation used in the Recommended Actions depend on the number of languages in the dataset. More languages generally require annotating more data.

Edit field settings

You can edit the settings for multiple fields from Document type manager.

To get to there, select the three-dot icon next to the document type you want to edit and select Document type manager from the menu.

Figure 1. Select Document type manager

Editing or adding new fields

To add a new field, select Add field and fill in the needed information. You can add or edit the following options for each field:
  • Field name: the unique name for the field.
  • Content type: the content type of the field:
    • String: used for company names or addresses, as well as payment terms, or for any other field where you want to build the parsing or formatting logic manually, in the RPA workflow.
    • Number: used for amounts or quantities, with intelligent parsing of the decimal/thousands separators.
    • Date: parse, format and unify the output using the YYYY-MM-DD format.
    • Phone: use for phone number. Formatting removes letters and parentheses, and replaces spaces with dashes.
    • ID Number: used for alphanumeric codes, numbers of IDs. It's similar to the string content type, but removes any characters coming before the : character. If the Id number you need to extract can contain : characters, use string content type instead to avoid data loss.
  • Shortcut: the shortcut key for the field. One key or a combination of two keys is allowed.
  • Advanced settings: the available options differ depending on the Content type of the selected field. Select the Advanced settings button for the desired field to edit:
    Figure 2. Document type advanced settings

    • Field ID: the unique id for the field.
    • Post processing:
      • first_span: if the model predicts more than one instance of a field in a document, make it return the first one.
      • longest_value: if the model predicts more than one instance of a field in a document, make it return the value consisting of the largest number of characters.
      • highest_confidence: if the model predicts more than one instance of a field in a document, make it return the value with the highest confidence.
      Scoring: the measure used to determine the accuracy when running evaluations of model predictions is only available for fields with content type String:
      • exact_match: prediction will only be 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). This is the default setting for all fields except for String fields.
      • levenshtein: prediction will be deemed to be partially correct according to the Levenshtein distance between the prediction and the true value. For example, if a 10 letter value is predicted correctly except for the last 2 characters, then the score of that prediction is be 0.8.
    • Date format: this field is only available for fields with content type Date and it indicates how ambiguous dates are parsed and returned:
      • Auto
      • US style: YYYY-DD-MM
      • Non-US style: YYYY-MM-DD
    • Multi-line: fields which span multiple text lines (addresses or descriptions) need to have this checked, otherwise only the first line is returned.
    • Multi-value: field returns a list with all the values detected in the document.

Model settings

You can change the document type settings from the Model settings view. To do so, select Model settings.

Figure 3. Model settings

You can change the following settings:

  • Base model: Dataset size estimations used in the Recommended Actions depend on the base model used to train. Using the most similar base model to your Document Type will reduce the amount of annotation work required.
  • Number of layouts: Dataset size estimations used in the Recommended Actions depend on the number of layouts in the dataset. More layouts generally require annotating more data.
  • Number of languages: Dataset size estimation used in the Recommended Actions depend on the number of languages in the dataset. More languages generally require annotating more data.

Search field names

You can search through the available field names. To do so, use the search bar from the top left corner of the Document type manager interface. For a more efficient search, use the Filter feature to filter by Content type.

Figure 4. Search field names

Delete fields

Select the Delete next to the field you want to delete.

Figure 5. Delete a field

You can also select several (or all) fields and delete them at once. To do so, select the check mark next to the fields you want to delete and then click Delete.
Figure 6. Delete several fields at once

Search Documents

You can search uploaded documents by document name. To do so, use the search bar from the left corner of the Build section. For a more efficient search, use the Filter feature to filter by:
  • Document type: choose the desired document type from the drop-down list.
  • Upload date: choose a date interval when the document was uploaded.
  • Status: choose the status of the document


Project and Model Score

You can check your project's overall score from the top right corner. This score factors in the classifier and extractor scores for all document types. Click Project score to display the Measure section. You can check more in-depth performance measurements in that section.

You can check the score for each document type separately from the Document type section. This score factors in the overall performance of the model, as well as the size and quality of the dataset.

Note: You need to upload at least 10 documents to get a project score. For a document type score, you need at least 10 documents under the same document type.


You can check the model rating of your models if you select the score tag. The model rating is a functionality intended to help you visualize the performance of a classification model. It is expressed as a model score from 0 to 100 as follows:
  • Poor (0-49)
  • Average (50-69)
  • Good (70-89)
  • Excellent (90-100)

Select Detailed model scores to go to the Measure section for detailed information.



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.