Dati del modulo (coppie chiave-valore)

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 comeBlockoggetti nelle risposte daAnalyzeDocumenteGetDocumentAnalysis. Puoi utilizzare il pluginFeatureTypesparametro di input per recuperare informazioni su coppie chiave-valore, tabelle o entrambi. Solo per coppie chiave-valore, utilizzare il valoreFORMS. Per un esempio, consultare Estrazione di coppie chiave-valore da un documento modulo. Per informazioni generali sul modo in cui un documento è rappresentato daBlockoggetti, vediOggetti di risposta di rilevamento del testo e analisi dei documenti.

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 pluginEntityTypeattributo per determinare se un blocco è KEY o VALUE.

• UNCHIAVEL'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.

• UNVALOREL'oggetto contiene informazioni sul testo associato a una chiave. Nell'esempio precedente,Ana Carolinaè il valore della chiaveNome:. 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. UNVALUEL'oggetto può anche contenere informazioni sugli elementi selezionati. Per ulteriori informazioni, consultare Elementi di selezione.

Ogni istanza di un KEY_VALUE_SETBlockl'oggetto è un figlio di PAGEBlockoggetto che corrisponde alla pagina corrente.

Il diagramma riportato di seguito illustra come la coppia chiave-valoreNome: Ana Carolinaè rappresentato daBlockobjects.

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

Il blocco PAGE ha blocchi CHILD di tipoKEY_VALUE_SETper 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 (- AnaeCarolina).

{
    "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 ilBlockoggetti per le paroleNome:,- Ana, eCarolina.

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