View a markdown version of this page

Datos del formulario (Key-Value pares) - Amazon Textract

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Datos del formulario (Key-Value pares)

Amazon Textract puede extraer datos de formularios de documentos como pares clave-valor. Por ejemplo, en el texto siguiente, Amazon Textract puede identificar una clave (Nombre:) y un valor (Ana Carolina).

Nombre: Ana Carolina

Los pares clave-valor detectados se devuelven como objetos de bloque en las respuestas de AnalyzeDocumenty. GetDocumentAnalysis Puede usar el parámetro FeatureTypes de entrada para recuperar información sobre pares clave-valor, tablas o ambos. Utilice el valor únicamente para los pares clave-valor. FORMS Para ver un ejemplo, consulta Extracción de Key-Value pares de un documento de formulario. Para obtener información general sobre cómo se representa un documento mediante Block objetos, consulte. Objetos de respuesta para la detección de texto y el análisis de documentos

Las fechas encontradas mediante la detección de pares clave-valor se devuelven exactamente como se detectaron en el documento de entrada, y se admiten la mayoría de los formatos de fecha.

Los objetos de bloque del tipo KEY_VALUE_SET son los contenedores de los objetos de bloque KEY o VALUE que almacenan información sobre los elementos de texto enlazados detectados en un documento. Puede utilizar el EntityType atributo para determinar si un bloque es una CLAVE o un VALOR.

  • Un objeto KEY contiene información sobre la clave del texto vinculado. Por ejemplo, Nombre:. Un bloque KEY tiene dos listas de relaciones. Una relación de tipo VALUE es una lista que contiene el ID del bloque VALUE asociado a la clave. Una relación de tipo CHILD es una lista de identificadores de los bloques WORD que componen el texto de la clave.

  • Un objeto VALUE contiene información sobre el texto asociado a una clave. En el ejemplo anterior, Ana Carolina es el valor de la clave Nombre:. Un bloque VALUE tiene una relación con una lista de bloques SECUNDARIOS que identifican los bloques WORD. Cada bloque WORD contiene una de las palabras que componen el texto del valor. Un VALUE objeto también puede contener información sobre los elementos seleccionados. Para obtener más información, consulte Elementos de selección.

Amazon Textract devuelve el mismo valor de confianza para KEY y VALUE en un KEY_VALUE_SET, ya que tanto KEY como VALUE se evalúan como un par. Devuelve un valor de confianza diferente para una palabra en bloques WORD.

Cada instancia de un objeto KEY_VALUE_SET es un elemento secundario del Block objeto PAGE que corresponde a la página Block actual.

El siguiente diagrama muestra cómo se representa mediante objetos el par clave-valor Nombre: Ana Carolina. Block

Diagrama que muestra la estructura de una tabla de base de datos con una página que contiene claves y valores, donde las claves son las palabras «Nombre:», «Ana» y «Carolina».

Los siguientes ejemplos muestran cómo el par clave-valor Nombre: Ana Carolina se representa mediante JSON.

El bloque PAGE tiene bloques SECUNDARIOS del tipo KEY_VALUE_SET KEY y VALUE detectados en el 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
},

El siguiente JSON muestra que el bloque KEY (52be1777-53f7-42f6-a7cf-6d09bdc15a30) tiene una relación con el bloque VALUE (7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c). También tiene un bloque CHILD para el bloque WORD (c734fca6-c4c4-415c-b6c1-30f7510b72ee) que contiene el texto de la clave (Nombre:).

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

El siguiente JSON muestra que el bloque VALUE 7ca7caa6-00ef-4cda-b1aa-5571dfed1a7c tiene una lista CHILD de identificadores para los bloques WORD que componen el texto del valor (Ana y 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
}

El siguiente JSON muestra los objetos de las palabras Nombre:, Ana y 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"
},