Extractor inteligente de formularios

UiPath.IntelligentOCR.Activities.DataExtraction.IntelligentFormExtractor

Descripción

Importante:

La actividad Extractor inteligente de formularios está obsoleta y no es compatible. Se ha eliminado de su paquete respectivo, lo que significa que solo puedes utilizarlo en flujos de trabajo donde se añadió previamente antes de esta obsolescencia.

Aunque los flujos de trabajo que contienen la actividad Extractor inteligente de formularios siguen funcionando normalmente, no puedes añadir la actividad a ningún flujo de trabajo nuevo. Recomendamos utilizar la actividad Extractor de formularios en su lugar.

Analiza, extrae, encuentra coincidencias y comunica la información necesaria de un documento teniendo en cuenta la posición de las palabras, incluidos los campos escritos a mano y firmados. Esta actividad solo se puede usar junto con la actividad Ámbito de extracción de datos.

Nota:

Utiliza los siguientes recursos para definir y configurar tu extractor inteligente de formularios:

• Asistente Gestor de plantillas;
• Gestor de taxonomía;
• Instalación y configuración de anclajes .

Compatibilidad de proyectos

Windows-Legacy | Windows

Propiedades

Panel de propiedades

Común

• Nombre para mostrar: el nombre para mostrar de la actividad.

Entrada

• ApiKey - Specifies the API key of the account.
• Punto final : la URL del servidor UiPath®. De forma predeterminada, el punto final es https://du.uipath.com/svc/intelligentforms. Para obtener más información, consulta Puntos finales públicos de Document Understanding.
• MinOverlapPercentage - Specifies the minimum overlap area (in percentage) between a box in the document and a box in the template required to make an extraction. The percentage value can be set between 0 and 100. The default value is 65.
• Timeout - Specifies the amount of time (in milliseconds) to wait for a response from the server before an error is thrown. The default value is 100000 milliseconds (100 seconds).

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

  Importante:

  Al utilizar la versión en la nube de este software de extracción de datos de documentos con cualquier clave API de UiPath® Community, los documentos procesados con el software son almacenados y utilizados por UiPath® junto con cualquier dato personal que puedan contener para la supervisión del servicio. UiPath® no almacena los documentos procesados utilizando cualquier punto final del servidor UiPath® con claves API Enterprise. UiPath® no procesa ningún documento si el software está configurado y se utiliza en tus instalaciones.

  Nota:

  Después de crear una plantilla, la actividad puede mostrar una advertencia que le informa de que es posible que se haya superado el número permitido de áreas escritas a mano en una página.

  El flujo de trabajo aún se puede ejecutar y se produce un error solo si se ha superado el número de áreas escritas a mano (más de 60 / página).

Asistente del Administrador de plantillas

Te permite crear, editar, gestionar y exportar/importar plantillas para los tipos de documento definidos en la taxonomía.

Crear una plantilla

• Add an Intelligent Form Extractor activity to your workflow, within a Data Extraction Scope.

• Configura el extractor seleccionando Gestionar plantillas. Se abre la ventana Gestor de plantillas.

  Figura 1. Descripción general del asistente Gestor de plantillas

  

• Selecciona Crear plantilla para crear una nueva plantilla. Figura 2. Descripción general del asistente Crear plantilla

  

  Nota:

  Si el paquete UiPath.IntelligentOCR.Activities se ha actualizado a v5.1.0, el parámetro ForceApplyOCR se ha reemplazado por el ApplyOcrOnPDF. Aquí está la compatibilidad entre los parámetros antiguos y nuevos:

  • ForceApplyOCR = True se reemplaza por ApplyOcrOnPDF = Yes;
  • ForceApplyOCR = False se reemplaza por ApplyOcrOnPDF = Auto;
  • ForceApplyOCR = Vacío se reemplaza por ApplyOcrOnPDF = Auto;
  • ForceApplyOCR = <user-defined variable> se reemplaza por ApplyOcrOnPDF = Auto.

• Select the document type for your template from the Document Type dropdown list.

  Nota:

  All Document Types are based on the Taxonomy. Make sure to add or create a taxonomy inside the project's folder.

• Add the name of the template in the Template name field. Choose a relevant name that reflects the version or the layout of your document.

• Add the document's path in the Template document field.

• Navigate to the file's path by using the Browse button.

• Selecciona un OCR de la lista desplegable Motor OCR, y configúralo en función de sus necesidades.

• Selecciona Configurar para desencadenar la edición de la plantilla. La opción Aplicar OCR en PDF establece si el proceso OCR debe aplicarse o no a los documentos PDF. Hay tres opciones disponibles en la lista desplegable: Verdadero, Falso y Automático. Si se establece en Verdadero, el OCR se aplica a todas las páginas PDF del documento. Si se establece en Falso, solo se extrae el texto escrito digitalmente. El valor predeterminado es Automático, que determina si el documento requiere aplicar el algoritmo OCR en función del documento de entrada. Cada motor OCR viene con su propio conjunto de opciones personalizadas. Consulta Motores OCR para obtener más información sobre todas las opciones disponibles para cada motor OCR. Si ya has creado una plantilla, puedes editarla, exportarla o eliminarla. Las opciones Eliminar y Exportar solo están disponibles cuando se selecciona al menos una plantilla. Las opciones Editar y Eliminar para una plantilla individual siempre están disponibles.

Figura 3. Ejemplo de una plantilla configurada en el asistente Gestor de plantillas

Nota:

Si un campo está marcado en las casillas Firma y Escrito a mano en el Gestor de plantillas de la actividad Extractor inteligente de formularios , aparece un mensaje emergente que te informa de que un campo solo puede añadirse en una casilla, no en ambas.

Configurar el procesamiento de campos booleanos

Para documentos que incluyen casillas de verificación, puedes añadir sinónimos conocidos para las opciones Sí y No, o puedes empezar por una lista compilada por nosotros (consulta las sugerencias Añadir recomendados). Estos valores se utilizan para interpretar el contenido booleano, que consiste en asignar un valor capturado a un valor notificado Sí o No.

Junto a Sinónimo de Sí y Sinónimo de No, selecciona Agregar recomendado para generar las sugerencias.

Figura 4. Imagen animada que muestra la selección de Añadir recomendados y generando sugerencias

Nota:

La casilla de verificación Distingue entre mayúsculas y minúsculas debe marcarse si los sinónimos que has añadido distinguen entre mayúsculas y minúsculas.

Exportar e importar plantillas

You can import templates created and exported from other workflows. Use these features to share templates between projects. Once a document type is configured using the Intelligent Form Extractor, you don't need to reconfigure the templates in a new implementation.

Procedimiento de exportación

Estos son los pasos que debes seguir para exportar una plantilla:

1. Crea una o varias plantillas siguiendo los pasos explicados al principio de esta página.

2. Selecciona las plantillas que quieres exportar.

3. Selecciona una opción Exportar:

   1. Exportar con archivos originalesLa exportación con archivos originales los adjunta a la exportación.

   2. Exportar sin archivos originales

      Figura 5. Las opciones de exportación disponibles en el asistente Gestor de plantillas

      

4. Guarda el archivo de la plantilla con el nombre deseado.

5. Una vez guardada la plantilla, aparece un mensaje. Selecciona Aceptar.

   Figura 6. El mensaje "Plantilla X exportadas correctamente"

   

   Nota:

   Si no puedes compartir el contenido de los documentos en los que has creado tus plantillas, utiliza la opción Exportar sin archivos originales. Podrás seguir compartiendo e importando el archivo de plantilla en otros proyectos, pero ya no podrás editarlas ni verlas.

   Si deseas editar las plantillas una vez importadas en un proyecto diferente, asegúrate de utilizar la opción Exportar con archivos originales al exportar y luego importarlas.

Procedimiento de importación

Estos son los pasos que debes seguir para importar una plantilla:

1. Seleccionar Importar.

   Figura 7. La acción de seleccionar Importar

   

2. Selecciona un archivo. Aparece el asistente de importación y muestra todos los tipos de documentos y todas las plantillas disponibles en el archivo de exportación seleccionado. Selecciona las plantillas que deseas importar y elige la opción Importar correcta:

   1. Importar con archivos originales

   2. Importar sin archivos originalesFigura 8. Las opciones de importación disponibles en el asistente Gestor de plantillas

      

      Nota:

      • Cuando se importan plantillas, los tipos de documento se crean automáticamente en la taxonomía del proyecto. Si un ya existe un tipo de documento con el mismo nombre, se creará otro añadiendo un número al nombre del tipo de documento.
      • Si estás importando plantillas que han sido exportadas sin los archivos originales, o si eliges importar plantillas sin los archivos originales, entonces no dispondrás de opciones de visualización o edición para esas plantillas.

Situaciones especiales al importar una plantilla

Cuando se importa una plantilla, pueden ocurrir varias situaciones especiales. La siguiente lista explica cada tipo de importación y sus particularidades:

• Nuevo tipo de documento: si se importa un nuevo tipo de documento, se añade un nuevo campo en la configuración del asistente, informándote de que se debe crear una nueva plantilla.

• Tipo de documento duplicado: si se importa un tipo de documento idéntico, aparece el siguiente mensaje de advertencia: "Esta plantilla ya existe y se sobrescribirá".

• Plantilla ampliada: si se importa una plantilla de tipo de documento que incluye campos adicionales a los ya existentes, aparece el siguiente mensaje de advertencia: "Este tipo de documento se actualizará de la siguiente manera: los siguientes campos no existen y se creado".

• Tipo de documento extendido: si el usuario importa un tipo de documento que incluye campos adicionales a los ya existentes, aparece el siguiente mensaje de advertencia: "Este tipo de documento se actualizará de la siguiente manera: los siguientes campos no tienen configuraciones para importar".

• Tipo de documento con nombre idéntico pero contenido diferente: si el usuario importa un tipo de documento que tiene el mismo nombre que el existente pero campos diferentes, aparece el siguiente mensaje de advertencia: "Este tipo de documento se actualizará de la siguiente manera":

  • "Los siguientes campos no existen y se crearán"
  • "Los siguientes campos no tienen configuraciones para importar"

• Tipo de documento con tabla faltante: si el usuario importa un tipo de documento que no incluye una tabla, aparece el siguiente mensaje de advertencia: "Este tipo de documento se actualizará de la siguiente manera: los siguientes campos no tienen configuraciones para importar".

• Tipo de documento con tabla ampliada: si el usuario importa un tipo de documento que incluye una tabla con columnas adicionales, aparece el siguiente mensaje de advertencia: "Este documento se actualizará de la siguiente manera: los siguientes campos no existen y se crearán ."

• Tipo de documento con tabla reducida: si el usuario importa un tipo de documento que incluye una tabla con columnas faltantes, aparece el siguiente mensaje de advertencia: "Este documento se actualizará de la siguiente manera: los siguientes campos no tienen configuraciones para importar ".

• Plantilla de tabla con diferentes tipos de documentos: si el usuario importa una plantilla de tipo de documento que incluye una tabla con diferentes tipos de documentos, se crea una nueva plantilla. Si tu taxonomía incluye una tabla que tiene un campo con un tipo de documento diferente, aparece el siguiente mensaje:

  El campo con ID xyz se ha encontrado tanto en la taxonomía importada como en la taxonomía existente, pero sus tipos son incompatibles (ambos deberían ser tablas o bien ninguno de ellos).

Asistente del Editor de Plantillas

Consideraciones generales

The Template Editor is built on top of the functionality present in the Validation station. To access it, select Edit for a template.

Consulta Estación de validación para obtener más información sobre el uso básico de la estación de validación.

Además de las opciones disponibles en la parte derecha de la pantalla de la estación de validación, hay las siguientes opciones en el Editor de plantillas:

• : establece el modo de selección de anclaje.
• : borra toda la selección de anclaje

Al crear una nueva plantilla, aparece un texto explicativo cuando se abre por primera vez el Editor de plantillas. En caso de que desees acceder al texto de nuevo, ve a la sección de vista de documentos en el lado derecho, selecciona Más opciones y luego Mostrar texto de explicación.

Figura 9. La acción de mostrar el texto de explicación

Configurar anclajes

Anchors can be defined once the Template Editor is opened from the Template Manager and can be found among the Selection Mode options.

When defining or editing a page-level template, although it is optional, the first thing that needs to be performed is the Page 1 Matching Info selection. This step is mandatory only for fixed form templates.

Situated on the left side of the screen, the Page 1 Matching Info selection requires a text input (tokens only are accepted) from the first page of the template that is always in the same position within that particular template layout and forms a unique graph of words (considering relative distances and angles between words) across all the templates defined for a particular document type.

In other words, the Page 1 Matching Info (and all other Page Matching Info fields) are "fingerprints" of a particular page and are extensively used in identifying the right matching template at runtime.

For this reason, for the Page 1 Matching Info field, it is strongly recommended to select 10 to 20 words, preferably longer, spread across the entire page area.

The other Page Matching Info fields (one for each template page) must be filled in only if you are attempting data extraction from that particular page, and do not require cross-template uniqueness anymore. If no fields need to be extracted from a particular page, defining the page-level matching info for that page is not mandatory.

Configurar campos simples

For all fields other than Tables, configuring the template consists of selecting a Custom Area and assigning it to a particular field.

For fixed form configurations, data fields can only be configured using Custom Area selections.

Para un campo, puedes definir una o más de tales Áreas personalizadas, utilizando la opción Añadir. Si se definen dos o más Áreas personalizadas para un único campo, en tiempo de ejecución, si el campo se define en la Taxonomía como Valor único, todos los valores se concatenan en un único valor notificado. Si el campo está definido como Varios valores, cada valor se notificará de manera individual.

El icono junto a cada campo indica el tipo de selección compatible: tokens o área personalizada.

Figura 10. Imagen animada que muestra los tipos de selecciones compatibles para campos de muestra

Nota:

If an empty area is selected, the selection is automatically set as Custom area. If text is detected inside the selected area, you are asked to choose the type of the selection between Tokens or Custom area.

Use the Validation Station selection mode feature to lock your selection between Tokens and Custom Areas.

Configurar tablas

Como ya se ha mencionado, hay campos en los que solo puede añadirse información mediante Tokens (como los campos Información de coincidencia de páginas) o solo utilizando un Área personalizada (como campos simples). Para los campos Tabla, puedes hacer lo siguiente:

• Define cada celda una a una, una vez que se expanda el Editor de tabla, añadiendo la selección Área personalizada a cada celda individualmente.
• Utiliza la funcionalidad de marcado de tabla, marcando el área de la tabla, dibujando separadores de filas y columnas y luego asignando la tabla así marcada al campo. Asegúrate de que el área extraída tiene el mismo número de columnas y filas que el área de la plantilla.

Para utilizar la funcionalidad de marcado de tabla:

1. Selecciona Más opciones para el campo de tabla
2. Selecciona Extraer nueva tabla.
3. Selecciona la tabla que deseas extraer.
4. Para cada campo sobre cada columna de tabla, selecciona el nombre de la columna que deseas que represente. También puedes elegir Extraer encabezado.
5. Por último, selecciona Guardar nueva tabla.

Figura 11. Imagen animada de un ejemplo utilizando la funcionalidad de marcado de tabla

Configuración de anclajes

Un método distintivo para definir los límites de un área personalizada de la que se extraerán datos es utilizar anclajes de campo. Estos permiten orientar la extracción de datos en función de las configuraciones a nivel de campo, lo que permite una mayor flexibilidad a la hora de definir las reglas de extracción de formularios.

En consecuencia, en tiempo de ejecución, el extractor inteligente de formularios sabe cómo realizar lo siguiente:

• identificar si coincide una plantilla de nivel de página, y extraer información acorde con la mejor correspondencia de plantilla de nivel de página que reconozca;
• identificar si coincide alguna configuración basada en anclajes, y extraer información según su aplicación en el documento que se va a procesar;
• calcular las puntuaciones de confianza adecuadas para todas las coincidencias posibles, a fin de poder notificar el mejor resultado (coincidencia de mayor probabilidad) de todas las opciones disponibles.

Crear una nueva configuración de anclaje

1. Make sure you are in the Anchor Selection mode.

2. Dibuja un cuadro alrededor del área de valor.

3. Selecciona una etiqueta (anclaje principal) para tu área de valor utilizando uno de los siguientes métodos:

   • Selecciona la primera palabra y luego utiliza Ctrl + Select para la última palabra de la selección.
   • Selecciona, arrastra y luego suelta para capturar un rango de palabras.
     Nota:

     A Label can only contain consecutive words from the same visual line.

4. Selecciona los anclajes adicionales que identificarían de forma exclusiva tu etiqueta. Se aplica el mismo principio de selección.

5. Assign your anchor construct to the appropriate field by selecting Extract Value for that particular field.

   Figura 12. Ejemplo de creación de varios anclajes para un campo

   

   Nota:

   También puedes utilizar los ejemplos anteriores de esta página para aprender a crear una plantilla y definir áreas de extracción y anclajes.

Editar una configuración de anclaje existente

1. Selecciona la configuración de anclaje.

2. Realiza cambios en ella (borra cualquier anclaje, la etiqueta, incluso el área de valor si lo deseas, añade nuevos elementos, etc.).

3. Selecciona Más opciones para un anclaje de campo y luego utiliza la opción Cambiar valor extraído para actualizar tu asociación de campo. Figura 13. Ejemplo de cambio del valor extraído para un campo

   

   Nota:

   • Si eliminas el área de destino, se borrarán todos los anclajes y tendrás que empezar de nuevo.
   • Si eliminas la Etiqueta (anclaje principal), el primer anclaje creado se convierte en la nueva Etiqueta.

Eliminar una configuración de anclaje existente

Para eliminar una configuración de anclaje, puedes:

• Selecciona Más opciones para un anclaje de campo y utiliza la opción Marcar como Falta para un valor guardado.

  Figura 14. Ejemplo de uso de la opción Marcar como ausente para eliminar una configuración de anclaje

  

• Selecciona Más opciones para un anclaje de campo y utiliza la opción Eliminar valor, caso de una lista de anclajes definidos para un campo determinado.

  Figura 15. Ejemplo de uso de la opción Eliminar valor para eliminar una configuración de anclaje

  

Mezclar y combinar configuraciones

Puedes definir tantas plantillas como quieras para el mismo tipo de documento. Puedes tener múltiples plantillas a nivel de página, múltiples anclajes para el mismo campo, incluso plantillas que contengan tanto anclajes a nivel de página como a nivel de campo.

Nota:

• A la hora de definir anclajes a nivel de campo, asegúrate de que tu etiqueta está próxima a tu área de valor y de que cuenta con anclajes adicionales si la misma construcción de texto puede encontrarse en varios lugares dentro del mismo documento.
• Cuanto mayor sea la longitud de tus etiquetas y anclajes, más precisión obtendrás. El área de valor siempre se calcula en función de su posición relativa respecto a su etiqueta (anclaje principal).Así pues, elige tus anclajes principales en consecuencia. Disponer de anclajes a nivel de campo permite a los campos moverse dentro de la plantilla y seguir siendo captados, lo que ofrece mayor flexibilidad en los cambios de diseño del documento.

Integración de Document Understanding

La actividad Extractor inteligente de formularios forma parte de Document Understanding Solutions. Consulta la Guía de Document Understanding para obtener más información.