提取结果处理程序类

V1 导航器的提取结果处理程序入口点，具有构造函数、工厂和转换方法，以及它继承的字段导航成员。

定义

• 命名空间: UiPath.DocumentProcessing.Contracts.Extensions.Navigator.V1
• 程序集: UiPath.DocumentProcessing.Contracts
• 继承：组件集合外观

描述

ExtractionResultHandler 是 V1 导航器的入口点。它提供了一种流畅的强类型方式来导航和编辑ExtractionResult的字段，而无需手动转换原始“ResultsDataPoint”和“ResultsValue”对象。

处理程序从ExtractionResult创建，并包含ExtractionResult.ResultsDocument.Fields处的字段集合。然后，继承的导航方法作为类型化外观到达每个字段：

• BasicDataPoint和BasicValue视为“基本”字段。
• 作为表格数据点、表格值和表格行的表格。
• 作为字段组数据点和字段组值的字段组。
• 作为WildcardDataPoint 的未知类型字段。

由于处理程序继承自ComponentCollectionFacade ，因此可直接在处理程序上使用“已继承的成员”下列出的导航方法。

成员

构造函数

构造函数	描述
ExtractionResultHandler(ExtractionResult extractionResult)	在指定提取结果 (ResultsDocument.Fields) 的字段上初始化新导航器。

工厂方法和转换方法

本节中的所有方法都是 static。

方法	返回	描述
FromExtractionResult(ExtractionResult extractionResult)	ExtractionResultHandler	根据提取结果创建一个导航器。
FromTable(ResultsDataPoint tableDataPoint)	表格数据点	在表格外观中包含表格数据点。
FromFieldGroup(ResultsDataPoint fieldGroupDataPoint)	字段组数据点	将字段组数据点包含在字段组外观中。
FromBasicDataPoint(ResultsDataPoint basicDataPoint)	基本数据点	包含基本字段外观中的基本数据点。
FromDataPoint(ResultsDataPoint dataPoint)	通配符数据点	包含通配符外观中的任何数据点。
FromFieldGroupValue(ResultsValue resultsValue)	字段组值	将字段组值包含在字段组值外观中。
FromTableValue(ResultsValue tableValue)	表格值	将表格值包含在表格值外观中。
FromTableRow(ResultsValue tableRow)	表格行	将表格行值包含在表格行外观中。
FromBasicValue(ResultsValue basicValue)	基本值	将基本值包含在基本值外观中。

已继承的成员

以下方法继承自ComponentCollectionFacade ，可直接在ExtractionResultHandler上使用。fieldLookup和tableLookup参数遵循FieldLookupBase中的字段查找解析规则。

方法	返回	描述
GetFields(Func<ResultsDataPoint, bool> condition = null, bool recursive = false)	通配符数据点集合	当condition为 condition 时，返回与 null 匹配的所有字段。当 recursive 为 true 时，包括嵌套字段。
GetSimpleFields()	基本数据点[]	返回所有基本（非复杂）字段。
GetSimpleField(string fieldLookup)	基本数据点	返回与查找内容匹配的基本字段。
GetTables()	表格数据点[]	返回所有表格字段。
GetTable(string tableLookup)	表格数据点	返回与查找内容匹配的表格字段。
GetTableValue(string tableLookup)	表格值	返回与查找匹配的表格字段的值。
GetFieldGroups()	字段组数据点[]	返回所有字段组字段。
GetFieldGroup(string fieldLookup)	字段组数据点	返回与查找匹配的字段组字段。
GetFieldGroupValue(string fieldLookup, int index)	字段组值	返回 index 中与查找匹配的字段的字段组实例。

示例

当“提取文档数据” 活动的“生成数据类型” 属性为关闭状态时，您可以通过Handler 属性直接从活动输出中获取处理程序：var handler = DocumentData.Data.Handler; 。

以下示例根据 ExtractionResult 创建一个处理程序，并使用导航方法读取日期值、字段组实例及其一个子字段。

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;