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à.

# 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\_VALUE\_SET 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\_VALUE\_SET`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.

![](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"
},
```