View a markdown version of this page

表單資料 （鍵值對） - Amazon Textract

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

表單資料 （鍵值對）

Amazon Textract 可以從文件擷取表單資料，做為索引鍵/值對。例如，在下列文字中，Amazon Textract 可以識別金鑰 (Name：) 和值 (Ana Carolina)。

名稱：Ana Carolina

偵測到的鍵/值對會在 AnalyzeDocument 和 GetDocumentAnalysis 的回應中傳回為區塊物件。您可以使用FeatureTypes輸入參數來擷取鍵值對、資料表或兩者的相關資訊。僅適用於鍵/值對，請使用值 FORMS。如需範例，請參閱 從表單文件中擷取鍵值對。如需如何以Block物件表示文件的一般資訊，請參閱 文字偵測和文件分析回應物件。

透過索引鍵/值對偵測找到的日期會完全按照輸入文件上的偵測傳回，並支援大多數的日期格式。

類型為 KEY_VALUE_SET 的封鎖物件是 KEY 或 VALUE 封鎖物件的容器，用於存放文件中偵測到之連結文字項目的相關資訊。您可以使用 EntityType 屬性來判斷區塊是 KEY 還是 VALUE。

  • KEY 物件包含連結文字之金鑰的相關資訊。例如，Name：。KEY 區塊有兩個關係清單。VALUE 類型的關係是包含與金鑰相關聯之 VALUE 區塊 ID 的清單。類型 CHILD 的關係是組成金鑰文字之 WORD 區塊的 IDs 清單。

  • VALUE 物件包含與金鑰相關聯文字的相關資訊。在上述範例中，Ana Carolina 是索引鍵 Name： 的值。VALUE 區塊與識別 WORD 區塊的 CHILD 區塊清單有關聯。每個 WORD 區塊都包含構成值文字的其中一個單字。VALUE 物件也可以包含所選元素的相關資訊。如需詳細資訊，請參閱選擇元素。

Amazon Textract 會傳回 KEY_VALUE_SET 中 KEY 和 VALUE 的相同可信度值，因為 KEY 和 VALUE 都會評估為一對。它會傳回 WORD 區塊中字詞的不同可信度值。

KEY_VALUE_SET Block 物件的每個執行個體都是對應至目前頁面的 PAGE Block 物件的子項。

下圖顯示金鑰/值對名稱：Ana Carolina 如何以Block物件表示。

描述資料庫資料表結構的圖表，其中包含索引鍵和值的頁面，其中索引鍵是「Name：」、「Ana」和「Carolina」一詞。

下列範例顯示金鑰值對名稱：Ana Carolina 如何以 JSON 表示。

PAGE 區塊具有文件中偵測到KEY_VALUE_SET的每個 KEY 和 VALUE 區塊的 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-b1aaa-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 區塊 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c 具有組成值文字 (Ana 和 Carolina) 之 IDs 清單。

{
    "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 顯示名稱、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"
},