Taxonomie laden (Load Taxonomy)

UiPath.IntelligentOCR.Activities.TaxonomyManagement.LoadTaxonomy

Konvertiert die mit dem Taxonomiemanager erstellte Datei taxonomy.json in eine Variable, die mit anderen Aktivitäten weiterverwendet werden kann.

Eigenschaften

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.

Ausgabe

• Taxonomie – Die zu ladende Taxonomie, gespeichert in einer DocumentTaxonomy-Variable. Diese Ausgabe kann anschließend in Aktivitäten verwendet werden, die eine Taxonomie als Eingabe erhalten.
  Wichtig: Falls Sie eine Intel Xe GPU verwenden und der Taxonomiemanager nicht ordnungsgemäß angezeigt wird, empfehlen wir, den Grafiktreiber auf die neueste Version zu aktualisieren. Weitere Informationen finden Sie auf dieser Seite.

Taxonomie-Erweiterungsmethoden

Serialisieren (Serialize) ()

Bei Aufruf mit einem DocumentTaxonomy-Objekt gibt die Serialize()-Methode eine JSON-Darstellung des Objekts zurück, sodass es gespeichert und zur späteren Verwendung wieder aufgerufen werden kann.

Deserialisieren (Deserialize) (String))

Die statische Erweiterung DocumentTaxonomy.Deserialize(jsonString) gibt ein Objekt DocumentTaxonomy zurück, das die mit JSON verschlüsselten Daten enthält, die als Parameter übergeben wurden.

Felder abrufen (GetFields (String))

Bei Aufruf auf einem DocumentTaxonomy -Objekt gibt die GetFields()-Methode, die mit einem DocumentTypeId-String aufgerufen wird, eine Liste von Feldern zurück, die in diesem Dokumenttyp definiert sind.

Der Taxonomiemanager kann verwendet werden, um eine Taxonomiedatei speziell für Ihr aktuelles Automatisierungsprojekt zu erstellen und zu bearbeiten. Diese Taxonomiedatei enthält benutzerdefinierte Dokumenttypen, die in Gruppen und Kategorien angeordnet sind.

Sie können die Taxonomiedatei weiter verwenden, indem Sie sie mit der Aktivität Load Taxonomy in einen .NET-Datentyp konvertieren und sie dann als Eingabe für Aktivitäten übergeben, z. B.:

• Dokumentbereich klassifizieren (Classify Document Scope)
• Klassifizierer-Scope trainieren
• Train Extractors Scope
• Aktuelle Validierungsstation

Auf den Taxonomiemanager kann nur zugegriffen werden, nachdem Sie ein UiPath.IntelligentOCR.Activities-Paket höher oder gleich v1.6.0 als Abhängigkeit für Ihr Projekt installiert haben. Sobald das Paket installiert ist, wird auf dem Menüband die Schaltfläche Taxonomiemanager im Abschnitt Assistenten angezeigt.

Verwenden des Taxonomiemanagers

Im Taxonomiemanager-Fenster können Sie Dokumenttypen erstellen, angeordnet in Gruppen und Kategorien. Beim ersten Öffnen in einem Projekt sind keine Gruppen, Kategorien oder Dokumenttypen definiert.

Festlegen der Struktur

Der erste Schritt besteht darin, eine Gruppe oder einen Dokumenttyp zu erstellen. Der Unterschied zwischen den beiden besteht darin, dass bei einer Gruppe eine hierarchische Struktur herrscht, während ein Dokumenttyp als einzelne Datei erstellt werden kann. Ein komplexes Projekt umfasst Gruppen, Kategorien und Dokumenttypen, während ein einfaches Projekt nur einen oder zwei Dokumenttypen umfassen kann.

Erstellen einer Gruppe

Wenn eine Gruppe erstellt wird, ist auch eine Kategorie für den Dokumenttyp erforderlich, den Sie innerhalb der Gruppe erstellen möchten. Dies geschieht über die Schaltfläche Gruppe. Nachdem Sie einen Namen für Ihre Gruppe ausgewählt haben, können Sie ihn über die Schaltfläche Speichern oder einfach die Eingabetaste speichern.

Erstellen einer Kategorie

Sobald eine Gruppe definiert und ausgewählt wurde, können Sie mithilfe ihrer definierten Schaltflächen eine Kategorie bzw. einen Dokumenttyp innerhalb der Gruppe erstellen.

Erstellen eines Dokumenttyps

Ein Dokumenttyp kann entweder von einem Teil einer Gruppe oder als einzelnes Dokument erstellt werden. Wählen Sie beim Erstellen in einer Gruppe die Gruppe aus und klicken Sie dann auf die Schaltfläche Dokumenttyp.

Wenn der Dokumenttyp als einzelne Datei erstellt wird, stellen Sie sicher, dass keine Gruppe ausgewählt ist, und klicken Sie auf die Schaltfläche Dokumenttyp. Nachdem Sie auf die Schaltfläche Dokumenttyp geklickt haben, geben Sie einen Namen für die Datei ein und klicken auf die Schaltfläche Speichern.

Hinweis: Wenn eine Document Understanding-Aktion vom Orchestrator gesendet wird, während Studio v20.10 verwendet wird, stellen Sie sicher, dass in der Taxonomie keine Dokumenttypen ohne Kategorie erstellt wurden.

Wenn Sie einen bereits erstellten Dokumenttyp auswählen, können Sie seinen Namen ändern, seine eindeutige ID in die Zwischenablage kopieren, sie einer anderen Gruppe oder Kategorie neu zuweisen oder keiner von ihnen zuweisen. Sie können auch einen Code für den Dokumenttyp eingeben.

Sobald ein Dokumenttyp gespeichert wurde, wird eine Dokumenttyp-ID dafür generiert. Beim Öffnen des Dokuments zur Bearbeitung wird die ID neben der Registerkarte Dokumenttypname angezeigt. Die Dokumenttyp-ID hat eine Struktur vom Typ Group.Category.Document und kann in die Zwischenablage kopiert werden. Der Dokumenttyp-ID -Code ist eine optionale Funktion und kann verwendet werden, um Ihre Dokumente zu finden oder Ihre Dokumente den Dokumenttypen zuzuordnen, die Sie in der Taxonomie definieren.

Erstellen von Feldern

Wenn der Dokumenttyp ausgewählt wird, wird die Schaltfläche Feld verfügbar, mit der Sie ein neues Feld erstellen können. Nachdem Sie auf die Schaltfläche Feld geklickt haben, können Sie einen Namen dafür eingeben und dessen Typ aus der Dropdownliste auswählen.

Die Kategorie Feld hat zwei Registerkarten, Details und Regeln. Die Registerkarte Details enthält Informationen über das ausgewählte Feld, z. B. Feldname, zugewiesener Hotkey oder Feldtyp, während Sie auf der Registerkarte Regeln Regeln erstellen können, die vom Extraktionsergebnis für das Feld erfüllt werden müssen.

Die verfügbaren Feldtypen sind:

• Text
• Nummer
• Datum (Date) - Bei Auswählen dieses Typs können Sie außerdem das zu erwartende Format bestimmen. Dies ist optional.
  Hinweis:

  Wenn Sie ein erwartetes Format hinzufügen möchten, verwenden Sie ein MSDN-konformes Format.

  Dieses Format kann von Extraktoren verwendet werden und wird von der Aktivität Data Extraction Scope verwendet, wenn versucht wird, ein Datum in die Bestandteile „Tag“, „Monat“ und „Jahr“ aufzuschlüsseln.

• Name
• Adresse
• Festlegen – Wenn Sie diesen Typ auswählen, können Sie dem Feld mehrere Werte aus einer vordefinierten Liste hinzufügen.
• Boolescher
• Tabelle - Bei Auswahl dieser Tabelle können Sie die Struktur der Tabelle bearbeiten, Spalten hinzufügen und deren Namen und Typ bearbeiten.
  
  

  

  
  

Registerkarte „Details“

Nachdem das neue Feld erstellt wurde, klicken Sie darauf, um weitere Informationen anzuzeigen. Wenn Sie ein Feld öffnen, wird standardmäßig die Registerkarte Details angezeigt, auf der Sie den Namen, die Farbe oder den Hotkey des Felds ändern können. Sie können auch angeben, ob es sich um einen Mehrfachwert handelt (Ist Mehrfachwert) oder ob Werte ohne Beweise im Dokument verarbeitet werden können (Referenz erforderlich). Die Option für mehrere Werte ermöglicht es einem Feld, mehrere Werte zu haben, ohne auf eine bestimmte Liste beschränkt zu sein.

Weitere Informationen zum Verwenden der beiden Felder finden Sie in den folgenden Beschreibungen:

• Ist Mehrfachwert: Wenn ein Feld als Mehrfachwert festgelegt ist, können Sie mehrere Werte für dieses Feld abrufen. Beispiel: Sie möchten eine „Liste der Direktoren“ mit einer variablen Anzahl an Einträgen extrahieren. Stellen Sie sich ein Mehrfachwertfeld wie eine einspaltige Tabelle vor.
• Erfordert Referenz: Wenn eine Referenz für ein Feld erforderlich ist, können Sie ihm nur dann einen Wert hinzufügen, wenn Sie ein Element im Dokument auswählen, das in der Validation Station angezeigt wird. Bei speziellen Feldern, in denen Sie Werte erfassen möchten, die eventuell im Dokument nicht sichtbar sind, können Sie Erfordert Referenz auf aus festlegen. Dann kann der Benutzer einen Wert hinzufügen, ohne eine Stelle im Dokument anzugeben, aus welcher der Wert stammt.

Sie können Validierungshinweise auf der Registerkarte Details aktivieren. Durch das Einrichten von Validierungshinweisen kann menschlicher Validierer Hinweise zu der Entscheidung hinzufügen, die er während der Validierung getroffen hat. Sie können die folgenden Einstellungen konfigurieren:

• Schreibgeschützt: Wenn diese Option aktiviert ist, kann der menschliche Validierer alle Validierungshinweise, die für das Feld „ Extraktionsergebnis “ in der Validation Station festgelegt wurden, als Meldung anzeigen. Wenn diese Option deaktiviert ist (Standardstatus), kann der menschliche Validierer diesen Hinweis auch in der Validation Station bearbeiten und so Informationen über die getroffene Entscheidung an den Roboter zurückgeben.
• Text: Wenn Text ausgewählt ist, wird der Validierungshinweis als Textnachricht (oder als bearbeitbarer Text, wenn die Bearbeitung aktiviert ist) in der Validierungsstation angezeigt. Der menschliche Validierer kann maximal 200 Zeichen Nachrichten in der Validierungsstation anzeigen, bearbeiten oder hinzufügen.
• Optionen: Wenn Sie Optionen auswählen, können Sie eine Reihe von Optionsfeldern konfigurieren, die der menschliche Validierer anzeigen und, wenn nicht schreibgeschützt, in der Validierungsstation auswählen kann. Sie können maximal 10 Optionen hinzufügen.

Tipp: Auf der Seite ExtractionResult-Klasse im Abschnitt UiPath.DocumentProcessing.Contracts finden Sie weitere Informationen zu den beiden Methoden im Zusammenhang mit Validierungshinweisen, GetFieldValidatorNotes(<fieldId>) und SetFieldValidatorNotes(<fieldId>, <validatorNote>).

Erstellte Felder können mit der entsprechenden Schaltfläche gelöscht werden, die daneben angezeigt wird. Sie können auch mit der Drag-and-drop-Funktion neu angeordnet werden.

Ein Feld kann auch aus dem Fenster Details gelöscht werden, indem Sie die Schaltfläche Löschen auswählen.

Durch Wiederholen dieser Schritte können Sie mehrere Gruppen, Kategorien und Dokumenttypen erstellen und dann mithilfe des Feldes Suchen filtern.

Registerkarte „Regeln“

Feldregeln helfen Ihnen, die Extraktionsergebnisse zu optimieren und sie beim Ausführen Ihres Workflows automatisch zu validieren. Ihre Rolle besteht darin, die Extraktionseffizienz zu erhöhen und Ihnen zu helfen, die Felder, die Ihre Aufmerksamkeit erfordern, in der Validation Station einfach zu validieren, indem Sie sie hervorheben. Sie können mehrere Regeln erstellen, die für ein Feld gelten.

Sie definieren eine Regel, indem Sie den Auswertungstyp und die Kritikalitätsstufefestlegen.

Auswertertyp

Verwenden Sie den Auswertungstyp, um anzugeben, wie die definierten Regeln ausgewertet werden sollen. Es gibt zwei Evaluatortypen, aus denen Sie wählen können: AND, OR.

Auswertertyp	Beschreibung	Beispiel
AND	Verwenden Sie diesen Auswertungstyp, wenn alle Regeln ausgeführt werden müssen.	Regel : Rechnungsnummer beginnt mit A und endet mit X. Gültiges Ergebnis : Der gültige Feldwert ist A123X. Ungültiges Ergebnis: Der gültige Feldwert ist A123.
ODER	Nur eine der Regeln muss ausgeführt werden.	Regel : Rechnungsnummer beginnt mit A ODER ist 123. Gültiges Ergebnis: Der gültige Feldwert ist A123, 123. Ungültiges Ergebnis: Der gültige Feldwert ist 234, 1A23.

Kritikalitätsstufe

Gibt die Kritikalität aller Regeln an, die für ein Feld definiert sind. Sie können keine MUSS -Stufe festlegen, wenn die Regel in der Validation Station-Sitzung verletzt wird. Es gibt zwei Kritikalitätsstufen, aus denen Sie wählen können: MUSS, SOLL.

Die erstellte Regel wird ausgelöst, sobald die festgelegte Kritikalitätsstufe identifiziert wurde.

Wenn Sie eine Regel senden möchten, erfordert eine MUSS- Regel 100 % Erfolg, andernfalls schlägt der Vorgang „Senden“ fehl. Mit einer SOLL- Regel können Sie sie auch dann einreichen , wenn die Regel verletzt wird.

Sie können jederzeit überprüfen, ob eine Regel verletzt wird, indem Sie die Hilfsmethode aus der ExtractionResult-Klasse verwenden, die sich im Aktivitätspaket UiPath.DocumentProcessing.Contracts befindet.

Kritikalitätsstufe	Beschreibung
MUST	Verwenden Sie diese Kritikalitätsstufe, wenn die erstellte Regel unbedingt in den Extraktionsergebnisprozess aufgenommen werden muss.
SHOULD	Verwenden Sie diese Kritikalitätsstufe, wenn die erstellte Regel optional ist.

Nachdem Sie den Evaluator-Typ und die Kritikalitätsstufeausgewählt haben, müssen Sie einen Typ festlegen, der für Ihre neu erstellte Regel gilt. Es gibt mehrere Optionen, aus denen Sie wählen können. Hier ist eine vollständige Liste mit allen verfügbaren:

• Ist nicht leer
• Mögliche Werte
• Beginnend mit (Starts with)
• Endend mit (Ends with)
• Enthält
• Feste Länge
• Ist E-Mail
• RegEx
  Hinweis: Der Feldtyp, für den Sie eine Regel erstellt haben, bestimmt die Anzahl der möglichen Regeltypen, aus denen Sie einen auswählen können. Beispielsweise zeigt ein Feld vom Typ Text alle möglichen Regeltypen an, während ein Feld vom Typ Datum nur zwei Regeltypen anzeigt: Ist nicht leer und Mögliche Werte.

Regeltyp

Hier ist eine Liste mit allen verfügbaren Regeltypen, klassifiziert nach der Kritikalitätsstufe:

Regeltyp	Beschreibung	Feldtyp	Kritikalitätsstufe	Auswertertyp
Ist nicht leer	Der extrahierte Wert darf nicht leer sein, d. h. das Feld ist ein Pflichtfeld. Wenn der Wert fehlt, ist eine Validierung/manuelle Eingabe erforderlich.	Gilt für Felder des Typs: Nummer text Datum Adresse name FESTLEGEN boolean	MUST SHOULD	AND ODER
Mögliche Werte	Der Benutzer definiert alle möglichen Werte und die extrahierten Daten sind einer der Werte, die beim Erstellen der Regel als Eingabe hinzugefügt wurden (z. B Arbeitgebertyp ist entweder „Vollzeit“, „Teilzeit“ oder „Praktikum“).	Gilt für Felder des Typs: Nummer text Datum	MUST SHOULD	AND ODER
Ausdruck	Definieren Sie mathematische Ausdrücke, die als Regel zum Extrahieren von Daten fungieren.	Gilt für Felder des Typs: Nummer Beim Konfigurieren der Regel ist eine Bedingung erforderlich. Wählen Sie eine der folgenden Optionen: Ist gleich Ist nicht gleich Ist größer als Ist größer oder gleich Ist kleiner oder gleich Ein mathematischer Ausdruck ist erforderlich. Verwenden Sie die vordefinierten Operatoren, um Ihren Ausdruck zu definieren. Hier sind einige Beispiele: Summenmenge * Nettostückpreis\n- Gesamt = Zwischensumme + Lieferung Rabatt – Der Summenoperator sammelt alle Werte aus einer Tabellenspalte.	MUST SHOULD	AND ODER
Beginnend mit (Starts with)	Dies ist eine feste Regel, d. h. der extrahierte Wert muss mit einem der vom Benutzer hinzugefügten Werte beginnen.	Gilt für Felder des Typs: text Adresse name	MUST SHOULD	AND ODER
Endend mit (Ends with)	Dies ist eine feste Regel, was bedeutet, dass der extrahierte Wert mit einem der vom Benutzer hinzugefügten Werte enden muss.	Gilt für Felder des Typs: text Adresse name	MUST SHOULD	AND ODER
Enthält	Dies ist eine feste Regel, was bedeutet, dass der extrahierte Wert einen der vom Benutzer hinzugefügten Werte enthalten muss.	Gilt für Felder des Typs: text Adresse name	MUST SHOULD	AND ODER
Feste Länge	Das ist eine feste Regel, was bedeutet, dass der extrahierte Wert eine bestimmte feste Länge haben muss.	Gilt für Felder des Typs: text Adresse name	MUST SHOULD	AND ODER
Ist E-Mail	Dies ist eine feste Regel, was bedeutet, dass der extrahierte Wert in einem E-Mail-Format geschrieben werden muss.	Gilt für Felder des Typs: text Adresse name	MUST SHOULD	AND ODER
RegEx	Dies ist eine feste Regel, was bedeutet, dass der extrahierte Wert einen regulären Ausdruck enthalten muss, der einem der vom Benutzer hinzugefügten Werte ähnelt.	Gilt für Felder des Typs: text Adresse name	MUST SHOULD	AND ODER

Verwenden von Regeln

Sehen wir uns ein praktisches Beispiel an, um die Anwendbarkeit dieser Regeln besser zu verstehen. So erstellen Sie eine neue Regel oder einen Regelsatz für ein Feld:

Andere Optionen

Bearbeiten

Sie können den Namen einer jeden Gruppe, Kategorie oder eines jeden Dokumenttyps bearbeiten, den bzw. die Sie erstellt haben. Dazu kann eine der drei Konfigurationsebenen ausgewählt und das Feld Name bearbeitet werden.

Wird gelöscht…

Gruppen, Kategorien und Dokumenttypen können ebenfalls gelöscht werden. Es gibt zwei verfügbare Optionen:

• Klicken Sie auf die Schaltfläche .
  
  

  

  
  
• klicken Sie auf Klicken Sie auf die Schaltfläche „Löschen “ oben rechts im Fenster.
  
  

  

  
  

In beiden Fällen wird ein Popup angezeigt, in dem Sie aufgefordert werden, den Löschvorgang zu bestätigen. Klicken Sie auf Löschen , um die Aktion zu genehmigen, wie in den obigen GIFs gezeigt.

Anpassung und Barrierefreiheit

Dem neu erstellten Feld werden automatisch ein Hotkey und eine Farbe zugewiesen. Sie schaffen eine bessere Sichtbarkeit und schnellere Navigation durch Ihre Taxonomie. Passen Sie sie an, indem Sie auf den Hotkey oder das Farbcodefeld klicken.

Ein benutzerdefiniertes Feld mit Farbe und Hotkey kann die Validation Station und den Vorlagenmanager anweisen, die zugewiesene Farbe bei der Anzeige des Felds zu verwenden und den zugewiesenen Hotkey als Tastenkombination zur Bereitstellung von Werten für Felder zu verwenden. Hier finden Sie weitere Informationen darüber, wie Sie die Tastenkombinationen für Felder verwenden, um einem Feld Werte zuzuweisen.

Navigieren Sie mithilfe der Tastenkombinationen durch den Taxonomie-Manager. Aktivieren Sie die Option Tastenkombinationen umschalten, um das versehentliche Auslösen der Tastenkombinationen zu vermeiden. Knoten können auch mit nur einem Klick reduziert werden.

Hier ist eine bessere Ansicht aller verfügbaren Tastenkombinationen.

Hinweis: Die im Taxonomiemanager vorgenommenen Änderungen werden automatisch in der projektspezifischen Datei taxonomy.json gespeichert.