ExtractionResultHandler-Klasse

ExtractionResultHandler-Einstiegspunkt des V1-Navigators mit dem Konstruktor, den Fabric- und Konvertierungsmethoden und den von ihm übernommenen Feldnavigationsmitgliedern.

Definition

• Namespace: UiPath.DocumentProcessing.Contracts.Extensions.Navigator.V1
• Assembly: UiPath.DocumentProcessing.Contracts
• Erbt: ComponentCollection

Beschreibung

ExtractionResultHandler ist der Einstiegspunkt des V1-Navigators. Es bietet eine reibungslose, stark typisierte Möglichkeit, durch die Felder eines ExtractionResult zu navigieren und diese zu bearbeiten, ohne unformatierte ResultsDataPoint- und ResultsValue- Objekte manuell umzuwandeln.

Ein Handler wird aus einem ExtractionResult erstellt und umschließt die Feldsammlung unter ExtractionResult.ResultsDocument.Fields. Die geerbten Navigationsmethoden erreichen dann jedes Feld als typisierte Version:

• Basisfelder als BasicDataPoint und BasicValue.
• Tabellen als TableDataPoint, TableValue und TableRow.
• Feldgruppen als FieldGroupDataPoint und FieldGroupValue.
• Felder mit unbekanntem Typ als PlatzhalterDataPoint.

Da der Handler von RobotCollectionFacade erbt, sind die unter Geerbten Mitglieder aufgeführten Navigationsmethoden direkt auf dem Handler verfügbar.

Mitglieder

Konstruktoren

Konstruktor	Beschreibung
ExtractionResultHandler(ExtractionResult extractionResult)	Initialisiert einen neuen Navigator über die Felder des angegebenen Extraktionsergebnisses (ResultsDocument.Fields).

Fabric- und Konvertierungsmethoden

Alle Methoden in diesem Abschnitt sind static.

Method	Gibt zurück	Beschreibung
FromExtractionResult(ExtractionResult extractionResult)	ExtractionResultHandler	Erstellt einen Navigator aus einem Extraktionsergebnis.
FromTable(ResultsDataPoint tableDataPoint)	Tabellendatenpunkt	Umfasst einen Tabellendatenpunkt in eine Tabellenansicht.
FromFieldGroup(ResultsDataPoint fieldGroupDataPoint)	FieldGroupDataPoint	Umfasst einen Feldgruppendatenpunkt in eine Feldgruppen UiPath.
FromBasicDataPoint(ResultsDataPoint basicDataPoint)	BasicDataPoint	Umfasst einen Basisdatenpunkt in einer Basisfeld UiPath.
FromDataPoint(ResultsDataPoint dataPoint)	Platzhalterdatenpunkt	Umfasst einen beliebigen Datenpunkt in eine Platzhalter-Fkata.
FromFieldGroupValue(ResultsValue resultsValue)	Feldgruppenwert	Umfasst einen Feldgruppenwert in eine Feldgruppenwertansicht.
FromTableValue(ResultsValue tableValue)	Tabellenwert	Umfasst einen Tabellenwert in eine Tabellenwert-Fkörper End.
FromTableRow(ResultsValue tableRow)	Tabellenzeile	Umbrucht einen Tabellenzeilenwert in eine Tabellenzeilen andere.
FromBasicValue(ResultsValue basicValue)	Grundwert	Umfasst einen Basiswert in eine Basiswert-Fkörper End.

Geerbte Mitglieder

Die folgenden Methoden werden von ComponentCollectionFacade geerbt und sind direkt auf ExtractionResultHandler verfügbar. Die Parameter fieldLookup und tableLookup folgen den Regeln für die Auflösung der Feldsuche in FieldLookupBase.

Method	Gibt zurück	Beschreibung
GetFields(Func<ResultsDataPoint, bool> condition = null, bool recursive = false)	Platzhalterdatenpunktsammlung	Gibt die Felder zurück, die mit condition übereinstimmen, oder alle Felder, wenn condition gleich null ist. Wenn recursive gleich true ist, sind geschachtelte Felder enthalten.
GetSimpleFields()	BasicDataPoint[]	Gibt alle grundlegenden (nicht komplexen) Felder zurück.
GetSimpleField(string fieldLookup)	BasicDataPoint	Gibt das Basisfeld zurück, das der Suche entspricht.
GetTables()	Tabellendatenpunkt[]	Gibt alle Tabellenfelder zurück.
GetTable(string tableLookup)	Tabellendatenpunkt	Gibt das Tabellenfeld zurück, das der Suche entspricht.
GetTableValue(string tableLookup)	Tabellenwert	Gibt den Wert des Tabellenfelds zurück, das der Suche entspricht.
GetFieldGroups()	FieldGroupDataPoint[]	Gibt alle Feldgruppenfelder zurück.
GetFieldGroup(string fieldLookup)	FieldGroupDataPoint	Gibt das Feldgruppenfeld zurück, das der Suche entspricht.
GetFieldGroupValue(string fieldLookup, int index)	Feldgruppenwert	Gibt die Feldgruppeninstanz unter index für das Feld zurück, das der Suche entspricht.

Beispiele

Wenn die Eigenschaft Datentyp generieren der Aktivität Extract Document Data deaktiviert ist, können Sie einen Handler direkt aus der Aktivitätsausgabe über die Eigenschaft Handler abrufen: var handler = DocumentData.Data.Handler;.

Im folgenden Beispiel wird ein Handler aus einem ExtractionResult erstellt und mithilfe der Navigationsmethoden Datumswerte, eine Feldgruppeninstanz und eines der untergeordneten Felder gelesen.

using UiPath.DocumentProcessing.Contracts.Taxonomy;
using UiPath.DocumentProcessing.Contracts.Extensions.Navigator.V1;

// Create a navigator over the fields of an extraction result.
var handler = new ExtractionResultHandler(extractionResult);

// Get all date values across the document (recursive to include nested fields).
foreach (var dateField in handler.GetFields(dp => dp.FieldType == FieldType.Date, recursive: true).BasicFields)
{
    foreach (var dateValue in dateField.Values)
    {
        Console.WriteLine($"{dateField.FieldName}: {dateValue.Value}");
    }
}

// Get the 3rd instance of the "ShippingDetails" field group (index is zero-based).
var shippingInstance = handler.GetFieldGroupValue("ShippingDetails", 2);

// From that instance, read a child field value.
var city = shippingInstance.GetSimpleField("City");
string cityText = city?.Value?.Value;