Manual Report Tool
Manual Report Tool
Introducción, ejecución y
1 creación de un nuevo reporte
Composición de la parte visual del
2 Reporte
Utilización de variables y
3 parámetros
Sincronización con Calipso
4 Corporate
Calipso Software – Uspallata 867 – (C1268AFC) - Capital Federal – Tel. (54-11) 5168-1000
Calipso Corporate – Report Tool
Introducción, ejecución y
creación de un nuevo reporte
Introducción
La aplicación Report Tool es una herramienta para la realización de informes y formatos de
documentos. En esta herramienta se basan todos los informes y formatos de Calipso Corporate.
Se desplegará entonces una lista con todos los reportes disponibles para esa entidad.
Una vez seleccionados los clientes sobre los cuales, se generará el reporte como se ve a
continuación.
2) Una vez dentro, hacemos doble clic sobre el icono Report Tool.
Al ejecutarse la aplicación se abre la siguiente ventana para loguearse. Seleccionar la Base de Datos
“DistrObj”, el campo usuario y password deben estar en blanco como muestra la figura. Luego
hacer clic en Aceptar.
Para las principales opciones también se pueden usar los botones que se verán debajo del menú
desplegado, en la Barra de Herramientas.
Para comenzar con nuestro reporte de ejemplo vamos a Archivo\Nuevo, veremos que se nos abre
una ventana para seleccionar el tipo de reporte que se va a realizar.
Mediante la Selección del Tipo de Reporte se va a hacer la conexión con Calipso Corporate, esto es
que, si por ejemplo se selecciona el tipo Cliente, este reporte va a estar disponible para ser ejecutado
en todas las ubicaciones en donde haya clientes. Asimismo, esta selección del tipo de reporte tiene
relación con las variables que se verán más adelante. En nuestro caso seleccionaremos un reporte
del tipo Cliente como se ve a continuación y luego hacemos clic en Aceptar.
Una vez seleccionado el tipo de reporte comenzamos con el armado del mismo.
La construcción del reporte se compone básicamente de 3 partes:
Calipso Corporate Report Tool Página 7
Calipso Software S.A. – Uspallata 867 – (C1268AFC) - Capital Federal – Tel. (54-11) 4300-2050
Calipso Corporate – Report Tool
El armado del query en SQL (para obtener todos los datos necesarios para el
reporte).
El armado de la parte visual del reporte.
La parametrización del reporte.
En la siguiente imagen tenemos un reporte vacío con la barra de herramientas para poder operar y
sobre el margen izquierdo todas las propiedades del reporte. Estas propiedades pueden modificarse
desde aquí poniendo en cada una los valores correspondientes o desde la ventana que se displaya
con el botón :
Barra de herramientas
del reporte
Propiedades del
reporte
En nuestro caso seleccionaremos la Base de Datos App y se le debe dar un nombre que puede ser en
mayúscula y/o minúscula pero sin espacios, en este caso en particular la llamaremos prueba. Luego
de esto podremos introducir el código del query, tanto a mano como importarlo desde algún archivo
y luego se deberá hacer clic en Aceptar.
En nuestro caso, importaremos el query desde el directorio Query del disco C de nuestra PC, para
ello clickearemos en Importar y buscaremos el archivo query1.txt, dentro de C:\Query.
Calipso Corporate Report Tool Página 10
Calipso Software S.A. – Uspallata 867 – (C1268AFC) - Capital Federal – Tel. (54-11) 4300-2050
Calipso Corporate – Report Tool
Tamaño del Papel: Se selecciona el tipo de la hoja y en qué posición se verá (horizontal o
vertical) y automáticamente se modificará el ancho y el largo.
Márgenes: Aparecen estos márgenes por default, pero se pueden modificar. Esto es conveniente
modificarlo en la medida que se necesite espacio para insertar las etiquetas. La Cantidad de
Columnas es para definir más de una columna en el caso por ejemplo de imprimir etiquetas.
Otros: Aquí se selecciona el tipo de letra que va a regir por default para todo el reporte, pero
luego en cada etiqueta insertada se le puede cambiar la letra para esa en particular.
Contorno: Si se requiere se marcan los contornos generales para todo el reporte. Luego en cada
banda que tenga el reporte se elegirá el contorno para ella.
Bandas: Aquí se tildan las bandas generales que se necesitan para el reporte. El largo de cada
banda se calcula automáticamente. Descripción de cada banda:
Título: Esta banda se imprimirá solamente en la primer hoja del informe.
Encabezado de Página: Aquí se pueden agregar datos como fecha, hora, nombre de la
empresa, etc.
Encabezado de Columna: Se imprimirá en todas las hojas del informe y generalmente se usa
para los nombres de las columnas que se verán en el detalle.
Calipso Corporate Report Tool Página 12
Calipso Software S.A. – Uspallata 867 – (C1268AFC) - Capital Federal – Tel. (54-11) 4300-2050
Calipso Corporate – Report Tool
Aquí vemos el formato general del reporte con el contorno Superior, Inferior,
Izquierdo y Derecho marcados y con las bandas Enc. Página, Enc. Columna, Detalle y Pie de
página.
Sobre el costado izquierdo podemos ver todas las propiedades de lo que está marcado. Por ejemplo
en una banda marcada vemos lo siguiente:
Encabezado de Página
Encabezado de Columna
Detalle
Pié de Página
Etiquetas
Ahora empezamos a insertarle a nuestro reporte las etiquetas correspondientes en cada una de las
bandas.
Para insertar una etiqueta de tipo texto: Clickeamos sobre este botón y luego sobre la
banda donde queremos insertar el texto. Sobre el costado izquierdo se muestran todas las
propiedades de esta etiqueta texto que está marcada.
Arriba: Ídem “Izquierda” pero con respecto al borde superior de la banda donde
está contenida la etiqueta.
Transparente: Con esta propiedad en Si, el color de la etiqueta se hará transparente y se verá
del color de la banda donde está contenida.
Ancho: Ídem “Alto” pero con respecto al ancho de la etiqueta.
Corte Palabra: En Si truncará el texto contenido en la etiqueta al tamaño de la misma en caso
que el texto sea más largo que el ancho de la etiqueta. En No, lo que sobre de texto aparecerá en
la línea siguiente y se verá si el alto de la etiqueta es suficiente como para poder ver dos líneas.
Para insertar una etiqueta de tipo campo: Clickeamos sobre el botón y luego sobre la
banda donde queremos insertar el campo. Sobre el costado izquierdo se muestran todas las
propiedades de esta etiqueta campo que está marcada.
Descripción de propiedades:
Todas funcionan de la misma manera que las de la etiqueta de tipo texto. Las etiquetas de tipo
campo además tienen dos propiedades en las cuales se indicará qué campo de qué query se
mostrará.
Query: Aquí se abrirá la lista de querys existentes y se selecciona la que tiene el campo
necesario.
Campo: Con dos clic sobre la parte derecha de la propiedad se habilitará un botón que al ser
clickeado mostrará todos los campos que tiene el query seleccionada en la propiedad anterior. Al
dar clic sobre el campo requerido y aceptar, queda introducido el campo.
Desde Herramientas \ Datos Directos se abrirá una ventana como la que se ve más abajo donde se
podrán ver las Variables (tema a tratar luego) y los Campos. Allí una vez localizado el campo a
insertar, se clickea sobre éste y luego sin cerrar la ventana, se clickea sobre la banda donde se quiere
introducir el campo.
De esta manera le vamos dando forma a nuestro reporte. Aquí tenemos un ejemplo armado con los
datos tomados del query.
Para poder ver las demás funcionalidades de la aplicación, se ampliará el ejemplo mostrando un
listado de las facturas de venta realizadas por cada cliente.
Nótese que los campos de tipo Texto se insertan en la banda Encabezado de Columna y todos los
de tipo Campo están situados en la banda Detalle. Se puede ver también que el reporte tiene
insertada una imagen en uno de sus extremos. Esta operación es muy sencilla y se puede hacer
mediante el menú Insertar\Imagen\Desde Archivo y luego con el cursor indicamos el lugar donde
va a estar la imagen. Luego en las propiedades del objeto sobre la izquierda haciendo clic en el
atributo Imagen, podremos elegir la imagen a insertar.
Con los campos insertados en el reporte como muestra la imagen anterior, el reporte se visualizará
de la siguiente forma:
Se observa que el mismo nombre del cliente se repite tantas veces como facturas tenga. Entonces si
queremos visualizar una sola vez el cliente y luego todas sus facturas debemos armar un grupo por
cliente. Para esto se inserta una banda de tipo Encabezado de Grupo, y como seguramente se
necesitará un total de todas las facturas por cliente, también se insertará una banda de tipo Pie de
Grupo. Esta operación se realiza desde el botón como se ve en la siguiente imagen.
Se ve que la banda Pie de Grupo se encuentra debajo de la banda Pie de Página y es porque en la
propiedad Banda Pie de la banda Encabezado de Grupo se define cuál es la banda Pie de Grupo
que le corresponde. Allí, al tener la relación entre ambas bandas, el Pie de Grupo se posicionará
después de la banda Detalle y arriba de la banda Pie de Página.
Si más adelante nos damos cuenta que necesitamos tener una banda más de Encabezado de Grupo,
podemos insertarla sin problemas, y la ubicación de ésta será debajo del primer Encabezado de
Grupo que se insertó, por lo tanto el grupo del segundo Encabezado se anidará dentro del primero.
Luego para darle un poco de estética a nuestro reporte colocamos un contorno a la banda
Encabezado de Grupo, esto lo hacemos clickeando sobre dicha banda y luego desplegando en el
atributo contorno. Para no sobrecargar tanto de líneas nuestro reporte simplemente habilitaremos el
contorno de arriba y el de debajo de la banda.
Aquí se observa que los importes (Valor Factura) no tienen decimales, es decir, no tienen un
formato apropiado.
Para el formato de los importes insertaremos una Expresión en el Detalle con el siguiente
botón.
Para ello hacemos clic sobre la etiqueta y en las propiedades de la misma, sobre la izquierda,
tenemos el atributo Expresión, que es la expresión en sí que se ejecutará en la etiqueta. Con doble
clic sobre la parte derecha de esta propiedad se habilita un botón que dará acceso a la ventana de
Construcción de Expresiones.
Este Constructor de Expresiones consta de varios cuadros donde cada uno tiene sus
funcionalidades.
Constantes: En el primer “subcuadro” se tipea el texto requerido. Luego se selecciona el tipo de
constante (Número o Cadena).
Funciones: Aquí tenemos una serie de funciones que se ven en la parte de Funciones Disponibles.
Si en la parte de Categoría está seleccionado All, en Funciones disponibles se verán todas. Pero se
puede seleccionar alguna categoría en particular y se ven las funciones correspondientes.
Clickeando una vez sobre alguna de las funciones, debajo de este cuadro se detalla una breve
descripción de la función y su sintaxis.
Campos: En este cuadro tenemos dos partes, query y Campo. En query se mostrarán todas las
querys existentes en el Query Manager. Aparecerán siempre y cuando estén Activas (tildando el
check box de cada query). En el caso que este cuadro esté vacío, hay que ir al query Manager y
activar el query y luego volver a esta pantalla. En Campo se verán todos los campos pertenecientes a
el query seleccionado.
Operadores: Se listan todos operadores necesarios para la combinación de funciones u operaciones.
Expresión: En este cuadro se va mostrando cómo se construye la expresión. Aquí no se puede
tipear, sólo se puede ingresar mediante los botones de Agregar que están en cada uno de los cuadros
Constantes, Funciones y Campos. Los operadores si insertan automáticamente al clickear sobre
ellos. Para comenzar a armar la expresión primero hay que vaciar el contenido del cuadro Expresión
con el botón Vaciar al pie del mismo. Luego se construye la expresión en el orden en que se
escribiría, no de adentro para afuera si es que hubiera funciones contenidas en otras. Al final de la
construcción se Acepta y queda la expresión insertada.
Al aceptarlo ya tenemos nuestra expresión con el formato para los importes que podremos ver en la
visualización. Esta expresión la colocaremos reemplazando a nuestra etiqueta del valor de la factura
(valortotal), como se ve a continuación:
Luego de insertada esta Expresión en el reporte, de otra etiqueta tipo Texto que indique que eso es
el subtotal y de un Campo que indique a qué cliente pertenece, el reporte se ve de esta manera:
Antes de volver a ejecutar el reporte, debemos cambiar en las propiedades de la etiqueta del
subtotal, el atributo “Vaciar al Imprimir” el cual tiene que estar en Si para que los subtotales se
corten por cada cliente y no se acumulen.
Utilización de variables y
parámetros
Variables
Propiedades de una variable
Parámetros
Etiquetas tipo Variable
Etiquetas tipo Datos del reporte
Para esto utilizaremos Variables y tendremos que modificar el query para agregar este filtro. Para
ahorrarnos tiempo, importaremos el query nuevamente desde el directorio Query del disco C de
nuestra PC, para ello iremos al Query Manager, luego haremos un clic sobre el query prueba y
posteriormente sobre el botón Editar. Una vez dentro del query hacemos clic en Importar y
buscaremos el archivo query2.txt, dentro de C:\Query.
Para agregar Parámetros en nuestra query lo único que tenemos que hacer es colocar un carácter “:”
antes de la cadena que utilizaremos como parámetro.
En la ilustración, se ve que se hace una comparación (en las líneas 5,6,7 y 8 del query) con un
campo fechaactual y con desdefecha, hastafecha, desdecliente y hastacliente. Estos cuatro últimos
son los Parámetros que tendremos que asignar a las Variables que contendrán los valores que
ingrese el usuario.
Entonces, confirmamos esto y luego no podremos activar el query porque todavía no tenemos los
Parámetros asignados. Para poder hacer esta asignación, primero tenemos que ir hasta la ventana de
las Variables por el menú Ver \ Variables.
Todas las variables que vemos acá (en nuestro caso 1 sola) son atributos del objeto que pertenece al
Tipo de Reporte que seleccionamos al principio cuando comenzamos con un reporte nuevo. Estas
las podemos utilizar para hacer los filtros en el query. No es conveniente modificar las propiedades
de estas Variables.
Si queremos que el usuario pueda seleccionar un rango de clientes y de fechas, tenemos que crear
nuevas Variables acorde con esto.
Para ello debemos hacer un clic en Agregar y sobre el costado izquierdo de la pantalla vemos las
propiedades de la variable sobre la cual estamos posicionados.
Etiqueta: Es el texto que le aparecerá al usuario como requerimiento para que ingrese el valor
correspondiente.
Pregunta Valor: Sí \ No. Con Sí, en el momento de la ejecución del reporte aparecerá una ventana
que permite cargar el valor deseado.
Valor por Defecto: Es el valor que aparecerá siempre que se ejecute el reporte como valor de la
variable, pero puede modificarse en el momento que aparece la ventana.
Nombre: Es el nombre interno que tendrá la variable con el cual se manejará la variable dentro del
reporte. Este nombre se usará para la parte de la asignación de los Parámetros en el query Manager.
Puede ser el mismo de los parámetros que tendremos en el query.
Valor: Es el valor que se le ingresa definitivamente en la ejecución del reporte, el que ingresa el
usuario.
Tipo: Es el tipo de valor que va a contener la variable.
Puede ser:
String: es una cadena de caracteres.
Integer: es un número entero.
Float: es un número flotante.
Date: es una fecha.
Object: de tipo Objeto para poder realizar otras acciones que veremos en las próximas líneas.
Enum: de tipo Enumeración para poder realizar otras acciones que veremos en las próximas
líneas.
SQL de Origen: Para esto es necesario que la variable sea de tipo Object. Si queremos que en la
variable, en vez de que el usuario tipee un valor, se abra un combo con los valores posibles
recuperados de la información que ya existe, aquí insertaremos una sentencia en SQL (query) que
devuelva el dato que deberá seleccionar el usuario y el dato que se utilizará para la asignación de
Parámetros. Entonces con doble clic se habilita el botón que dará acceso a una ventana similar a la
del query Manager para introducir dicha query.
Atributo a Asignar: Acá se ingresa el nombre del campo del query que está en SQL de Origen que
utilizaremos para asignar en la parte de Parámetros del query Manager. Esto es cuando la variable es
de tipo Object. Si no, queda vacío.
Atributo a Mostrar: Acá se ingresa el nombre del campo del query que está en SQL de Origen que
utilizaremos para mostrarle al usuario en el momento de la ejecución del reporte. Esto es cuando la
variable es de tipo Object. Si no, queda vacío.
Datos Enumerados: Para esto es necesario que la variable sea del tipo Enum. Al clickear dos veces
se activa el botón con el que accederemos a una ventana parecida a la del query Manager, pero en
este caso solamente se introducirán línea por línea las distintas enumeraciones que se utilizarán.
Esto será un texto en cada línea y en el momento de la ejecución del reporte se abrirá el combo
solamente con estas enumeraciones. Estas enumeraciones también tienen relación con la cantidad de
copias que se le definan al reporte en el momento de la grabación del reporte. Con cada copia se
imprimirá una enumeración distinta respetando el orden de los textos en la enumeración.
En este caso comenzaremos con desdefecha, la cual deberá tener la siguiente configuración:
Luego agregamos la siguiente variable hastafecha, para ello debemos hacer un clic nuevamente en
Agregar y sobre el costado izquierdo de la pantalla configuraremos las propiedades de la variable
de la siguiente manera:
Luego seguimos con desdecliente, para ello debemos hacer un clic nuevamente en
Agregar y sobre el costado izquierdo de la pantalla configuraremos las propiedades de la variable
de la siguiente manera:
Una vez importado el query para el SQL de Origen, hacemos clic en Confirmar y volveremos a la
pantalla de Variables.
Por ultimo nos queda la variable hastacliente, por lo tanto volvemos a hacer clic en Agregar y
luego configuramos la variable de la misma forma que desdecliente pero con la diferencia de los
atributos Etiqueta y Nombre, como vemos a continuación:
Para el caso del SQL de Origen, lo haremos de la misma forma que el caso anterior,
importando el mismo archivo para el query.
Allí se mostrarán todos los parámetros que existen en el query pendientes de asignación. Al marcar
un parámetro (clickeando sobre él) y luego haciendo clic en Editar veremos una pantalla en la que
hay que definir el Tipo de dato del parámetro que se asignará y qué Variable se le asignará. El Valor
por Default no es necesario completarlo.
Así tendremos que ir relacionando las 4 variables que definimos con los 4
parámetros de nuestro query. Las configuraciones de los parámetros deberán ser:
Por lo que al terminar de configurar todos nuestros parámetros, la ventana nos quedara de la
siguiente manera:
Para salir hacemos un clic en Aceptar y volvemos a la ventana del Query Manager,
en donde debemos volver a activar nuestro query (clickeando en el cuadrado al lado del nombre del
query).
Una vez activada la query, se puede visualizar el reporte donde se abrirá una ventana para que el
usuario ingrese los valores deseados utilizados para el filtro del informe, como se muestra en la
siguiente imagen:
Es muy útil tener en alguna parte del informe los valores con los cuales se emitió este reporte. Para
ello podemos insertar con el siguiente botón etiquetas de tipo Variable que mostrarán el
valor ingresado por el usuario en cada oportunidad en que ejecute el informe.
En nuestro caso, insertaremos 2 etiquetas de este tipo, en la banda encabezado de pagina, estas nos
servirán para visualizar en la ejecución del reporte, desde que cliente, a que cliente estamos viendo
el reporte. También a la izquierda de las etiquetas del tipo variable, les insertaremos 2 etiquetas del
tipo texto (“Desde:” y “Hasta:”) para hacer referencia al valor que estamos mostrando. La siguiente
imagen, nos muestra como nos queda el diseño del reporte:
En la etiqueta tipo Variable sólo es necesario tipear el nombre de la variable (nombre que le dimos
en la ventana Ver\Variables) en el atributo llamado Variable, como se ve en la imagen siguiente:
Las variables también pueden usarse para hacer cálculos dentro de un reporte. Estas variables no le
preguntarán el valor al usuario, se les asignará por ej. Un valor con la función ASIGN que está en el
constructor de expresiones. Luego cuando requiera verse u operarse con el valor de la variable, el
mismo podrá tomarse con la función VAR contenida también en el constructor de expresiones.
Algo muy práctico, es colocar en la banda Pie de Página, una etiqueta que es del tipo Datos del
Reporte. Con este tipo de etiquetas podremos obtener el número de página, fecha, hora, etc.
Al insertar una de estas etiquetas, en la parte izquierda del reporte donde están las propiedades,
tenemos un atributo llamado Dato en el cual, si lo desplegamos, podremos elegir as opciones que
nos da, las cuales se detallan a continuación:
Como vimos al principio de este curso, para ejecutar un reporte desde Calipso
Corporate, debemos pararnos en la entidad sobre la cual queremos visualizar y luego
clickear sobre el botón: y de esta manera se nos desplegaba una lista con todos los reportes
disponibles para esa entidad.
Ahora si nosotros queremos que nuestro reporte aparezca en la lista de todos los reportes
disponibles, debemos primero salvar nuestro reporte con el botón o también desde el menú
Archivo\Guardar, donde nos aparecerá la siguiente pantalla:
Hacemos clic en Yes para salvarlo y luego nos presentara la siguiente pantalla:
Aquí pondremos como Nombre, el número de alumno que tiene cada uno en su propia PC, en el
Tipo de reporte nos aparece el mismo que seleccionamos anteriormente al principio del armado y en
Copias de Documento dejaremos el valor en 0.
Una vez que creado el reporte este debe ser sincronizado dentro de Calipso
Corporate, para poder ser ejecutado, la sincronización se lleva a cabo posicionándose en uno de los
elementos de la lista de la entidad a la cual fue asociado el reporte (Tipo del reporte).
En nuestro caso, deberemos sincronizar el reporte al objeto Cliente, para ello debemos:
2.7 Ir a Mantenimiento.
2.8 Ir a Sincronizar.
Al dar clic en Aceptar habremos sincronizado el reporte creado en Report Tool con
Calipso Corporate.
Cuestionario de Autoevaluación
Marcar la(s) respuesta(s) correcta(s). Tenga en cuenta que puede haber más de una.
1) Para ejecutar un Reporte necesariamente debo estar dentro de aplicación Calipso Corporate.
Verdadero
Falso
2) Un reporte puede ser creado desde dentro de la aplicación Calipso Corporate:
Verdadero
Falso
3) La herramienta Query Manager nos da la posibilidad de:
Crear un query.
Ejecutarlo antes de utilizarlo en el reporte.
Ingresar parámetros.
Seleccionar un query por default.
Editar un query y modificarlo.
4) Las cuatro bandas principales de un reporte son:
Encabezado de página.
Detalle.
Encabezado de Columna.
Pie de página.
Encabezado de grupo.
Pie de grupo.
5) En un reporte podemos insertar:
Campos.
Cuadro de Texto.
Variables.
Imagen.
Expresiones.
6) En el caso de que existan agrupamientos y cortes de control es necesario tener los datos
ordenados para que los mismos no se repitan.
Verdadero
Falso
Calipso Corporate Report Tool Página 49
Calipso Software S.A. – Uspallata 867 – (C1268AFC) - Capital Federal – Tel. (54-11) 4300-2050
Calipso Corporate – Report Tool