Grupo/Filtro
El objeto Grupo/Filtro es el elemento principal para estructurar el esquema de árbol. Este objeto organiza los datos del PDF en grupos y le permite filtrar las páginas de su documento PDF para incluir sólo la información necesaria.
La imagen siguiente ilustra un ejemplo de objeto Grupo/Filtro que no tiene nombre y que se encuentra debajo de la raíz del documento. El objeto Grupo/Filtro tiene como elementos secundarios un objeto Captura de texto y un objeto División.
Para más información sobre cómo agregar objetos a la estructura jerárquica, consulte el apartado Insertar un objeto.
Propiedades
A continuación se describen las propiedades del objeto Grupo/Filtro que puede configurar.
Nombre de salida XML
La propiedad Nombre de salida XML representa el nombre del objeto Grupo/Filtro. Si esta propiedad contiene un valor, este valor aparecerá en la estructura (ver <Row> en la imagen siguiente) y como elemento en la estructura XML del panel Resultados. Los resultados producidos por el contenido del grupo se anidarán dentro de este elemento. Si el objeto Grupo/Filtro no tiene nombre, no aparecerá ningún elemento adicional en el panel Resultados y solo se verán los corchetes angulares vacíos en la estructura (imagen anterior).
En el ejemplo más abajo se ve cómo el objeto Grupo/Filtro y sus secundarios se han definido en el panel Esquema. El objeto Grupo/Filtro se llama Row y los objetos Captura de texto se llaman Col1, Col2, Col3 y Col4. Además, hay varias Asignaciones de ancla horizontal que determinan las posiciones de los separadores en la página. Sin embargo, las anclas no aparecen en la estructura XML en el panel Resultados.
La estructura que se ve más arriba aparecerá en el panel Resultados con este aspecto:
<Row>
<Col1>Garden design</Col1>
<Col2>6</Col2>
<Col3>50</Col3>
<Col4>300</Col4>
</Row>
<Row>...</Row>
<Row>...</Row>
Tipo de agrupación
La propiedad Tipo de agrupación le permite especificar criterios de agrupación y ofrece las opciones que se describen a continuación.
Un grupo por página
La opción Un grupo por página crea sólo un grupo de objetos por página, de los que cada uno tiene un índice que corresponde al número de índice de la página en la secuencia principal. Esta propiedad resulta especialmente útil cuando quiere envolver cada página en un elemento XML (que se verá en el panel Resultados), o si quiere limitar el procesamiento a cierta página o cierto rango de páginas en vez de todo el documento. Para seleccionar una página o un rango de páginas, introduzca el índice o rango de página(s), respectivamente, en el campo Seleccionar grupos (véase la propiedad siguiente).
Grupos de la lista
La opción Grupos de la lista funciona de la siguiente manera: Mientras los índices de una sola página resultan en grupos de una sola página, el rango de páginas resulta en un único grupo. Puede especificar números de páginas o un rango de páginas en el campo Páginas que aparece al seleccionar la opción Grupos de la lista. Puede extender un rango de páginas hasta el final del documento, omitiendo el último índice de página. Si introduce, por ejemplo, 5- se seleccionarán todas las páginas desde la página 5 hasta el final del documento. Si deja vacío el campo Páginas se procesará todo el documento.
Agrupar por texto en página
El tipo Agrupar por texto en página le permite crear grupos basados en un término de búsqueda que se ha encontrado o no en una página. Este tipo de agrupación tiene las propiedades que se describen a continuación.
Región
La región muestra dónde se realiza una búsqueda de texto. Por defecto es toda la página, pero la región también puede restringirse a una zona concreta de la página.
Modo
El modo define cómo se transforman las coincidencias en grupos. Esta propiedad tiene las siguientes opciones:
•Crear un grupo separado por cada página que contiene/no contiene el texto de búsqueda
•Combinar en un grupo las páginas consecutivas que contienen/no contienen el texto de búsqueda
•Iniciar nuevo grupo en cada página que contiene/no contiene el texto de búsqueda
•Terminar el grupo actual después de la página que contiene/no contiene el texto de búsqueda
Para más detalles sobre esta propiedad, consulte Modo.
Coincidencia
La estructura Coincidencia es un conjunto de propiedades que controlan los criterios de coincidencia del texto de búsqueda. Para más detalles, consulte el método Buscar texto del objeto División.
Seleccionar grupos
La propiedad Seleccionar grupos se refiere a una lista de índices que permite seleccionar ciertos grupos o un grupo en particular. Básicamente, esta propiedad funciona de la misma manera que los áreas de impresión para especificar qué páginas se deben imprimir. Por ejemplo, si ha definido varios grupos con los rangos de páginas 1-3, 6-10, 13-15 y quiere seleccionar el segundo rango de páginas, en el campo Seleccionar grupos deberá introducir 2 En este caso, el valor 2 se refiere al segundo grupo de páginas, es decir el rango de páginas 6-10. Si deja vacía la propiedad Seleccionar grupos se procesarán todos los grupos.