Validieren von Dokumenten mit App-Aktionen

Diese Schnellstartanleitung hilft Ihnen, mit der Validierung von Dokumenten zu beginnen, indem Sie die Validation Station in UiPath® Action-Apps hinzufügen und sie dann als App-Aktionen zur Validierung über das Action Center senden. Das Tutorial verwendet UiPath Studio, um die Dokumentverarbeitung zu automatisieren, UiPath Apps für die Anzeige der Validation Station und Action Center für die Durchführung der Validierung. Der Dokumenttyp, der in den Beispielen in diesem Tutorial verwendet wird, ist ein Gesundheitsformular vom Typ CMS 1500.

Die Übersichtsschritte dieser Schnellstartanleitung sind:

1. Erstellen Sie die Aktions-App, die das Validierungssteuerelement anzeigt.
2. Verwenden Sie eine zuvor konfigurierte App, um die Studio-Automatisierung zu entwerfen, die das Dokument verarbeitet und zur Validierung im Action Center sendet.
3. Schließen Sie die Aktion im Action Center ab.

Schritte

1. Erstellen Sie eine Action-App

Voraussetzungen

Stellen Sie sicher, dass Ihr Mandant:

• Verfügt über genügend Robot Units, da die App mit Serverless-Robotern ausgeführt wird.
• Eine Vorlage für den serverlosen Roboter wird im Orchestrator erstellt und bereitgestellt. Weitere Informationen zu serverlosen Robotern und zum Hinzufügen zu einem Mandanten finden Sie unter Ausführen von Unattended-Automatisierungen mit serverlosen Robotern.

1. Erstellen Sie eine Aktions-App

Hinweis: Im Gegensatz zu VB-Apps, die über den Apps-Dienst verfügbar sind, kann auf Apps über Studio Web zugegriffen werden.

Führen Sie die folgenden Schritte aus, um eine Aktions-App zu erstellen:

1. Wechseln Sie zu Studio Web.
2. Wählen Sie Neu erstellen > App aus, um ein neues Projekt zu erstellen.
3. Wählen Sie im Projekt-Explorer Ihrer App die Option Seiten, Workflows, Steuerelemente und Integrationen hinzufügen > Aktion aus.

   In diesem Schritt wird Ihrer App eine Aktion hinzugefügt, und Sie können ein Aktionsschema dafür konfigurieren.

4. Erweitern Sie Action und wählen Sie ActionSchema aus.

   Konfigurieren Sie das Aktionsschema mit den gewünschten In- und Out-Argumenten für App-Aktionen im Action Center.

   1. Fügen Sie für Outcomes weitere benutzerdefinierte Ergebnisse hinzu, die die Aktion haben soll.

      Sie können z. B. ein benutzerdefiniertes Ergebnis mit dem Namen „Genehmigen“ hinzufügen.

   2. Fügen Sie für Eingabeeigenschaften Eigenschaften für Daten hinzu, die Sie in die Aktion übergeben möchten.

      Diese Eigenschaften werden in der Aktivität „Create App Task“ angezeigt, wenn diese App aus der Dropdownliste „Apps“ ausgewählt wird. Mit Eingabeeigenschaften können Sie Daten von Ihrer Studio-Automatisierung an Ihre Aktion übergeben.

   3. Fügen Sie für Ausgabeeigenschaften Eigenschaften für Argumente hinzu, die Sie von der Aktion abrufen möchten.

      Auf diese Eigenschaften kann über die Aktivität Wait for App Task and Resume über die Variable Task Object (Output) zugegriffen werden.

   4. Fügen Sie für Eingabe-/Ausgabeeigenschaften Eigenschaften hinzu, die als In-/Out-Argumente in Ihrer Studio-Automatisierung fungieren.

      Diese Eingabe-/Ausgabeeigenschaften erscheinen zuerst als Eigenschaften in der Aktivität Create App Task , die Sie an die Aktion übergeben. Und nachdem die Aktion abgeschlossen ist, können Sie auf dieselben Eigenschaften zugreifen, die über die Aktivität Wait for App Task and Resume über die Eigenschaft Aufgabenobjekt (Ausgabe) aktualisiert wurden.

2. Fügen Sie das Validierungssteuerelement hinzu und passen Sie es an

Ein Validierungssteuerelement enthält die Validierungsstation, die in Workflows zur Dokumentverarbeitung verwendet wird. Führen Sie die folgenden Schritte aus, um ein Validierungssteuerelement innerhalb einer Aktions-App hinzuzufügen und anzupassen:

1. Öffnen Sie die gewünschte Action-App, in die Sie die Validation Station integrieren möchten.
2. Wählen Sie Toolbox öffnen aus.
3. Suchen Sie unter Anzeige das Validierungssteuerelement und fügen Sie es zu Ihrer App hinzu.
   Durch Hinzufügen des Validierungssteuerelements zu Ihrer App wird automatisch eine Var<ValidationControl_PageName> -Variable im Abschnitt App-Variablen im Projekt-Explorer Ihrer App erstellt.
   Hinweis: Sie können das Validierungssteuerelement und die entsprechende App-Variable verwenden, um Informationen aus dem Validierungssteuerelement zu lesen. Verwenden Sie die App-Variable Var<ValidationControl_PageName> , um Informationen hineinzuschreiben.
4. Bereiten Sie das Aktionsschema vor:
   1. Wählen Sie im Projekt-Explorer unter Aktion die Option ActionSchema aus.
   2. Wählen Sie in den Eingabeeigenschaften die Option Eigenschaft hinzufügen aus.
   3. Wählen Sie in der Eigenschaftssuchleiste Weitere Optionen aus.
   4. Wählen Sie unter Erweitert die Option Inhaltsvalidierungsdaten aus.
      Dies ist die Eingabeeigenschaft, die in der Aktivität „Create App Task“ angezeigt wird. Die Eingabeeigenschaft ContentValidationData erfordert ein ContentValidationData -Objekt als Eingabe, das ein einzelnes Objekt oder ein Array/eine Liste von ContentValidationData -Instanzen sein kann. ContentValidationData enthält die Artefakte der Validation Station. ContentValidationData wird mit der Aktivität Create Document Validation Artifacts erstellt.
5. Konfigurieren Sie das Validierungssteuerelement:
   1. Wechseln Sie zu den Eigenschaften des Validierungssteuerelements.
   2. Wählen Sie in der Eingabe Quelle die Aktionseingabe aus, die Sie als ContentValidationData -Typ definiert haben.
6. Konfigurieren Sie den Rest der App mit anderen Steuerelementen, die Sie benötigen.

3. Greifen Sie auf Validierungssteuerelementdaten und deren Eigenschaften zu

Auf verschiedene Eigenschaften des Validierungssteuerelements, z. B. Taxonomie, Extraktionsergebnis, ausgewählter Dokumenttyp, ausgewähltes Feld und Datenquelle, kann mit der Validierungssteuerelement-Variable (VarValidationControl_PageName) zugegriffen werden. Sie können die im Validierungssteuerelement angezeigten Werte über die entsprechende App-Variable ändern. Führen Sie die unter Validierungssteuerelementdaten bearbeiten beschriebenen Schritte aus, um einen Feldwert hinzuzufügen, zu ändern oder zu entfernen.

In der folgenden Tabelle werden die Eigenschaften beschrieben, auf die Sie über das Validierungssteuerelement zugreifen können, ihr Datentyp und Beschreibungen.

Tabelle 1. Eigenschaften des Validierungssteuerelements

Eigenschaften	Datentyp	Beschreibung
Taxonomy	UiPath.DocumentProcessing.Contracts.Taxonomy.DocumentTaxonomy	Das Taxonomieobjekt, mit dem der Inhalt für die Anzeige vorbereitet wurde. Es enthält Informationen zu Dokumenttypen, Feldern und Anzeigeeigenschaften.
Extraktionsergebnis	UiPath.DocumentProcessing.Contracts.Results.ExtractionResult	Die Extraktionsergebnisse, wie sie sind (mit oder ohne menschliche Änderungen), aus der Validierungskontrolle.
AusgewählterDokumenttyp	System.String	Der Name des aktuell im Validierungssteuerelement ausgewählten Dokumenttyps.
SelectedField	UiPath.DocumentProcessing.Contracts.Apps.FieldValueDetails	Das aktuell im Validierungssteuerelement ausgewählte Feld zusammen mit seinem Wert.
DataSource	UiPath.DocumentProcessing.Contracts.Actions.ContentValidationData	Die Inhaltsvalidierungsdaten, die derzeit die Quelle des Validierungssteuerelements sind.
Hidden	boolean	Der Status der Steuerelementeigenschaft, der bestimmt, ob das Steuerelement sichtbar oder ausgeblendet ist.
Disabled	boolan	Der Status der Steuerelementeigenschaft, der bestimmt, ob das Steuerelement bearbeitbar ist oder nicht.
IsValid	boolean	Überprüft die Gültigkeit des Werts der Validierungssteuerung. „true“ gibt an, dass sie gültig ist.

4. Bearbeiten Sie die Validierungssteuerelementdaten

Sie können die im Validierungssteuerelement angezeigten Werte über die entsprechende App-Variable ändern. Sie können beispielsweise die im Validierungssteuerelement angezeigten Extraktionsergebniswerte über die entsprechende App-Variable ändern.

Das folgende Beispiel zeigt, wie Sie einen regulären Feldwert aktualisieren:

1. Wählen Sie ein beliebiges Steuerelement in Ihrer App aus und wechseln Sie zu Ereignisse.
2. Wählen Sie Automatisierung definieren aus.

   Diese Aktion öffnet das Designer-Panel von Studio Web, in dem Sie eine Trigger-Automatisierung für ein bestimmtes App-Steuerelement erstellen können.

3. Um im Kontext der Extraktionsergebnisse des Dokuments einen Feldwert für reguläre Felder hinzuzufügen oder zu ändern, fügen Sie eine Aktivität Set Variable Value in der Automatisierung hinzu.
   1. Verwenden Sie für das Feld An-Variable AppVariable.VarValidationControl_PageName.Field("<field name>").Value.
      Dieser Ausdruck stellt das Feld dar, das Sie ändern möchten, auf das über die Variable VarValidationControl_PageName zugegriffen wird.
   2. Geben Sie im Feld An den gewünschten Wert für das referenzierte Feld ein.
   Neben regulären Feldern kann die Variable AppVariable.VarValidationControl_PageName auch Felder mit mehreren Werten mit AppVariable.VarValidationControl_PageName.Field("<field name>", <index>) bearbeiten und mit Tabellenzellen interagieren, indem sie AppVariable.VarValidationControl_PageName.Field("<table field name").Field("<column name>", <row index>) verwendet.
   Um Werte zu löschen, wählen Sie den Zielwert in ähnlicher Weise aus und verwenden Sie das Flag .DeleteValue , das auf True festgelegt ist.

   Zu den Eigenschaften von Werten, die Sie im Validierungssteuerelement aktualisieren können, gehören:

   • Textwert (.Value)
   • Bestätigter Status (.Confirmed)
   • Konfidenzniveau des Werts (.Confidence)
   • Löschmarkierung (.DeleteValue)
   • Flag zum Entfernen eines Wertverweises (.KeepReference)

Sie können die gleichen Schritte zum Ändern anderer Validierungssteuerelement-Daten zur Laufzeit verwenden. Der einzige Unterschied besteht darin, dass Sie eine andere Variable im Feld An-Variable verwenden, sodass sie den Validierungssteuerungsdaten entspricht, die Sie ändern möchten. Sie können beispielsweise die Variable AppVariable.ValidationControl.SelectedDocumentType verwenden, wenn Sie sie mit einem anderen Wert aktualisieren möchten.

Abbildung 1. Die Set Variable Value -Aktivitäten, mit denen Sie Daten aus dem Validierungssteuerelement aktualisieren können

5. Erstellen Sie Ereignisse für das Validierungssteuerelement

Sie können verschiedene Ereignisse auslösen, die für das Validierungssteuerelement spezifisch sind. Navigieren Sie im Projekt-Explorer zum Validierungssteuerelement und wählen Sie es aus. Im Ereignisbereich des Validierungssteuerelements können Sie Automatisierungen für bestimmte Ereignisse definieren.

In der folgenden Tabelle werden die verfügbaren Validierungssteuerungsereignisse beschrieben:

Tabelle 2. Validierungssteuerungsereignisse

Ereignis (Event)	Beschreibung
Wenn bereit	Wird ausgelöst, wenn das Validierungssteuerelement geladen wird.
Dokumenttyp geändert	Wird ausgelöst, wenn der Benutzer den Dokumenttyp im Validierungssteuerelement ändert.
Feld ausgewählt	Wird ausgelöst, wenn der Benutzer eines der Felder oder den Wert eines Felds im Validierungssteuerelement auswählt.
Feldwert geändert	Wird ausgelöst, wenn der Benutzer einen Feldwert im Validierungssteuerelement hinzufügt, entfernt oder ersetzt.

6. Verwenden Sie dedizierte Validierungssteuerungsaktivitäten

Sie können bestimmte Aktivitäten für die Arbeit mit dem Validierungssteuerelement aus dem Paket AppEvents.Activities verwenden:

1. Feldfokussierung der Validierungssteuerung festlegen: Ermöglicht es Ihnen, sich basierend auf einem konfigurierten Ereignis auf ein Feld zu konzentrieren.
2. Validierungssteuerelementstatus speichern: Speichert den Status des Validierungssteuerelements. Sie können dies verwenden, wenn Sie die Validierung später erneut aufrufen und abschließen möchten.

Allgemeine Ausdrücke für das Validierungssteuerelement

Wenn Sie Ihre App erstellen, die ein Validierungssteuerelement enthält, können Sie die folgenden Ausdrücke verwenden, um auf verschiedene Daten zuzugreifen, die vom Validierungssteuerelement verfügbar gemacht werden. In der folgenden Tabelle werden die gängigsten Ausdrücke beschrieben, die Sie bei der Arbeit mit dem Validierungssteuerelement verwenden können:

Tabelle 3. Gängige Ausdrücke für das Validierungssteuerelement

Zweck	Ausdruck
Zugriff auf Extraktionsergebnisse, die im Validierungssteuerelement angezeigt werden	AppVariable.VarValidationControl_PageName.ExtractionResult Hauptseite.Validierungssteuerung.Extraktionsergebnis
Greifen Sie auf die im Validierungssteuerelement geladene Taxonomie zu	AppVariable.VarValidationControl_PageName.Taxonomy MainPage.ValidationControl.Taxonomy
Greifen Sie im Validierungssteuerelement auf das ausgewählte Feld zu	AppVariable.VarValidationControl_PageName.SelectedField MainPage.ValidationControl.SelectedField Die Eigenschaften des ausgewählten Felds können sein: Field.FieldName – Feldname. Field.FieldType – Feldtyp. Field.ValidatorNotes – Die Validierungshinweise des Felds. Field.Values – Alle Werte eines ausgewählten Felds. Field.Value – Informationen zum Feldwert: FieldValue.Value FieldValue.Confidence FieldValue.OperatorConfirmed FieldValue.FieldValueIndex (für Felder mit mehreren Werten wird der Index zurückgegeben, zu dem der ausgewählte Feldwert gehört).
Greifen Sie auf zusätzliche Eigenschaften des Validierungssteuerelements zu	MainPage.ValidationControl.<PropertyName>
Lesen Sie die Daten der Extraktionsergebnisse	Verwenden Sie die von der Klasse Extraktionsergebnis (Extraction Result) offengelegten Methoden.
Lesen Sie Taxonomiedaten	Verwenden Sie die von der Taxonomieklasse verfügbar gemachten Methoden.
Greifen Sie auf einen Feldwert zu, um ihn im Validierungssteuerelement zu aktualisieren	AppVariable.<ValidationControlVariable>.Field("<FieldName>").Value
Rufen Sie die Liste der im Validierungssteuerelement angezeigten Feldnamen ab	AppVariable.<ValidationControlVariable>.ExtractionResult.GetFields().Select(Function(f) f.FieldName)

6. Veröffentlichen und stellen Sie die App bereit

Nachdem Sie Ihre Aktions-App erstellt und Automatisierungen für darin enthaltene Steuerelemente ausgelöst haben, können Sie sie veröffentlichen. Durch das Veröffentlichen der App kann sie zum Erstellen von App-Aktionen verwendet werden. Weitere Informationen zum Veröffentlichen von Apps finden Sie unter Veröffentlichen, Bereitstellen und Upgraden von App-Projekten.

2. Erstellen Sie eine Studio-Automatisierung

Voraussetzungen

• Installieren Sie die folgenden Aktivitätspaketversionen:
  • IntelligentOCR.Activities Version 6.24.0
  • Persistence.Activities Version 1.5.5 oder höher.
  • AppEvents.Activities-Version 3.12.0 oder höher.
• Erstellen Sie einen Speicher-Bucket im Orchestrator, in demselben Ordner, in dem Sie die Automatisierung der Dokumentverarbeitung veröffentlichen möchten.

  Daten, die zum Laden der Validierungssteuerung in Apps erforderlich sind, werden in einem Orchestrator Speicher-Bucket gespeichert.

• Fügen Sie das Dokument hinzu, das Sie im Studio-Projektordner verarbeiten möchten.
• Wenn Sie generative Extraktions- oder Validierungsfunktionen verwenden möchten, benötigen Sie optional bestimmte Diensteinheiten
  • Wenn Sie sich für den Flex-Plan angemeldet haben, benötigen Sie AI Units

  Weitere Informationen zu den generativen Funktionen von Document Understanding finden Sie unter Generative Funktionen.

1. Verarbeiten Sie eine Datei mit Document Understanding

Fügen Sie Aktivitäten hinzu, die Document Understanding verwenden, um eine Datei zu verarbeiten. Bereiten Sie das Dokument mithilfe von Digitalisierung und Extraktion über Apps auf die Validierung im Action Center vor.

Nach dem Hinzufügen der Aktivitäten zum Verarbeiten der Datei sollten die folgenden Variablen verfügbar sein:

• DocumentTaxonomy (Taxonomie): Wird über die Aktivität Load Taxonomy abgerufen.
• Dom (Document Object Model) und text (Dokumenttext): Wird über die Aktivität Digitize Document bezogen.
• doc (Dokumentpfad): Stellt den Pfad zur verarbeiteten Datei dar.
• autoExtractionResults (ExtractionResults): Dies ist die Ausgabe der Aktivität Data Extraction Scope , unabhängig von den verwendeten Extraktionsmethoden.

2. Senden Sie die Validierungsinformationen an die App

Nachdem das Dokument für die Validierung bereit ist, können Sie alle Informationen vorbereiten, die an die zuvor erstellte und bereitgestellte App gesendet werden sollen. Befolgen Sie diese folgenden Schritte:

1. Fügen Sie eine Aktivität Create Document Validation Artifacts hinzu, um das Content Validation Data -Objekt zu erstellen, in dem die Informationen gespeichert werden, die zum Laden des Validierungssteuerelements in der Aktions-App erforderlich sind.
   Konfigurieren Sie in diesem Beispiel die Aktivität mithilfe der zuvor erstellten oder ausgegebenen Variablen:

   • Bucket-Ordnerpfad: Der Name des Orchestrator-Ordners, in dem der Speicher-Bucket erstellt wurde.
   • Bucket-Name: storageBucketName
   • Bucket-Verzeichnispfad: Der Verzeichnispfad innerhalb des zuvor eingegebenen Speicher-Buckets, in dem Sie Aktionsdaten speichern möchten.
   • Dokumentpfad: doc
   • Dokumenttext: text
   • Dokumentobjektmodell: dom
   • Taxonomie: taxonomy
   • Ergebnisse der automatischen Extraktion: autoExtractionResults
2. Fügen Sie eine Aktivität Create App Task hinzu, sodass Sie das Content Validation Data -Objekt an die zuvor entworfene App binden und dann zur Validierung an das Action Center senden können.

   In diesem Beispiel konfigurieren Sie die Aktivität wie folgt:

   • Titel: CVD
   • Priorität: Medium
   • Apps: Demo.Validation.Control.in.Apps
   • App-Version: v2.0.0

     Nachdem Sie die App und die entsprechende Version ausgewählt haben, die Sie zum Erstellen der Aktion verwenden möchten, werden die Eingabeeigenschaften dieser App im Textkörper der Aktivität angezeigt.

     • In diesem Beispiel ist eine der Eingabeeigenschaften Action_Content_Validation_Data, die die zuvor erstellten Dokumentvalidierungsartefakte erfordert: contentValidationData.
   Abbildung 2. Die Aktivität Create App Task
   

   

   
   
3. Fügen Sie eine Wait for App Task and Resume -Aktivität hinzu, um die Informationen über die Aktion zurückzugeben und den Workflow fortzusetzen.

   Geben Sie im Feld Erstellte App-Aufgabe die Ausgabevariable der Aktivität Create App Task ein.

4. Fügen Sie eine Aktivität Retrieve Document Validation Artifacts hinzu, um die Dokumentvalidierungsartefakte zurückzugeben, nachdem der Benutzer die Validierung im Action Center durchgeführt hat.

   Übergeben Sie die Ausgabevariable der Aktivität Create Document Validation Artifacts als Eingabe der Aktivität Retrieve Document Validation Artifacts .

   Tipp: Sie können auch dedizierte Ausgabevariablen für zusätzliche Informationen erstellen, die in den Validierungsartefakten gespeichert sind, z. B. AutomaticExtractionResults und ValidatedExtractionResults.

3. Führen Sie die Validierung im Action Center durch

1. Öffnen Sie das Action Center und wechseln Sie zu Meine Aktionen oder Aktionen verwalten.
2. Suchen Sie auf der Registerkarte Nicht zugewiesen die Aktion, die Sie gerade mit der vorherigen Studio-Automatisierung erstellt haben.
3. Wenn Sie die Aktion sich selbst zuweisen möchten, wählen Sie die gewünschte Aktion und dann Sich selbst zuweisen aus.
4. Wenn Sie die Aktion einem anderen Benutzer zuweisen möchten, wählen Sie Weitere Optionen für die gewünschte Aktion aus. Wählen Sie dann Dem Benutzer zuweisen aus und wählen Sie einen Benutzer aus der Dropdownliste aus.
5. Wechseln Sie zur Registerkarte Ausstehend und schließen Sie die Aktion ab, sodass der Studio-Workflow fortgesetzt werden kann.