View a markdown version of this page

Données du formulaire (Key-Value paires) - Amazon Textract

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Données du formulaire (Key-Value paires)

Amazon Textract peut extraire des données de formulaire à partir de documents sous forme de paires clé-valeur. Par exemple, dans le texte suivant, Amazon Textract peut identifier une clé (Nom :) et une valeur (Ana Carolina).

Nom : Ana Carolina

Les paires clé-valeur détectées sont renvoyées sous forme d'objets Block dans les réponses de AnalyzeDocumentet. GetDocumentAnalysis Vous pouvez utiliser le paramètre FeatureTypes d'entrée pour récupérer des informations sur les paires clé-valeur, les tables ou les deux. Pour les paires clé-valeur uniquement, utilisez la valeur. FORMS Pour obtenir un exemple, consultez Extraire des Key-Value paires à partir d'un document de formulaire. Pour des informations générales sur la façon dont un document est représenté par Block des objets, consultezObjets de réponse pour la détection de texte et l'analyse de documents.

Les dates détectées grâce à la détection de paires clé-valeur sont renvoyées exactement telles qu'elles sont détectées sur le document d'entrée, la plupart des formats de date étant pris en charge.

Les objets de type KEY_VALUE_SET sont les conteneurs des objets de bloc KEY ou VALUE qui stockent des informations sur les éléments de texte liés détectés dans un document. Vous pouvez utiliser l'EntityTypeattribut pour déterminer si un bloc est une clé ou une valeur.

  • Un objet KEY contient des informations sur la clé du texte lié. Par exemple, Nom :. Un bloc KEY contient deux listes de relations. Une relation de type VALUE est une liste qui contient l'ID du bloc VALUE associé à la clé. Une relation de type CHILD est une liste d'identifiants pour les blocs WORD qui constituent le texte de la clé.

  • Un objet VALUE contient des informations sur le texte associé à une clé. Dans l'exemple précédent, Ana Carolina est la valeur de la clé Name :. Un bloc VALUE a une relation avec une liste de blocs CHILD qui identifient les blocs WORD. Chaque bloc WORD contient l'un des mots qui constituent le texte de la valeur. Un VALUE objet peut également contenir des informations sur des éléments sélectionnés. Pour de plus amples informations, veuillez consulter Éléments de sélection.

Amazon Textract renvoie la même valeur de confiance pour KEY et VALUE dans un KEY_VALUE_SET, car KEY et VALUE sont toutes deux évaluées par paire. Elle renvoie une valeur de confiance différente pour un mot dans les blocs WORD.

Chaque instance d'un objet KEY_VALUE_SET est un enfant de l'Blockobjet PAGE qui correspond à la page Block en cours.

Le schéma suivant montre comment la paire clé-valeur Nom : Ana Carolina est représentée par Block des objets.

Schéma illustrant la structure d'une table de base de données avec une page contenant des clés et des valeurs, où les clés sont les mots « Nom : », « Ana » et « Carolina ».

Les exemples suivants montrent comment la paire clé-valeur Name : Ana Carolina est représentée par JSON.

Le bloc PAGE contient des blocs CHILD de type CHILD KEY_VALUE_SET pour chaque bloc KEY et VALUE détecté dans le document. 

{
    "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
},

Le JSON suivant montre que le bloc KEY (52be1777-53f7-42f6-a7cf-6d09bdc15a30) a une relation avec le bloc VALUE (7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c). Il possède également un bloc CHILD pour le bloc WORD (c734fca6-c4c4-415c-b6c1-30f7510b72ee) qui contient le texte de la clé (Nom :).

{
    "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
},

Le JSON suivant montre que le bloc VALUE 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c possède une liste CHILD d'identifiants pour les blocs WORD qui constituent le texte de la valeur (Ana et 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
}

Le JSON suivant montre les Block objets pour les mots Name :, Ana et Carolina.

{
    "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"
},