reporwin gestiÓn de listados - t-innova• envío masivo de sms: accedemos a la opción de envío...

REPORWIN – GESTIÓN DE LISTADOS V1.0 – 27/02/2015

Manual de funcionamiento de Reporwin.

Funciones principales:

- Definir componentes de listados - Crear nuevos listados - Gestionar listados existentes

MANUAL REPORWIN – GESTIÓN DE LISTADOS

WWW.T-INNOVA.COM 2 / 80

INTRODUCCIÓN 4

QUÉ ES REPORWIN 4 ACCEDER A REPORWIN 4 MENÚS DE LA APLICACIÓN 4

MÓDULO LISTADOS. VISTA RÁPIDA 7

INFORMES DISPONIBLES 8 DEFINICIÓN DEL INFORME 10

Componentes de un listado 11 ELEMENTOS DISPONIBLES 12 ÁREA DE BOTONES 12

CREAR UN NUEVO LISTADO 14

ASIGNAR COMPONENTES AL LISTADO 15 MODIFICAR COMPONENTES DE UN LISTADO 16 ELIMINAR COMPONENTES DE UN LISTADO 16 MODIFICAR LA POSICIÓN DE UN LISTADO EN LA JERARQUÍA 17

MÓDULO VISTAS 18

INTRODUCCIÓN 18 PANTALLA DE VISTAS 18 CREAR UNA VISTA 23

Definición básica 23 El dilema de empezar la vista 25 Gestionar los campos a una vista 25 Campos personalizados 31 Campos especiales 34 Ir a… 37 Alias 37 Relaciones “no recomendadas” 40 Funciones 41 Modificar la relación entre tablas 44 Añadir una tabla / consulta relacionada, pero sin relación existente en el modelo 47 Añadir una tabla no relacionada 50 Guardar la vista 51

MODIFICAR UNA VISTA 52 OTRAS OPCIONES DEL MÓDULO 53

MÓDULO FILTROS 57

INTRODUCCIÓN 57 CREAR UN FILTRO 58

Definición básica 58 Pestaña filtro 59 Campo de filtro 60 Condiciones de filtro 61 Establecer nuestra primera condición de filtro 68 Guardar el filtro 71

MODIFICAR UN FILTRO 73 OTRAS OPCIONES DEL MÓDULO 74

MODULO LISTADOS: EJECUTAR NUESTRO PRIMER LISTADO 75

OPCIONES DE DESTINO DE UN LISTADO 75



ANEXOS 78

ANEXO 1: CONSULTAS ÚTILES INCLUIDAS EN EL MODELO DE DATOS 78



INTRODUCCIÓN QUÉ ES REPORWIN

Reporwin es la aplicación diseñada por T-Innova para la creación y mantenimiento de los listados (reports) usados por el resto de aplicaciones de la Suite. Esta aplicación nos permitirá, de una forma sencilla, gestionar los diferentes componentes de un listado, modificarlos, crear nuestros propios listados, etc.

ACCEDER A REPORWIN

La aplicación está identificada por el icono que nos dará acceso a la aplicación. Como en la mayoría de aplicaciones de nuestra Suite, lo primero que aparecerá es la pantalla de login, en la cual debemos seleccionar el entorno al que queremos acceder.

Debemos tener en cuenta que la selección del entorno puede ser importante, dado que este puede modificar la base de datos de listados que empleamos y, por tanto, los listados que tendremos a nuestra disposición.

MENÚS DE LA APLICACIÓN

Una vez hemos accedido a la aplicación, nos aparecerá la pantalla principal, en la cual tenemos a nuestra disposición diversos menús para realizar las distintas acciones.

De estos menús, los 3 últimos (Seguridad, Ventana y Ayuda) son los habituales en otras aplicaciones de la Suite. Nos centraremos en los 2 primeros, que son los que nos dan las funcionalidades específicas de esta aplicación.



Menú Archivo

El menú archivo nos da acceso, además de a la opción de salir de la aplicación, a las opciones de Nuevo, Abrir, Guardar y Guardar como…, habituales en muchas aplicaciones. Estas opciones sólo estarán disponibles en determinados módulos (Vistas, Filtros, Plantillas) de la aplicación.

Menú Módulos

Este menú nos da acceso a las opciones que conforman el núcleo de la aplicación y que son las que nos permitirán realizar nuestro trabajo.

Veamos de forma resumida la utilidad de cada opción:

• Bases de datos: Nos muestra las bases de datos que se están utilizando en el entorno al que hemos accedido.

• Vistas / Filtro / Plantillas: Nos darán acceso a los correspondientes módulos, que veremos posteriormente.

• Listados: Podríamos decir que es la pantalla principal de la aplicación.

• Listados contextuales: Nos muestra la habitual ventana flotante de listados que aparece en el resto de aplicaciones de la Suite cuando queremos seleccionar un listado.



• Envío masivo de SMS: Accedemos a la opción de envío masivo de SMS equivalente a la que se encuentra en Deporwin.

• Procesos de aplicación: Nos permite acceder a la pantalla de mantenimiento de los llamados “Procesos de aplicación”, que veremos posteriormente.

• Migrar Vistas: Permite realizar la migración de las vistas desde el sistema “antiguo” al actual. Esta opción podríamos decir que es obsoleta, pues todas las deberían estar migradas.

• Actualizar Componentes: Lee el contenido de las carpetas del sistema de archivos en los que se encuentran los ficheros con la definición de Vistas, Filtro y Plantillas, actualizando la base de datos con dicha información.



MÓDULO LISTADOS. VISTA RÁPIDA Tal como hemos comentado, podríamos decir que la pantalla de listados es la pantalla principal de la aplicación. Al acceder a ella, nos encontramos con la siguiente pantalla:

En esta pantalla, podemos identificar 4 zonas diferentes:

1. Informes disponibles: Nos mostrará la relación de listados que tenemos a nuestra disposición.

2. Definición del informe: Nos mostrará, para un informe dado, cuál es su definición y características.

3. Elementos disponibles: Nos muestra qué elementos (Vistas, Filtros, Plantillas) tenemos disponibles para confeccionar nuestros informes.

4. Área de botones: Tenemos botones para realizar diferentes acciones.



INFORMES DISPONIBLES

En esta zona, tal como hemos indicado, tendremos una relación de todos los informes que tenemos disponibles para su uso desde las aplicaciones de la Suite.

En nuestras aplicaciones, los informes pueden pertenecer a 2 categorías:

a) Propios: Listados (informes) específicos del cliente. Estos listados son modificables por el cliente y pueden ser diferentes en cada instalación, utilizándose para ajustarse a requerimientos específicos de cada cliente.

b) Catálogo: Son informes que desde T-Innova consideramos básicos para el buen funcionamiento. Estos listados no son modificables por parte de los clientes, sino que son mantenidos por T-Innova y se distribuyen conjuntamente con el DSuite, actualizándose junto con la aplicación.

Podemos ver que en esta zona aparecen diferentes pestañas:

Propios

Nos muestra la relación de informes personalizados del cliente, con la estructura que este haya decidido.

Catálogo

Similar a la anterior, pero muestra la relación de informes del catálogo de T-Innova.



Recientes

Nos muestra una relación de los 10 listados usados más recientemente por el usuario logeado, tanto del catálogo propio como del de T-Innova. La información mostrada depende del operador que ha hecho login.

Usados

Similar a la anterior, nos muestra los 20 listados más utilizados por el usuario logeado.

Buscar

Nos permite buscar un listado concreto a partir de su nombre exacto o por contenido del nombre.



Impresoras

Nos muestra una lista de las impresoras disponibles. Nos será muy útil posteriormente para configurar correctamente nuestros listados.

DEFINICIÓN DEL INFORME

En esta área de la pantalla, tendremos toda la información relativa a la definición del informe y a sus características. Como anteriormente, tenemos diferentes pestañas, aunque por ahora sólo nos fijaremos en la primera de ellas, dejando el resto para un punto posterior de este manual.

Si seleccionamos un listado en el área de informes disponibles y nos fijamos en esta primera pestaña (Básicos), tenemos algo parecido a lo siguiente:

Como vemos, la primera línea nos indica el nombre del fichero, el cual podremos modificar por el que nos parezca más adecuado (siempre que el listado no pertenezca al catálogo de T-Innova).

A continuación, vemos 3 campos cuyos títulos son Vista, Filtro y Plantilla y que corresponden a los componentes que forman un listado, que enseguida veremos que son.



Finalmente, tenemos 2 opciones: v2.95 y v3.0. Estas son únicamente informativas y nos sirven (sobre todo en el caso de listados del catálogo T-Innova) para saber en qué versiones de la suite es válido.

Componentes de un listado

Hemos dicho que Vista, Filtro y Plantilla son los componentes que forman un listado, pero ¿qué quiere decir esto?

Cuando hablamos de listados (o informes), estamos hablando de obtener información que se encuentra en la base de datos y mostrárnosla de una forma más “amistosa” o funcional. Para ello, necesitamos varias cosas:

a) Obtener la información de la base de datos.

b) Ordenar y / o filtrar esa información según nuestros requisitos.

c) Mostrar la información.

Pues bien, de cada uno de estos requisitos se encarga uno de los componentes del listado:

• Vistas: Son las encargadas de obtener la información de la base de datos a partir de las diferentes tablas y campos en que esta se encuentra.

• Filtros: Nos permiten indicar, de toda la información que contiene una tabla, cual es la requerida en cada momento.

• Plantillas: Nos permiten presentar esa información de una forma más amigable, para que cumpla nuestros requisitos.

Como vemos, ésta el parte más importante en la definición de un listado, por lo que cada componente tendrá su propio apartado en este manual.

Para que un listado sea válido, no es necesario que esté formado por los 3 componentes, sólo la vista es necesaria: si no obtenemos datos de ningún sitio, no tenemos nada que mostrar. El resto de componentes son opcionales, dando lugar a diferentes resultados. Además, las diferencias en la composición del listado tienen su reflejo en la zona de “Informes disponibles”, pues el icono que representa a cada listado variará en función a esta composición:



Una pregunta que nos podríamos hacer en este punto podría ser: ¿Por qué se ha separado un listado en 3 partes, en lugar de hacerlo todo junto, que sería más fácil? La respuesta es: reaprovechamiento.

Al separar un listado en 3 componentes, nos permite reaprovechar cada uno de ellos en diferentes listados / informes y no tener que volver a crearlos cada vez. Por ejemplo:

• Si queremos imprimir etiquetas, los datos que queremos suelen ser siempre los mismos, la forma de filtrarlos también y sólo variará la plantilla para ajustarse a diferentes tipos de etiquetas. En este caso, tendríamos varios listados que compartirían la misma vista y filtro, teniendo cada uno de ellos su plantilla correspondiente.

• Podemos tener varios listados en los que la información tiene diferentes orígenes (diferentes vistas), que queremos mostrar de forma diferentes en cada caso (carta, lista, …), pero que siempre queremos filtrar de la misma forma (la persona actual, un rango de personas). En este caso, los listados sólo compartirían el filtro, teniendo cada uno de ellos sus propias vistas y filtros.

ELEMENTOS DISPONIBLES

En esta área, tenemos 3 pestañas que nos mostrarán los elementos disponibles que tenemos para cada uno de los componentes de un listado (Vistas, Filtros, Plantillas). Esto nos permitirá la selección de forma rápida del elemento para asignarlo a un listado, tal como veremos más adelante.

ÁREA DE BOTONES

Aquí nos encontramos con una serie de botones que nos permitirán realizar acciones sobre los listados. Veamos que hace cada uno de ellos:

Nos permitirá ejecutar el listado para ver su resultado.

Similar al anterior, pero en lugar de mostrar directamente el resultado del listado nos llevará al módulo de plantillas, donde podremos modificar la plantilla correspondiente al listado actual y ver el resultado.

Nos permitirá guardar toda la definición del listado en un fichero .LST que podremos recuperar posteriormente en otro cliente

Nos permite recuperar un fichero .LST generado con la opción anterior y crear un nuevo listado (y la vista, filtro, plantilla y Tablas dinámicas asociadas) a partir de esa información.



Permitirá crear un nuevo listado.

Permite duplicar un listado existente

Permite renumerar un listado para asignarle cualquier código disponible que queramos

Se activará cuando hayamos hecho alguna modificación en lugar del botón Nuevo, y nos permitirá validar los cambios realizados.

Permitirá eliminar un listado existente.

Se activará cuando hayamos hecho alguna modificación en lugar del botón Eliminar, y nos permitirá cancelar los cambios realizados.



CREAR UN NUEVO LISTADO Como hemos visto anteriormente, los listados aparecen en el área de informes en forma jerárquica, similar a la estructura de ficheros de Windows. En esta estructura, a partir del nodo raíz (la Unidad en Windows), podemos tener carpetas o listados, y como hijos de cualquiera de estos elementos podemos tener más listados o carpetas (a diferencia de las carpetas del sistema operativo, en Reporwin un listado puede tener como hijos carpetas u otros listados.

Si queremos crear un nuevo listado en nuestro catálogo, lo primero que tenemos que decidir es en que punto de la jerarquía del área de informes queremos incluirlo. Tenemos que tener en cuenta que un listado se puede añadir en cualquier punto de la jerarquía existente, pero incluirlo en el punto correcto ayudará posteriormente a su localización.

Una vez decidido este punto, nos situamos sobre el nodo del cual queremos que nuestro listado sea “hijo” y pulsamos el botón nuevo, con lo que en el área de definición del informe tendremos todos los campos “limpios” a punto de que definamos el listado.



Una vez introducido el nombre de nuestro listado (en este caso será Listado Ejemplo), pulsamos el botón Validar, con lo que el nombre quedará establecido. Veremos que, en la jerarquía, aparecerá un nodo con el nombre que acabamos de indicar y con el icono correspondiente a la carpeta, pues, de momento, no tiene ningún componente.

ASIGNAR COMPONENTES AL LISTADO

Ahora que hemos creado la base de nuestro listado, debemos asignarle los componentes necesarios para su funcionamiento. Para poder asignarle los componentes, estos deben existir, por lo que, en caso de necesitar nuevas vistas, filtros y/o plantillas, deberemos crearlos previamente (posteriormente veremos cómo se crean estos componentes).

Una vez tenemos creados los componentes de nuestro listado, para asignárselos tenemos que:

a) Buscarlos en la correspondiente lista de Elementos Disponibles.

b) Hacer doble click sobre el componente a asignar.

c) Validar la operación.

Así, si a nuestro listado le queremos asignar la vista 1, el filtro 1 y la plantilla 99, realizaríamos las acciones anteriores para cada uno de los elementos, quedando la definición del listado de la siguiente forma:

Con lo que tenemos nuestro listado perfectamente definido.



Plantillas Word: En el caso de usar plantillas en Word, nos encontramos con un caso especial. En este caso, la plantilla no aparece en la lista de elementos disponibles, sino que tenemos que pulsar sobre la carpeta al lado del campo Plantilla

Y buscar la plantilla en su ubicación dentro del sistema de archivos (el archivo debe encontrarse en la ruta correspondiente a las plantillas de Reporwin (X:\Deporwin\Plantillas)

MODIFICAR COMPONENTES DE UN LISTADO

Modificar un componente de un listado es tan sencillo como asignar el componente que queremos al listado, de forma que substituirá al que previamente hubiésemos asignado. Por ejemplo, si en lugar del filtro 1, el listado anterior tuviese que utilizar el filtro 140, sólo tendríamos que buscar ese filtro, hacer doble click sobre él, validar el cambio y listos.

Plantillas Word: Como en el caso anterior, este caso es especial. Para modificar la plantilla de Word a utilizar por un listado, debemos eliminar el componente plantilla del listado (ver siguiente punto) y añadir la correcta.

ELIMINAR COMPONENTES DE UN LISTADO

Eliminar componentes de un listado también es muy sencillo. Solo tenemos que pulsar sobre el botón correspondiente situado al lado del elemento a eliminar.



MODIFICAR LA POSICIÓN DE UN LISTADO EN LA JERARQUÍA

A pesar de haber determinado inicialmente la posición de la jerarquía en la que hemos añadido nuestro listado, puede ser que finalmente nos demos cuenta que esa no es la posición correcta y queramos corregirlo.

Para hacerlo, debemos seleccionar nuestro listado en la jerarquía, pulsar el botón derecho del ratón, y sin soltar el botón, arrastrar el listado hasta su nueva posición. Entonces soltaremos el botón y ya habremos cambiado la posición del listado:



MÓDULO VISTAS INTRODUCCIÓN

Como hemos comentado anteriormente, las vistas de Reporwin nos permiten determinar qué datos son los que queremos utilizar en nuestro/s listado/s. Básicamente, consisten en una lista de los campos y/o expresiones que queremos mostrar en el listado, así como las tablas en las que se encuentran esos datos y las relaciones existentes entre ellas. Si lo comparamos con las sentencias SQL (que finalmente es en lo que se convertirán), nos permite determinar las partes correspondientes al SELECT y al FROM (y el GROUP BY en algún caso, como veremos).

PANTALLA DE VISTAS

Tal como hemos comentado anteriormente, para acceder al módulo vistas lo haremos desde el menú principal, en la opción “Módulos -> Vistas”.

Con esto accederemos a la pantalla de Vistas:



En esta pantalla podemos diferencias 3 zonas:

a) Área elementos disponibles: Aquí tendremos una lista de las tablas y campos disponibles para su uso.

b) Área definición de vista: En esta zona definiremos los parámetros aplicables a la vista, así como las tablas y campos que queremos que incluya.

c) Área botones: Nos permitirán realizar diversas acciones sobre la vista.

Como vemos, si estamos creando una vista, inicialmente las 2 primeras zonas están en blanco, dado que estamos creando una nueva vista y no sabemos cuál será el origen de los datos. Si en lugar de crear una nueva vista estuviésemos modificando una ya existente, tendríamos valores en ambas zonas

Área elementos disponibles

En esta área, una vez hayamos realizado la carga de una vista existente o iniciado una nueva vista, tendremos una lista con todas las vistas y tablas existentes en la base de datos que tenemos disponibles para nuestro uso.

Si seleccionamos cualquiera de los elementos, por ejemplo, la tabla Personas, veremos que se despliega una lista con todas las tablas / vistas relacionadas con esta tabla, mostrando diferentes colores.



Tanto el color como el texto que aparece entre corchetes en los nodos nos dan información sobre el funcionamiento:

Magenta: • Este nodo representa los campos disponibles de la tabla seleccionada.

Rojo:

• Estas tablas tienen una relación de tipo N a 1 con la tabla “padre”, es decir, existe 1 registro de la esta tabla por cada registro de la tabla padre, pero pueden existir N registros en la tabla padre relacionadas con el mismo registro de esta tabla. Un ejemplo sería la relación entre Personas (campo Abono) y Abonos (campo IdAbono): Cada persona sólo está relacionada con un Abono, pero puede haber varias personas relacionadas con el mismo abono.

• El texto entre corchetes indica qué campo de la tabla padre se usa en la relación con esta tabla.

Azul:

• Estas tablas tienen una relación de tipo 1 a N con la tabla “padre”, es decir, existen N registros en esta tabla por cada registro en la tabla padre. Un ejemplo sería la relación entre las tablas Personas (campo IdPersona) y Abonos (campo Titular), pues una persona puede ser titular de varios abonos.

• El texto entre corchetes indica qué campo de esta tabla se usa en la relación con la tabla padre.

Amarillo:

• También se llaman relaciones de pérdida de filiación. Estas tablas tienen una relación N a 1 – 1 a N con la tabla “abuelo”, es decir con el “padre” del “padre” de la tabla actual. Esto quiere decir que hay una relación 1 a N entre esta tabla y su tabla padre, y otra relación N a 1 entre esta y su padre. Un ejemplo sería la relación entre las tablas Cursillistas (campo IdActividad) con Actividades (campo Codigo) y de esta con TarifasActividades (campo CodigoActividad) En este caso, cada cursillista Tarifa podría estar asociada a N cursillistas y cada cursillista estaría relacionada con N tarifas (realmente en los datos reales esto no es así pues tenemos campos para saber que tarifa se aplica a cada cursillistas, pero esta información no está en la relación directa).

• El texto entre corchetes indica qué campo de esta tabla se usa en la relación con la tabla padre.



Gris:

• Corresponde a nodos desactivados, que no deberían utilizarse pues suelen ser relaciones N : M o tablas en el mismo nivel, es decir, sin relación entre ellas, lo cual daría resultados impredecibles.

El uso de nodos de color Gris debe hacerse con mucha precaución si tenemos claro que los datos que obtendremos son los esperados.

Este árbol es recursivo, de forma que seleccionando cualquiera de los nodos hijos mostrados, veremos la relación de tablas relacionadas con él, y así sucesivamente hasta un máximo de 30 niveles de profundidad.

Además, desde este árbol podremos ver los registros que contiene cualquier tabla. Si pulsamos sobre cualquiera de ellas con el botón derecho del ratón, se nos preguntará si deseamos ver su contenido.

Y en caso afirmativo, nos mostrará una tabla con el contenido.



Área definición

En el área de definición, tenemos diferentes pestañas cuya utilidad veremos en los siguientes apartados. Ahora sólo haremos una pequeña descripción:

• Datos vista: Los datos básicos de la vista.

• Vista plana: Nos mostrará una relación de todos los campos añadidos a la vista.

• Vista jerárquica: Nos mostrará, en forma de árbol, los campos y tablas que hemos incluido en la vista.

• Filtro: Nos permitirá definir un filtro para utilizar conjuntamente con la vista, tanto definitivo como para pruebas.

• Resultado: Nos mostrará la consulta SQL resultante de lo que hayamos añadido a la vista.

• Listados: Relación de listados en los que se usa la vista actual.

• Comp (Compatibilidad): Relación de filtros y plantillas con los que es compatible la vista actual.

Área botones

• Imprimir vista: Nos permitirá imprimir en formato .htm la vista sobre la que estamos trabajando.

• Reset vista: Restaura la vista al estado inicial. Si estamos modificando una vista, la dejará tal como estaban antes de haber realizado cualquier modificación y si estamos creando una nueva, volverá a dejarla en blanco.

• Presentación tabla: Nos permite ver en forma de tabla la información que estamos incluyendo en la vista.

ATENCIÓN: Debemos tener mucho cuidado con la opción “Presentación Tabla” si estamos usando en nuestra vista tablas con gran cantidad de registros (Pagos, Accesos, etc.), pues si no tenemos ningún filtro aplicado el proceso puede tardar bastante tiempo.



CREAR UNA VISTA

Definición básica

Si queremos crear una nueva Vista para Reporwin, lo primero es definir ciertos valores que serán necesarios para poder continuar con nuestro trabajo, que se encuentran en la pestaña “Datos Vista”.

Lo primero, será decidir para qué queremos crear la vista, es decir, cual es el objetivo de los datos que deseamos recuperar y en qué base de datos los encontraremos. En nuestro caso vamos a crear una vista que nos permita obtener una relación de todas las personas con sus pagos detallados.

Una vez determinado, introducimos los datos en la pantalla:

• Fichero: Será el nombre del fichero donde se guardará la vista. Este dato no se introduce en este campo, sino se indica en el momento en que la guardemos. Aquí aparecerá su ubicación una vez la hayamos grabado.

• Nombre: Nombre “explicativo” que le daremos a la vista. Este dato, así como la descripción aparecerán en la pantalla principal de Reporwin y nos servirán para determinar que vista nos interesa.

• Descripción: Una explicación más completa del objetivo de la vista.

• Base de datos: Aquí escogeremos, entre las disponibles (en función de lo indicado en la sección [Bases de Datos] de Deporwin.ini), la base de datos donde se encuentran los datos que queremos recuperar. En nuestro caso será Deporwin.

• Tratamiento de repeticiones: Nos servirá para indicar si queremos que en los datos obtenidos existan registros repetidos. Si admitimos repeticiones, el posible que el resultado final devuelva registros con los mismos valores en todos sus campos. En caso de no admitirlas, si existen varios registros con los mismos valores, sólo se devolverá uno de ellos. Esta última opción correspondería a un “SELECT DISTINCT“, mientras la primera es un “SELECT“ normal. El escoger una opción u otra dependerá del objetivo del listado que estemos confeccionando. Además, si sabemos que en el listado no se van a producir duplicados, por rendimiento de la consulta, siempre es mejor la opción de admitir duplicados. En nuestro caso, como no habrá duplicados, admitiremos las repeticiones.

• Tratamiento de relaciones: Indica el valor por defecto que se establecerá en las relaciones entre las tablas que incluyamos en la vista:

o Solo registros relacionados: Seleccionará sólo los registros que estén relacionados entre las tablas. Equivale a un INNER JOIN en lenguaje SQL.

o Todos los registros: Seleccionará todos los registros de la primera tabla y sólo los registros relacionados del resto de tabla. Equivale a un LEFT JOIN.



Una vez indicados todos los valores, pulsaremos el botón situado al lado de la base de datos, con lo que el programa realizará la carga de todos los elementos disponibles (tablas, vistas, campos y relaciones entre ellos).



El dilema de empezar la vista

Para empezar el diseño de cualquier vista tenemos que decidir qué tabla será el punto de partida. Este es un punto clave, pues nos marcará los datos que podemos o no podemos recuperar. La elección de esa primera tabla dependerá del modelo de datos que estemos usando y la información que queramos obtener. Generalmente, el motivo por el cual generamos la vista nos resolverá esta pregunta, aunque puede que no siempre sea así. Por ejemplo:

a) Actividades con sus cursillistas.

b) Cursillistas con información de la actividad.

En el primer caso, la tabla inicial será la tabla “Actividades”, dado que queremos obtener la información de TODAS las actividades, tengan o no inscritos, y los datos de cursillistas allá donde los hubiese. En cambio, en el segundo caso, empezaríamos por la tabla “Cursillistas”, ya que queremos la relación de los cursillistas y, como añadido, información de la actividad a la que están inscritos.

Como en nuestro caso queremos un listado de “Personas con pagos detallados y sus correspondientes orígenes”, nuestra tabla inicial será la tabla Personas, que es de la que queremos obtener todos los datos.

Gestionar los campos a una vista

Añadir el primer campo a la vista

Ahora que hemos decidido cuál es nuestra tabla principal (Personas), debemos añadirla a nuestra vista. Podemos añadir todos los campos de la tabla (veremos posteriormente como), pero lo más habitual es que sólo queramos añadir algunos campos. En nuestro caso, el primer campo que queremos añadir es el campo IdPersona.

Añadir un campo a la vista es sencillo, sólo tenemos que buscar la tabla correspondiente (Personas) en la lista de elementos disponibles y pulsar sobre ella para que aparezcan sus nodos. Abrimos el nodo correspondiente a sus campos (Campos Personas), buscamos el campo que queremos añadir (IdPersona) y lo arrastramos desde la lista a la pestaña “Vista Jerárquica” (que se habrá activado automáticamente al seleccionar la tabla). También podemos realizar la misma acción haciendo “doble click” sobre el campo.



Como vemos, al arrastrar el campo, en la vista jerárquica automáticamente se añade un nodo con el nombre de la tabla (Personas) y el campo vinculado.

Añadir otros campos de la misma tabla.

Ahora que hemos añadido el primer campo a la vista, podemos seguir añadiendo otros campos que creamos necesarios (Nombre y Apellidos, como hemos comentado).

Para hacerlo, podemos seguir el mismo procedimiento anterior, es decir seleccionar el campo en la lista de elementos disponibles y arrastrarlo a la vista jerárquica (o hacer doble click sobre el).

En este caso, como ya tenemos la tabla en la vista jerárquica, tenemos otra opción que puede ser más rápida, la opción de “Añadir campos” de la propia tabla. Para ello, seleccionamos la tabla en la vista jerárquica, pulsamos sobre ella con el botón derecho del ratón, y en el submenú que aparecerá escogemos esta opción

Un mismo campo puede añadirse múltiples veces a la definición de la vista.



Con esta opción, nos aparecerá una lista de todos los campos existentes en la tabla escogida, en la cual podemos seleccionar todos aquellos que queramos añadir a la vista de una sola vez.

Añadir campos de otras tablas relacionadas

Evidentemente, cuando estamos confeccionando una vista, pocas veces tendremos toda la información necesaria en una única tabla, por lo que será preciso añadir campos de otras tablas para poder obtener la información que deseamos.

En nuestro caso, queremos obtener también información de los pagos y de los orígenes de estos pagos, por lo que necesitaremos campos de estas tablas.

Para añadir campos de estas nuevas tablas, lo que tenemos que hacer es, como en el caso anterior, buscar la tabla a la que pertenecen, pero en este caso esa tabla debe estar relacionada con la anterior para evitar comportamientos no deseados como veremos más adelante.

Si la tabla origen de nuestros campos ya existe en la vista jerárquica, podemos añadir campos más rápidamente con la opción “Añadir campos” de la tabla.



Una vez localizada la tabla, sólo tenemos que hacer lo mismo que antes para añadir cualquier campo que deseemos.

Añadir campos de una tabla nieta (hija de una tabla hija)

En ocasiones, nos encontramos en la situación que los campos que deseamos añadir no son de la tabla directamente relacionada con ninguna tabla de nuestra vista, como la tabla Pagos del caso anterior, sino que pertenecen a una tabla que está relacionada con una de las tablas relacionadas con una de las tablas de nuestra vista. En nuestro caso, por ejemplo, si queremos conocer el Tipo de Abono al que corresponden los pagos incluidos, nos encontramos con que para obtener esta información debemos hacer el siguiente camino:

Pagos -> Abonos -> TipoAbono -> Campo Descripción

Para añadir el campo que necesitamos (campo Descripcion de la tabla TipoAbono), no es necesario que añadamos ningún campo de la tabla intermedia (Abonos). Sencillamente, si añadimos el campo a la vista, teniendo en cuenta que seleccionemos la tabla de origen de forma correcta como indicamos anteriormente, se añadirán automáticamente todas las tablas intermedias que sean necesarias.



Realizando lo mismo para el resto de campos necesarios para conocer el origen de los pagos, nuestra vista quedará:

Añadir todos los campos de una tabla

Hasta ahora, hemos añadido los campos 1 a 1, seleccionando sólo aquellos que nos interesaban. En algún caso, pueda que nos interese incluir todos los campos de una tabla, con lo que el sistema anterior sería un poco lento. Para hacerlo de forma más rápida y simple, podemos seleccionar la tabla y arrastrar la tabla (en este caso no es válido el “doble clic”) en lugar del campo, a la vista jerárquica, de forma que se añadirán todos los campos de la misma.



Añadir un campo sólo para el fi ltro

Dado que los listados se basan en las vistas, cualquier campo que necesitemos en cualquier punto de los listados (filtros o plantillas), debe existir en la vista. En muchas ocasiones este campo sólo lo necesitamos para filtrar los datos, pero no queremos que se muestre en los resultados de ninguna forma, bien por claridad en los resultados bien porque provocaría problemas en las funciones de agregación o por otros motivos.

En estos casos, tenemos disponible la opción del menú contextual de los campos “Mostrar en resultado”.

Por defecto, al añadir cualquier campo a la vista, este se mostrará en el resultado, por lo que, si deseamos que un campo sólo esté disponible para el filtro, debemos desactivarlo.

Eliminar campos de la vista

Cuando estamos confeccionando una vista, es posible que nos equivoquemos y añadamos un campo que no es necesario, o que no era el que queríamos. En este caso, podemos eliminarlo simplemente haciendo lo contrario que al añadirlo, arrastrando el

Al arrastrar una tabla a la vista jerárquica, se añadirán todos los campos de la tabla a la vista, pero sólo los campos de esa tabla, no todas las tablas relacionadas con la misma.



campo desde la vista jerárquica hacía la lista de elementos disponibles (a cualquier parte, no hace falta que sea a su tabla origen).

Eliminar una tabla (y sus campos) de la vista

Otra posibilidad es que, en un momento dado, tengamos la necesidad de eliminar una tabla entera de la vista. En este caso, si arrastramos la tabla desde la vista jerárquica a la lista de elementos, eliminaremos la tabla, así como todos sus campos y las tablas relacionadas con ella que hubiésemos incluido en la vista.

Campos personalizados

En muchas ocasiones, los campos directos de la base de datos no tienen la información tal como la queremos. Por ejemplo, para saber si un cursillista está activo, no sólo tenemos que ver si el propio cursillista está activo, sino también si la actividad a la que está inscrito aún no ha finalizado, por lo que si en nuestra vista queremos un campo que nos indique esta situación, no tenemos ningún campo en la base de datos que nos dé la información de forma directa. Para solucionar esta situación (y muchas otras parecidas con las que nos encontraremos), tenemos la opción de crear nuestros propios campos personalizados.

Estos campos personalizados consistirán en expresiones en lenguaje SQL (T-SQL), lo que nos dará una gran cantidad de posibilidades.



El primer paso para poder crear un campo personalizado, es añadir un nuevo campo “normal” a la vista. Lo ideal es que este campo pertenezca a la tabla (o a una de ellas) que usaremos en la expresión SQL, y que sea del mismo tipo de datos que el resultado de nuestra expresión (en caso contrario podremos tener problemas posteriores al ejecutar el listado, sobre todo si usamos este campo en el filtro).

Una vez añadido el campo a la vista, lo seleccionamos y en el menú contextual escogemos la opción SQL.

Con esto, accederemos a la pantalla de edición de expresiones SQL.

En la parte superior de esta pantalla (Consulta personalizada) podremos escribir la consulta personalizada que deseamos para el campo. Por ejemplo:



• Cursillista activo

CASE WHEN Cursillistas.Activo = 1 AND (Actividades.FechaFin IS

NULL OR Actividades.FechaFin > GETDATE()) THEN 1 ELSE 0 END

• Nombre completo de la persona

CASE WHEN Personas.EsEntidad = 1 THEN Personas.Nombre ELSE

Personas.Apellido1 + ' ' + Personas.Apellido2 + ', ' +

Personas.Nombre END

En la parte central (Tipo de datos), podemos modificar el tipo de datos asociado al campo, de forma que podemos establecerlo al que sea correcto en cada caso, sobre todo de cara a su uso en los filtros. Por ejemplo, en los casos anteriores:

• Cursillista activo: Tipo Booleano

• Nombre completo: Tipo Cadena

En la parte inferior, en la zona “Expresiones guardadas” se mostrarán, si existen, la lista de expresiones predefinidas que se hayan guardado y estén asociadas a la misma tabla a la que corresponda el campo que inicialmente hayamos escogido. En la parte derecha, en la zona “Definición” se nos mostrará la expresión asociada a ese nombre.

Si seleccionamos cualquiera de estas expresiones haciendo doble clic sobre la misma, se aplicará automáticamente al campo actual. Debemos tener en cuenta que, si hemos indicado un alias para alguna de las tablas usadas en la expresión, deberemos modificarla para ajustarla a este alias.



Finalmente, el área “Botones” nos permite realizar ciertas acciones:

Eliminará de la lista de expresiones guardadas la que esté seleccionada en ese momento.

Si ninguna de las expresiones existentes se ajusta a nuestras necesidades, podemos escribir una nueva en la zona de Consulta Personalizada y guardarla para usar posteriormente con este botón.

Volverá a dejar el campo en su estado original, eliminando cualquier consulta personalizada que le hubiésemos asignado

Validará los cambios realizados, asignando la expresión indicada a la definición del campo.

Cancelará los cambios realizados. Esto no afectará a las expresiones que hayamos creado o eliminado.

Campos especiales

Hasta ahora hemos visto como añadir campos existentes en la base de datos o modificar alguno para convertirlo en la expresión SQL válida. Pero existe la posibilidad de incluir otros campos con funcionalidades especiales. Estos campos pueden agruparse en 2 tipos:

Campos calculados

Son un tipo de campo especial que permitirá obtener un valor calculado (generalmente el importe de una cuota) inexistente en ninguna tabla de la base de datos. Estos campos realmente son llamadas a funciones y sólo serán útiles cuando se incluyan en una plantilla y el listado se ejecute desde Deporwin, pues en el resto de casos no devolverán ningún valor o devolverá la propia expresión. El motivo de esta limitación es que su cálculo es costoso, por lo que emplearlo en listados sin plantilla provocaría que el tiempo de ejecución del listado fuera muy alto; y que el cálculo de la función lo debe realizar Deporwin.

Para incluir uno de estos campos especiales, debemos incluir en la vista un campo cualquiera (preferiblemente un campo tipo Texto) y modificar su definición con una expresión personalizada. La expresión debe ser del tipo

'NombreFuncion(NombreParámetro:=AliasCampoConValor)'

(se deben incluir las comillas), donde:

• NombreFuncion: es el nombre de la función que queremos que realice el cálculo



• NombreParámetro: es el nombre del parámetro que le pasamos a la función para realizar el cálculo. Este valor no es necesario, pero es recomendable usarlo para evitar problemas con el orden de los campos.

• AliasCampo: es el alias del campo, tal como esté definido en la vista, que contiene el valor correspondiente al parámetro.

Además, este campo debe tener un alias que sea CCC_Alias (donde Alias puede ser cualquier nombre).

Las funciones disponibles son (separamos por / diferentes posibilidades para el mismo campo):

CuotaAbono(IdAbono) CuotaAbonado(IdAbono) Calcula la cuota actual correspondiente al IdAbono indicado

CuotaMantenimientoAbono(IdAbono) CuotaMantenimientoAbonado(IdAbono) Calcula la cuota de mantenimiento actual correspondiente al IdAbono indicado

MatriculaAbono(IdAbono) MatriculaAbonado(IdAbono) Calcula la matrícula actual correspondiente al IdAbono indicado

CuotaCursillista(IdPersonaCursillista/IdPersona, IdActividad/IdActividadCursillista/CodigoActividad, IdNumeroCursillista / Numero) Calcula la cuota actual para el cursillista indicado

MatriculaCursillista(IdPersonaCursillista/IdPersona, IdActividad/IdActividadCursillista/CodigoActividad, IdNumeroCursillista / Numero) Calcula la matrícula actual para el cursillista indicado

CuotasCursillista(IdPersonaCursillista/IdPersona, IdActividad/IdActividadCursillista/CodigoActividad, IdNumeroCursillista / Numero, FechaInicio, FechaFin) Calcula las cuotas a pagar por el cursillista indicado en las fechas seleccionades. El formato de salida es una cadena con formato: 57,15€ [01/01/2007] 63,10€ [01/03/2007]

PrecioServicioNMS(IdContratoComponenteServicioPeriodo, IdTipoCargo) Calcula el precio correspondiente al periodo indicado para el tipo de cargo que indiquemos.



Veámoslo en ejemplos:

Campos INI

Además de los campos anteriores, en una vista podemos incluir un campo personalizado que tome como valor el valor de una entrada en uno de los ficheros .ini de la aplicación.

Como en el caso anterior, para añadir un campo de este tipo debemos incluir en la vista un campo cualquiera (preferiblemente un campo tipo Texto) y modificar su definición con una expresión personalizada. La expresión debe ser del tipo

"{ValorINI=NombreFicheroIni;NombreSeccion;NombreParámetro}"

(ojo a las comillas, llaves inicial y final y al punto y coma de separación), donde:

• NombreFicheroIni: es el nombre del fichero del cual queremos recuperar el valor (deporwin, vigilante, etc, sin la extensión .ini)

• NombreSección: es el nombre de la sección del fichero donde se encuentra el valor que queremos recuperar (sin los corchetes).

• NombreParámetro: nombre del parámetro del cual queremos obtener el valor.

El uso de esta opción nos permitirá personalizar algunos contenidos de los listados en función del entorno del usuario (por ejemplo, variar el logo que sale impreso en la cabecera):



Por ejemplo, en el listado C706:

Ir a…

En el menú contextual del campo, vemos que aparece la opción “Ir a…”. Esta opción “sincronizará” la vista jerárquica con la lista de elementos disponibles, situándose en el campo sobre el que hayamos lanzado el menú.

Alias

Establecer / modificar alias de los campos

El Alias (como en las redes sociales), es la forma de darle un nombre “propio” a cada campo de una vista, igual que en SQL le da nombre a cada campo de una consulta.

Al añadir campos a la vista, veremos que en la vista jerárquica el campo aparece en la forma: NombreAlias ALIAS DE NombreCampo.



donde vemos que, en principio, el NombreAlias coincide con el NombreCampo, lo que hace que tengamos alias repetidos (Descripcion) que provocaría que en el resultado final no fuésemos capaces de diferencias a qué campo real se refiere cada uno de ellos.

Para evitar este problema, nosotros podemos determinar qué alias se asigna a cada campo de la vista, de forma que podamos saber, en todo momento, a qué campo nos referimos.

Para poder modificar el alias asignado a cada campo, seleccionamos el campo para el que deseamos asignarlo / modificarlo y accedemos al menú contextual.

Vemos que las 2 primeras opciones son: Alias y Alias abreviado.

a) Alias: Se refiere al alias tal como hemos explicado anteriormente, el nombre por el cual nos referiremos al campo en esta vista

b) Alias abreviado: Similar al anterior, pero sólo se utiliza en las Tablas Dinámicas. En caso de no existir, se usará el Alias.

Reporwin evita que en la consulta final existan alias duplicados añadiendo un número al final del Alias en caso de que existan.

Si un campo de la vista no tiene Alias asignado, Reporwin creará un alias por defecto en el momento de la ejecución que será NombreTabla_NombreCampo (por ejemplo, TipoAbono_Descripcion).



Si seleccionamos cualquiera de ellas, accederemos a la pantalla de gestión de Alias

Esta pantalla nos permitirá asignar un alias al campo seleccionado, tanto escribiéndolo directamente en la zona superior (Alias actual), como seleccionando uno de los que aparecen en la lista.

En la zona de alias pre establecidos aparecerán todos los alias que se hayan usado en algún momento para ese campo en concreto y si el alias que indiquemos no aparece, será añadido automáticamente.

Si en cualquiera de los alias marcamos la casilla “Defecto”, ese alias se convertirá en el alias por defecto para ese campo, de forma que cuando volvamos a añadir (en esta u otra vista) ese campo a la vista, será el alias que se le asigne automáticamente en lugar del nombre del campo.

El botón Eliminar alias, nos permitirá eliminar un alias de la lista.

Alias para una tabla

De forma idéntica a los campos, a las tablas también les podemos asignar un Alias diferente a su nombre para referirnos a ellas en la vista.

Esto es especialmente útil si tenemos que incluir más de una vez la misma tabla en la vista, como por ejemplo la tabla Pagos relacionada con Personas por el campo IdPersona (Titular) y nuevamente por el campo IdPersonaOrigen (Usuario). Al añadir la segunda tabla, Reporwin le asignará internamente el alias Pagos_2, pero este es poco explicativo, por lo que sería recomendable asignarle un alias, como por ejemplo PagosUsuario a una y PagosTitular a la otra.



Relaciones “no recomendadas”

Tal como hemos indicado en más de una ocasión, al añadir campos de tablas tenemos que tener especial cuidado para que las tablas que estamos incluyendo estén relacionadas entre sí para no obtener resultados erróneos. Veamos posibles ejemplos de relaciones que deberíamos evitar, o por lo menos ser conscientes de su resultado.

a) Incluir 2 tablas raíz, es decir 2 tablas sin ninguna relación entre sí.

En este caso, obtendríamos un producto cartesiano de los resultados, pues estamos relacionando cada registro de la tabla Pagos con TODOS los registros de la tabla Personas.

b) Añadir 2 veces la misma tabla, pero desde 2 puntos distintos del hilo de relaciones.

En este caso, la vista devolverá los resultados esperados, pero estaremos reduciendo su rendimiento por obtener un dato disponible ya en la primera tabla desde otra tabla.

c) Incluir dos tablas en relación 1 a N con la tabla “padre” y no relacionadas entre ellas.

Este caso es similar al de añadir dos tablas raíz, pues cada pago queda cruzado con todos los perfiles de la persona.



Funciones

Funciones unarias

Las funciones unarias son funciones predefinidas en el sistema que modifican el valor devuelto por un campo incluido en la vista. Estas funciones son diversas y su disponibilidad depende del tipo de campo sobre el que la queramos aplicar.

Estas funciones las encontramos en el menú contextual de cada campo.

Veamos cuales son las funciones disponibles y a que tipos de campo se aplican:

Función Tipo datos campo

Tipo datos devuelto

Explicación

Nada Todos Tipo campo origen

Devuelve el campo sin aplicar ninguna función unaria.

Día Semana Fecha / Fecha-Hora

Numérico Devuelve un número que representa el día de la semana correspondiente a la fecha. 1 para el Lunes, …, 7 para el Domingo

Día semana texto

Fecha / Fecha-Hora

Texto Como la anterior, pero devuelve el nombre del día de la semana.

Mes Texto Fecha / Fecha-Hora

Texto Devuelve el nombre del mes correspondiente a la fecha (Enero,…, Diciembre).

Día Fecha / Fecha-Hora

Numérico Devuelve el día correspondiente a la fecha.

Mes Fecha / Fecha-Hora

Numérico Devuelve el número de mes correspondiente a la fecha.

Año Fecha / Fecha-Hora

Numérico Devuelve el año correspondiente a la fecha.




Tipo datos devuelto

Explicación

Segundo Fecha / Fecha-Hora

Numérico Devuelve los segundos correspondientes a la parte hora de la fecha.

Minuto Fecha / Fecha-Hora

Numérico Devuelve los minutos correspondientes a la parte hora de la fecha.

Hora Fecha / Fecha-Hora

Numérico Devuelve la hora correspondiente a la parte hora de la fecha.

Texto Todos Texto Convierte el valor de campo en texto. Foto Numérico Texto Devuelve la ruta en la que se encontraría la foto

del usuario con IdPersona correspondiente al valor del campo.

Imagen Concepto

Numérico Texto Devuelve la ruta en la que se encontraría la imagen del concepto con Id correspondiente al valor del campo.

Edad Fecha / Fecha-Hora

Numérico Devuelve la diferencia, en años, entre la fecha correspondiente al campo y la actual.

EsNegativo Numérico Boleano Indica si el campo tiene un valor negativo o no. Euros Numérico Numérico Convierte el valor del campo a Euros aplicando

el tipo de cambio SiNoBlanco Todos Texto Devuelve el texto “Sí” en caso que el valor del

campo sea Verdadero, “No” si es Falso y un espacio en blanco en cualquier otro caso.

SiNo Todos Texto Similar al anterior, pero sólo devuelve “Sí” si el valor del campo es Verdadero y “No” en cualquier otro caso.

Funciones de agregación

En algunas ocasiones nos encontraremos con que lo que deseamos obtener mediante nuestra vista no es la lista de todos los valores posibles de todos los campos incluidos en la vista, sino el valor detallado de algunos de ellos y un cálculo sobre otros para cada uno de los grupos resultantes. Ejemplos de esto serian:

• Saber el importe total de los pagos realizados por un usuario.

• Conocer cuántas personas viven en cada calle.

• Cuántas veces ha accedido una persona cada día.

Para poder obtener datos de esta forma tenemos disponibles las funciones de agregación. Estas funciones se aplican a uno o varios campos de la base de datos, con lo cual obtendremos, para cada combinación de valores del resto de campos incluidos en la vista, unos valores “resumidos” para los campos agregados.

Como en el caso de las funciones unarias, las funciones de agregación se encuentran en el menú contextual de los campos y las funciones disponibles dependen del tipo de campo sobre el que estemos actuando.



Veamos cuales son las funciones disponibles y a que tipos de campo se aplican:


Tipo datos devuelto

Explicación

No Agregado

Todos Tipo campo origen

Devuelve el valor original del campo, no aplicando ninguna agregación.

Primero Todos Tipo campo origen

Devuelve el primer valor (en Access) o el valor mínimo (en SQL), en el grupo, del campo al que se aplique.

Ultimo Todos Tipo campo origen

Devuelve el último valor (en Access) o el valor máximo (en SQL), en el grupo, del campo al que se aplique.

Cuenta Todos Numérico Nos devuelve el número de veces que ese campo, en el grupo, tiene un valor no nulo.

Cuenta todos

Todos Numérico Idéntica a la anterior.

Suma Numérico Tipo campo origen

Devuelve la suma de los valores, en el grupo, para el campo donde se aplica.

Mínimo Todos Tipo campo origen

Devuelve el valor mínimo, en el grupo, para el campo donde se aplica.

Máximo Todos Tipo campo origen

Devuelve el valor máximo, en el grupo, para el campo donde se aplica.

Promedio Numérico Numérico Devuelve el valor promedio, en el grupo, del campo donde se aplica.

Agregado Todos El especificado en la consulta

Permite establecer una consulta personalizada para el campo, que corresponda a una agregación (generalmente más compleja de las admitidas inicialmente). Debemos marcarla de esta forma para que la vista sea válida.

Como vemos en las descripciones, siempre indicamos que realiza el cálculo en el grupo. Este grupo corresponde a los valores idénticos para todos los campos no agregados existentes en la vista. Por ejemplo:



Esta vista nos devolvería la Suma del Importe para cada valor diferente de todos los demás campos incluidos.

Modificar la relación entre tablas

Modificar el tipo de relación entre tablas

Hasta ahora, hemos añadido tablas a la vista simplemente añadiendo los campos que necesitábamos, de forma que la relación entre las tablas se establecía tal como hubiésemos indicado inicialmente en la definición del listado. En su momento ya comentamos que este valor de la definición era un valor por defecto, pero este valor puede ser modificado.

Para modificarlo, debemos seleccionar la tabla “hija” para la que deseamos modificar la relación con su “padre” y mostrar el menú contextual.



Como vemos, aquí tenemos diferentes opciones disponibles. Por defecto, vemos seleccionada la escogida inicialmente en la definición de la vista, pero podemos modificar esta selección si es necesario:

• Sólo los registros relacionados de PERSONAS con PAGOS: Sólo mostraría los registros en que exista relación entre las dos tablas, es decir, sólo las personas que tengan algún pago. Correspondería al INNER JOIN.

• Todos los registros de PERSONAS y sólo los relacionados de PAGOS: Correspondería a un LEFT JOIN.

• Todos los registros de PAGOS y sólo los relacionados de PERSONAS: Correspondería a un RIGHT JOIN.

Aunque cualquiera de las opciones es posible y válida, excepto en casos en que sea absolutamente imposible hacerlo de otro modo, no es recomendable utilizar la última de ellas, ya que “rompe” el flujo natural de la vista y no se ve reflejado de ninguna forma en la vista jerárquica de la vista, lo que puede inducir a errores en la interpretación de los datos que se obtendrán.

Modificar la expresión de relación entre tablas

Cuando añadimos una nueva tabla a partir de la lista de elementos disponibles a la vista, esta se añade mediante la relación existente entre ellas que hayamos escogido. Pero en ciertas ocasiones esta relación no es la que buscamos, o por lo menos, no “exactamente” la que buscamos. Por ejemplo, si en nuestra vista de ejemplo deseamos obtener todas las personas con sus pagos (si hay) pero solo cuando el origen de los pagos sea la venta de un concepto, la relación existente entre Personas y Pagos no es “exactamente” la que buscamos.

La relación generada automáticamente entre personas y pagos es:

Personas LEFT JOIN Pagos ON Personas.IdPersona = Pagos.IdPersona

pero nosotros queremos limitarla a los pagos correspondientes a conceptos, por lo que debería ser:

Personas LEFT JOIN Pagos ON Personas.IdPersona = Pagos.IdPersona

AND Pagos.Origen = 7

¿Cómo modificamos la relación para que se ajuste a nuestras necesidades? Sencillo. Igual que en el caso de los campos teníamos la opción de crear un campo personalizado mediante una consulta SQL, en el caso de las tablas también tenemos la posibilidad de personalizar la relación mediante SQL.



Al seleccionar esta opción, accedemos a la misma pantalla que anteriormente en el caso de los campos, en la cual podremos modificar la consulta que especifica la relación entre las tablas.

Esta funcionalidad nos permitirá ajustar en muchos casos la información obtenida, así como modificar totalmente el comportamiento de la relación entre tablas. Debemos tener muy claro que la relación que estamos modificando sea válida y nos proporcione resultados correctos.



Añadir una tabla / consulta relacionada, pero sin relación existente en el modelo

En ocasiones veremos que en nuestra vista es necesario incluir los datos de una tabla (o una consulta la mayoría de las veces), para la que no existe una relación con ninguna tabla que estemos utilizando en la vista, pero que realmente sabemos que se pueden relacionar, pues existen campos comunes que lo permiten. Como decimos, esto puede ser muy habitual si hemos creado una consulta en la propia base de datos para obtener algunos datos y, después, deseamos incluirla en la vista, dado que en SQL no es posible crear en relaciones entre tablas y consultas.

Para ayudarnos a solucionar este problema, en Reporwin disponemos de la opción de incluir estas tablas / consultas desde el menú contextual de la tabla: Seleccionamos en la vista jerárquica la tabla con la que queremos relacionar nuestra nueva tabla y en el menú contextual escogemos la opción “Nueva relación”

Con esta opción, nos aparecerá una pantalla en la que podremos establecer la relación entre nuestra tabla y la que queramos relacionar y que nos permitirá guardarla en la base de datos para poder usarla posteriormente en otras vistas sin tener que volverla a crear.

Veamos los diferentes campos que tenemos:



• Nombre de la relación: Nombre que le daremos a nuestra relación. Este campo lo podemos rellenar con el nombre que queramos, pero por defecto se creará con el nombre de las tablas que incluyamos.

• Tabla seleccionada: Tabla a la que queremos relacionar la nueva tabla / consulta. Este campo está fijado.

• Tipo: Tipo de relación existente entre ambas tablas. Puede ser N:1 (Personas – Calles), 1:N (Personas – Cursillistas) ó 1:1 (Personas – PersonasDatosExtra).

• Tabla relacionada: Tabla / Consulta que queremos relacionar con la anterior. Aquí tendremos una lista con todas las tablas / consultas existentes en la base de datos para seleccionar la que queremos.

• Campos tabla seleccionada: Campos de nuestra tabla inicial por los que se establecerá relación con la nueva tabla. Inicialmente sólo hay uno, pero se pueden añadir más o eliminar alguno existente con los botones “+” y “-“ situados al lado.

• Campos tabla relacionada: Campos de la tabla relacionada por los que se establecerá la relación con la tabla anterior. Cada campo se relaciona con su equivalente en la otra tabla.

Así, si queremos relacionar la tabla personas con la consulta _PrimeraAltaPorPersona, tendríamos:

En cambio, si la relación fuese entre Personas e IntegrantesAbonos para el abono activo:



Una vez creada la relación que deseamos, pulsamos aceptar. En este punto, se nos preguntará si deseamos guardar la relación creada en la base de datos, lo que, como decíamos anteriormente, nos permitirá que esté disponible en cualquier vista sin necesidad de volverla a crear (en nuestra vista actual estará disponible de todas formas). En caso de que la relación sea reaprovechable, sería conveniente crearla; si es una prueba o una relación “poco clara”, mejor no la creamos y sólo la utilizamos en esta vista.

Una vez guardada o no la relación (se creará igualmente para la vista actual), veremos que tanto en la lista de elementos disponibles como en la vista jerárquica aparece esta nueva tabla relacionada con la seleccionada.

También puede pasar que la relación que deseamos establecer no es exactamente por un campo, sino por un cálculo realizado en alguno de ellos u otras condiciones que no podemos indicar en la anterior pantalla. En ese caso, debemos añadir un campo en la pantalla de creación de la relación, aunque no sea el que se va a usar realmente, pues es necesario. Posteriormente, podemos modificar la expresión de relación, tal como hemos visto anteriormente, mediante una consulta SQL.



Añadir una tabla no relacionada

A pesar de que más de una vez hemos comentado los peligros de incluir en nuestras vistas tablas no relacionadas con las ya incluidos, en algunos casos, y conociendo perfectamente su repercusión, es necesario hacerlo.

Un caso muy habitual es el correspondiente a la tabla Parametros, que incluye información sobre la entidad. Dado que esta tabla tiene un único registro, su inclusión no provocará resultados erróneos.

Otro caso en el que sería útil y necesario incluir una tabla no relacionada, sería la tabla Diario, que utilizamos en algunos listados para simplificar el filtro. En este caso la tabla tiene muchos registros (1 por día por x años), por lo que al añadirla provocará registros duplicados que evitaremos posteriormente mediante condiciones en el filtro.



Guardar la vista

Ahora que ya tenemos nuestra vista creada, con todos los campos que deseamos y sus alias establecidos, viene el momento de guardarla para poder utilizarla posteriormente.

Para ello, en el menú seleccionamos la opción “Guardar Vista como …”

con lo que aparecerá la pantalla con la lista de vistas existentes,

dónde podemos seleccionar una de las vistas existentes para modificar su definición o introducir un nuevo nombre para crear una nueva vista. En nuestro caso, la llamaremos VistaCurso.



MODIFICAR UNA VISTA

La modificación de una vista existente se realiza igual que su confección. Sólo necesitamos abrir la vista que queremos modificar. Para acceder a la vista que queremos modificar podemos hacerlo de distintas formas:

a) Accediendo a la pantalla de vistas (Módulos -> Vistas), como si fuésemos a crear una nueva vista. Desde aquí, en el menú podremos selección “Abrir Vista”,

con lo que aparecerá la pantalla para seleccionar qué vista deseamos abrir para su modificación.

b) En la pantalla principal de Reporwin, desde la propia definición de un listado, pulsando en el botón correspondiente a la vista.



c) En la pantalla principal de Reporwin, escogiendo la vista que deseemos modificar en la lista de vistas situada en la parte inferior de la pantalla. Una vez seleccionado, clicamos con el botón derecho del ratón y, en el menú contextual, seleccionamos la opción “Diseñar”

Una vez realizado cualquiera de estos pasos, accederemos a la pantalla de Vistas mostrando la definición de la vista que hayamos seleccionado y que ya podremos proceder a modificar.

OTRAS OPCIONES DEL MÓDULO

Una vez hemos visto cómo se crea y / o modifica una plantilla, es el momento de fijarnos en el resto de pestañas que aparecen en este módulo.

Las pestañas Datos Vista y Vista Jerárquica ya las hemos visto de forma completa. Veamos el resto.

Vista Plana

La pestaña Vista Plana, nos mostrará todos los campos (sólo los campos) incluidos en la vista en forma de lista. En ella, podremos modificar el orden de los campos, lo cual puede ser útil posteriormente si visualizamos los datos en formato tabla.



Filtro

Esta pestaña nos permitirá gestionar (crear, guardar, modificar) un filtro, sobre todo para hacer pruebas con la vista. Dado que los filtros tendrán su propio capítulo más adelante, no entraremos en detalle.

Resultado

En esta pestaña encontraremos la consulta SQL resultante de la vista que hemos creado. Puede ser muy útil en los casos en que no estemos obteniendo los resultados esperados para poder analizar más claramente el motivo. Esta ventana NO permite la modificación de la vista, sólo ver su equivalencia en SQL.



Listados

Como hemos dicho en alguna ocasión, los componentes en Reporwin son reaprovechables, de forma que una vista se puede utilizar en más de un listado. En esta pestaña veremos en qué listados se está utilizando la vista actual, junto con que filtros y plantillas.

Debemos tener muy presente esta información al realizar modificaciones que pueden provocar que dejen de funcionar otros listados.

Compatibilidad

Además de poder utilizar una vista en más de un listado, podemos indicar que una vista es compatible con ciertos filtros y plantillas. Esto significa que los campos que precisan filtros y plantillas se encuentran disponibles en la vista, de forma que no se producirá ningún error y nos permitirá imprimir una vista de más de una forma (esto lo veremos posteriormente en el manual).



En esta pantalla, podremos indicar con que Filtros y / o Plantillas es compatible la vista actual.

Para añadir un nuevo filtro o plantilla a la lista correspondiente de compatibles con la vista actual, sólo debemos arrastrarlos desde la lista superior (disponibles) a la inferior (compatibles).

Para eliminar un elemento compatible, realizaremos la acción contraria, arrastrando el elemento desde la lista inferior a la superior.

Vemos que en la parte inferior (compatibles) aparece la columna “Activo”, que nos permite indicar si ese elemento está activo actualmente o no. Realizando doble click sobre esa columna, podemos cambiar su estado.

Debemos tener en cuenta que en esta pantalla no se realiza ninguna comprobación: si decimos que un listado es compatible con un cierto filtro, el programa se lo “creerá”, aunque posteriormente podemos tener problemas por no ser así.



MÓDULO FILTROS INTRODUCCIÓN

Los filtros, como hemos comentado previamente, nos permitirán limitar el número de registros obtenidos a partir de los datos de la vista mediante la aplicación de ciertas condiciones. También nos permitirán ordenar estos registros de cara a su presentación en tablas. Comparándolo con las sentencias SQL, en esta pantalla definimos la parte correspondiente al WHERE, al ORDER y al HAVING (en el caso que la vista incluya campos agregados).

Pantalla de Filtros

Para acceder al módulo filtros lo haremos desde el menú principal, en la opción “Módulos -> Filtros”.

Con esto accederemos a la pantalla de Filtros:

En esta pantalla vemos que tenemos diferentes pestañas. Veamos una breve descripción de cada una:

• Datos filtro: Los datos básicos del filtro.

• Filtro: La propia definición del filtro.

• Resultado: Nos mostrará la consulta SQL resultante de la vista y el filtro, permitiendo presentar los resultados en una tabla.

• Listados: Relación de listados en los que se usa el filtro actual.



CREAR UN FILTRO

Definición básica

Si queremos crear un nuevo Filtro para Reporwin, lo primero es definir ciertos valores que serán necesarios para poder continuar con nuestro trabajo, que se encuentran en la pestaña “Datos Filtro”.

Lo primero, será decidir qué queremos filtrar, es decir, en que vista están los datos que deseamos filtrar, que en nuestro caso será la vista creada anteriormente: VistaFiltro

Una vez determinado, introducimos los datos necesarios en la pantalla:

• Nombre: Nombre “explicativo” que le daremos a la vista. Este dato, así como la descripción aparecerán en la pantalla principal de Reporwin y nos servirán para determinar que filtro nos interesa.

• Descripción: Una explicación más completa del objetivo del filtro.

• Vista: Aquí escogeremos, de entre todas las disponibles, la vista en la que basaremos nuestro filtro. Podemos escribir el nombre de la vista directamente, o pulsar el botón situado al lado, que nos mostrará una ventana con todas las vistas disponibles y podremos seleccionar una.

• Una vez definidos estos valores:

pasaremos a la siguiente pestaña, Filtro, para empezar con la definición de las condiciones del filtro.

Debemos tener en cuenta que la vista seleccionada sólo nos indicará qué campos tendremos disponibles en el filtro, no implicando que sólo pueda aplicarse a esa vista, pues como ya comentamos los componentes son reutilizables. Además, podrá modificarse posteriormente si fuese necesario.



Pestaña filtro

Al acceder a la pestaña filtro, nos encontramos con la siguiente pantalla:

Como vemos, en esta pantalla tenemos diferentes controles que nos permitirán gestionar el filtro:

• Nº Cond. (Nº Condiciones): Nos indicará el número de condiciones que tendrá el filtro (nº de posibles condiciones diferentes para un mismo campo).

• Orden: Nos permitirá modificar el orden en que se muestran los campos, es decir, que campo debe aparecer más arriba (o más abajo) en la lista de campos disponibles, con las implicaciones que tiene, que veremos posteriormente.

• Refrescar Campos: Vuelve a cargar la lista de campos disponibles para el filtro. Es especialmente útil en caso de haber modificado la vista asociada al filtro para cargar los nuevos campos disponibles, o en el caso de que no aparezcan todos los casos en la lista inferior.

• Lista campos disponibles: Muestra la lista de campos disponibles en función de la vista escogida previamente. A su vez, está dividida en las zonas Campo y Condiciones.

o Campo: Aparte de indicarnos el Alias que tiene el campo, nos permitirá establecer condiciones que afectarán a todo el campo en la definición del filtro.

o Condiciones (Condición 1, …, Condición N): Nos permitirá establecer condiciones concretas de filtro para el campo. Estas condiciones siempre tienen las partes Desde – Hasta.



Campo de filtro

Tal como acabamos de indicar, el campo corresponde a cada uno de los campos en la vista seleccionada. En ella tenemos, en primer lugar, el Alias del campo (de ahí la importancia de indicar alias correctamente en la vista), y 4 campos para indicar el comportamiento.

Orden (Ord)

Con esta propiedad podremos indicar si queremos que se utilice algún orden en el campo. Por defecto, no se aplica ningún orden, pero podemos escoger entre Ascendente (Asc) y Descendente (Desc). Si en un filtro indicamos orden para varios campos, el orden vendrá establecido por la posición que ocupen en la lista, de forma que se ordenará primero por el que aparezca más arriba, después por el siguiente y así consecutivamente, de forma que para modificar ese orden, deberemos cambiar la posición de los campos en la lista mediante los botones de orden.

Negado (Neg)

Con esta propiedad podemos establecer si las condiciones indicadas para el campo se deben cumplir o no cumplir. Por defecto, el valor es no negado, lo que indica que se deben cumplir las condiciones. Si lo marcamos, estaremos indicando que no deben cumplirse



las mismas. Este valor se refiere a TODAS las condiciones especificadas para el campo (tengamos en cuenta que puede haber más de 1 condición), a diferencia del indicador que encontraremos en la condición, que se refiere exclusivamente a esa condición.

Prescindible (Presc)

Mediante esta propiedad podremos indicar si un campo es prescindible o no. Un campo prescindible en el filtro es aquel para el que estamos estableciendo una condición, pero que en caso que la vista donde estamos aplicando el filtro (recordemos que un mismo filtro se puede aplicar a varias vistas) no contenga ese campo, podremos continuar sin problemas. En caso de que el campo no esté marcado como prescindible, si no existe en la vista obtendremos un mensaje de error.

Tipo Condición (TC)

Esta propiedad nos permitirá establecer en que parte de la consulta final aparecerá la condición que indiquemos: en la cláusula WHERE o en la cláusula HAVING. Por defecto, el valor es automático (Auto), con el cual es el propio programa el que determina en cuál de las 2 cláusulas aparece, pero podemos forzar que aparezca en el WHERE o en el HAVING.

Aunque el hecho de que una condición aparezca en una u otra cláusula no suele causar problemas (excepto si el campo al que aplicamos la condición es un agregado, que sólo puede aparecer en el HAVING), si tiene repercusiones en el rendimiento: no es lo mismo calcular la suma de los importes para todas las personas y después filtrar sólo la persona que nos interesa (having), que calcular la suma sólo para la persona que nos interesa (where), por lo que puede ser interesante forzarlo para mejorar el rendimiento del listado.

Condiciones de filtro



Esta es la parte real donde definiremos las condiciones de filtro que queremos establecer. Aunque por defecto al crear un filtro este sólo tiene 1 condición (es el mínimo), podemos establecer hasta 15 condiciones diferentes para cada campo.

Como vemos en la pantalla, cada condición se compone de 3 propiedades:

• No: Nos permite indicar si queremos que la condición indicada se cumpla o no. Por defecto no está marcado, lo que indica que la condición se debe cumplir. Esta propiedad sólo se aplica a la condición actual, a diferencia del negado del campo, que se aplica a todas las condiciones del campo.

• Desde – Hasta: Todas las condiciones pueden especificarse en forma de intervalo o rango, que se indica en las propiedades desde – hasta. En el caso de que ambas propiedades sean iguales, la condición será una igualdad.

o Condición Desde <> Condición Hasta: Rango

Valor Campo >= Condición Desde y Valor Campo <= Condición Hasta

o Condición Desde = Condición Hasta: Igualdad

Valor Campo = Condición

Para establecer una condición para uno de los campos del filtro, debemos clicar sobre la columna “Desde” o “Hasta”. Al hacerlo, aparecerá la siguiente pantalla:

en la que observamos que tenemos varias opciones para establecer el filtro, indicándonos en la zona del título para que campo y qué condición estamos estableciendo.



Filtro Todos

Este es el valor por defecto e indica que no estamos realizando ningún filtro en esa condición. Tenemos 3 posibilidades:

a) Lo usamos en ambas condiciones (Desde y Hasta): no estaremos realizando ningún filtro sobre ese campo.

b) Aparece en la condición Desde y establecemos un filtro diferente en la condición Hasta. En este caso tendremos:

Valor Campo <= Condición Hasta

c) Aparece en la condición Hasta Tenemos un filtro en la condición Desde. En este caso tendremos:

Valor Campo >= Condición Desde

Filtro Exacto

En este caso, filtraremos el valor del campo por el valor exacto que estemos indicando. Como en cualquier otro de los filtros que explicamos, es importante que la condición indicada en el filtro sea aplicable al campo sobre el que lo realizamos, es decir, el valor sea aplicable al campo y el tipo de datos sea correcto. Así, sobre el campo IdPersona, deberá ser un valor numérico. En este caso, y los posteriores, tenemos 4 opciones:

a) Usamos el mismo valor en ambas condiciones (Desde y Hasta): Igualdad

Valor Campo = Condición

b) Usamos valores diferentes en ambas condiciones:

Valor Campo >= Condicion Desde Y Valor Campo <= Condición Hasta

c) Usamos el Todos en la condición Desde y esta condición en Hasta:

Valor Campo <= Condición Hasta

d) Usamos el Todos en la condición Hasta y esta condición en Desde:

Valor Campo >= Condición Desde



Filtro Parecido

En este caso, establecemos que queremos obtener valores parecidos a los indicados mediante un patrón en la condición. Este tipo de filtro sólo tiene utilidad en campos de tipo texto. En campos numéricos, fecha, etc, se convertirá en un valor exacto.

Filtro Variable

En este caso, el valor que usaremos como filtro nos viene dado desde el exterior: Deporwin, Reserwin, etc, tienen la capacidad, en ciertas pantallas y en los procesos de aplicación (que veremos posteriormente en este manual), de pasar información al listado para filtrar los datos que se obtienen (imprimir un listado referente a la ficha de la persona en la cual nos encontramos en Deporwin, de la actividad que tenemos seleccionada, del servicio seleccionado, etc.). Para ello se usan variables, que son las que se asignan al filtro del campo mediante esta opción.

Aunque el control nos permite escribir cualquier texto, los nombres de variables que se pueden utilizar no son ilimitados, sino que están fijados mediante código en la aplicación, por lo que sólo ciertos valores obtendrán respuesta. En la lista tampoco tienen porque aparecer todos los posibles valores, pues esta lista se carga a partir de información que se encuentra en el .ini de la aplicación, que puede ser incompleta. Por otra parte, el valor asignado a la variable sólo se obtendrá si ejecutamos el listado desde un lugar “apropiado”, es decir, donde el programa espera la petición de ese valor (no recibiremos valor para la variable IdPersona si nos encontramos en la pantalla de definición de conceptos, por ejemplo). En el resto de casos, tanto si la variable no existe como si



Deporwin no es capaz de devolver su valor, aparecerá una pantalla solicitando el valor. Al final del manual encontraremos un Anexo con las posibles variables a usar y dónde están disponibles.

Filtro Parámetro

Hasta ahora, todos los tipos de filtro que hemos mostrado eran transparentes al uso, es decir, se establecen en el filtro y el usuario final no necesita conocer su existencia. Pero en muchos casos es preciso solicitar al usuario algún dato para el listado: La fecha en que queremos obtener el listado, condiciones a cumplir por el listado que queremos que puedan variar en cada caso (tiene email, tiene teléfono, es socio, etc.).

En estos casos, usaremos el filtro de tipo parámetro, que nos permitirá hacerle una pregunta al usuario para que él nos indique el valor. Así, a diferencia de los filtros anteriores, en los que indicábamos el valor que queríamos usar para el filtro, en este caso lo que introduciremos es la pregunta que deseamos hacerle al usuario para que él introduzca el valor.

Con lo que, al ejecutar el listado, se nos mostrará esta pregunta:

En este caso, si queremos preguntar valores diferentes para la condición Desde y Hasta, tendremos que introducir preguntas diferentes para ambas condiciones.



Una característica especial de los filtros de tipo parámetro es que la pregunta establecida en el filtro se convierte en una variable que almacena el valor introducido por el cliente y que se puede utilizar posteriormente en la plantilla asociada al listado. Además, si queremos simplificar el nombre de esta “variable”, podemos especificar un nombre en la propia pregunta, indicándolo entre corchetes, que no aparecerá posteriormente al solicitar el valor al usuario.

Filtro Nulo

Mediante este tipo de filtro, establecemos que el valor del campo donde lo aplicamos debe ser nulo (valor NULL), valor que no podemos indicar en el filtro exacto, pues se entendería como el texto “NULL”

Filtro Expresión

Este tipo de filtro es especial, pues realmente no se aplica al campo donde lo estemos indicando, sino que este actúa, simplemente, como contenedor para definir el filtro. En este caso el filtro que indicamos debe ser una expresión SQL válida, que pasará a formar parte “tal cual”, del filtro aplicado al listado.



Filtro Campo

Un filtro de este tipo nos permite indicar que el valor de un cierto campo debe ser igual (o mayor o menor) que otro campo contenido en la propia vista. Por ejemplo, para que los 2 apellidos sean iguales:

Convertir filtro en parámetro

Como hemos visto, en la mayoría de los casos, excepto el tipo parámetro, la condición se establece en el filtro y es “invisible” al usuario, que no la puede modificar al ejecutar el listado. En casos excepcionales, nos puede interesar que el filtro aparezca con un valor por defecto, pero que el usuario pueda modificar su valor. En estos casos, debemos convertir el filtro en parámetro, pero sin usar el tipo de filtro parámetro, pues este no da un valor por defecto. Para ello, en la parte inferior de la pantalla tenemos la marca “parámetro”, que se puede aplicar a cualquier tipo de filtro (en el de tipo Parámetro es obligatoria y no se puede eliminar) y que forzará que al ejecutar el listado se nos pregunte por el valor para ese campo (en este caso la pregunta será el nombre del campo).



Convertir filtro en obligatorio

Cuando un filtro es de tipo parámetro, es decir, solicitamos datos al usuario, podemos indicar que se debe introducir un valor obligatoriamente (como veremos posteriormente las condiciones parámetro de un filtro pueden desactivarse en la ejecución del listado) para evitar que se lance un listado sin filtro que podría provocar el bloqueo del sistema. Para ello, debemos marcar la opción “Obligatoria” que aparece bajo “Parámetro” y sólo cuando ésta está activa.

Establecer nuestra primera condición de filtro

Ahora que hemos visto todas las posibilidades que nos ofrece la pantalla, vamos a establecer nuestro primer filtro.

En cualquier filtro que apliquemos es importante que la condición indicada en el filtro sea aplicable al campo sobre el que lo realizamos, es decir, el valor sea válido para el campo y el tipo de datos sea correcto.



En nuestro caso, realizaremos el filtro para el campo IdPersona, solicitando un rango de personas sobre las que mostrar los datos, por lo que usaremos un filtro de tipo parámetro con valores diferentes para Desde y Hasta.

Así, seleccionaremos el campo IdPersona y haremos “doble clic” sobre la casilla Desde para indicar la primera condición:

Ahora, haremos “doble clic” sobre la condición Hasta para modificarla y poner el nuevo valor.

Con lo que tendremos establecido nuestro filtro, que se mostrará de la siguiente forma:

Al establecer la primera condición para un campo, se establecerá tanto en la condición Desde como en Hasta, por lo que si no queremos una igualdad deberemos modificar la otra condición del filtro.

Una vez establecidas las condiciones, si modificamos una de ellas la otra no se modificarán aunque sean iguales, por lo que si deseamos una igualdad deberemos modificar la otra condición para que sea idéntica.



Establecer condiciones sobre más de un campo

En muchas ocasiones nos encontraremos con que debemos filtrar la información de más de 1 campo para obtener el resultado requerido. Hacerlo, es tan sencillo cómo establecer el filtro en ese segundo campo de la misma forma que en el caso anterior. Por ejemplo, si queremos que el Apellido1 de las personas seleccionadas empiece por PER, estableceremos un nuevo filtro sobre ese campo.

Cuando indicamos filtros sobre diferentes campos (IdPersona y Apellido1 en nuestro caso), siempre se establece que deben cumplirse TODAS las condiciones, es decir, en nuestro listado aparecerán las personas en el rango que indique el usuario (es un filtro parámetro) y cuyo primer apellido empiece por PER (es un filtro parecido).

Establecer más de una condición sobre un campo

¿Y qué pasa si necesitamos que el apellido empiece por PER o por JIM? En este caso, necesitamos tener más de 1 condición para el mismo campo usando el campo Nº Condiciones que se encuentra en la parte superior de la ventana de filtro.

Con ello vemos que aparece una nueva columna “Condición 2”, en la que podemos indicar nuevas condiciones para cada uno de los campos que necesitemos (no es preciso indicar la condición 2 en los campos que no sea preciso). Esta condición se aplicará con la condición 1 de forma que para ese campo se tenga que cumplir una o la otra, de forma que quedaría:



Forma de aplicación de las condiciones

Visto lo anterior, tenemos que, cuando tenemos varias condiciones se aplican de la siguiente forma:

• En cada condición de cada campo los valores Desde – Hasta se combinan mediante un AND, es decir, se deben cumplir ambas condiciones.

• Para cada campo se evalúan todas las condiciones existentes combinándolas mediante un OR, es decir, se debe cumplir una condición O la otra. Este conjunto sería la condición global del campo.

• Las condiciones globales de cada campo se combinan mediante un AND, es decir, se deben cumplir TODAS las condiciones globales.

Esto, en nuestro caso, significaría:

• Listado de las personas con (IdPersona >= “Persona Desde” Y IdPersona <= “Persona Hasta”) Y con (Apellido1 parecido a “PER*” O Apellido1 parecido a “JIM*”)

Guardar el filtro

Ahora que ya tenemos nuestro filtro creado, viene el momento de guardarlo para poder utilizarlo posteriormente.

Para ello, en el menú seleccionamos la opción “Guardar Filtro como …”

con lo que aparecerá la pantalla con la lista de filtros existentes,



donde podemos seleccionar uno de los filtros existentes para modificar su definición o introducir un nuevo nombre para crear uno nuevo. En nuestro caso, la llamaremos FiltroCurso.



MODIFICAR UN FILTRO

La modificación de filtro existente se realiza igual que su confección. Sólo necesitamos abrir el filtro que queremos modificar, que se hace de forma similar al caso anterior de la vista

a) Accediendo a la pantalla de vistas (Módulos -> Filtros), como si fuésemos a crear un nuevo filtro. Desde aquí, en el menú podremos selección “Abrir Filtro”.

b) En la pantalla principal de Reporwin, desde la propia definición de un listado, pulsando en el botón correspondiente al filtro.

c) En la pantalla principal de Reporwin, escogiendo el filtro que deseemos modificar en la lista de filtros situada en la parte inferior de la pantalla. Una vez seleccionado, clicamos con el botón derecho del ratón y, en el menú contextual, seleccionamos la opción “Diseñar”

Una vez realizado cualquiera de estos pasos, accederemos a la pantalla de Filtros mostrando la definición del filtro que hayamos seleccionado y que ya podremos proceder a modificar.



OTRAS OPCIONES DEL MÓDULO

Una vez hemos visto como se crea y / o modifica un filtro, es el momento de fijarnos en el resto de pestañas que aparecen en este módulo.

Las pestañas Datos Filtro y Filtro ya las hemos visto de forma completa. Veamos el resto.

Resultado

En esta pestaña podremos ejecutar la vista con el filtro que estamos definiendo, devolviéndonos una tabla con el resultado de la operación y la consulta SQL resultante de la combinación de vista y filtro que hemos creado. Puede ser muy útil en los casos en que no estemos obteniendo los resultados esperados para poder analizar más claramente el motivo. Esta ventana NO permite la modificación de la vista, sólo ver su equivalencia en SQL.

Listados

Como hemos dicho en alguna ocasión, los componentes en Reporwin son reaprovechables, de forma que un filtro se puede utilizar en más de un listado. En esta pestaña veremos en que listados se está utilizando el filtro actual, junto con que vistas y plantillas.

Debemos tener muy presente esta información al realizar modificaciones que pueden provocar que dejen de funcionar otros listados.



MODULO LISTADOS: EJECUTAR NUESTRO PRIMER LISTADO OPCIONES DE DESTINO DE UN LISTADO

Ahora que ya hemos creado una vista para nuestro listado, se la podemos asignar tal como habíamos explicado previamente, con lo que veremos que el icono que lo representa cambia.

De esta forma, ya tenemos un listado “válido” y podemos ejecutarlo. Para ello, tenemos 2 opciones:

a) Hacer “doble clic” sobre el listado

b) Pulsar el botón “Preliminar”

De cualquiera de las 2 formas, se iniciará la ejecución del listado. En este caso, lo primero que aparecerá es la pantalla de selección de destino de nuestro listado.



Como vemos, en esta pantalla tenemos múltiples opciones, que nos brindan un gran número de posibilidades de mostrar nuestro listado.

Estos 2 botones nos permiten indicar si queremos utilizar la plantilla definida para el listado o no. Evidentemente, si no hay plantilla definida (como en nuestro caso), el botón correspondiente aparecerá deshabilitado.

Usar la plantilla no significa obligatoriamente que el listado se mostrará con esa plantilla. Según la opción posterior que seleccionemos, se imprimirá con la plantilla o de otra forma, en cuyo caso se usarán sólo los campos de la vista que se hayan incluido en la plantilla (y sólo los campos, no otros elementos que se encuentren en la plantilla como etiquetas, formulas, etc.).

Mostrará los resultados del listado por pantalla. Si hemos seleccionado “Con Plantilla” usará la plantilla asignada, en caso contrario mostrará una tabla con los resultados.

Como la opción anterior, pero enviará el resultado del listado directamente a la impresora seleccionada (o a la indicada en la plantilla si hay alguna).

Enviará el resultado al Servidor de Impresión si está configurado (en caso contrario la opción aparece deshabilitada). Esta opción está en desuso.

Permitirá ver el resultado de nuestro listado en forma de tabla dinámica (ver el manual de correspondiente para más detalles).

Requiere plantilla. Nos permitirá enviar el listado (en forma de documento pdf adjunto) por correo electrónico a todas las personas que aparezcan en el listado. Requiere que la vista incluya la dirección de correo electrónico y un campo especial en la plantilla.

Requiere plantilla. Generará un pdf con el listado. Puede configurarse el listado para generar múltiples documentos pdf.

Permitirá enviar un SMS a todas las personas que aparezcan en el listado. Requiere que en la vista existan campos con alias IdPersona y TelefonoMovil.



Enviará los datos del listado a un Word para permitirnos realizar combinación de correspondencia desde el mismo usando esa información.

Copiará los datos del listado al portapapeles.

Guardará los datos del listado en un fichero de texto.

Mostrará los datos en forma de tabla. Es idéntica a la opción “Sin Plantilla” – “Pantalla”, pero permitiría escoger plantilla.

Enviará los datos del listado a un Excel para su tratamiento posterior en el mismo.

Existe la opción de tener “pregeneradas” muestras del resultado del listado (se ubican en la carpeta Muestras en formato pdf). Si existe muestra del listado seleccionado, nos mostraría su aspecto.

Permite generar la muestra para el listado a partir de los datos actuales.

Generará una página HTML con los datos del listado.

Enviará un boletín de noticias/artículos a las personas del listado

Si hemos realizado la geolocalización de las personas de nuestra base de datos, nos mostrará un mapa de Google con la localización de las personas que aparecen en el listado. Requiere que la vista contenga un campo con alias IdPersona.



ANEXOS ANEXO 1: CONSULTAS ÚTILES INCLUIDAS EN EL MODELO DE DATOS

En el modelo de datos de Deporwin se incluyen ciertas consultas que nos facilitarán nuestro trabajo a la hora de confeccionar vistas o que nos proporcionarán datos imposibles de obtener de otra forma.

Consulta: Accesos / AccesosDetallados / UsosEntradas

Nos permiten acceder a las tablas equivalentes de la base de datos Accesos.

Consulta: GruposSeguridadDatos / PrivilegiosGruposSeguridadDatos

Como las anteriores, acceden a sus equivalentes de la base de datos Secuwin (corresponden a la definición de los permisos de acceso a los servicios en NMS).

Consulta: UsuariosAplicacion / GruposUsuariosAplicacion

Permiten acceder a las tablas Personas y Grupos, respectivamente, de la base de datos Secuwin (definición de usuarios y grupos de los usuarios de deporwin).

Consulta: PuntosVenta

Es el equivalente de la tabla Almacenes.

Consulta _AbonadosPorFecha

Nos devuelve, para cada fecha y cada abono, los meses de antigüedad, basándose en la fecha de antigüedad del abono y la fecha de cálculo. Conviene filtrar los resultados a una fecha para no obtener duplicados.

Consulta _AbonosConPagosMesActual

Devuelve la relación de IdAbono con pagos cuya FechaInicioValidez – FechaFinValidez incluya la fecha actual (la del día de ejecución). Puede devolver más de 1 registro por abono (si hay más de 1 pago).



Consulta _AbonosConPagoValidoHoy

Similar a la anterior, pero sólo devuelve 1 registro por IdAbono, informando además del importe total de los pagos correspondiente al periodo.

Consulta _AbonosPorPersona

Devuelve la relación de todos los abonos de cada persona obteniendo la información de la tabla Abonos o de IntegrantesAbonos en función de cada caso. Es mejor que esas tablas dado que la información está resumida, utilizando el dato adecuado para cada situación (AltaPorCambio, Alta, Baja, etc.).

Consulta _AbonosQueSonReingreso

Devuelve una lista con los IdPersona, IdAbono de todos los abonos correspondientes a un reingreso, es decir, abonos que ya habían sido abonados anteriormente.

Consulta _AccesosAbonadosPorFecha

Basada en la consulta _AbonadosPorFecha nos indica, para cada uno de los abonos en cada fecha si ha accedido a la instalación o no. Como en el caso anterior, es recomendable filtrar el resultado a una fecha.

Consulta _AccesosFichasPersonas

Nos indica la última fecha en que cada operador ha accedido a la ficha de cada persona

Consulta _AforosServiciosPeriodoGestion

Nos indica, para cada servicio y periodo de gestión, cual es el aforo definido (bien en el servicio, bien en el propio periodo). Es recomendable filtrar a una fecha.

Consulta _AforosServiciosPeriodoGestionActual

Como la anterior, pero sólo del periodo de gestión actual (del indicado mediante la FechaReferencia y la definición del servicio).



Consulta _Altas

Devuelve para cada persona las fechas de alta en Abonos y Cursillos.

reporwin gestiÓn de listados - t-innova• envío masivo de sms: accedemos a la opción de envío...

Documents