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

Éléments de sélection

Amazon Textract peut détecter les é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 des formulaires 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 AnalyzeDocumentet 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

En outre, Amazon Textract peut détecter les éléments cliquables implicites, ou les éléments cliquables structurés sous forme de questions auxquelles 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 tables ou les deux. Par exemple, si vous filtrez sur des tables, la réponse inclut les éléments de sélection détectés dans les tables. Les éléments de sélection détectés dans les 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 le statut 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é à une paire clé-valeur ou à une cellule de tableau. Un SELECTION_ELEMENT Block objet contient les informations du cadre de sélection correspondant à un élément de sélection dans le Geometry champ. Un SELECTION_ELEMENT Block objet n'est pas un enfant d'un PAGE Block objet.

Données du 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 du formulaire (Key-Value paires)

L'extrait de code JSON suivant montre la clé d'une paire clé-valeur contenant un élément de sélection (mâle ☑). L'ID enfant (ID bd14cfd5-9005-498b-a7f3-45ceb171f0ff) est l'ID 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 de code JSON suivant est le bloc WORD pour le mot Male. 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 a 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 les composants suivants : page, tableau, cellule, mot et élément de sélection.

Pour plus d'informations sur les tables, consultezTables.

L'Blockobjet TABLE du tableau précédent ressemble à ceci.


{
    "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 ressemble à ce qui 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