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

Document Understanding Activities

Last updated Mar 3, 2025

PREVIEW
Configuring external connection

An external connection allows you to create and run activities using on-premise robots. To set an external connection, begin by adding an external application to your cloud organization that contains resources for your local project. Next, you need to enter the external application credentials, which vary based on your needs. If you are designing the activity, input the credentials directly into the activity. For runtime, save these credentials in the local Orchestrator linked to your executing robot. This equips the on-premises robot with the necessary access to use resources from the cloud organization, or from a different tenant.

1. Add the external application

  1. In your Automation CloudTM organization, add an external application and select Document Understanding as one of its resources. Ensure that the necessary User and Application scopes are included.

    The necessary application scopes depend on the activities for which you want to use the external application. For example, if you want to use external application authentication with extraction activities, such as the Generative Extractor or Data Extraction Scope, we recommend that you assign application scopes related to extraction, such as the Du.Extraction.Api application scope.

    Once you've added the external application to your organization, save the provided App ID and App Secret. These credentials are necessary for your local Studio workflow, as they allow it to consume resources from the cloud organization at design-time or runtime.

    Figure 1. Generated credentials after adding an external application to your organization

  2. Enable Document UnderstandingTM in your chosen tenant.
  3. Allocate AI Units to the selected tenant.
  4. If you want to use this external application at runtime, store the external application credentials, saved at step 1, in the local Orchestrator, where the robot belongs to, as a Credential Asset. In the Credential Asset, assign the external application credentials as follows:
    • Username: The App ID of the external application;
    • Password: The App Secret of the external application.

2. Provide the credentials in the activity

After you add the external application, and store its credentials in a dedicated Credential Asset, you can configure the external connection, as follows:

  1. For Design-time external connection:
    1. Input the external application credentials directly in the activity, in the App ID and App secret fields.
    2. In the Tenant URL field, enter the URL of the tenant that the robot will connect to in order to configure the classification. The URL should be in the following format: https://<baseURL>/<OrganizationName>/<TenantName>.
  2. For Runtime external connection:
    1. Runtime Credentials Asset - Use this field to input the Credential Asset where you stored the external application credentials from your desired cloud organization, or 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 to.
      • Manually enter the path to the Orchestrator Credential Asset where you store the external application credentials for accessing the generative features.
        The format of the path should be: <OrchestratorFolderName>/<AssetName>.
    2. 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 activity. The URL should be in the following format: https://<baseURL>/<OrganizationName>/<TenantName>.
  • 1. Add the external application
  • 2. Provide the credentials in the activity

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.