기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 양식 데이터(키-값 페어)
<a name="how-it-works-kvp"></a>

Amazon Textract는 문서에서 양식 데이터를 키-값 페어로 추출할 수 있습니다. 예를 들어 다음 텍스트에서 Amazon Textract는 키(*이름:*)와 값(*아나캐롤라이나*)을 식별할 수 있습니다.

*이름: Ana Carolina*

감지된 키-값 페어는 [AnalyzeDocument](https://docs.aws.amazon.com/textract/latest/APIReference/API_AnalyzeDocument.html) 및 [GetDocumentAnalysis](https://docs.aws.amazon.com/textract/latest/APIReference/API_GetDocumentAnalysis.html)의 응답에서 [블록](https://docs.aws.amazon.com/textract/latest/APIReference/API_Block.html) 객체로 반환됩니다. `FeatureTypes` 입력 파라미터를 사용하여 키-값 페어, 테이블 또는 둘 다에 대한 정보를 검색할 수 있습니다. 키-값 페어에만 값을 사용합니다`FORMS`. 예제는 [양식 문서에서 키-값 페어 추출](examples-extract-kvp.md) 섹션을 참조하세요. 문서가 `Block` 객체로 표현되는 방법에 대한 일반적인 내용은 섹션을 참조하세요[텍스트 감지 및 문서 분석 응답 객체](how-it-works-document-layout.md).

키-값 페어 감지를 통해 발견된 날짜는 입력 문서에서 감지된 대로 정확히 반환되며 대부분의 날짜 형식이 지원됩니다.

KEY\_VALUE\_SET 유형의 블록 객체는 문서에서 감지된 연결된 텍스트 항목에 대한 정보를 저장하는 KEY 또는 VALUE Block 객체의 컨테이너입니다. `EntityType` 속성을 사용하여 블록이 KEY 또는 VALUE인지 확인할 수 있습니다.
+ *KEY* 객체에는 연결된 텍스트의 키에 대한 정보가 포함됩니다. 예: *이름:*. KEY 블록에는 두 개의 관계 목록이 있습니다. VALUE 유형의 관계는 키와 연결된 VALUE 블록의 ID를 포함하는 목록입니다. CHILD 유형의 관계는 키의 텍스트를 구성하는 WORD 블록의 IDs 목록입니다.
+ *VALUE* 객체에는 키와 연결된 텍스트에 대한 정보가 포함됩니다. 앞의 예에서 *Ana Carolina*는 키 *Name:*의 값입니다. VALUE 블록은 WORD 블록을 식별하는 CHILD 블록 목록과 관계가 있습니다. 각 WORD 블록에는 값의 텍스트를 구성하는 단어 중 하나가 포함되어 있습니다. `VALUE` 객체에는 선택한 요소에 대한 정보도 포함될 수 있습니다. 자세한 내용은 [선택 요소](how-it-works-selectables.md) 단원을 참조하십시오.

Amazon Textract는 KEY와 VALUE가 쌍으로 평가되므로 KEY\_VALUE\_SET에서 KEY와 VALUE 모두에 대해 동일한 신뢰도 값을 반환합니다. WORD 블록의 단어에 대해 다른 신뢰도 값을 반환합니다.

KEY\_VALUE\_SET `Block` 객체의 각 인스턴스는 현재 페이지에 해당하는 PAGE `Block` 객체의 하위 인스턴스입니다.

다음 다이어그램은 키-값 페어 *이름: Ana Carolina*을 `Block` 객체로 표현하는 방법을 보여줍니다.

![키와 값이 포함된 페이지가 있는 데이터베이스 테이블의 구조를 보여주는 다이어그램입니다. 여기서 키는 "Name:", "Ana" 및 "Carolina"라는 단어입니다.](https://docs.aws.amazon.com/ko_kr/textract/latest/dg/images/hieroglyph-key-value-set.png)


다음 예제에서는 키-값 페어 *이름: Ana Carolina*을 JSON으로 표현하는 방법을 보여줍니다.

PAGE 블록에는 문서에서 감지된 각 KEY 및 VALUE 블록에 `KEY_VALUE_SET` 대한 유형의 CHILD 블록이 있습니다.

```
{
    "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은 KEY 블록(52be1777-53f7-42f6-a7cf-6d09bdc15a30)이 VALUE 블록(7ca7caa6-00ef-4cda-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은 값 블록 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c에 값의 텍스트를 구성하는 WORD 블록의 CHILD IDs 목록이 있음을 보여줍니다(*Ana* 및 *Carolina*).

```
{
    "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* 및 *Carolina*이라는 단어의 `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"
},
```