Verwendung von Modellen aus verschiedenen Umgebungen

Wenn Sie moderne Document Understanding^TM- Projekte verwenden, müssen Sie eine externe Anwendung konfigurieren, um auf Modelle in verschiedenen Mandanten und Organisationen zuzugreifen.

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.

Mit dieser Funktion können Sie auch Modelle in hybriden Bereitstellungsumgebungen verwenden. In diesem Fall werden Document Understanding-Projekte auf der Automation Cloud^TM konfiguriert, während der Orchestrator und Roboter lokal bereitgestellt werden.

Hinweis:

Units consumption in cross-tenant and cross-organization scenarios

When a Document Understanding project is hosted in a different tenant or organization than the automation calling it, units are charged to the project tenant — the tenant where the model is hosted — not the automation tenant. Enforcement settings on the automation tenant do not apply to this consumption. To control Document Understanding units through enforcement, configure enforcement on the project tenant. For more information, see Tenant consumption enforcement.

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. Gehen Sie zur Seite Administration und wählen Sie Ihre Organisation.

3. Gehen Sie zur Seite Externe Anwendungen.

   

4. Wählen Sie Anwendung hinzufügen auf der Seite Externe Anwendungen.

   Tipp:

   Weitere Informationen zum Hinzufügen einer externen Anwendung finden Sie auf der Seite Verwalten externer OAuth-Anwendungen .

5. Geben Sie einen eindeutigen Namen für die Anwendung im Feld Anwendungsname ein.

6. Wählen Sie einen Anwendungstyp im Abschnitt Anwendungstyp:

   • Vertrauliche Anwendung: geeignet, um den geheimen App-Schlüssel sicher zu speichern. Verwenden Sie diese Option für hohe Sicherheitsanforderungen.
   • Nicht vertrauliche Anwendung: Verwenden Sie diese Option nur, wenn kein sicherer Speicher für das App-Geheimnis erforderlich ist.

   

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

   1. Wählen Sie Zugriffsbereiche hinzufügen im Abschnitt Ressourcen.
   2. Wählen Sie Document Understanding in der Auswahlliste Ressourcen.
   3. Konfigurieren Sie Benutzerbereich(e), um Berechtigungen in einem Benutzerkontext zu erteilen.

   Markieren Sie die Kontrollkästchen neben den logischen API-Berechtigungen, die Sie gemäß Ihren Anforderungen in der Registerkarte Benutzerbereich(e) gewähren möchten.Wenn Sie Berechtigungen im Benutzerbereich erteilen, bedeutet dies, dass die externe Anwendung in einem Benutzerkontext auf diese Ressourcen zugreifen kann. Daher muss ein Benutzer mit den entsprechenden Berechtigungen angemeldet sein.

   4. Konfigurieren Sie Anwendungsbereich(e), um bei umfassenderen Automatisierungsanforderungen Zugriffe auf Anwendungsebene bereitzustellen.

   Wenn Sie eine vertrauliche Anwendung verwenden, gehen Sie zur Registerkarte Anwendungsbereich(e), um der ausgewählten Ressource die erforderlichen Berechtigungen auf Anwendungsebene zuzuweisen. Durch die Delegierung von Berechtigungen im Anwendungsbereich kann die externe Anwendung ohne Benutzerinteraktion auf Daten in den ausgewählten Bereichen zugreifen.

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

   

   5. Wählen Sie Speichern.
      Hinweis:

      Wenn Sie die externe Anwendung bei Benutzer-Scopes registriert haben, fügen Sie eine Umleitungs-URL hinzu. Diese URL erhält die Autorisierungsantwort. Wenn Sie jedoch nur Anwendungs-Scopes ausgewählt haben, ist die Angabe einer Umleitungs-URL 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:

• Verwenden Sie eine kompatible Version von Windows Project.
• Stellen Sie sicher, dass das Aktivitätspaket IntelligentOCR installiert ist. Das Paket IntelligentOCR.Activities unterstützt die Nutzung von Projekten mit Document Understanding ab Version 6.22.1.
  Tipp:

  Mehr zu den Unterschieden zwischen den Paketen DocumentUnderstanding.Activities und IntelligentOCR.Activities sowie eine Anleitung zur Verwendung der beiden Pakete finden Sie auf der Seite Automatisierungen in Document Understanding.

1. Öffnen Sie Ihr UiPath Studio-Projekt.

2. Definieren Sie die Taxonomie.

   1. Öffnen Sie den Taxonomiemanager, um relevante Dokumenttypen und Felder für Ihre Automatisierung zu definieren.

   Ihre Projekt taxonomie- sollte jeden Dokumententyp und die erforderlichen Felder umfassen. Die in Studio erstellte Taxonomie- kann zusätzliche Dokumenttypen und Felder enthalten, die nicht Teil der modernen Document Understanding-Projekte sind.Wenn Sie zusätzliche Extraktoren wie den Form Extractor oder den Regex Extractor für verschiedene Dokumenttypen verwenden möchten, ist dieser Schritt erforderlich.

   

3. Installieren Sie das Paket IntelligentOCR.Activities, um Aktivitäten wie Document Understanding Project Extractor und Document Understanding Project Classifier zu verwenden.

   1. Fügen Sie die Aktivität Data Extraction Scope hinzu, um Extraktionsmodelle zu konfigurieren und die Aktivität Document Understanding Project Extractor einzubeziehen.

   

   2. Fügen Sie die Aktivität Classify Document Scope hinzu, um Klassifizierungsmodelle zu konfigurieren und die Aktivität Document Understanding Project Classifier einzubeziehen.

4. Konfigurieren Sie Zugangsdaten für die Entwurfsphase.

   1. Öffnen Sie den Assistenten Get Capabilities im Aktivitätsbereich.

   Der Assistent wird angezeigt, wenn Sie die Aktivitäten des Document Understanding-Projekts in diesen Bereich einschließen. In diesem Assistenten können Sie Zugangsdaten für die Entwurfsphase konfigurieren, die zur Zuordnung der Taxonomiefelder eines modernen Projekts erforderlich sind.

   2. Geben Sie folgende Informationen ein:
      • App-ID und App-Geheimnis aus der externen Anwendung.
      • Mandanten-URL für die Zielumgebung.
   3. Wählen Sie Projekte laden und dann das gewünschte Projekt sowie die Version.
   4. Schließen Sie den Assistenten.

   

5. Ordnen Sie die Taxonomie- zu.

   1. Wählen Sie Extraktoren konfigurieren in der Aktivität Data Extraction Scope
   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. Gehen Sie zur Registerkarte Assets.
   5. Wählen Sie Asset hinzufügen und dann Neues Asset erstellen in der Auswahlliste.
   6. Geben Sie einen Namen in das Feld Assetname ein.
   7. Wählen Sie Zugangsdaten in der Auswahlliste Typ.
   8. Verwenden Sie die zuvor erstellte App-ID und App-Geheimnis als Benutzername und Passwort.

   

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. Konfigurieren Sie die Eigenschaft Asset mit Zugangsdaten für Runtime.

   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. Konfigurieren Sie die Eigenschaft Mandaten-URL für Runtime.

   Verwenden Sie dieses Feld zusammen mit der Eigenschaft Runtime Credentials Asset . Geben Sie die URL des Mandanten ein, mit dem sich der Roboter verbindet, um die Extraktion auszuführen. Die URL muss das folgende Format haben: 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. Gehen Sie zur Registerkarte Assets.

5. Wählen Sie Asset hinzufügen und dann Neues Asset erstellen in der Auswahlliste.

6. Geben Sie einen Namen in das Feld Assetname ein.

7. Wählen Sie Text in der Auswahlliste Typ.

8. Geben Sie einen Namen in das Feld Text ein, um ein versionsspezifisches Asset zu definieren.

   

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. Fügen Sie Ihrem Workflow eine Aktivität Get Asset hinzu, um das Versionsasset abzurufen.

12. Übergeben Sie den abgerufenen Wert als Eingabevariable an die Aktivitäten Document Understanding Project.

    

Document Understanding-Prozessvorlage

Document Understanding Process ist eine voll funktionsfähige UiPath® Studio-Projektvorlage, die auf einem Flowchart für die Dokumentverarbeitung basiert. Sie können damit mit der Arbeit an einer Demo oder einer umfangreichen Implementierung von Document Understanding^TM beginnen.

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

Weitere Informationen dazu finden Sie auf der Seite Prozessvorlage für Document Understanding.