Validieren von Dokumenten mit App-Aktionen

Diese Schnellstartanleitung hilft Ihnen, mit der Validierung von Dokumenten zu beginnen, indem Sie die Validation Station in UiPath®-Aktions-Apps hinzufügen und sie dann zur Validierung über das Action Center als App-Aktionen 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 dieses Tutorials verwendet wird, ist ein Krankenversicherungsformular 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 serverlose Robotervorlage wird im Orchestrator erstellt und bereitgestellt. Weitere Informationen zu serverlosen Robotern und dem 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 , um ein neues Projekt zu erstellen.
3. Wählen Sie im Projekt-Explorer Ihrer App Seiten, Workflows, Steuerelemente, 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 Aktion und wählen Sie Aktionsschema aus. Konfigurieren Sie das Aktionsschema mit den gewünschten In- und Out-Argumenten für App-Aktionen im Action Center.
   1. Für Ergebnisse fügen Sie weitere benutzerdefinierte Ergebnisse hinzu, die die Aktion haben soll. Sie können beispielsweise ein benutzerdefiniertes Ergebnis namens „Genehmigen“ hinzufügen.
   2. Fügen Sie für Eingabeeigenschaften Eigenschaften für Daten hinzu, die Sie an 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 ist. Mithilfe von Eingabeeigenschaften können Sie Daten aus 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 Aufgabenobjekt (Ausgabe) zugegriffen werden.
   4. Fügen Sie für Eingabe-/Ausgabeeigenschaften Eigenschaften hinzu, die als Eingabe-/Ausgabeargumente in Ihrer Studio-Automatisierung fungieren. Diese Eingabe-/Ausgabeeigenschaften werden zuerst als Eigenschaften in der Aktivität Create App Task angezeigt, die Sie an die Aktion übergeben. Und dann, nachdem die Aktion abgeschlossen ist, können Sie über die Eigenschaft Aufgabenobjekt (Ausgabe) auf die gleichen Eigenschaften zugreifen, die von der Aktivität Wait for App Task and Resume 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.

3. Suchen Sie unter Anzeige das Validierungssteuerelement und fügen Sie es in Ihre App ein.

   Wenn Sie das Validierungssteuerelement zu Ihrer App hinzufügen, wird automatisch eine Var<ValidationControl_PageName> -Variable im Abschnitt App-Variablen vom 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 Aktionsschema aus.

   2. Wählen Sie in den Eingabeeigenschaften die Option Eigenschaft hinzufügen aus.

   3. Wählen Sie in der Eigenschaftensuchleiste Weitere Optionen aus.

   4. Wählen Sie unter Erweitert die Option ContentValidationData aus.

      Dies ist die Eingabeeigenschaft, die in der Aktivität „Create App Task“ angezeigt wird. Die Eingabeeigenschaft Inhaltsvalidierungsdaten 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 Quelleingabe 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

Verschiedene Eigenschaften des Validierungssteuerelements, wie z. B. Taxonomie, Extraktionsergebnis, ausgewählter Dokumenttyp, ausgewähltes Feld und Datenquelle, können mit der Variablen Validierungssteuerelement (VarValidationControl_PageName) aufgerufen 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.
ExtractionResult	UiPath.DocumentProcessing.Contracts.Results.ExtractionResult	Die Extraktionsergebnisse, wie sie sind (mit oder ohne menschliche Änderungen), aus der Validierungskontrolle.
SelectedDocumentType	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 den Designerbereich 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 .DeleteValue -Flag, 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 verwenden, um andere Validierungssteuerelementdaten zur Laufzeit zu ändern. Der einzige Unterschied besteht darin, dass Sie eine andere Variable im Feld An Variable verwenden, sodass sie den Validierungssteuerelementdaten 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 Bereich Ereignisse des Validierungssteuerelements können Sie Automatisierungen für bestimmte Ereignisse definieren.

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

Tabelle 2. Validierungssteuerelement-Ereignisse

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 verwenden, die für die Arbeit mit dem Validierungssteuerelement aus dem Paket AppEvents.Activities vorgesehen sind:

1. Feldfokus des Validierungssteuerelements festlegen: Ermöglicht es Ihnen, den Fokus auf ein Feld basierend auf einem konfigurierten Ereignis zu legen.
2. Status des Validierungssteuerelements speichern: Speichert den Status des Validierungssteuerelements. Sie können dies verwenden, wenn Sie die Validierung später noch einmal 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. Allgemeine Ausdrücke für Validierungssteuerelemente

Zweck	Ausdruck
Zugriff auf Extraktionsergebnisse, die im Validierungssteuerelement angezeigt werden	AppVariable.VarValidationControl_PageName.ExtractionResult MainPage.ValidationControl.ExtractionResult
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“ verfügbar gemachten 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 darin Automatisierungen für Steuerelemente ausgelöst haben, können Sie sie veröffentlichen. Durch das Veröffentlichen der App wird sie zum Erstellen von App-Aktionen verfügbar. Weitere Informationen zum Veröffentlichen von Apps finden Sie unter Veröffentlichen, Bereitstellen und Aktualisieren 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 im selben Ordner, in dem Sie die Dokumentverarbeitungsautomatisierung veröffentlichen möchten. Daten, die zum Laden des Validierungssteuerelements innerhalb von 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-Tarif 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): Über die Aktivität Load Taxonomy abgerufen.
• Dom (Dokumentobjektmodell) und text (Dokumenttext): Durch die Aktivität Digitize Document erworben.
• 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, das die Informationen speichert, 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 es dann zur Validierung an das Action Center senden können. Konfigurieren Sie die Aktivität in diesem Beispiel 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 Aktivität Wait for App Task and Resume 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 Retrie 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 Retrie je 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 und dann 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.