Usar regiones e iteradores
Las regiones son elementos especiales de las fórmulas que, junto con los iteradores, permiten especificar un contexto para trabajar y manipular elementos pertenecientes a una colección de datos.
Cada una de estas regiones incluirá en el documento las marcas TABLESTART (inicio de región) y TABLEEND (fin de región) en el documento de Word para delimitar el contexto donde los usuarios pueden utilizar el resto de fórmulas pertenecientes a dicha región.
Si una fórmula que hace referencia a una región se coloca antes de la etiqueta de inicio de región, o después de la de fin de región, el sistema no la reconocerá ya que ha perdido el contexto asociado.
Ejemplo básico de regiones e iterador
Este ejemplo crea un región denominada xTitulares para hacer listados personalizados.
| Región | Nombre | Fórmula | Descripción |
|---|---|---|---|
| xTitulares | Iterar(Expediente.Titulares) |
Crea una región con el nombre Titulares para trabajar con los datos de cada titular del expediente. | |
| xTitulares | NombreTitular | xTitulares.NombreCompleto |
Obtiene el nombre completo de cada titular de la colección |
| xTitulares | DNITitular | xTitulares.IDLegal |
Obtiene el identificador legal de cada titular de la colección |
| xTitulares | DirNotificacion | xTitulares.DirNotificacion |
Obtiene la dirección de notificación de cada titular de la colección |
También puede combinar los iteradores con la manipulación de secuencias de datos. Por ejemplo, con la fórmula Iterar(Expediente.Titulares.Filtrar(Filtrar(funcion(titular) {titular.Persona.Edad < 50}))) para la variable xTitular se limitaría la lista a aquellos que titulares que tienen menos de 50 años.
Para ver otros ejemplos consulte la página de manipulación de secuencias de datos.
Regiones de varios niveles
En este ejemplo se crea una segunda región para trabajar con el conjunto de Representados de cada uno de los titulares.
| Región | Nombre | Fórmula | Descripción |
|---|---|---|---|
| xTitulares | Iterar(Expediente.Titulares) |
Crea una región con el nombre Titulares para trabajar con los datos de cada titular del expediente. | |
| xTitulares | NombreTitular | xTitulares.NombreCompleto |
Obtiene el nombre completo de cada titular de la colección. |
| xTitulares | xRepresentados | Iterar(xTitulares.Representados) |
Crea una nueva región dentro de xTitulares para obtener los representados de cada uno de los titulares. |
| xRepresentados | NombreRepresentados | xRepresentados.NombreCompleto |
Obtiene el nombre completo de cada uno de los representados. |
Ejemplo real con la plantilla recibo de notificaciones (RECIBO.NOTIF)
Se define la región de los documentos relacionados con el de la notificación y se itera por cada uno de ellos, obteniendo la descripción, el código de verificación y la imagen QR.
Como queda definido en la plantilla la tabla que va a contener todos los documentos que estén relacionados con el de la notificación e indicar la fila que se va a regenerar sin que se vea afectada la cabecera. Dentro de la plantilla, la iteración se define entre las dos claves «TableStart:xRel» … «TableEnd:xRel» donde xRel es la región que hemos definido anteriormente en las variables.
Resultado final de la combinación de la plantilla recibo de las notificaciones.
