

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.

# Objets de réponse Détection de texte et analyse de documents
<a name="how-it-works-document-layout"></a>

Lorsque Amazon Textract traite un document, il crée une liste de[Block](API_Block.md)objets pour le texte détecté ou analysé. Chaque bloc contient des informations sur un article détecté, où il se trouve, et la confiance d'Amazon Textract dans la précision du traitement.

Un document est composé des types suivants de`Block`objets.
+ [Pages](how-it-works-pages.md)
+  [Lignes et mots de texte](how-it-works-lines-words.md) 
+  [Données de formulaire (paires clé-valeur)](how-it-works-kvp.md) 
+  [Tables et cellules](how-it-works-tables.md) 
+ [Éléments de sélection](how-it-works-selectables.md)

Le contenu d'un bloc dépend de l'opération que vous appelez. Si vous appelez l'une des opérations de détection de texte, les pages, les lignes et les mots du texte détecté sont renvoyés. Pour plus d'informations, consultez [Détection de texte](how-it-works-detecting.md). Si vous appelez l'une des opérations d'analyse de documents, des informations sur les pages détectées, les paires clé-valeur, les tableaux, les éléments de sélection et le texte sont renvoyées. Pour plus d'informations, consultez [Analyse des documents](how-it-works-analyzing.md).

Momentanée`Block`Les champs d'objets sont communs aux deux types de traitement. Par exemple, chaque bloc possède un identifiant unique.

Pour obtenir des exemples illustrant l'utilisation`Block`objets, voir[Tutoriels](examples-blocks.md).

## Disposition du document
<a name="hows-it-works-blocks-types.title"></a>

Amazon Textract renvoie une représentation d'un document sous forme de liste de différents types de`Block`objets liés dans une relation parent-enfant ou une paire clé-valeur. Les métadonnées indiquant le nombre de pages d'un document sont également renvoyées. Voici le JSON d'un type type`Block`objet de type`PAGE`.

```
{
    "Blocks": [
        {
            "Geometry": {
                "BoundingBox": {
                    "Width": 1.0, 
                    "Top": 0.0, 
                    "Left": 0.0, 
                    "Height": 1.0
                }, 
                "Polygon": [
                    {
                        "Y": 0.0, 
                        "X": 0.0
                    }, 
                    {
                        "Y": 0.0, 
                        "X": 1.0
                    }, 
                    {
                        "Y": 1.0, 
                        "X": 1.0
                    }, 
                    {
                        "Y": 1.0, 
                        "X": 0.0
                    }
                ]
            }, 
            "Relationships": [
                {
                    "Type": "CHILD", 
                    "Ids": [
                        "2602b0a6-20e3-4e6e-9e46-3be57fd0844b", 
                        "82aedd57-187f-43dd-9eb1-4f312ca30042", 
                        "52be1777-53f7-42f6-a7cf-6d09bdc15a30", 
                        "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"
                    ]
                }
            ], 
            "BlockType": "PAGE", 
            "Id": "8136b2dc-37c1-4300-a9da-6ed8b276ea97"
        }..... 
        
    ], 
    "DocumentMetadata": {
        "Pages": 1
    }
}
```

Un document est fabriqué à partir d'un ou plusieurs`PAGE`. Chaque page contient une liste de blocs enfants pour les éléments principaux détectés sur la page, tels que des lignes de texte et des tableaux. Pour plus d'informations, consultez [Pages](how-it-works-pages.md). 

Vous pouvez déterminer le type d'objet`Block`en inspectant l'objet`BlockType`.

UN`Block`contient une liste de`Block`objets dans le`Relationships`, qui est un tableau de[Relationship](API_Relationship.md)objets. UN`Relationships`tableau est soit de type CHILD, soit de type VALUE. Un tableau de type CHILD permet de répertorier les éléments enfants du bloc actuel. Par exemple, si le bloc actuel est de type LINE,`Relationships`contient une liste d'ID des blocs WORD qui composent la ligne de texte. Un tableau de type VALUE est utilisé pour contenir des paires clé-valeur. Vous pouvez déterminer le type de relation en inspectant le`Type`du champ`Relationship`objet. 

Les blocs enfants ne contiennent pas d'informations sur leurs objets Block parents.

Pour des exemples qui montrent`Block`, consultez[Traitement de documents avec des opérations synchrone](sync.md).

## Fiabilité
<a name="how-it-works-confidence"></a>

Les opérations Amazon Textract indiquent le pourcentage de fiabilité déterminé par Amazon Textract pour l'exactitude de l'article détecté. Pour obtenir la confiance, utilisez le`Confidence`du champ`Block`objet. Une valeur supérieure indique une confiance supérieure. Selon le scénario, les détections avec une faible confiance peuvent nécessiter une confirmation visuelle de la part d'un humain.

## Geometry
<a name="how-it-works-geometry"></a>

Les opérations Amazon Textract, à l'exception de l'analyse d'identité, renvoient des informations de localisation concernant l'emplacement des éléments détectés sur une page de document. Pour obtenir cet emplacement, utilisez le`Geometry`du champ`Block`objet. Pour de plus amples informations, veuillez consulter[Emplacement de l'article sur une page de document](text-location.md) 

# Pages
<a name="how-it-works-pages"></a>

Un document est composé d'une ou plusieurs pages. UN[Block](API_Block.md)objet de type`PAGE`existe pour chaque page du document. UN`PAGE`bloc objet contient une liste des ID enfants des lignes de texte, des paires clé-valeur et des tables détectées sur la page de document. 

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/textract/latest/dg/images/hieroglyph-pages.png)


Le JSON pour un`PAGE`ressemble à ce qui suit.

```
{

    "Geometry": .... 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "2602b0a6-20e3-4e6e-9e46-3be57fd0844b", // Line - Hello, world.
                "82aedd57-187f-43dd-9eb1-4f312ca30042", // Line - How are you?
                "52be1777-53f7-42f6-a7cf-6d09bdc15a30", 
                "7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c"   
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "8136b2dc-37c1-4300-a9da-6ed8b276ea97"  // Page identifier
},
```

Si vous utilisez des opérations asynchrones avec un document multipage au format PDF, vous pouvez déterminer la page sur laquelle se trouve un bloc en inspectant le`Page`du champ`Block`objet. Une image numérisée (image au format JPEG, PNG, PDF ou TIFF) est considérée comme un document d'une seule page, même s'il y a plusieurs pages de document sur l'image. Les opérations asynchrones renvoient toujours un`Page`valeur 1 pour les images numérisées.

Le nombre total de pages est renvoyé dans la`Pages`field of`DocumentMetadata`.`DocumentMetadata`est renvoyé avec chaque liste de`Block`objets renvoyés par une opération Amazon Textract.

# Lignes et mots de texte
<a name="how-it-works-lines-words"></a>

Le texte détecté renvoyé par les opérations Amazon Textract est renvoyé dans une liste de[Block](API_Block.md)objets. Ces objets représentent des lignes de texte ou des mots textuels détectés sur une page de document. Le texte suivant présente deux lignes de texte composées de plusieurs mots.

Il s'agit d'un texte.

En deux lignes distinctes.

Le texte détecté est renvoyé dans le`Text`d'un champ`Block`objet. Le`BlockType`détermine si le texte est une ligne de texte (LINE) ou un mot (WORD). UN*MOT*est un ou plusieurs caractères latins de base ISO non séparés par des espaces. UN*LIGNE*est une chaîne de mots contigus et délimités par des tabulations.

 En outre, Amazon Textract déterminera si un morceau de texte a été manuscrit ou imprimé à l'aide de la`TextTypes`. Ils reviennent respectivement sous forme d'écriture manuscrite et d'impression. 

L'autre`Block`sont communes à tous les types de blocs, tels que l'ID, la confiance et les informations de géométrie. Pour plus d'informations, consultez [Objets de réponse Détection de texte et analyse de documents](how-it-works-document-layout.md). 

Pour détecter uniquement les lignes et les mots, vous pouvez utiliser[DetectDocumentText](API_DetectDocumentText.md)ou[StartDocumentTextDetection](API_StartDocumentTextDetection.md). Pour plus d'informations, consultez [Détection de texte](how-it-works-detecting.md). Pour obtenir le texte détecté (lignes et mots) et des informations sur sa relation avec d'autres parties du document, telles que les tableaux, vous pouvez utiliser[AnalyzeDocument](API_AnalyzeDocument.md)ou[StartDocumentAnalysis](API_StartDocumentAnalysis.md). Pour plus d'informations, consultez [Analyse des documents](how-it-works-analyzing.md).

`PAGE`,`LINE`, et`WORD`les blocs sont liés les uns aux autres dans une relation parent-enfant. UN`PAGE`block est le parent de tous`LINE`blocs d'objets sur une page de document. Parce qu'une ligne peut comporter un ou plusieurs mots, la`Relationships`pour un bloc LINE stocke les ID des blocs WORD enfants qui constituent la ligne de texte. 

Le schéma suivant montre comment la ligne*Hello World.*dans le texte*Hello World. Comment allez-vous ?*est représenté par`Block`objets. 

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/textract/latest/dg/images/hieroglyph-text-detection.png)




Voici la sortie JSON de`DetectDocumentText`quand la phrase*Hello World. Comment allez-vous ?*est détecté. Le premier exemple est le JSON de la page de document. Notez comment les ID CHILD vous permettent de naviguer dans le document.

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "d7fbd604-d609-4d69-857d-247a3f591238", // Line - Hello, world.
                "b6c19a93-6493-4d8e-958f-853c8f7ca055" //  Line - How are you?
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "56ec1d77-171f-4881-9852-2b5b7e761608"
},
```

Voici le JSON pour les blocs LINE qui composent la ligne « Hello, World » : 

```
{
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "7f97e2ca-063e-47a8-981c-8beee31afc01", // Word - Hello,
                "4b990aa0-af96-4369-b90f-dbe02538ed21"  // Word - world.
            ]
        }
    ], 
    "Confidence": 99.63229370117188, 
    "Geometry": {...}, 
    "Text": "Hello, world.", 
    "BlockType": "LINE", 
    "Id": "d7fbd604-d609-4d69-857d-247a3f591238"
},
```

Voici le code JSON du bloc WORD pour le mot*Hello,* : 

```
{
    "Geometry": {...}, 
    "Text": "Hello,", 
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.74746704101562, 
    "Id": "7f97e2ca-063e-47a8-981c-8beee31afc01"
},
```

Le JSON final est le bloc WORD du mot*.* :

```
{
    "Geometry": {...}, 
    "Text": "world.",
    "TextType": "PRINTED",
    "BlockType": "WORD", 
    "Confidence": 99.5171127319336, 
    "Id": "4b990aa0-af96-4369-b90f-dbe02538ed21"
},
```

# Données de formulaire (paires clé-valeur)
<a name="how-it-works-kvp"></a>

Amazon Textract peut extraire les données de formulaire de documents sous forme de paires clé-valeur. Par exemple, dans le texte suivant, Amazon Textract peut identifier une clé (*Name :*) et une valeur (*Ana Caroline*).

Name : Ana Caroline

Les paires clé-valeur détectées sont renvoyées sous forme de[Block](API_Block.md)objets dans les réponses de[AnalyzeDocument](API_AnalyzeDocument.md)et[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Vous pouvez utiliser le plugin`FeatureTypes`paramètre 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 voir un exemple, consultez [Extraction de paires clé-valeur à partir d'un document de formulaire](examples-extract-kvp.md). Pour obtenir des informations générales sur la représentation d'un document`Block`objets, voir[Objets de réponse Détection de texte et analyse de documents](how-it-works-document-layout.md). 

Les objets Block de type KEY\$1VALUE\$1SET sont les conteneurs des objets KEY ou VALUE Block qui stockent des informations sur les éléments de texte liés détectés dans un document. Vous pouvez utiliser le plugin`EntityType`pour déterminer si un bloc est une CLÉ ou une VALEUR. 
+ UN*CLÉ*Objets contient des informations sur la clé du texte lié. Par exemple,*Name :*. Un bloc KEY comporte deux listes de relations. Une relation de type VALUE est une liste contenant l'ID du bloc VALUE associé à la clé. Une relation de type CHILD est une liste d'ID des blocs WORD qui composent le texte de la clé.
+ UN*VALEUR*Objets contient des informations sur le texte associé à une clé. Dans l'exemple précédent,*Ana Caroline*représente 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 composent le texte de la valeur. UN`VALUE`Objets peuvent également contenir des informations sur les éléments sélectionnés. Pour plus d'informations, consultez [Éléments de sélection](how-it-works-selectables.md).

Chaque instance d'un KEY\$1VALUE\$1SET`Block`est un enfant de la page`Block`objet correspondant à la page actuelle.

Le schéma suivant montre comment la paire clé-valeur*Name : Ana Caroline*est représenté par`Block`objets.

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/textract/latest/dg/images/hieroglyph-key-value-set.png)


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

Le bloc PAGE comporte des blocs CHILD de type`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 indique 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é (*Name :*).

```
{
    "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 indique que le bloc VALUE 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c possède une liste ENFANT d'ID pour les blocs WORD qui composent le texte de la valeur (*Ana*et*Caroline*).

```
{
    "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 fichier JSON suivant affiche le`Block`objets pour les mots*Name :*,*Ana*, et*Caroline*.

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

# Tables
<a name="how-it-works-tables"></a>

Amazon Textract peut extraire des tables et des cellules d'une table. Par exemple, lorsque le tableau suivant est détecté sur un formulaire, Amazon Textract détecte une table comportant quatre cellules. 


| Nom | Address | 
| --- | --- | 
|  Ana Caroline  |  123 Any Town  | 

Les tables détectées sont renvoyées sous forme[Block](API_Block.md)objets dans les réponses de[AnalyzeDocument](API_AnalyzeDocument.md)et[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Vous pouvez utiliser le plugin`FeatureTypes`paramètre d'entrée pour récupérer des informations sur les paires clé-valeur, les tables ou les deux. Pour les tables uniquement, utilisez la valeur`TABLES`. Pour voir un exemple, consultez [Exportation de tables dans un fichier CSV](examples-export-table-csv.md). Pour obtenir des informations générales sur la représentation d'un document`Block`objets, voir[Objets de réponse Détection de texte et analyse de documents](how-it-works-document-layout.md).

Le schéma suivant montre comment une cellule unique d'un tableau est représentée par`Block`objets.

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/textract/latest/dg/images/hieroglyph-table-cell.png)


Une cellule contient`WORD`blocs pour les mots détectés, et`SELECTION_ELEMENT`blocs pour les éléments de sélection tels que les cases à cocher. 

Ce qui suit est un JSON partiel pour le tableau précédent, qui comporte quatre cellules.

L'objet PAGE Block contient une liste d'ID de bloc ENFANT pour le bloc TABLE et chaque LIGNE de texte détectée. 

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "f2a4ad7b-f21d-4966-b548-c859b84f66a4",   // Line - Name
                "4dce3516-ffeb-45e0-92a2-60770e9cb744",   // Line  - Address 
                "ee506578-768f-4696-8f4b-e4917e429f50",   // Line - Ana Carolina
                "33fc7223-411b-4399-8a90-ccd3c5a2c196",   // Line  - 123 Any Town
                "3f9665be-379d-4ae7-be44-d02f32b049c2"    // Table
            ]
        }
    ], 
    "BlockType": "PAGE", 
    "Id": "78c3ce84-ae70-418e-add7-27058418adf6"
},
```

Le bloc TABLE inclut une liste d'ID enfants pour les cellules du tableau. Un bloc TABLE inclut également des informations de géométrie pour l'emplacement de la table dans le document. Le fichier JSON suivant indique que la table comporte quatre cellules répertoriées dans le`Ids`tableau.

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "505e9581-0d1c-42fb-a214-6ff736822e8c", 
                "6fca44d4-d3d3-46ab-b22f-7fca1fbaaf02", 
                "9778bd78-f3fe-4ae1-9b78-e6d29b89e5e9", 
                "55404b05-ae12-4159-9003-92b7c129532e"
            ]
        }
    ], 
    "BlockType": "TABLE", 
    "Confidence": 92.5705337524414, 
    "Id": "3f9665be-379d-4ae7-be44-d02f32b049c2"
},
```

Le type de bloc des cellules du tableau est CELL. Le`Block`pour chaque cellule contient des informations sur l'emplacement de la cellule par rapport aux autres cellules du tableau. Il inclut également des informations géométriques pour l'emplacement de la cellule sur le document. Dans l'exemple précédent,`505e9581-0d1c-42fb-a214-6ff736822e8c`est l'ID enfant de la cellule contenant le mot*Nom*. L'exemple suivant illustre les informations relatives à la cellule. 

```
{
    "Geometry": {...}, 
    "Relationships": [
        {
            "Type": "CHILD", 
            "Ids": [
                "e9108c8e-0167-4482-989e-8b6cd3c3653e"
            ]
        }
    ], 
    "Confidence": 100.0, 
    "RowSpan": 1, 
    "RowIndex": 1, 
    "ColumnIndex": 1, 
    "ColumnSpan": 1, 
    "BlockType": "CELL", 
    "Id": "505e9581-0d1c-42fb-a214-6ff736822e8c"
},
```

Chaque cellule a un emplacement dans un tableau, la première cellule étant 1,1. Dans l'exemple précédent, la cellule avec la valeur*Nom*se trouve à la ligne 1, colonne 1. La cellule avec la valeur*123 Any Town*se trouve à la ligne 2, colonne 2. Un objet de bloc de cellules contient ces informations dans le`RowIndex`et`ColumnIndex`. La liste enfant contient les ID des objets WORD Block qui contiennent le texte qui se trouve dans la cellule. Les mots de la liste sont dans l'ordre dans lequel ils sont détectés, du haut à gauche de la cellule jusqu'en bas à droite de la cellule. Dans l'exemple précédent, la cellule a un ID enfant avec la valeur e9108c8e-0167-4482-989e-8b6cd3c3653e. La sortie suivante concerne le bloc WORD dont la valeur d'ID est e9108c8e-0167-4482-989e-8b6cd3c3653e : 

```
"Geometry": {...}, 
"Text": "Name", 
"TextType": "Printed",
"BlockType": "WORD",
"Confidence": 99.81139373779297, 
"Id": "e9108c8e-0167-4482-989e-8b6cd3c3653e"
},
```

# Éléments de sélection
<a name="how-it-works-selectables"></a>

Amazon Textract peut détecter des éléments de sélection tels que les boutons d'option (boutons radio) et les cases à cocher sur une page de document. Les éléments de sélection peuvent être détectés dans[données de formulaire](how-it-works-kvp.md)et dans[tables](how-it-works-tables.md). Par exemple, lorsque le tableau suivant est détecté sur un formulaire, Amazon Textract détecte les cases à cocher dans les cellules du tableau.


|  |  |  |  | 
| --- |--- |--- |--- |
|     |  **D'accord**  |  **Neutral**  |  **En désaccord**  | 
|  **Bon service**  |  ☑  |  ☐  |  ☐  | 
|  **Facile à utiliser**  |  ☐  |  ☑  |  ☐  | 
|  **Prix équitable**  |  ☑  |  ☐  |  ☐  | 

Les éléments de sélection détectés sont renvoyés comme[Block](API_Block.md)objets dans les réponses de[AnalyzeDocument](API_AnalyzeDocument.md)et[GetDocumentAnalysis](API_GetDocumentAnalysis.md).

**Note**  
Vous pouvez utiliser le plugin`FeatureTypes`paramètre 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 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 type`SELECTION_ELEMENT`. Pour déterminer l'état d'un élément sélectionnable, utilisez la`SelectionStatus`dans le domaine`SELECTION_ELEMENT`. Le statut peut être l'un ou l'autre*SÉLECTIONNÉ*ou*NOT\$1SELECTED*. Par exemple, la valeur de`SelectionStatus`pour l'image précédente est*SÉLECTIONNÉ*.

UN`SELECTION_ELEMENT` `Block`est associé à une paire clé-valeur ou à une cellule de table. UN`SELECTION_ELEMENT` `Block`contient des informations de cadre de sélection pour un élément de sélection dans la zone de sélection`Geometry`. UN`SELECTION_ELEMENT` `Block`n'est pas un enfant d'un objet`PAGE` `Block`objet.

## Données de formulaire (paires clé-valeur)
<a name="how-it-works-selectable-kvp"></a>

Une paire clé-valeur est utilisée pour représenter un élément de sélection détecté sur un formulaire. Le`KEY`contient le texte de l'élément de sélection. Le`VALUE`contient le bloc SELECTION\$1ELEMENT. Le schéma suivant montre comment les éléments de sélection sont représentés par[Block](API_Block.md)objets.

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/textract/latest/dg/images/hieroglyph-key-value-set-selectable.png)


Pour plus d'informations sur les paires clé-valeur, consultez[Données de formulaire (paires clé-valeur)](how-it-works-kvp.md).

L'extrait JSON suivant affiche la clé d'une paire clé-valeur contenant un élément de sélection (**male ☑**). 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*). L'ID de valeur (Id 24aaac7f-fcce-49c7-a4f0-3688b05586d4) est l'ID du`VALUE`qui contient le bloc`SELECTION_ELEMENT`bloc d'objet.

```
{
    "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 du 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 a un enfant (Id f2f5e8cd-e73a-4e99-a095-053acd3b6bfb) qui est le bloc SELECTION\$1ELEMENT. 

```
{
    "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\$1ELEMENT. Pour`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 de
<a name="how-it-works-selectable-table"></a>

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


|  |  |  |  | 
| --- |--- |--- |--- |
|     |  **D'accord**  |  **Neutral**  |  **En désaccord**  | 
|  **Bon service**  |  ☑  |  ☐  |  ☐  | 
|  **Facile à utiliser**  |  ☐  |  ☑  |  ☐  | 
|  **Prix équitable**  |  ☑  |  ☐  |  ☐  | 

UN`CELL`peut contenir un enfant`SELECTION_ELEMENT`objets pour éléments de sélection, ainsi que pour enfants`WORD`blocs pour le texte détecté.

![\[alt text not found\]](http://docs.aws.amazon.com/fr_fr/textract/latest/dg/images/hieroglyph-table-cell-selectable.png)


Pour plus d'informations sur les tableaux, consultez[Tables](how-it-works-tables.md).

La TABLE`Block`pour le 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"
}
```

Cell`BLOCK`objet (Id c63ad40d-5a14-4646-a8df-2d4304213dbc) pour la cellule contenant la case à cocher*Bon service*On dirait ce qui suit. Il comprend un enfant`Block`(Id = 26d122fd-c5f4-4b53-92c4-0ae92730ee1e) c'est le`SELECTION_ELEMENT` `Block`pour la case à cocher.

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

Le SELECTION\$1ELEMENT`Block`objet de la case à cocher est le suivant. Pour`SelectionStatus`indique que la case est cochée.

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