

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Oggetti di risposta di rilevamento del testo e analisi dei documenti
<a name="how-it-works-document-layout"></a>

Quando Amazon Textract elabora un documento, crea un elenco di[Block](API_Block.md)oggetti per il testo rilevato o analizzato. Ogni blocco contiene informazioni su un articolo rilevato, dove si trova e la sicurezza di Amazon Textract nell'accuratezza dell'elaborazione.

Un documento è costituito dai seguenti tipi di`Block`objects.
+ [Pagine](how-it-works-pages.md)
+  [Linee e parole di testo](how-it-works-lines-words.md) 
+  [Dati modulo (coppie chiave-valore)](how-it-works-kvp.md) 
+  [Tabelle e celle](how-it-works-tables.md) 
+ [Elementi di selezione](how-it-works-selectables.md)

Il contenuto di un blocco dipende dall'operazione chiamata. Se si chiama una delle operazioni di rilevamento del testo, vengono restituite le pagine, le righe e le parole del testo rilevato. Per ulteriori informazioni, consultare [Rilevamento del testo](how-it-works-detecting.md). Se si chiama una delle operazioni di analisi del documento, vengono restituite le informazioni sulle pagine rilevate, le coppie chiave-valore, le tabelle, gli elementi di selezione e il testo. Per ulteriori informazioni, consultare [Analisi di documenti](how-it-works-analyzing.md).

Medio`Block`I campi dell'oggetto sono comuni a entrambi i tipi di elaborazione. Ad esempio, ogni blocco ha un identificatore univoco.

Per esempi che mostrano come utilizzare`Block`oggetti, vedi[Tutorial](examples-blocks.md).

## Layout del documento
<a name="hows-it-works-blocks-types.title"></a>

Amazon Textract restituisce una rappresentazione di un documento come elenco di diversi tipi di`Block`oggetti collegati in una relazione padre-figlio o in una coppia chiave-valore. Vengono restituiti anche i metadati che forniscono il numero di pagine in un documento. Di seguito è riportato il JSON per un tipico`Block`Oggetto di tipo`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 documento è costituito da uno o più documenti`PAGE`blocca. Ogni pagina contiene un elenco di blocchi figlio per gli elementi principali rilevati nella pagina, ad esempio righe di testo e tabelle. Per ulteriori informazioni, consultare [Pagine](how-it-works-pages.md). 

È possibile determinare il tipo di`Block`obiettare ispezionando il`BlockType`.

UN`Block`L'oggetto contiene un elenco di elementi correlati`Block`oggetti nel`Relationships`campo, che è una serie di[Relationship](API_Relationship.md)objects. UN`Relationships`array è di tipo CHILD o di tipo VALUE. Un array di tipo CHILD viene utilizzato per elencare gli elementi figlio del blocco corrente. Ad esempio, se il blocco corrente è di tipo LINE,`Relationships`contiene un elenco di ID per i blocchi WORD che compongono la riga di testo. Un array di tipo VALUE viene utilizzato per contenere coppie chiave-valore. È possibile determinare il tipo di relazione ispezionando il`Type`del campo`Relationship`oggetto. 

I blocchi figlio non hanno informazioni sugli oggetti Blocco padre.

Per esempi che mostrano`Block`informazioni, consulta[Elaborazione di documenti con operazioni sincrone](sync.md).

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

L'affidabilità di Amazon Textract riguardo alla precisione dell'articolo rilevato. Per avere la fiducia, usa il`Confidence`del campo`Block`oggetto. Un valore elevato indica una maggiore confidenza. A seconda dello scenario, i rilevamenti con una bassa confidenza potrebbero aver bisogno di una conferma visiva da parte di un essere umano.

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

Le operazioni di Amazon Textract, ad eccezione dell'analisi delle identità, restituiscono informazioni sulla posizione degli elementi rilevati in una pagina del documento. Per ottenere la posizione, utilizzare il modulo`Geometry`del campo`Block`oggetto. Per ulteriori informazioni, consulta[Posizione dell'articolo in una pagina del documento](text-location.md) 

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

Un documento è costituito da una o più pagine. UN[Block](API_Block.md)Oggetto di tipo`PAGE`esiste per ogni pagina del documento. UN`PAGE`block object contiene un elenco degli ID figlio per le righe di testo, le coppie chiave-valore e le tabelle rilevate nella pagina del documento. 

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


Il JSON per un`PAGE`Il blocco è simile a quello riportato di seguito.

```
{

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

Se si utilizzano operazioni asincrone con un documento multipagina in formato PDF, è possibile determinare la pagina in cui si trova un blocco ispezionando il`Page`del campo`Block`oggetto. Un'immagine scansionata (un'immagine in formato JPEG, PNG, PDF o TIFF) è considerata un documento a pagina singola, anche se nell'immagine è presente più di una pagina del documento. Le operazioni asincrone restituiscono sempre un`Page`valore di 1 per le immagini scansionate.

Il numero totale di pagine viene restituito nel`Pages`campo di`DocumentMetadata`.`DocumentMetadata`viene restituito con ogni elenco di`Block`oggetti restituiti da un'operazione Amazon Textract.

# Linee e parole di testo
<a name="how-it-works-lines-words"></a>

Il testo rilevato restituito dalle operazioni di Amazon Textract viene restituito in un elenco di[Block](API_Block.md)objects. Questi oggetti rappresentano righe di testo o parole testuali rilevate in una pagina del documento. Il testo seguente mostra due righe di testo formate da più parole.

Questo è testo.

In due righe separate.

Il testo rilevato viene restituito nella`Text`campo di a`Block`oggetto. La`BlockType`campo determina se il testo è una riga di testo (LINEA) o una parola (WORD). UN*PAROLA*è uno o più caratteri di script latino di base ISO non separati da spazi. UN*LINEA*è una stringa di parole delimitate da tabulazioni e contigue.

 Inoltre, Amazon Textract determinerà se un pezzo di testo è stato scritto a mano o stampato utilizzando il`TextTypes`. Restituiscono rispettivamente come HANDWWRITING e PRINTED 

L'altro`Block`le proprietà sono comuni a tutti i tipi di blocchi, come l'ID, la confidenza e le informazioni sulla geometria. Per ulteriori informazioni, consultare [Oggetti di risposta di rilevamento del testo e analisi dei documenti](how-it-works-document-layout.md). 

Per rilevare solo linee e parole, è possibile utilizzare[DetectDocumentText](API_DetectDocumentText.md)o[StartDocumentTextDetection](API_StartDocumentTextDetection.md). Per ulteriori informazioni, consultare [Rilevamento del testo](how-it-works-detecting.md). Per ottenere il testo rilevato (righe e parole) e informazioni su come si riferisce ad altre parti del documento, come le tabelle, è possibile utilizzare[AnalyzeDocument](API_AnalyzeDocument.md)o[StartDocumentAnalysis](API_StartDocumentAnalysis.md). Per ulteriori informazioni, consultare [Analisi di documenti](how-it-works-analyzing.md).

`PAGE`,`LINE`, e`WORD`i blocchi sono correlati tra loro in una relazione genitore-figlio. UN`PAGE`block è il genitore per tutti`LINE`blocca gli oggetti in una pagina del documento. Poiché una LINEA può avere una o più parole,`Relationships`l'array per un blocco LINE memorizza gli ID per i blocchi WORD figlio che costituiscono la riga di testo. 

Il diagramma riportato di seguito illustra come la linea*Ciao, world.*nel testo*Ciao, world. Come stai?*è rappresentato da`Block`objects. 

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




Di seguito è riportato l'output JSON da`DetectDocumentText`quando la frase*Ciao, world. Come stai?*viene rilevato. Il primo esempio è il JSON per la pagina del documento. Nota come gli ID FIGLIO consentono di navigare nel documento.

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

Di seguito è riportato il JSON per i blocchi LINE che compongono la riga «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"
},
```

Di seguito è riportato il JSON per il blocco WORD per la parola*Ciao,*: 

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

Il JSON finale è il blocco WORD per la parola*mondo.*:

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

# Dati del modulo (coppie chiave-valore)
<a name="how-it-works-kvp"></a>

Amazon Textract può estrarre i dati dei moduli dai documenti come coppie chiave-valore. Ad esempio, nel seguente testo, Amazon Textract può identificare una chiave (*Nome:*) e un valore (*Ana Carolina*).

Nome: Ana Carolina

Le coppie chiave-valore rilevate vengono restituite come[Block](API_Block.md)oggetti nelle risposte da[AnalyzeDocument](API_AnalyzeDocument.md)e[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Puoi utilizzare il plugin`FeatureTypes`parametro di input per recuperare informazioni su coppie chiave-valore, tabelle o entrambi. Solo per coppie chiave-valore, utilizzare il valore`FORMS`. Per un esempio, consultare [Estrazione di coppie chiave-valore da un documento modulo](examples-extract-kvp.md). Per informazioni generali sul modo in cui un documento è rappresentato da`Block`oggetti, vedi[Oggetti di risposta di rilevamento del testo e analisi dei documenti](how-it-works-document-layout.md). 

Gli oggetti Block con il tipo KEY\$1VALUE\$1SET sono i contenitori per gli oggetti KEY o VALUE Block che memorizzano informazioni sugli elementi di testo collegati rilevati in un documento. Puoi utilizzare il plugin`EntityType`attributo per determinare se un blocco è KEY o VALUE. 
+ UN*CHIAVE*L'oggetto contiene informazioni sulla chiave per il testo collegato. Ad esempio:*Nome:*. Un blocco KEY ha due elenchi di relazioni. Una relazione di tipo VALUE è un elenco che contiene l'ID del blocco VALUE associato alla chiave. Una relazione di tipo CHILD è un elenco di ID per i blocchi WORD che compongono il testo della chiave.
+ UN*VALORE*L'oggetto contiene informazioni sul testo associato a una chiave. Nell'esempio precedente,*Ana Carolina*è il valore della chiave*Nome:*. Un blocco VALUE ha una relazione con un elenco di blocchi CHILD che identificano i blocchi WORD. Ogni blocco WORD contiene una delle parole che compongono il testo del valore. UN`VALUE`L'oggetto può anche contenere informazioni sugli elementi selezionati. Per ulteriori informazioni, consultare [Elementi di selezione](how-it-works-selectables.md).

Ogni istanza di un KEY\$1VALUE\$1SET`Block`l'oggetto è un figlio di PAGE`Block`oggetto che corrisponde alla pagina corrente.

Il diagramma riportato di seguito illustra come la coppia chiave-valore*Nome: Ana Carolina*è rappresentato da`Block`objects.

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


I seguenti esempi mostrano come la coppia chiave-valore*Nome: Ana Carolina*è rappresentato da JSON.

Il blocco PAGE ha blocchi CHILD di tipo`KEY_VALUE_SET`per ogni blocco KEY e VALUE rilevato nel documento. 

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

Il seguente JSON mostra che il blocco KEY (52be1777-53f7-42f6-a7cf-6d09bdc15a30) ha una relazione con il blocco VALUE (7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c). Ha anche un blocco CHILD per il blocco WORD (c734fca6-c4c4-415c-b6c1-30f7510b72ee) che contiene il testo per la chiave (*Nome:*).

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

Il seguente JSON mostra che il blocco VALUE 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c ha un elenco FIGLIO di ID per i blocchi WORD che compongono il testo del valore (*- Ana*e*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
}
```

Il seguente JSON mostra il`Block`oggetti per le parole*Nome:*,*- Ana*, e*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"
},
```

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

Amazon Textract può estrarre tabelle e celle di una tabella. Ad esempio, quando viene rilevata la tabella seguente in un modulo, Amazon Textract rileva una tabella con quattro celle. 


| Nome | Indirizzo | 
| --- | --- | 
|  Ana Carolina  |  123 Qualsiasi città  | 

Le tabelle rilevate vengono restituite come[Block](API_Block.md)oggetti nelle risposte da[AnalyzeDocument](API_AnalyzeDocument.md)e[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Puoi utilizzare il plugin`FeatureTypes`parametro di input per recuperare informazioni su coppie chiave-valore, tabelle o entrambi. Solo per le tabelle, utilizzare il valore`TABLES`. Per un esempio, consultare [Esportazione di tabelle in un file CSV](examples-export-table-csv.md). Per informazioni generali sul modo in cui un documento è rappresentato da`Block`oggetti, vedi[Oggetti di risposta di rilevamento del testo e analisi dei documenti](how-it-works-document-layout.md).

Il diagramma riportato di seguito illustra come viene rappresentata una singola cella in una tabella.`Block`objects.

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


Una cella contiene`WORD`blocchi per parole rilevate e`SELECTION_ELEMENT`blocchi per elementi di selezione come caselle di controllo. 

Di seguito è riportato un JSON parziale per la tabella precedente, che ha quattro celle.

L'oggetto PAGE Block contiene un elenco di ID Blocco FIGLIO per il blocco TABLE e ogni LINEA di testo rilevata. 

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

Il blocco TABLE include un elenco di ID figlio per le celle all'interno della tabella. Un blocco TABLE include anche informazioni sulla geometria per la posizione della tabella nel documento. Il seguente JSON mostra che la tabella ha quattro celle, elencate nella`Ids`array.

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

Il tipo di blocco per le celle della tabella è CELL. La`Block`l'oggetto per ogni cella include informazioni sulla posizione della cella rispetto ad altre celle della tabella. Include inoltre informazioni sulla geometria per la posizione della cella sul documento. Nell'esempio precedente,`505e9581-0d1c-42fb-a214-6ff736822e8c`è l'ID figlio per la cella che contiene la parola*Nome*. L'esempio seguente sono le informazioni per la cella. 

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

Ogni cella ha una posizione in una tabella, con la prima cella 1,1. Nell'esempio precedente, la cella con il valore*Nome*è alla riga 1, colonna 1. La cella con il valore*123 Qualsiasi città*è alla riga 2, colonna 2. Un oggetto blocco di celle contiene queste informazioni nel`RowIndex`e`ColumnIndex`. L'elenco figlio contiene gli ID per gli oggetti WORD Block che contengono il testo che si trova all'interno della cella. Le parole nell'elenco sono nell'ordine in cui vengono rilevate, dall'alto a sinistra della cella in basso a destra della cella. Nell'esempio precedente, la cella ha un ID figlio con il valore e9108c8e-0167-4482-989e-8b6cd3c3653e. Il seguente output è per il WORD Block con il valore ID di e9108c8e-0167-4482-989e-8b6cd3c3653e: 

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

# Elementi di selezione
<a name="how-it-works-selectables"></a>

Amazon Textract è in grado di rilevare elementi di selezione come pulsanti di opzione (pulsanti di opzione) e caselle di controllo in una pagina del documento. Gli elementi di selezione possono essere rilevati in[dati del modulo](how-it-works-kvp.md)e in[tabelle](how-it-works-tables.md). Ad esempio, quando viene rilevata la tabella seguente in un modulo, Amazon Textract rileva le caselle di controllo nelle celle della tabella.


|  |  |  |  | 
| --- |--- |--- |--- |
|     |  **Accetto**  |  **Neutral**  |  **Non sono d'accordo**  | 
|  **Buon servizio**  |  ☑  |  ☐  |  ☐  | 
|  **Facile da usare**  |  ☐  |  ☑  |  ☐  | 
|  **Prezzo equo**  |  ☑  |  ☐  |  ☐  | 

Gli elementi di selezione rilevati vengono restituiti come[Block](API_Block.md)oggetti nelle risposte da[AnalyzeDocument](API_AnalyzeDocument.md)e[GetDocumentAnalysis](API_GetDocumentAnalysis.md).

**Nota**  
Puoi utilizzare il plugin`FeatureTypes`parametro di input per recuperare informazioni su coppie chiave-valore, tabelle o entrambi. Ad esempio, se si filtrano sulle tabelle, la risposta include gli elementi di selezione rilevati nelle tabelle. Gli elementi di selezione rilevati nelle coppie chiave-valore non sono inclusi nella risposta.

Le informazioni su un elemento di selezione sono contenute in un`Block`Oggetto di tipo`SELECTION_ELEMENT`. Per determinare lo stato di un elemento selezionabile, utilizza`SelectionStatus`del campo`SELECTION_ELEMENT`blocca. Lo stato può essere*SELEZIONATO*o*NOT\$1SELECTED*. Ad esempio, il valore di`SelectionStatus`per l'immagine precedente è*SELEZIONATO*.

UN`SELECTION_ELEMENT` `Block`l'oggetto è associato a una coppia chiave-valore o a una cella di tabella. UN`SELECTION_ELEMENT` `Block`l'oggetto contiene informazioni sul rettangolo di selezione per un elemento di selezione`Geometry`. UN`SELECTION_ELEMENT` `Block`l'oggetto non è figlio di un`PAGE` `Block`oggetto.

## Dati del modulo (coppie chiave-valore)
<a name="how-it-works-selectable-kvp"></a>

Una coppia chiave-valore viene utilizzata per rappresentare un elemento di selezione rilevato in un modulo. La`KEY`block contiene il testo per l'elemento di selezione. La`VALUE`block contiene il blocco SELECTION\$1ELEMENT. Il diagramma riportato di seguito illustra come vengono rappresentati gli elementi di selezione[Block](API_Block.md)objects.

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


Per ulteriori informazioni sulle coppie chiave-valore, consulta[Dati del modulo (coppie chiave-valore)](how-it-works-kvp.md).

Il seguente snippet JSON mostra la chiave per una coppia chiave-valore che contiene un elemento di selezione (**male ☑**). L'ID figlio (Id bd14cfd5-9005-498b-a7f3-45ceb171f0ff) è l'ID del blocco WORD che contiene il testo per l'elemento di selezione (*maschio*). Il valore ID (Id 24aaac7f-fcce-49c7-a4f0-3688b05586d4) è l'ID del`VALUE`blocco che contiene il`SELECTION_ELEMENT`blocco dell'oggetto.

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

Il seguente snippet JSON è il blocco WORD per la parola*Maschio*. Il blocco WORD ha anche un blocco LINE padre.

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

Il blocco VALUE ha un figlio (Id f2f5e8cd-e73a-4e99-a095-053acd3b6bfb) che è il blocco 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"
}, 
}
```

Il seguente JSON è il blocco SELECTION\$1ELEMENT. Il valore di`SelectionStatus`indica che la casella di controllo è selezionata.

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

## celle di tabella
<a name="how-it-works-selectable-table"></a>

Amazon Textract è in grado di rilevare elementi di selezione all'interno di una cella di tabella Ad esempio, le celle della tabella seguente hanno caselle di controllo.


|  |  |  |  | 
| --- |--- |--- |--- |
|     |  **Accetto**  |  **Neutral**  |  **Non sono d'accordo**  | 
|  **Buon servizio**  |  ☑  |  ☐  |  ☐  | 
|  **Facile da usare**  |  ☐  |  ☑  |  ☐  | 
|  **Prezzo equo**  |  ☑  |  ☐  |  ☐  | 

UN`CELL`può contenere un blocco figlio`SELECTION_ELEMENT`oggetti per elementi di selezione, nonché figlio`WORD`blocchi per il testo rilevato.

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


Per ulteriori informazioni sulle tabelle, consulta[Tabelle](how-it-works-tables.md).

La tabella`Block`l'oggetto per la tabella precedente è simile a questo.

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

La cella`BLOCK`oggetto (Id c63ad40d-5a14-4646-a8df-2d4304213dbc) per la cella che contiene la casella di controllo*Buon servizio*ha il seguente aspetto. Include un bambino`Block`(Id = 26d122fd-c5f4-4b53-92c4-0ae92730ee1e) che è il`SELECTION_ELEMENT` `Block`oggetto per la casella di controllo.

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

SELECTION\$1ELEMENT`Block`oggetto per la casella di controllo è il seguente. Il valore di`SelectionStatus`indica che la casella di controllo è selezionata.

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