activities
latest
false
UiPath logo, featuring letters U and I in white

Document Understanding Activities

Last updated Jun 11, 2025

PREVIEW
Document Understanding Project Extractor Trainer

UiPath.IntelligentOCR.Activities.Training.DuAppExtractorTrainer

Description

This activity allows you to use documents from Validation Station and retrain the models.

You can use this activity only with the Train Extractors Scope activity.

Project compatibility

Windows - Legacy | Windows

Configuration

Designer panel
  • Project - Select the desired modern project from the dropdown menu. The available options are:
    • Predefined: A default option that exposes the public UiPath® extraction model. You can select this, if you want to use the out-of-the-box extraction capabilities of UiPath®.
    • Generative Predefined – Modern project type that uses pre-trained generative models.
    • Modern projects available in the organization and tenant to which your Studio is connected.
    Note: You can only use the initial 500 projects created on your tenant. If you use the Document Understanding Project Extractor Trainer activity, UiPath Studio or Studio Web will only display the initial 500. Therefore, any projects beyond the initial 500 cannot be used.
  • Version - Select the deployed version of the desired project. If you select a version, you cannot select a tag.

    This field is disabled if you select the Predefined project type.

  • Tag - Select a tag that links directly to a specific version of your chosen project. For example, if you select the Staging tag, the activity uses the project version assigned to this tag during the document extraction process. If you select a tag, you cannot select a version.

    This field is disabled if you select the Predefined project type.

  • Completed Action Object - Provide the completed action object returned by Action Center once the action is completed.
Properties panel

Common

  • DisplayName - The display name of the activity.

Authentication

The Authentication properties allow you to execute the activity via on-premises robots. Before configuring these properties, ensure you have fulfilled the prerequisites mentioned on the Configuring Authentication page. Once these steps are completed, you can proceed to fill in the Authentication properties of the activity.

  • Runtime Credentials Asset - Use this field when you need to access Document Understanding modern project resources while the robot is connected to a local Orchestrator, or from a different tenant. You can choose to enter a Credential Asset, for authentication purposes, in one of the following ways:
    • From the dropdown list, select the desired Credential Asset from the Orchestrator to which the UiPath® Robot is connected.
    • Manually enter the path to the Orchestrator Credential Asset where you store the external application credentials for accessing the project.
      The format of the path should be: <OrchestratorFolderName>/<AssetName>.
  • Runtime Tenant Url - Use this field, alongside the Runtime Credentials Asset field. Enter the URL of the tenant that the robot will connect to in order to execute the extraction. The URL should be in the following format: https://<baseURL>/<OrganizationName>/<TenantName>.

Input

  • ActionObject(Input) - Specify the input action, which is the output of the Create Document Validation Action activity.
  • Project - Select the desired modern project from the dropdown menu. The available options are:
    • Predefined: A default option that exposes the public UiPath® extraction model. You can select this, if you want to use the out-of-the-box extraction capabilities of UiPath®.
    • Generative Predefined: Modern projects available in the organization and tenant to which your Studio is connected.
  • Tag - Select a tag that links directly to a specific version of your chosen project. For example, if you select the Staging tag, the activity uses the project version assigned to this tag during the document extraction process. If you select a tag, you cannot select a version.

    This field is disabled if you select the Predefined project type.

  • Timeout (milliseconds) - Specifies the amount of time (in milliseconds) to wait for the activity to run before an error is thrown. The default value is 900000 milliseconds (900 seconds).
  • Version - Select the deployed version of the desired project.

    This field is disabled if you select the Predefined project type.

Misc

  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.
Note: You can use variables in the Project and Version fields.

Configuring Document Understanding Project Extractor Trainer

To map your taxonomy fields to a specific extractor, perform the following steps in the Configure Extractors Wizard:
Note: If you wish to use the same project resources at runtime, ensure the Authentication properties of the activity match those in the Get Capabilities wizard.
  1. Add the Document Understanding Project Extractor Trainer activity in the Train Extractors Scope activity.
  2. Configure the Design time credentials that allow you to map the taxonomy fields of a modern project from a specific tenant or organization:

    Before configuring these properties, ensure you have fulfilled the prerequisites mentioned on the Configuring Authentication page. Once these steps are completed, input your external application credentials into the wizard.

    • App Id: Enter the App ID you generated from the external application in the organization you're trying to access.
    • App Secret: Enter the App Secret generated from the same external application.
    • Tenant Url: Provide the URL of the specific tenant whose resources you wish to use. The format of the URL should be: https://<baseURL>/<OrganizationName>/<TenantName>.
  3. Select Get Projects to populate the Project dropdown list with projects from the organization and tenant where you created the external application.
  4. For Project, select your desired modern project from the dropdown list.
  5. For Version, select a version for your chosen project.

    After you select a version, you cannot select a project tag.

  6. Optionally, for Tag, you can select a tag associated with a version of your chosen project.

    If you select a tag, its corresponding version is automatically used. Therefore, you cannot select a version, while you are using a tag.

  7. Select Get Capabilities.
    Note: If you use variables for the Project, Version, and Tag fields, then the Get Capabilities wizard will also request you to select an existing project and version that the robot can access, for configuration purposes.
Figure 1. The Get Capabilities wizard overview

Was this page helpful?

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