PREVIEW

方法

“提取文档数据”活动中的“生成数据类型”设置决定文档数据输出类型：

1. 当“生成数据”为 True 时，文档数据输出为 IDocumentData<ExtractorType>。
2. 当“生成数据”为 False 时，文档数据输出为 IDocumentData<DictionaryData>。

IDocumentData<DictionaryData> 类型允许您使用某些方法检索和修改字段值。您还可以在“验证站点”中更改文档类型。

以下部分显示 DocumentData.Data 的可用方法。

注意：fieldIdOrName 参数既被视为字段的标识符，也被视为字段名称。

GetFields()

返回某一文档类型中字段的所有信息，表格字段除外。

语法

GetFields()

返回值

ResultsDataPoint[]

包含所有字段及其关联的提取值的数组。

示例

检查以下示例以了解该方法：

ResultsDataPoint[] allFields = DocumentData.Data.GetFields()

GetField(string)

根据给定的字段 ID 或名称返回所有字段信息。

语法

GetField(string fieldIdOrName)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

返回值

ResultsDataPoint

该字段及其关联的提取值。

示例

当所需字段 ID 或名称为 vendor 时，请查看以下示例以了解使用方法：

结果数据点供应商数据 = DocumentData.Data.GetField（“供应商”）；

GetFieldValue(string)

根据给定的字段 ID 或名称，返回第一个字段值。

语法

GetFieldValue(string fieldIdOrName)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

返回值

ResultsValue

为提取结果中的字段报告的值。

异常

如果未找到 fieldIdOrName，则会引发以下异常：未找到 Field {FieldIDOrName}。

示例

当字段 ID 或名称为 vendor 时，请查看以下示例以了解使用方法：

ResultsValue fieldValue = DocumentData.Data.GetFieldValue("vendor");
    // stores the value of the fieldValue object in a string variable   
    string value = fieldValue.Value;
    // stores the confidence of the fieldValue object in a float variable
    float confidence = fieldValue.Confidence;

GetFieldValue(string, int)

根据给定的字段 ID 或名称以及字段 index 返回字段值，以从值数组中返回特定值。

此方法适用于简单字段。

语法

GetFieldValue(string fieldIdOrName, int index)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

索引 Int

特定值的索引。

返回值

ResultsValue

为提取结果中的字段报告的值。

异常

• 如果未找到 fieldIdOrName，则会引发以下异常：未找到 Field {fieldIdOrName}。
• 如果未找到 index，则会引发以下异常：Index is out of range。

示例

检查以下示例以使用该方法，其中字段 ID 为 vendor，所需值的索引为 2：

ResultsValue fieldValue = DocumentData.Data.GetFieldValue("vendor", 2);
    // store the retrieved value in a string variable
    string value = fieldValue.Value;
    // retrieve and store the confidence level of the field value
    float confidence = fieldValue.Confidence

GetFieldValues(string)

根据给定的字段 ID 或名称，返回文档类型中字段的所有值。

此方法不仅适用于多值字段，还适用于提取模型提供替代值的字段。这意味着一个字段可以具有多个替代值，即使它本质上不是多值字段。

语法

GetFieldValues(string fieldIdOrName)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

返回值

ResultsValue[]

为提取结果中的字段报告的值的数组。

异常

如果未找到 fieldIdOrName，则会引发以下异常：未找到 Field {fieldIdOrName}。

示例

如果字段 ID 或名称为 vendor 时，请查看以下示例以了解使用方法：

ResultsValue[] fieldValues = DocumentData.Data.GetFieldValues("vendor");

GetTables()

返回某一文档类型中所有表格中的所有字段信息。

语法

GetTables()

返回值

ResultsTable[]

以数组形式提取的表格字段，其中包含一个或多个结果表格值（以分别支持单值表和多值表）。每个值都有一个结果表格单元格数组。每个单元格都有一个结果值数组，这是用于简单字段的标准值对象。

示例

检查以下示例以了解该方法：

ResultsTable[] tableValues = DocumentData.Data.GetTables();

GetTable(string)

根据给定 ID，返回表格中某一文档类型的所有字段信息。

语法

GetTable(string tableID)

参数

tableID 字符串

要检索的表格 ID。您可以通过导航至项目的“构建”部分找到表格 ID。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关表格字段选择“高级设置”。

返回值

ResultsTable

已提取的表格字段，其中包含一个或多个结果表格值（以分别支持单值表和多值表）。每个值都有一个结果表格单元格数组。每个单元格都有一个结果值数组，这是用于简单字段的标准值对象。

示例

如果字段 ID 或名称为 prices 时，请查看以下示例以了解使用方法：

var tableValues = DocumentData.Data.GetTable("prices");

SetFieldValue(string, ResultsValue)

使用指定值覆盖由字段 ID 标识的整个值数组。

语法

SetFieldValue(string fieldID, ResultsValue value)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

值 ResultsValue

要为字段设置的值。

异常

如果未找到 fieldID，则会引发以下异常：未找到 Field {FieldIDOrName}。

示例

查看以下示例以了解该方法的使用方法，在该示例中，我们首先使用 ResultsValue.CreateWithNoReference 辅助方法创建字段值。该帮助程序方法采用以下参数：

• 第一个参数表示值。
• 第二个参数表示置信度。
• 第三个参数表示 OCR 的可信度。

创建 taxValue 字段值对象后，我们将 tax 字段可能预先存在的值（如果有）替换为仅包含 taxValue 对象的新数组。在本例中，由于我们使用 SetFieldValue，tax 字段将采用新值 10。

var taxValue = ResultsValue.CreateWithNoReference("10", 1, 1);
documentData.Data.SetFieldValue("tax", taxValue);

SetFieldValue(string, ResultsValue, int)

根据给定的字段 ID 或名称，并根据字段索引设置字段值。

此方法适用于简单字段。

语法

SetFieldValue(string fieldID, ResultsValue value, int index)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

值 ResultsValue

要为字段设置的值。

索引 Int

特定值的索引。

异常

• 如果未找到 fieldID，则会引发以下异常：未找到 Field {FieldIDOrName}。
• 如果未找到 index，则会引发以下异常：Index is out of range。

示例

查看以下示例以了解该方法的使用方法，在该示例中，我们首先使用 ResultsValue.CreateWithNoReference 辅助方法创建字段值。该帮助程序方法采用以下参数：

• 第一个参数表示值数组。
• 第二个参数表示置信度。
• 第三个参数表示 OCR 的可信度。

创建 taxValue 字段值对象后，我们继续将此新 taxValue 对象替换 tax 字段数组索引 1 处的值。在此处，SetFieldValue 方法用于替换索引 1 处的值。

var taxValue = ResultsValue.CreateWithNoReference("10", 1, 1);
documentData.Data.SetFieldValue("tax", new [] {taxValue}, 1);

SetFieldValues(string, ResultsValue[])

对于给定的字段 ID 或名称，将整个值数组替换为另一个指定的值数组。

语法

SetFieldValues(string fieldID, ResultsValue[] values)

参数

fieldIdOrName 字符串

要检索或设置的字段的 ID 或名称。此方法首先使用 ID 搜索匹配项。如果未找到匹配项，则使用与字段名称相同的值进行搜索。

您可以通过以下方式发现字段 ID 和名称：

• 导航至项目的“构建”部分。为示例文档选择“文档类型管理器”。进入“字段”，然后为相关字段选择“高级设置”。
  
  

  

  
  
• 打开“验证站点”，在“文档类型”下，搜索已存在的字段名称。
• 如果您使用的是 Document Understanding API，则可以使用发现服务中的 API 来检索字段名称和 ID。访问“使用发现 API”，检查可用的 API 调用。

值 ResultsValue[]

要为字段设置的值的数组。

异常

如果未找到 fieldID，则会引发以下异常：未找到 Field {FieldIDOrName}。

示例

查看以下示例以了解该方法的使用方法，在该示例中，我们首先使用 ResultsValue.CreateWithNoReference 帮助程序方法创建两个字段值：total1 和 total2。该帮助程序方法接受三个参数：

1. 第一个参数表示实际值。
2. 第二个参数表示置信度值。
3. 第三个参数表示 OCR 置信度值。

创建这些字段值后，我们将名为 Total Amount 字段的值替换为包含 total1 和 total2 的数组。

var total1 = ResultsValue.CreateWithNoReference("100", 1, 1);
    var total2 = ResultsValue.CreateWithNoReference("200", 1, 1);
    documentData.Data.SetFieldValues("Total Amount", new []{total1, total2});