View a markdown version of this page

Dati del modulo (Key-Value coppie) - Amazon Textract

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 (Key-Value coppie)

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

Nome: Ana Carolina

Le coppie chiave-valore rilevate vengono restituite come oggetti Block nelle risposte da AnalyzeDocumente. GetDocumentAnalysis È possibile utilizzare il parametro FeatureTypes di input per recuperare informazioni su coppie chiave-valore, tabelle o entrambi. Utilizzate il valore solo per le coppie chiave-valore. FORMS Per vedere un esempio, consulta Estrazione di Key-Value coppie da un modulo. Per informazioni generali su come un documento è rappresentato dagli Block oggetti, vedere. Oggetti di risposta per il rilevamento del testo e l'analisi dei documenti

Le date trovate tramite il rilevamento della coppia chiave-valore vengono restituite esattamente come rilevate nel documento di input, con la maggior parte dei formati di data supportati.

Gli oggetti a blocchi di tipo KEY_VALUE_SET sono i contenitori per gli oggetti KEY o VALUE Block che memorizzano le informazioni sugli elementi di testo collegati rilevati in un documento. È possibile utilizzare l'EntityTypeattributo per determinare se un blocco è una CHIAVE o un VALORE.

  • Un oggetto KEY contiene informazioni sulla chiave per il testo collegato. Ad esempio, Name:. 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 costituiscono il testo della chiave.

  • Un oggetto VALUE contiene informazioni sul testo associato a una chiave. Nell'esempio precedente, Ana Carolina è il valore per la chiave Name:. 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 oggetto può contenere anche informazioni sugli elementi selezionati. Per ulteriori informazioni, consulta Elementi di selezione.

Amazon Textract restituisce lo stesso valore di confidenza sia per KEY che per VALUE in un KEY_VALUE_SET, poiché sia KEY che VALUE vengono valutati in coppia. Restituisce un valore di confidenza diverso per una parola in blocchi WORD.

Ogni istanza di un Block oggetto KEY_VALUE_SET è un elemento secondario dell'Blockoggetto PAGE che corrisponde alla pagina corrente.

Il diagramma seguente mostra come la coppia chiave-valore Name: Ana Carolina è rappresentata dagli oggetti. Block

Diagramma che illustra la struttura di una tabella di database con una pagina contenente chiavi e valori, in cui le chiavi sono le parole «Name:», «Ana» e «Carolina».

Gli esempi seguenti mostrano come la coppia chiave-valore Name: Ana Carolina è rappresentata da JSON.

Il blocco PAGE contiene 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 codice 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 codice JSON seguente mostra che il blocco VALUE 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c ha un elenco CHILD 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 codice JSON seguente mostra gli oggetti per le parole Name:, Ana e Carolina. Block

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