Saltar al contenido principal
Los bloques de FlexiLayout corresponden a los campos de los documentos de los que se deben capturar datos. Un bloque especifica el tipo de datos que puede contener el campo y las coordenadas del área de la imagen donde probablemente se encuentre el campo. La rama de bloques está marcada con Icono de bloque en el árbol en el árbol de FlexiLayout.

Tipos de bloque de FlexiLayout

ABBYY FlexiLayout™ Studio admite los siguientes tipos de bloque:
  • Text (marcado con el icono Icono de bloque de texto) se usa para extraer datos de texto. Ampliar las regiones de los bloques de texto puede mejorar la calidad del reconocimiento. Para ampliar una región, haga doble clic en el elemento Blocks para abrir su cuadro de diálogo Properties y especifique los valores verticales y horizontales de la propiedad Blocks result region inflate.
  • Barcode (marcado con el icono Icono de bloque de código de barras) se usa para leer códigos de barras.
  • Checkmark (marcado con el icono Icono de bloque de marca de verificación) se usa para reconocer marcas de verificación.
  • Picture (marcado con el icono Icono de bloque de imagen) se usa para procesar objetos que no se identificaron como texto durante el prerreconocimiento.
  • Table (marcado con el icono Icono de bloque de tabla) se usa para extraer datos de tablas.
  • Group (marcado con el icono Icono de bloque de grupo) se usa para agrupar bloques de forma lógica.
  • Checkmark Group (marcado con el icono Icono de bloque de grupo de marcas de verificación) se usa para crear grupos de marcas de verificación. Solo se pueden agregar bloques de marcas de verificación a este tipo de grupo. No puede crear ni mover aquí bloques de otros tipos.
  • Repeating Group (marcado con el icono Icono de bloque de grupo repetido) se usa para crear un grupo repetido de bloques.
  • Non-Recognized (marcado con el icono Icono de bloque no reconocible) se usa para excluir un área del reconocimiento.
Los bloques para los que no se especifica ningún área de imagen en al menos una alternativa de layout tienen un cuadrado vacío en la esquina superior derecha del icono: Icono de bloque no definido. Si solo se selecciona un FlexiLayout (mediante el elemento Select Layout del menú contextual del elemento, mediante el mismo elemento en la sección FlexiLayout o mediante el elemento Select Alternative Layout del menú contextual del FlexiLayout), el programa comprueba el área de imagen solo en ese FlexiLayout.
Los datos de los bloques se extraen en una aplicación de captura de datos como ABBYY FlexiCapture.

Propiedades del bloque

  • Name — El nombre del bloque. El nombre de un bloque puede contener letras (caracteres romanos, caracteres romanos con diacríticos y caracteres cirílicos), dígitos y guiones bajos. El nombre de un bloque debe comenzar con una letra o un guion bajo. Los nombres de los bloques no deben contener espacios en blanco ni símbolos especiales.
  • Type — El tipo de bloque (seleccionado al crearlo). El tipo de bloque debe corresponder al tipo de objeto u objetos ubicados en el área delimitada por el bloque.
  • Comment — Comentario proporcionado por el usuario (opcional).
  • Has repeating instances — Indica que el bloque consta de varias instancias. Seleccione esta propiedad si, por ejemplo, todas las instancias de un elemento grupo repetido se usan como la región del bloque.
  • Instance sort order — Establece el orden en que las instancias del grupo se unen en un bloque. Esta propiedad solo está disponible si está seleccionada la opción Has repeating instances. Valores posibles:
    • Top to bottom — Las instancias se unen en un bloque según su ubicación en la imagen, de arriba abajo.
    • Left to right — Las instancias se unen en un bloque según su ubicación en la imagen, de izquierda a derecha.
    • Right to left — Las instancias se unen en un bloque según su ubicación en la imagen, de derecha a izquierda.
    • In order of finding — Las instancias se unen en un bloque en el orden en que se generan las hipótesis. Las hipótesis se generan en orden descendente de calidad. Si el usuario especificó condiciones adicionales para las instancias, las hipótesis se generan en el orden definido por el usuario. Por lo tanto, si necesita un orden distinto del orden estándar que utiliza el programa, puede especificarlo mediante condiciones adicionales.
Las siguientes propiedades especifican el área de la imagen de la que se deben extraer los datos.
  • For Layout — Selecciona la alternativa de layout en la que se especifica el área de búsqueda.
  • Source element — Especifica un área de la imagen idéntica a la Region del elemento utilizado para encontrar el bloque en la imagen. Cuando el FlexiLayout se aplica a la imagen, el programa busca el objeto (o los objetos) descrito por el elemento. Los datos se extraen de estos objetos. Para un grupo repetido, puede seleccionar una de las instancias o usar todas las instancias (AllInstances). Para obtener más información, consulte Uso de instancias de un Repeating Group como elementos de referencia, excluidos o de origen.
  • Expression — Establece un área en la imagen que no coincide con ninguna de las regiones de los elementos. Por ejemplo, puede combinar en un solo bloque las regiones de algunos elementos y el espacio entre ellas, ampliar la región de un elemento en un valor determinado o especificar las coordenadas del bloque sin depender de ningún elemento. En este caso, la región del bloque puede describirse en el FlexiLayout language.
La región de un bloque es continua. Esto significa que, si crea una región a partir de rectángulos separados entre sí, los espacios entre ellos se rellenan con rectángulos adicionales estrechos para que la región sea continua.
Sin embargo, un bloque puede constar de varias regiones si todas las instancias de un grupo repetido se usan como elemento de referencia. La región de un bloque de grupo se calcula a partir de las regiones de los bloques secundarios, al igual que la región de las hipótesis. La región resultante se amplía ligeramente para facilitar la visualización.

Parámetros de los bloques de grupo y de grupo repetido

Un grupo de marcas de verificación y un grupo común de bloques no tienen más parámetros que el nombre y el comentario. Los parámetros de un grupo repetido de bloques son los mismos que los de los bloques no agrupados. La opción Has repeating instances siempre está habilitada para ellos. Los bloques secundarios pueden tener o no la opción Has repeating instances, pero siempre se crea para ellos una variable Output instances. Si un bloque dentro de un grupo repetido de bloques tiene la opción Has repeating instances, esto significa que puede repetirse dentro de cada instancia del bloque padre.

Especifique una región de bloque mediante instancias de un grupo repetido

Si un bloque se define mediante varias instancias, la región de bloque consta de varias regiones independientes. Si utiliza una instancia concreta de un grupo repetido (por ejemplo, LastFound), la región de bloque se define igual que para cualquier otro elemento. Sin embargo, puede usar todas las instancias detectadas (AllInstances). Para usar varias instancias, seleccione la opción Has repeating instances. También puede escribir código para el bloque usando la variable predefinida OutputInstances. Por ejemplo:
OutputInstances = SearchElements.PageHeader.AllInstances.UnionRect;
ABBYY FlexiCapture procesa los bloques con la opción Has repeating instances habilitada de la siguiente manera:
  • Para los bloques que no son de tabla, las instancias especificadas son las del campo correspondiente.
  • Para un bloque de tabla, las instancias especificadas se tratan como una sola instancia del campo. Es decir, ABBYY FlexiCapture procesa ese bloque como un campo de tipo Tabla con una región discontinua.

Reglas para crear referencias a elementos para grupos repetidos de bloques

Un grupo repetido de bloques hace referencia a un elemento repetido. Para crear instancias de un grupo repetido de bloques, necesita varias instancias de elementos. Por lo tanto, uno de los Id debe ser AllInstances. Dado que los elementos anidados bajo el elemento con AllInstances no pueden tener otros Id, esta condición también significa que el elemento repetido ubicado más abajo tiene AllInstances. Los bloques secundarios de un grupo repetido de bloques hacen referencia a elementos secundarios del grupo repetido de elementos al que hace referencia el bloque primario. La referencia debe tener el mismo Id para las instancias. Ejemplo: Si un bloque de grupo repetido tiene la siguiente referencia: SearchElements..RepGr1.Instance(1).RepGr2.AllInstances, sus bloques secundarios pueden hacer referencia al elemento RepGr1..RepGr2.Element solo de la siguiente manera:
SearchElements.RepGr1.Instance(1).RepGr2.AllInstances.Element
Si no hay un atributo HasRepeatingInstances, solo puede hacer referencia a subelementos del grupo básico que no tengan repeticiones dentro de él, y viceversa. Si hay un atributo HasRepeatingInstances, puede hacer referencia a elementos que tengan repeticiones dentro del grupo básico (y solo puede hacer referencia a todas las instancias a la vez). Ejemplos: Hay un atributo HasRepeatingInstances
SearchElements.RepGr1.Instance(1).RepGr2.AllInstances.RepGr3.AllInstaces.Element
SearchElements.RepGr1.Instance(1).RepGr2.AllInstances.RepGr3.AllInstaces.RepGr4.AllInstances.Element
No hay un atributo HasRepeatingInstances
SearchElements.RepGr1.Instance(1).RepGr2.AllInstancess.Gr3.SubElement(where Gr3 is a simple group)
SearchElements.RepGr1.Instance(1).RepGr2.AllInstances.SubElement
Si las referencias se crean mediante Source element, la comprobación se realiza cuando se compila el FlexiLayout. Si las referencias se crean mediante código Advanced, se detecta un error al realizar el emparejamiento del FlexiLayout.

Describa la región de un bloque con FlexiLayout language

Para especificar la región de un bloque, use el campo Expression. Según el tipo de bloque y si la opción Has repeating instances está seleccionada, se usa una de las siguientes variables predefinidas: OutputRegion (de tipo Region), OutputTable (de tipo TableHypothesis) y OutputInstances (de tipo HypothesisInstances o TableHypothesisInstances). Para obtener más información sobre las variables predefinidas que pueden usarse en el campo Expression, consulte Variables predefinidas.
TareaCódigo de ejemplo
Obtener y expandir la región de un elemento en 3 mm de ancho y 5 mm de longitudOutputRegion = SomeElement.Rect; OutputRegion.Inflate( 3*mm, 5*mm );
Combinar los Rectangle de las regiones de dos elementos y obtener el Rectangle que circunscribe los Rectangle combinadosRect outputRect; outputRect = Element1.Rect Or Element2.Rect; OutputRegion = outputRect;
Combinar en una sola Region los Rectangle que circunscriben las regiones de dos elementosRectArray outputRects; outputRects = RectArray( Element1.Rect ); outputRects.Add: Element2.Rect; OutputRegion = Region( outputRects );
Combinar en una sola Region las regiones de los objetos correspondientes a dos elementos diferentesRectArray outputRects; outputRects = Element1.Rects; outputRects.Add( Element2.Rects ); OutputRegion = outputRects.Region;
Combinar las regiones de los objetos que pertenecen a la Region de Element1 y eliminar las regiones de los objetos que pertenecen a la Region de Element2OutputRegion = FormRegion( Element1.Rects, Element2.Rects );
Usar un elemento Tabla para especificar un bloque TablaOutputTable = SearchElements.TableElement;
Usar instancias de hipótesis de un determinado elemento para especificar un bloque TablaOutputInstances = SearchElements.RepeatingGroup.AllInstances.TemplateElement;

Usar la variable IsNull

También puede usar una variable predefinida IsNull para describir la región de un bloque. Esta variable indica si la región del bloque se ha encontrado durante el emparejamiento del FlexiLayout. El valor false significa que la región se ha encontrado. El valor true significa que no se ha encontrado. La variable IsNull se inicializa con el valor false, por lo que se considera que la región del bloque se ha encontrado. Sin embargo, a veces puede ser necesario comprobar ciertas condiciones antes de llegar a una conclusión.
  1. Para indicar al programa que considere encontrada la región del bloque si el ancho de la región del Source element supera los 50 dots, escriba el siguiente código en el campo Region Expression:
    if Element1.Width < 50dt then IsNull = true;
    
  2. Para indicar al programa que considere encontrada la región del bloque solo si se ha encontrado Element1, escriba el siguiente código en el campo Region Expression:
    IsNull = Element1.IsNull
    
  3. Suponga que necesita usar Element1 y Element2 para buscar un bloque. Si al menos uno de los elementos no se ha encontrado, se considera que el bloque no se ha encontrado.
    Rect outputRect;
    Let FieldLeft = Element1.Rect.Left;
    Let FieldRight = Element2.Rect.Right;
    Let FieldTop = Element1.Rect.Top;
    Let FieldBottom = Element2.Rect.Bottom;
    outputRect = Rect( FieldLeft, FieldTop, FieldRight, FieldBottom);
    if ((Element1.IsNull == True) or (Element2.IsNull == True) ) then {IsNull = true;}
    OutputRegion = outputRect;
    
Este código funcionará correctamente solo si el área de búsqueda de Element1 está encima y a la izquierda del área de búsqueda de Element2. En el ejemplo anterior, no se incluye la comprobación de esta condición por simplicidad. En el código real, esta comprobación es necesaria y los valores de las variables FieldLeft, FieldRight, FieldTop y FieldBottom deben ajustarse. De lo contrario, la llamada a la función Rect devolverá un error.