Taxonomieverwaltung

Wichtig:

Falls Sie einen 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.

Die Taxonomiemanager können 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.

Abbildung 1. 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 mithilfe ihrer definierten Schaltflächen eine Kategorie bzw. einen Dokumenttyp innerhalb der Gruppe erstellen. Wählen Sie Speichern aus oder verwenden Sie die Eingabetaste, um die Konfiguration zu speichern.

Erstellen eines Dokumenttyps

Ein Dokumenttyp kann entweder als 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 Dokumenttyp.

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 Sie Speichern aus.

Hinweis:

Wenn eine Document Understanding-Aktion vom Orchestrator während der Verwendung von Studio-Version 2020.10 eingereicht wird, sollten Sie sicherstellen, 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 oder sie einer anderen Gruppe oder Kategorie neu zuweisen. Sie können auch einen Code für den Dokumenttyp eingeben.

Once a document type is saved, a Document Type ID is generated for it. Opening the document for editing displays the ID next to the Document Type Name tab. The Document Type ID has a structure of the type Group.Category.Document and can be copied to the clipboard. The Document Type ID code is an optional functionality and it can be used to find your documents or map your documents to the Document Types that you define in the taxonomy.

Konfigurieren der Anzeigeeinstellungen für den Dokumenttyp

Nachdem Sie den Dokumenttyp erstellt haben, können Sie seine Anzeigeeinstellungen konfigurieren. Wählen Sie den Dokumenttyp im Taxonomiemanager aus und wechseln Sie zu Anzeigeeinstellungen. Sie können die folgenden Konfigurationen ändern:

• OCR-Konfidenzschwellenwert: Legen Sie einen Mindestkonfidenzschwellenwert auf Dokumenttypebene fest. Wenn das Dokument in der Validation Station angezeigt wird, müssten sowohl das OCR-Konfidenzniveau als auch das Extraktionskonfidenzniveau für ein Feld höher sein als der Schwellenwert, den Sie im Taxonomiemanager konfigurieren. Der Standardwert für den OCR-Konfidenzschwellenwert beträgt 90 %.

• Anzeigeformat des Datums: Das für den Dokumenttyp angezeigte Datumsformat.

  Der Standardwert ist YYYY-MM-DD.

• Dezimaltrennzeichen für Zahlen: Das Dezimaltrennzeichen für Zahlen, das Sie für den Dokumenttyp verwenden möchten.

• Tausendertrennzeichen: Das Tausendertrennzeichen, das Sie für den Dokumenttyp verwenden möchten.

Erstellen von Feldern

Wenn der Dokumenttyp ausgewählt wird, wird die Schaltfläche Feld verfügbar, um ein neues Feld zu erstellen. Sobald die Schaltfläche Feld ausgewählt ist, 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. Auf der Registerkarte Regeln können Sie Regeln erstellen, die durch das Extraktionsergebnis für das Feld erfüllt werden müssen.

Die folgenden Feldtypen sind verfügbar:

• Text

• Nummer

• Datum - 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 (MicroSoft Developer Network).

  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 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, wählen Sie es aus, um weitere Informationen anzuzeigen. Wenn Sie ein Feld öffnen, wird standardmäßig die Registerkarte Details angezeigt, sodass 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 (Referenz erforderlich). Mit der Option für mehrere Werte kann ein Feld mehrere Werte 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. Sie möchten beispielsweise 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.

Validierungseinstellungen

Unter Validierungseinstellungen haben Sie die Möglichkeit, einen Extraktionskonfidenzschwellenwert festzulegen. Dieser Schwellenwert wird bei der Validierung des Felds in der Validation Station berücksichtigt. Um einen Konfidenzschwellenwert für die Extraktion festzulegen, wechseln Sie zum Konfidenzschwellenwert der Extraktion und geben Sie einen Wert zwischen 0 und 100 ein.

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

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

• Schreibgeschützt: Wenn diese Option aktiviert ist, kann der menschliche Validierer alle Validierungshinweise anzeigen, die für das Feld Extraktionsergebnis in der Validierungsstation festgelegt wurden als Nachricht. Wenn diese Option deaktiviert ist (Standardstatus), kann der menschliche Validierer diesen Hinweis auch in der Validierungsstation 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 bearbeitbarer Text, wenn die Bearbeitung aktiviert ist) in der Validation Station 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 sie nicht schreibgeschützt sind, in der Validation Station auswählen können . 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 Aufgabe besteht darin, die Extraktionseffizienz zu erhöhen und Ihnen dabei zu helfen, die Felder, die in der Validierungsstation überprüft werden müssen, einfach zu validieren, indem sie hervorgehoben werden. Sie können mehrere Regeln erstellen, die für ein Feld gelten.

You define a rule by setting the Evaluator type and the Criticality level.

Auswertertyp

Use the Evaluator Type to specify how the defined rules should be evaluated. There are two evaluator types that you can choose from: AND, OR.

Tabelle 1. Tabelle mit Auswertertypen , ihren Beschreibungen und Beispielen dafür

Auswertertyp	Beschreibung	Beispiel
AND	Verwenden Sie diesen Auswertungstyp, wenn alle Regeln ausgeführt werden müssen.	Rule : Invoice Number starts with A And ends with X. Valid Result : The valid field value is A123X. Invalid Result : The valid field value is A123.
ODER	Nur eine der Regeln muss ausgeführt werden.	Regel : Rechnungsnummer beginnt mit A ODER ist 123. Valid Result : The valid field value is A123, 123. Ungültiges Ergebnis: Der gültige Feldwert ist 234, 1A23.

Kritikalitätsstufe

Indicates the criticality of all rules defined for a field. You cannot set a MUST level if the rule is broken in the Validation Station session. There are two criticality levels that you can choose from: MUST, SHOULD.

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

When you want to submit a rule, a MUST rule requires 100% success, otherwise the Submit operation fails. A SHOULD rule allows you to Submit it even if the rule is broken.

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

	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.

Once you have selected the Evaluator Type and the Criticality Level, you must set a type applicable for your newly created rule. There are several options you can choose from. Here's a complete list with all the available ones:

• 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

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

	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 Mitarbeitertyp 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 Zahl. Beim Konfigurieren der Regel ist eine Bedingung erforderlich. Es gibt die 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

Im Folgenden wird die Anwendbarkeit dieser Regeln anhand eines praktischen Beispiels besser erläutert. Wir erstellen eine Reihe von Regeln für das Adressfeld des Dokuments. In den folgenden Beispielschritten erfahren Sie, wie Sie eine neue Regel oder einen Satz von Regeln für ein Feld erstellen können:

1. Wählen Sie ein Feld im Bereich Taxonomie 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 Enthält enthält 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 die Einstellung Ist nicht leer hat.
9. Wählen Sie Neu hinzufügen aus.
10. Geben Sie die Regel city or state ein, für die der Typ Enthält enthält und der Ausdruck city, state ist.

Das folgende animierte Bild zeigt die zuvor beschriebenen Schritte.

Abbildung 3. Animiertes Bild, das anzeigt, wie drei Regeln für ein Feld hinzugefügt werden.

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 beim übergeordneten Element des Objekts aus, das Sie löschen möchten.
• Wählen Sie Löschen beim Auswählen des Objekts aus, 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 Tastenkombination zur Bereitstellung von Werten für Felder zu verwenden. Weitere Informationen zur Verwendung der Feldverknüpfungen zum Zuweisen von Werten zu einem Feld finden Sie auf der Seite Validierungsstation .

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 eingeklappt werden.

Hinweis:

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