Taxonomie – Übersicht

Was ist eine Taxonomie

The Taxonomy is the metadata that the Document Understanding^TM framework considers in each of its steps.

• Eine Taxonomie ist eine Sammlung von Dokumenttypen.
• Ein Dokumenttyp ist die Definition eines logischen Dokumenttyps, der von verschiedenen Geschäftsprozessen verarbeitet werden muss. Beispiele für Dokumenttypen sind Rechnungen, Gesundheitsakten, IRS-Formulare W-2, Verträge usw. Ein Dokumenttyp enthält in der Regel neben einem Namen, einer Gruppe und einer Kategorie (zur leichteren Handhabung) eine Sammlung von Feldern.
• Ein Feld ist eine Information, die von einem bestimmten Dokumenttyp erwartet und erfasst wird.

Eine Taxonomie ist eine hierarchische Struktur, die das Schema der Informationen enthält, die das Document Understanding Framework verwenden wird. Jede Entitätsdefinition (für Dokumenttypen oder Felder) in der Taxonomie hat eine eindeutige ID.

Wie hilft sie bei der Dokumentklassifizierung?

Wenn Sie eingehende Dateien in verschiedene Dokumenttypen klassifizieren möchten, sollte die Taxonomie die Dokumenttypen enthalten, die Sie speziell behandeln möchten. Damit können Sie Ihre Document Understanding-Prozesse basierend auf einem einheitlichen Datenschema konfigurieren: der Struktur Ihrer Taxonomie.

Wie hilft sie bei der Datenextraktion?

Wenn Sie Daten aus bestimmten Dokumenttypen extrahieren möchten, enthält die Taxonomie die Liste der relevanten Felder für die automatische Datenextraktion. Diese ermöglichen die Konfiguration verschiedener Extraktionsmethoden und -regeln erneut basierend auf einem Single-Source-of-Truth-Datenschema: der Struktur Ihres Dokumenttyps.

Feldtypen und Details

Ein Feld kann abgeleitete Teile enthalten: formatierte Informationen, die vom zugrundeliegenden Textwert im Dokument extrahiert oder bearbeitet wurden.

Feldtyp	Mehrere Werte möglich	Zweck	Abgeleitete Teile für die Formatierung	Zusätzliche Angaben
Text	Ja	Textangaben	Keine Angabe	Keine Angabe
Nummer	Ja	Numerische Werte	Wert (bis zu acht Dezimalstellen)	Keine Angabe
Datum	Ja	Daten	Tag Monat Jahr	Date fields allow for the definition of an Expected Format , which must be an MSDN-compliant date format string (for example, dd-MM-yyyy or MM, dd, yyyy ). Dieses Format kann von der Aktivität Data Extraction Scope verwendet, wenn versucht wird, ein Datum in die Bestandteile „Tag“, „Monat“ und „Jahr“ aufzuschlüsseln.
Name	Ja	Personennamen	Gegebener Name Zweiter Vorname Nachname	Keine Angabe
Address	Ja	Adressen	Adresszeile 1 Adresszeile 2 Adresszeile 3 Stadt Staat / Bezirk / Bundesland Land Postleitzahl	Keine Angabe
Set (Satz)	Ja	Definiert eine Liste möglicher Werte aus einem vordefinierten Satz	Keine Angabe	Ein Set-Feld muss die zulässigen Optionen als Werte definieren. Diese sind in der Validierungsstation widergespiegelt.
Boolescher	Ja	Ja/Nein-Werte	Keine Angabe	Ein Boolesches Feld kann als mögliche Werte nur Ja oder Nein haben und ist in der Validierungsstation widergespiegelt.
Tabelle	Nein	Tabellendaten	Keine Angabe	Ein Tabellenfeld enthält die Definition der Spalten.
Tabellenspalte	Nein	Jede Zelle in der Tabelle.	Keine Angabe	Tabellenspalten in einem Tabellenfeld sind als eines der regulären Felder der Komponentenliste definiert. Sie können nicht vom Typ „Tabelle“ sein.

Andere in der Taxonomie erfasste Informationen

Die Taxonomie enthält zudem die Liste der Gruppen und Kategorien sowie eine Liste der unterstützten Sprachen, die den zu bearbeitenden Dokumenten zugeordnet werden können. Um beispielsweise Dokumente auf Japanisch und Englisch zu bearbeiten, muss das Tag der unterstützten Sprachen deren jeweiligen Anzeigenamen und den Sprachencode enthalten. Für Ausnahmefälle empfehlen wir, eine nicht bestimmte Sprache (Code und) hinzuzufügen.

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))

Called on a DocumentTaxonomy object, the GetFields() method called with a DocumentTypeId string returns a list of fields defined within that document type.

Wie die Taxonomie Ihres Projekts erstellt und bearbeitet wird

Once the UiPath.IntelligentOCR.Activities package is installed in your project in UiPath® Studio, a Taxonomy Manager button appears in the main ribbon of Studio's Design tab. Use the Taxonomy Manager wizard to edit your project taxonomy.

Die Taxonomie wird in einer Datei in Ihrem UiPath Studio-Projekt im Ordner DocumentProcessing und in der taxonomy.json-Datei gespeichert.

The file is automatically created when you first open the Taxonomy Manager wizard. You can check the exact location of the file in the Taxonomy Manager, by hovering over the button. Alternatively, each time you open the Taxonomy Manager, a pop-up message will appear in the upper right corner, informing you of the location of the file. When a project is published from Studio, the taxonomy will be published as well as an artifact of the project.

Die taxonomy.json-Datei ist für jedes Projekt eindeutig, kann aber wiederverwendet werden, wenn Sie sie manuell in ein neues Projekt kopieren. Dazu müssen Sie einfach ein neues Projekt erstellen, dann zum Projektordner wechseln und die Datei mit der Taxonomie Ihrer Wahl in den richtigen Speicherort (in den Ordner DocumentProcessing) kopieren.

Wichtig:

For data integrity purposes, we recommend you always edit the taxonomy using Taxonomy Manager.

Wie die Taxonomie in Ihrem Projekt verwendet wird

Die Taxonomie für das Document Understanding ist als Objekt im gesamten Document Understanding-Framework erforderlich.

The simplest and most convenient way to load your object is by using the Load Taxonomy activity. Once your taxonomy object is loaded, you can use it in all subsequent framework components requiring it.

Erweiterte Anwendungsfälle

• Wenn Sie Ihre Taxonomie an einem anderen Ort speichern, können Sie sie weiterhin in Ihr Projekt laden (sobald Sie den String-Inhalt der Taxonomiedatei erhalten haben, z. B. in einer myTaxonomyContentString-Variablen), indem Sie eine einfache Assign-Aktivität wie folgt verwenden:

  myTaxonomy = DocumentTaxonomy.Deserialize(myTaxonomyContentString)

• Wenn Ihr Anwendungsfall dies erfordert, dann denken Sie daran, dass die Taxonomie ein POCO (Plain Old Class Object) ist, das bei Bedarf sogar während der Ausführung bearbeitet werden kann.