Classe ExtractionResultHandler

Ponto de entrada ExtractionResultHandler do navegador V1, com o construtor, métodos de origem e de conversão, além dos membros de navegação de campo que herda.

Definição

• Espaço de nomes: UiPath.DocumentProcessing.Contracts.Extensions.Navigator.V1
• Montagem: UiPath.DocumentProcessing.Contracts
• Herda: ComponentCollectionFacade

Description

ExtractionResultHandler é o ponto de entrada do navegador V1. Ele fornece uma maneira fluida e fortemente digitada de navegar e editar os campos de um ExtractionResult sem gerar manualmente objetos ResultsDataPoint e ResultsValue brutos.

Um manipulador é criado a partir de um ExtractionResult e encapsula a coleção de campos em ExtractionResult.ResultsDocument.Fields. Os métodos de navegação herdados alcançam cada campo como uma identidade digitada:

• Campos básicos como BasicDataPoint e BasicValue.
• Tabelas como PontoDeDadosDaTabela, ValorDaTabela e LinhaDaTabela.
• Grupos de campos como FieldGroupDataPoint e FieldGroupValue.
• Campos de tipo desconhecido como CuringaPontoDeDados.

Como o manipulador herda do ComponentCollectionFacade, os métodos de navegação listados em Membros herdados estão disponíveis diretamente no manipulador.

Membros

Construtores

Construtor	Description
ExtractionResultHandler(ExtractionResult extractionResult)	Inicializa um novo navegador sobre os campos do resultado da extração especificado (ResultsDocument.Fields).

Fabricação e métodos de conversão

Todos os métodos nesta seção static são.

Método	Retorna	Description
FromExtractionResult(ExtractionResult extractionResult)	ExtractionResultHandler	Cria um navegador a partir de um resultado de extração.
FromTable(ResultsDataPoint tableDataPoint)	PontoDeDadosDaTabela	Envolve um ponto de dados de tabela em uma máscara de tabela.
FromFieldGroup(ResultsDataPoint fieldGroupDataPoint)	PontoDeDadosDoGrupoDeCampos	Envolve um ponto de dados de grupo em uma máscara de grupo de campos.
FromBasicDataPoint(ResultsDataPoint basicDataPoint)	PontoDeDados Básicos	Envolve um ponto de dados básico em uma máscara de campo básico.
FromDataPoint(ResultsDataPoint dataPoint)	PontoDeDadosCuringa	Envolve qualquer ponto de dados em uma máscara de curinga.
FromFieldGroupValue(ResultsValue resultsValue)	ValorDoGrupoDeCampos	Envolve um valor de grupo em uma máscara de valor de grupo de campos.
FromTableValue(ResultsValue tableValue)	ValorDaTabela	Envolve um valor de tabela em uma máscara de valor de tabela.
FromTableRow(ResultsValue tableRow)	LinhaDaTabela	Envolve um valor de linha de tabela em uma máscara de linha de tabela.
FromBasicValue(ResultsValue basicValue)	Valor Básico	Envolve um valor básico em uma máscara de valor básico.

Membros herdados

Os seguintes métodos são herdados do ComponentCollectionFacade e estão disponíveis diretamente em ExtractionResultHandler. Os parâmetros fieldLookup e tableLookup seguem as regras de resolução de pesquisa de campo em Field LookupBase.

Método	Retorna	Description
GetFields(Func<ResultsDataPoint, bool> condition = null, bool recursive = false)	ColeçãoDePontosDeDadosCuringa	Retorna os campos correspondentes a condition ou todos os campos quando condition é null. Quando recursive é true, os campos aninhados são incluídos.
GetSimpleFields()	PontoDeDados Básicos[]	Retorna todos os campos básicos (não complexos).
GetSimpleField(string fieldLookup)	PontoDeDados Básicos	Retorna o campo básico que corresponde à pesquisa.
GetTables()	PontoDeDadosDaTabela[]	Retorna todos os campos da tabela.
GetTable(string tableLookup)	PontoDeDadosDaTabela	Retorna o campo de tabela que corresponde à pesquisa.
GetTableValue(string tableLookup)	ValorDaTabela	Retorna o valor do campo de tabela correspondente à pesquisa.
GetFieldGroups()	PontoDeDadosDoGrupoDeCampos[]	Retorna todos os campos do grupo de campos.
GetFieldGroup(string fieldLookup)	PontoDeDadosDoGrupoDeCampos	Retorna o campo do grupo de campos correspondente à pesquisa.
GetFieldGroupValue(string fieldLookup, int index)	ValorDoGrupoDeCampos	Retorna a instância do grupo de campos em index para o campo correspondente à pesquisa.

Exemplos

Quando a propriedade Gerar Tipo de Dados da atividade Extract Document Data estiver desativada, você pode obter um manipulador diretamente da saída da atividade por meio da propriedade Handler : var handler = DocumentData.Data.Handler;.

O exemplo a seguir cria um manipulador a partir de um ExtractionResult e usa os métodos de navegação para ler valores de data, uma instância de grupo de campos e um de seus campos filhos.

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;