Données de formulaire (Key-Value paires)Cellules du tableau

Eléments de sélection

Amazon Textract peut détecter des éléments de sélection tels que les boutons d'option (boutons radio), les cases à cocher, le texte souligné et encerclé sur une page de document. Les éléments de sélection peuvent être détectés dans les données de formulaire et dans les tableaux. Par exemple, lorsque le tableau suivant est détecté dans un formulaire, Amazon Textract détecte les cases à cocher dans les cellules du tableau.

	D'accord	Neutre	Pas d'accord
Bon service	☑	☐	☐
Facile à utiliser	☐	☑	☐
Prix équitable	☑	☐	☐

Les éléments de sélection détectés sont renvoyés sous forme d'objets Block dans les réponses de AnalyzeDocument et GetDocumentAnalysis.

Le tableau ci-dessous fournit des exemples des différents types sélectionnables pris en charge par Amazon Textract.

Type sélectionnable	Exemple
Bouton radio	Oui ○ Non ●
Checkbox	Oui ☐ Non ☑
Mots soulignés	Oui Non
Mots encerclés
Mots barrés

Amazon Textract peut également détecter les éléments cliquables implicites, c'est-à-dire les éléments cliquables qui sont structurés sous forme de questions et auxquels on répond en cochant l'une des nombreuses réponses. Ils sont renvoyés de la même manière que les objets cliquables.

Note

Vous pouvez utiliser le paramètre FeatureTypes d'entrée pour récupérer des informations sur les paires clé-valeur, les tableaux ou les deux. Par exemple, si vous filtrez sur des tableaux, la réponse inclut les éléments de sélection détectés dans les tableaux. Les éléments de sélection détectés dans des paires clé-valeur ne sont pas inclus dans la réponse.

Les informations relatives à un élément de sélection sont contenues dans un Block objet de typeSELECTION_ELEMENT. Pour déterminer l'état d'un élément sélectionnable, utilisez le SelectionStatus champ du SELECTION_ELEMENT bloc. Le statut peut être SELECTED ou NOT_SELECTED. Par exemple, la valeur de SelectionStatus pour l'image précédente est SELECTED.

Un SELECTION_ELEMENT Block objet est associé soit à une paire clé-valeur, soit à une cellule de tableau. Un SELECTION_ELEMENT Block objet contient des informations de cadre de sélection pour un élément de sélection dans le Geometry champ. Un SELECTION_ELEMENT Block objet n'est pas le fils d'un PAGE Block objet.

Données de formulaire (Key-Value paires)

Une paire clé-valeur est utilisée pour représenter un élément de sélection détecté sur un formulaire. Le KEY bloc contient le texte de l'élément de sélection. Le VALUE bloc contient le bloc SELECTION_ELEMENT. Le schéma suivant montre comment les éléments de sélection sont représentés par les objets Block.

Schéma illustrant la représentation d'un élément de sélection sur un formulaire à l'aide d'une structure de données par paire clé-valeur, avec KEY contenant le texte, VALUE contenant le SELECTION_ELEMENT et PAGE comme objet parent.

Pour plus d'informations sur les paires clé-valeur, consultez. Données de formulaire (Key-Value paires)

L'extrait JSON suivant montre la clé d'une paire clé-valeur qui contient un élément de sélection (male ☑). L'identifiant de l'enfant (Id bd14cfd5-9005-498b-a7f3-45ceb171f0ff) est l'identifiant du bloc WORD qui contient le texte de l'élément de sélection (masculin). La valeur ID (ID 24aaac7f-fcce-49c7-a4f0-3688b05586d4) est l'ID du bloc qui contient l'objet du bloc. VALUE SELECTION_ELEMENT


{
    "Relationships": [
        {
            "Type": "VALUE", 
            "Ids": [
                "24aaac7f-fcce-49c7-a4f0-3688b05586d4"  // Value containing Selection Element
            ]
        }, 
        {
            "Type": "CHILD", 
            "Ids": [
                "bd14cfd5-9005-498b-a7f3-45ceb171f0ff"  // WORD - male
            ]
        }
    ], 
    "Confidence": 94.15619659423828, 
    "Geometry": {
        "BoundingBox": {
            "Width": 0.022914813831448555, 
            "Top": 0.08072036504745483, 
            "Left": 0.18966935575008392, 
            "Height": 0.014860388822853565
        }, 
        "Polygon": [
            {
                "Y": 0.08072036504745483, 
                "X": 0.18966935575008392
            }, 
            {
                "Y": 0.08072036504745483, 
                "X": 0.21258416771888733
            }, 
            {
                "Y": 0.09558075666427612, 
                "X": 0.21258416771888733
            }, 
            {
                "Y": 0.09558075666427612, 
                "X": 0.18966935575008392
            }
        ]
    }, 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "KEY"
    ], 
    "Id": "a118dc43-d5f7-49a2-a20a-5f876d9ffd79"
}

L'extrait JSON suivant est le bloc WORD pour le mot Homme. Le bloc WORD possède également un bloc LINE parent.


{
    "Geometry": {
        "BoundingBox": {
            "Width": 0.022464623674750328, 
            "Top": 0.07842985540628433, 
            "Left": 0.18863198161125183, 
            "Height": 0.01617223583161831
        }, 
        "Polygon": [
            {
                "Y": 0.07842985540628433, 
                "X": 0.18863198161125183
            }, 
            {
                "Y": 0.07842985540628433, 
                "X": 0.2110965996980667
            }, 
            {
                "Y": 0.09460209310054779, 
                "X": 0.2110965996980667
            }, 
            {
                "Y": 0.09460209310054779, 
                "X": 0.18863198161125183
            }
        ]
    }, 
    "Text": "Male", 
    "BlockType": "WORD", 
    "Confidence": 54.06439208984375, 
    "Id": "bd14cfd5-9005-498b-a7f3-45ceb171f0ff"
},

Le bloc VALUE possède un enfant (ID f2f5e8cd-e73a-4e99-a095-053acd3b6bfb) qui est le bloc SELECTION_ELEMENT.


{
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "f2f5e8cd-e73a-4e99-a095-053acd3b6bfb"  // Selection element
            ]
        }
    ], 
    "Confidence": 94.15619659423828, 
    "Geometry": {
        "BoundingBox": {
            "Width": 0.017281491309404373, 
            "Top": 0.07643391191959381, 
            "Left": 0.2271782010793686, 
            "Height": 0.026274094358086586
        }, 
        "Polygon": [
            {
                "Y": 0.07643391191959381, 
                "X": 0.2271782010793686
            }, 
            {
                "Y": 0.07643391191959381, 
                "X": 0.24445968866348267
            }, 
            {
                "Y": 0.10270800441503525, 
                "X": 0.24445968866348267
            }, 
            {
                "Y": 0.10270800441503525, 
                "X": 0.2271782010793686
            }
        ]
    }, 
    "BlockType": "KEY_VALUE_SET", 
    "EntityTypes": [
        "VALUE"
    ], 
    "Id": "24aaac7f-fcce-49c7-a4f0-3688b05586d4"
}, 
}

Le JSON suivant est le bloc SELECTION_ELEMENT. La valeur de SelectionStatus indique que la case est cochée.


{
    "Geometry": {
        "BoundingBox": {
            "Width": 0.020316146314144135, 
            "Top": 0.07575977593660355, 
            "Left": 0.22590067982673645, 
            "Height": 0.027631107717752457
        }, 
        "Polygon": [
            {
                "Y": 0.07575977593660355, 
                "X": 0.22590067982673645
            }, 
            {
                "Y": 0.07575977593660355, 
                "X": 0.2462168186903
            }, 
            {
                "Y": 0.1033908873796463, 
                "X": 0.2462168186903
            }, 
            {
                "Y": 0.1033908873796463, 
                "X": 0.22590067982673645
            }
        ]
    }, 
    "BlockType": "SELECTION_ELEMENT", 
    "SelectionStatus": "SELECTED", 
    "Confidence": 74.14942932128906, 
    "Id": "f2f5e8cd-e73a-4e99-a095-053acd3b6bfb"
}

Cellules du tableau

Amazon Textract peut détecter des éléments de sélection dans une cellule de tableau. Par exemple, les cellules du tableau suivant comportent des cases à cocher.

	D'accord	Neutre	Pas d'accord
Bon service	☑	☐	☐
Facile à utiliser	☐	☑	☐
Prix équitable	☑	☐	☐

Un CELL bloc peut contenir des SELECTION_ELEMENT objets enfants pour les éléments de sélection et des WORD blocs enfants pour le texte détecté.

Schéma illustrant la structure hiérarchique d'une mise en page avec des composants : page, tableau, cellule, mot et élément de sélection.

Pour plus d'informations sur les tableaux, consultezTables.

L'Blockobjet TABLE du tableau précédent ressemble à celui-ci.


{
    "Geometry": {.....}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "652c09eb-8945-473d-b1be-fa03ac055928", 
                "37efc5cc-946d-42cd-aa04-e68e5ed4741d", 
                "4a44940a-435a-4c5c-8a6a-7fea341fa295", 
                "2de20014-9a3b-4e26-b453-0de755144b1a", 
                "8ed78aeb-5c9a-4980-b669-9e08b28671d2", 
                "1f8e1c68-2c97-47b2-847c-a19619c02ca9", 
                "9927e1d1-6018-4960-ac17-aadb0a94f4d9", 
                "68f0ed8b-a887-42a5-b618-f68b494a6034", 
                "fcba16e0-6bd7-4ea5-b86e-36e8330b68ea", 
                "2250357c-ae34-4ed9-86da-45dac5a5e903", 
                "c63ad40d-5a14-4646-a8df-2d4304213dbc",   // Cell
                "2b8417dc-e65f-4fcd-aa0f-61a23f1e8cb0", 
                "26c62932-72f0-4dc2-9893-1ae27829c060", 
                "27f291cc-abf4-4c23-aa24-676abe99cb1e", 
                "7e5ce028-1bcd-4d9f-ad42-15ac181c5b47", 
                "bf32e3d2-efa2-4fc1-b09b-ab9cc52ff734"
            ]
        }
    ], 
    "BlockType": "TABLE", 
    "Confidence": 99.99993896484375, 
    "Id": "f66eac36-2e74-406e-8032-14d1c14e0b86"
}

L'BLOCKobjet CELL (ID c63ad40d-5a14-4646-a8df-2d4304213dbc) de la cellule contenant la case à cocher Good Service se présente comme suit. Il inclut un enfant Block (Id = 26d122fd-c5f4-4b53-92c4-0ae92730ee1e) qui est l'objet de la case à cocher. SELECTION_ELEMENT Block


{
    "Geometry": {.....}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "26d122fd-c5f4-4b53-92c4-0ae92730ee1e"  // Selection Element
            ]
        }
    ], 
    "Confidence": 79.741689682006836, 
    "RowSpan": 1, 
    "RowIndex": 3, 
    "ColumnIndex": 3, 
    "ColumnSpan": 1, 
    "BlockType": "CELL", 
    "Id": "c63ad40d-5a14-4646-a8df-2d4304213dbc"
}

L'Blockobjet SELECTION_ELEMENT pour la case à cocher est le suivant. La valeur de SelectionStatus indique que la case est cochée.


{
    "Geometry": {.......}, 
    "BlockType": "SELECTION_ELEMENT", 
    "SelectionStatus": "SELECTED", 
    "Confidence": 88.79517364501953, 
    "Id": "26d122fd-c5f4-4b53-92c4-0ae92730ee1e"
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Tables

Requêtes