本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 表单数据（Key-Value 成对）
<a name="how-it-works-kvp"></a>

Amazon Textract 可以从文档中提取表单数据作为键值对。例如，在以下文本中，Amazon Textract 可以识别密钥（*名称:*）和值（*Ana Carolina*）。

*姓名：安娜卡罗来纳州*

检测到的键值对在和的响应中作为 [Block](https://docs.aws.amazon.com/textract/latest/APIReference/API_Block.html) 对象返回。[AnalyzeDocument[GetDocumentAnalysis](https://docs.aws.amazon.com/textract/latest/APIReference/API_GetDocumentAnalysis.html)](https://docs.aws.amazon.com/textract/latest/APIReference/API_AnalyzeDocument.html)您可以使用`FeatureTypes`输入参数来检索有关键值对、表或两者的信息。仅对于键值对，请使用该值。`FORMS`有关示例，请参阅[从表单文档中提取 Key-Value 配对](examples-extract-kvp.md)。有关如何用`Block`对象表示文档的一般信息，请参见[文本检测和文档分析响应对象](how-it-works-document-layout.md)。

通过键值对检测找到的日期返回的日期与输入文档中检测到的日期完全相同，并且支持大多数日期格式。

KEY\_VALUE\_SET 类型的方块对象是 KEY 或 VALUE 块对象的容器，用于存储有关在文档中检测到的链接文本项的信息。您可以使用该`EntityType`属性来确定区块是键还是值。
+ *KEY* 对象包含有关链接文本的密钥的信息。例如，*名称：*。一个 KEY 区块有两个关系列表。VALUE 类型的关系是一个包含与密钥关联的 VALUE 块的 ID 的列表。CHILD 类型的关系是构成密钥文本的 WORD 块的 ID 列表。
+ V *AL* UE 对象包含与键关联的文本的相关信息。在前面的示例中，*Ana Carol* ina 是密钥的值 *Name:*。VALUE 块与标识单词块的子块列表有关系。每个 WORD 块都包含一个构成该值文本的单词。`VALUE`对象也可以包含有关选定元素的信息。有关更多信息，请参阅 [选择元素](how-it-works-selectables.md)。

Amazon Textract 对 KEY\_VALUE\_SET 中的键和值返回相同的置信度值，因为键和值都是成对评估的。它会为 WORD 块中的单词返回不同的置信度值。

KEY\_VALUE\_SET `Block` 对象的每个实例都是与当前页面对应的 PAG `Block` E 对象的子对象。

下图显示了如何用对象表示键值对 *Name: Ana Carol* ina。`Block`

![该图描绘了数据库表的结构，该表的页面包含键和值，其中键是 “Name:”、“Ana” 和 “Carolina” 字样。](http://docs.aws.amazon.com/zh_cn/textract/latest/dg/images/hieroglyph-key-value-set.png)


以下示例显示了如何用 JSON 表示键值对 *Name: Ana Carol* ina。

`KEY_VALUE_SET`对于在文档中检测到的每个 KEY 和 VALUE 块，PAGE 块都有子块类型。

```
{
    "Geometry": .... 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "2602b0a6-20e3-4e6e-9e46-3be57fd0844b", 
                "82aedd57-187f-43dd-9eb1-4f312ca30042", 
                "52be1777-53f7-42f6-a7cf-6d09bdc15a30", // Key - Name:
                "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"  // Value - Ana Caroline 
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "8136b2dc-37c1-4300-a9da-6ed8b276ea97"  // Page identifier
},
```

以下 JSON 显示密钥方块（52be1777-53f7-42f6-a7cf-6d09bdc15a30）与 VALUE 区块（7ca7caa6-00ef-4cda-b1aa-b1aa-5571dfed1a7c）有关系。*它还有一个 WORD 块（c734fca6-c4c4-415c-b6c1-30f7510b72ee）的 CHILD 块，其中包含密钥的文本（名称:）。*

```
{
    "Relationships": [
        {
            "Type": "VALUE", 
            "Ids": [
                "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"  // Value identifier
            ]
        }, 
        {
            "Type": "CHILD", 
            "Ids": [
                "c734fca6-c4c4-415c-b6c1-30f7510b72ee"  // Name:
            ]
        }
    ], 
    "Confidence": 51.55965805053711, 
    "Geometry": ...., 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "KEY"
    ], 
    "Id": "52be1777-53f7-42f6-a7cf-6d09bdc15a30"  //Key identifier
},
```

**以下 JSON 显示，VALUE 区块 7caa6-00ef-4cda-b1aa-5571dfed1a7c 具有构成值文本的 WORD 块（Ana 和 Carolina）的 ID 子列表。**

```
{
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "db553509-64ef-4ecf-ad3c-bea62cc1cd8a", // Ana
                "e5d7646c-eaa2-413a-95ad-f4ae19f53ef3"  // Carolina
            ]
        }
    ], 
    "Confidence": 51.55965805053711, 
    "Geometry": ...., 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "VALUE"
    ], 
    "Id": "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c" // Value identifier
}
```

以下 JSON 显示了 *Name:*、*Ana 和 Car *ol* ina* 这两个词的`Block`对象。

```
{
    "Geometry": {...}, 
    "Text": "Name:", 
    "TextType": "PRINTED".
    "BlockType": "WORD", 
    "Confidence": 99.56285858154297, 
    "Id": "c734fca6-c4c4-415c-b6c1-30f7510b72ee"
},
 {
    "Geometry": {...}, 
    "Text": "Ana", 
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.52057647705078, 
    "Id": "db553509-64ef-4ecf-ad3c-bea62cc1cd8a"
}, 
{
    "Geometry": {...}, 
    "Text": "Carolina", 
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.84207916259766, 
    "Id": "e5d7646c-eaa2-413a-95ad-f4ae19f53ef3"
},
```