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.

Abbildung 1. Übersicht über den Taxonomiemanager im Studio-Menüband

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.

Abbildung 2. Der Taxonomiemanager vor der Zuordnung von Dokumenttypen oder Feldern

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 die Eingabetaste speichern.

Erstellen einer Kategorie

Sobald eine Gruppe definiert und ausgewählt wurde, können Sie eine Kategorie und/oder einen Dokumenttyp innerhalb der Gruppe erstellen, indem Sie deren definierte Schaltflächen verwenden. Wählen Sie Speichern oder verwenden Sie die Eingabetaste, um die Konfiguration zu speichern.

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 wählen Sie dann den Dokumenttyp aus.

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

Hinweis: Wenn eine Document Understanding-Aktion vom Orchestrator während der Verwendung von Studio-Version 2020.10 eingereicht wird, Stellen Sie sicher, dass die Taxonomie keine Dokumenttypen enthält, die 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. Sobald die Schaltfläche Feld ausgewählt wurde, können Sie einen Namen dafür eingeben und dessen Typ aus der Dropdownliste auswählen.

Die Kategorie Feld verfügt über zwei Registerkarten: Details und Regeln. Die Registerkarte Details enthält Informationen über das ausgewählte Feld, z. B. den Feldnamen, den zugewiesenen Hotkey oder den Feldtyp, während Sie auf der Registerkarte Regeln Regeln erstellen können, die durch das Extraktionsergebnis für das Feld erfüllt werden müssen.

Die verfügbaren Feldtypen sind die folgenden:

• 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 (MicroSoft Developer Network) 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
• Address
• Set - Wenn Sie diesen Typ auswählen, können Sie dem Feld mehrere Werte aus einer vorab festgelegten Liste hinzufügen.
• Boolescher
• Tabelle - Bei Auswahl dieses Typs 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, wählen Sie es aus, 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 Nachweis im Dokument verarbeitet werden können (Erfordert Referenz). Die Mehrfachwertoption ermöglicht, dass ein Feld mehrere Werte hat, 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. Sie möchten z. B. 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 auch den Typ des Felds aus der Dropdownliste auswählen oder einen Standardwert hinzufügen. Verwenden Sie das Feld Standardwert , um Werte zu definieren, die im Extraktionsergebnis ausgefüllt werden sollen, wenn für das im Dokument identifizierte Feld kein Wert vorhanden ist.

Abbildung 3. Übersicht über die Registerkarte Details eines Felds

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 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 bei der Ausführung Ihres Workflows automatisch zu validieren. Ihre Rolle besteht darin, die Extraktionseffizienz zu erhöhen und Ihnen zu helfen, die Felder, die in der Validation Station Aufmerksamkeit erfordern, einfach zu validieren, indem sie hervorgehoben werden. 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.

Tabelle 1. Tabelle mit Auswertertypen, ihren Beschreibungen und Beispielen

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 Klasse ExtractionResult Class verwenden, die sich im Aktivitätspaket „UiPath.DocumentProcessing.Contracts“ befindet.

Tabelle 2. Tabelle mit Kritikalitätsstufen und ihren Beschreibungen

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 Date nur die beiden Regeltypen Ist nicht leer und Mögliche Werte anzeigt.

Regeltyp

Die folgende Tabelle zeigt Details für jeden verfügbaren Regeltyp, klassifiziert nach der Kritikalitätsstufe und dem Bewertertyp.

Tabelle 3. Regeltypen und ihre Beschreibungen, abhängig von der Kritikalitätsstufe und dem Bewertertyp

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 der folgenden Typen: 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. ist der Arbeitgebertyp entweder „Vollzeit“, „Teilzeit“ oder „Praktisch“).	Gilt für Felder der folgenden Typen: 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 vom Typ 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. Sehen Sie sich die folgenden Beispiele an: 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 der folgenden Typen: 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 der folgenden Typen: 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 der folgenden Typen: 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 der folgenden Typen: 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 der folgenden Typen: 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 der folgenden Typen: 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. Wir erstellen eine Reihe von Regeln für das Adressfeld des Dokuments. Sehen Sie sich die folgenden Beispielschritte an, um zu erfahren, wie Sie eine neue Regel oder einen Satz von Regeln für ein Feld erstellen können:

1. Wählen Sie ein Feld im Taxonomiebereich aus.
2. Wechseln Sie zur Registerkarte Regeln .
3. Wählen Sie Neue hinzufügen aus, um eine neue Regel hinzuzufügen.
4. Geben Sie die Regel full address ein, für die der Typ Contains und der Ausdruck st, str, street ist.
5. Wählen Sie den Auswertertyp aus.

   Wählen Sie in diesem Beispiel ODER aus.

6. Wählen Sie die Kritikalitätsstufe aus.

   Wählen Sie in diesem Beispiel MUST aus.

7. Wählen Sie Neu hinzufügen aus.
8. Geben Sie die Regel phone number ein, für die der Typ Ist nicht leer ist.
9. Wählen Sie Neu hinzufügen aus.
10. Geben Sie die Regel city or state ein, für die der Typ Contains und der Ausdruck city, state ist.

Das folgende animierte Bild zeigt die zuvor beschriebenen Schritte.

Abbildung 4. Animiertes Bild, das zeigt, wie Sie drei Regeln für ein Feld hinzufügen

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:

• Wählen Sie Löschen aus , beim übergeordneten Element des Objekts, das Sie löschen möchten.
• Wählen Sie Löschen aus beim Auswählen des Objekts, das Sie löschen möchten.

In beiden Fällen wird ein Popup angezeigt, in dem Sie aufgefordert werden, die Löschen-Aktion zu bestätigen. Wählen Sie Löschen aus, um die Aktion zu bestätigen.

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 Verknüpfung zur Bereitstellung von Werten für Felder zu verwenden. Weitere Informationen darüber, wie Sie die Feldverknüpfungen verwenden, um einem Feld Werte zuzuweisen, finden Sie in der Validation Station .

Um einem Feld eine Farbe und einen Hotkey zuzuweisen, wählen Sie das Feld und einen bestimmten Farbcode im Feld Farbe aus. Wählen Sie dann einen bestimmten Hotkey aus dem Hotkey- Menü aus.

Navigieren Sie mithilfe der Tastenkombinationen durch den Taxonomiemanager. Wählen Sie Verfügbare Tastenkombinationen anzeigen aus und aktivieren Sie die Option Tastenkombinationen umschalten, um ein versehentliches Auslösen der Tastenkombinationen zu vermeiden. Knoten können auch reduziert werden.

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