Verwendung von Modellen aus verschiedenen Umgebungen

When using Document Understanding^TM modern projects, you need to configure an external application to access models across various tenants and organizations.

Dieses Verfahren bietet einen umfassenden Überblick darüber, wie Sie mit externen Anwendungen auf Modelle zugreifen, die in verschiedenen Umgebungen bereitgestellt wurden. Es enthält schrittweise Anweisungen zur Konfiguration einer externen Anwendung für Zugriffsrechte, zur Einrichtung des Studio-Workflows zur Nutzung dieser Modelle und zur Einrichtung von Produktionsworkflows.

This functionality also allows you to use models in hybrid deployment environments. In this case, Document Understanding projects are configured on Automation Cloud^TM, while Orchestrator and Robots are deployed on-premises.

1. Konfigurieren einer externen Anwendung
2. Konfigurieren des UiPath Studio-Workflows
3. Konfigurieren Sie Modellversionen als Parameter
4. Document Understanding-Prozessvorlage

Konfigurieren einer externen Anwendung

1. Gehen Sie zu Ihrem Automation Cloud-Mandanten.

2. Go to the Administration page and select your organization.

3. Go to the External applications page.

   

4. Select Add Application from the External applications page.

   Tipp:

   For more information on adding an external application, check the Managing external OAuth applications page from the Automation Cloud admin guide.

5. Type in a unique name for the application in the Application Name field.

6. Select an application type from the Application type section:

   • Confidential application: suitable for storing the App Secret securely. Use this for high-security requirements.

   • Non-Confidential application: use this option only when secure storage for the App Secret is not required.

     

7. Definieren Sie die Zugriffsrechte für Ihre externe Anwendung.

   1. Select Add Scopes from the Resources section.

   2. Select Document Understanding from the Resource drop-down list.

   3. Configure User scope(s) to grant permissions within a user context.

      Select the checkboxes corresponding to the logical API permissions you want to grant as per your requirement in the User scope(s) tab. If you grant permissions under user scope, it is implied that the external application can access those resources within a user context. Therefore, a user with the corresponding permissions must be logged in.

   4. Configure Application scope(s) to provide application-level access for broader automation needs.

      If you are using a confidential application, navigate to the Application scope(s) tab to allocate application-level permissions for the chosen resource as required. By delegating permissions under the application scope, the external application can access data across the selected scopes without any user interaction.

      Nicht vertrauliche Anwendungen können nicht auf den Anwendungsbereich zugreifen.

   

   5. Wählen Sie Speichern.
      Hinweis:

      If you have registered the external application with user scopes, add a Redirect URL. This URL will receive the authorization response. However, if you selected only application scopes, providing a redirect URL is optional.

8. Klicken Sie auf Hinzufügen , um die Registrierung zu erstellen.

   Eine Bestätigungsmeldung wird angezeigt. Bei vertraulichen Anwendungen enthält diese Meldung das App-Geheimnis. Die registrierte externe Anwendung kann mithilfe dieses App-Geheimnisses eine Autorisierung anfordern.Stellen Sie sicher, dass Sie das App-Geheimnis an einem sicheren Ort speichern, da Sie es nicht mehr sehen werden können.

   

Konfigurieren des UiPath Studio-Workflows

Bevor Sie beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

• Use a compatible Windows Project version.
• Make sure that the IntelligentOCR activity package is installed. The IntelligentOCR.Activities package supports the consumption of Document Understanding modern projects starting with v6.22.1.

Tipp:

For a more detailed understanding of the differences between the DocumentUnderstanding.Activities and IntelligentOCR.Activities packages, as well as guidance on when to use each of them, check the Automations in Document Understanding page.

1. Open your UiPath Studio project.
2. Definieren Sie die Taxonomie.

   1. Open Taxonomy Manager to define relevant document types and fields for your automation.

      Your project taxonomy should encompass each document type and the necessary fields. The taxonomy you create in Studio can contain additional document types and fields that are not part of the Document Understanding modern projects. If you wish to use additional extractors like the Form Extractor or the Regex Extractor for various document types, this step will be necessary.

      

3. Install the IntelligentOCR.Activities package to use activities such as Document Understanding Project Extractor and Document Understanding Project Classifier.

   1. Add the Data Extraction Scope activity to configure extraction models and include the Document Understanding Project Extractor activity.

      

   2. Add the Classify Document Scope activity to configure classification models and include the Document Understanding Project Classifier activity.

4. Konfigurieren Sie Zugangsdaten für die Entwurfsphase.

   1. Open the Get Capabilities wizard from the activity scope.

      The wizard is displayed when you include the Document Understanding Project activities within that scope. This wizard allows you to configure design-time credentials needed to map the taxonomy fields of a modern project.

   2. Geben Sie folgende Informationen ein:

      • App ID and App Secret from the external application.
      • Tenant URL for the target environment.

   3. Select Get Projects and choose the needed project and version.

   4. Schließen Sie den Assistenten.

      

5. Ordnen Sie die Taxonomie- zu.

   1. Select Configure Extractors within the Data Extraction Scope activity.

   2. Erstellen Sie eine Zuordnung der Projekttaxonomie zur Modelltaxonomie für jeden Dokumententyp.

      Um diesen Schritt auszuführen, wählen Sie einen Dokumententyp in der Taxonomie und richten Sie jedes Feld dieses Dokumententyps an ein entsprechendes Feld im Modell aus, das für das Document Understanding-Projekt entworfen wurde.

      

6. Speichern Sie die Zugangsdaten für die Runtime als Orchestrator-Asset.

   1. Gehen Sie zu Ihrem Automation Cloud-Mandanten.

   2. Gehen Sie zu Orchestrator.

   3. Wählen Sie Ihren Automatisierungsordner.

   4. Go to the Assets tab.

   5. Select Add asset and choose Create a new asset from the drop-down list.

   6. Type in a name in the Asset name field.

   7. Select Credential from the Type drop-down list.

   8. Use the previously created App ID and App Secret as the Username and Password.

      

7. Konfigurieren Sie in Studio Zugangsdaten für die Runtime.

   1. Gehen Sie zu Ihrem Studio-Projekt.

   2. Gehen Sie zur Aktivität Data Extraction Scope.

   3. Configure the Runtime Credentials Asset property.

      Verwenden Sie dieses Feld, um auf Ressourcen des modernen Document Understanding-Projekts zuzugreifen, während der Roboter entweder mit einem lokalen Orchestrator oder einem anderen Mandanten verbunden ist. Sie können ein Asset mit Zugangsdaten zu Authentifizierungszwecken auf eine der folgenden Arten eingeben:

      • Wählen Sie im Orchestrator in der Auswahlliste das gewünschte Asset mit Zugangsdaten, mit dem der Roboter verbunden ist.
      • Geben Sie den Pfad zum Asset mit Zugangsdaten in Orchestrator ein, in dem Sie die externen Zugangsdaten für den Zugriff auf das Projekt speichern.Das Pfadformat muss wie folgt aussehen: <OrchestratorFolderName>/<AssetName>.

   4. Configure the Runtime Tenant Url property.

      Use this field together with the Runtime Credentials Asset property. Enter the URL of the tenant to which the robot will connect to execute the extraction. The URL must have the following format: https://<baseURL>/<OrganizationName>/<TenantName>.

Die externe Anwendung bietet Zugriff auf alle Projekte des Moduls Document Understanding innerhalb des Mandanten. Sie müssen den Zugriff nicht für jedes Projekt einzeln konfigurieren.

Konfigurieren Sie Modellversionen als Parameter

Wenn Sie Projektversionen als Parameter konfigurieren, können Sie Automatisierungsworkflows für neue Projektversionen aktualisieren, ohne den Workflow-Code anpassen zu müssen.

1. Gehen Sie zu Ihrem Automation Cloud-Mandanten.

2. Gehen Sie zu Orchestrator.

3. Wählen Sie Ihren Automatisierungsordner.

4. Go to the Assets tab.

5. Select Add asset and choose Create a new asset from the drop-down list.

6. Type in a name in the Asset name field.

7. Select Text from the Type drop-down list.

8. Type in a name in the Text field to define a version-specific asset.

   

9. Wählen Sie Erstellen.

   Auf diese Weise können Sie Automatisierungsworkflows für neue Projektversionen aktualisieren, ohne den Workflow-Code anpassen zu müssen. Wenn die Automatisierung in einem angegebenen Ordner bereitgestellt wird, wird die Modellversion entsprechend dem Asset in Orchestrator festgelegt. Dieser Prozess ähnelt dem Speichern von Zugangsdaten für externe Anwendungen als Assets.

10. Gehen Sie zu Ihrem Studio-Projekt.

11. Add a Get Asset activity in your workflow to retrieve the version asset.

12. Pass the retrieved value as an input variable to the Document Understanding Project activities.

    

Document Understanding-Prozessvorlage

Document Understanding Process is a fully functional UiPath® Studio project template based on a document processing flowchart. You can use it to get started with working on either a demo, or a large-scale implementation of Document Understanding^TM.

Der Prozess bringt Protokollierung, Ausnahmebehandlung, Wiederholungsmechanismen und alle Methoden mit, die in einem Document Understanding-Workflow verwendet werden sollten.

For more information, check the Document Understanding Process template page.