Clase ExtractionResultHandler

Punto de entrada del ControladorDeResultadosDeExtracción del navegador V1, con los métodos de constructor, fábrica y conversión, y los miembros de navegación de campo que hereda.

Definición

• Espacio de nombres: UiPath.DocumentProcessing.Contracts.Extensions.Navigator.V1
• Ensamblado: UiPath.DocumentProcessing.Contracts
• Hereda: FachadaColecciónDeComponentes

Descripción

ExtractionResultHandler es el punto de entrada del navegador V1. Proporciona una forma fluida y fuertemente tipada de navegar y editar los campos de un ResultadoDeExtracción sin convertir manualmente los objetos PuntoDatosResultados y ValorResultados sin procesar.

Se crea un controlador a partir de un ResultadoDeExtracción y envuelve la colección de campos en ExtractionResult.ResultsDocument.Fields. Los métodos de navegación heredados llegan a cada campo como una fachada con tipo:

• Campos básicos como BasicDataPoint y BasicValue.
• Tablas como TableDataPoint, TableValue y TableRow.
• Grupos de campos como FieldGroupDataPoint y FieldGroupValue.
• Campos de tipo desconocido como WildcardDataPoint.

Como el controlador hereda de ComponentCollectionFacade, los métodos de navegación enumerados en Miembros heredados están disponibles directamente en el controlador.

Miembros

Constructores

Constructor	Descripción
ExtractionResultHandler(ExtractionResult extractionResult)	Inicializa un nuevo navegador sobre los campos del resultado de extracción especificado (ResultsDocument.Fields).

Métodos de fábrica y conversión

Todos los métodos de esta sección son static.

Método	Devoluciones	Descripción
FromExtractionResult(ExtractionResult extractionResult)	ExtractionResultHandler	Crea un navegador a partir de un resultado de extracción.
FromTable(ResultsDataPoint tableDataPoint)	PuntoDeDatosDeLaTabla	Envuelve un punto de datos de tabla en una fachada de tabla.
FromFieldGroup(ResultsDataPoint fieldGroupDataPoint)	PuntoDeDatosDeGrupoDeCampos	Envuelve un punto de datos de grupo de campos en una fachada de grupo de campos.
FromBasicDataPoint(ResultsDataPoint basicDataPoint)	PuntoDeDatosBásicos	Envuelve un punto de datos básico en una fachada de campo básico.
FromDataPoint(ResultsDataPoint dataPoint)	PuntoDeDatosComodín	Envuelve cualquier punto de datos en una fachada de comodín.
FromFieldGroupValue(ResultsValue resultsValue)	Valor de grupo de campos	Envuelve un valor de grupo de campos en una fachada de valor de grupo de campos.
FromTableValue(ResultsValue tableValue)	ValorDeTabla	Envuelve un valor de tabla en una fachada de valor de tabla.
FromTableRow(ResultsValue tableRow)	FilaDeLaTabla	Envuelve un valor de fila de tabla en una fachada de fila de tabla.
FromBasicValue(ResultsValue basicValue)	Valor básico	Envuelve un valor básico en una fachada de valor básico.

Miembros heredados

Los siguientes métodos se heredan de ComponentCollectionFacade y están disponibles directamente en ExtractionResultHandler. Los parámetros fieldLookup y tableLookup siguen las reglas de resolución de búsqueda de campos en FieldLookupBase.

Método	Devoluciones	Descripción
GetFields(Func<ResultsDataPoint, bool> condition = null, bool recursive = false)	ColecciónDeDatosDePuntosComodín	Devuelve los campos que coinciden con condition, o todos los campos cuando condition es null. Cuando recursive es true, se incluyen los campos anidados.
GetSimpleFields()	PuntoDeDatosBásicos[]	Devuelve todos los campos básicos (no complejos).
GetSimpleField(string fieldLookup)	PuntoDeDatosBásicos	Devuelve el campo básico que coincide con la búsqueda.
GetTables()	PuntoDeDatosDeLaTabla[]	Devuelve todos los campos de la tabla.
GetTable(string tableLookup)	PuntoDeDatosDeLaTabla	Devuelve el campo de la tabla que coincide con la búsqueda.
GetTableValue(string tableLookup)	ValorDeTabla	Devuelve el valor del campo de la tabla que coincide con la búsqueda.
GetFieldGroups()	PuntoDeDatosDeGrupoDeCampos[]	Devuelve todos los campos del grupo de campos.
GetFieldGroup(string fieldLookup)	PuntoDeDatosDeGrupoDeCampos	Devuelve el campo del grupo de campos que coincide con la búsqueda.
GetFieldGroupValue(string fieldLookup, int index)	Valor de grupo de campos	Devuelve la instancia de grupo de campos en index para el campo que coincide con la búsqueda.

Ejemplos

Cuando la propiedad Generar tipo de datos de la actividad Extraer datos del documento está desactivada, puedes obtener un controlador directamente de la salida de la actividad a través de la propiedad Handler : var handler = DocumentData.Data.Handler;.

El siguiente ejemplo crea un controlador a partir de un ExtractionResult y utiliza los métodos de navegación para leer valores de fecha, una instancia de grupo de campos y uno de sus campos secundarios.

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;