MAXICOMERCIO Guía para desarrllar reprtes Códice FX MaxiCmerci Business Platfrm 2010 M A X I C O M E R C I O E R P & POS
Permitida la reprducción de este dcument cn fines didáctics Cpyright Tds ls derechs reservads. Este dcument cntiene infrmación técnica que pdría n estar actualizada. N existe ninguna respnsabilidad pr parte del autr pr el us de esta infrmación. 2
Cntenid Guía para desarrllar Reprtes... 4 Qué es Códice FX?... 4 Qué se puede hacer cn Códice FX?... 5 Elements que frman un reprte... 5 Cnexines... 5 Origen de registrs... 5 Parámetrs... 6 Diálgs... 6 Frmats de impresión... 7 Imágenes y texts... 7 Subprgrama... 8 Explrand la interfaz del usuari (Ejempl: Hla mund)... 9 Cnexión, btención y presentación de dats... 9 Administrand cnexines a Bases de Dats... 9 Diseñand un rigen de registrs (Us del diseñadr de cnsultas)... 13 Manej de parámetrs... 16 Parámetrs en ls reprtes de Códice FX... 16 Sintaxis embebida en SQL... 16 Manej de parámetrs de fecha... 17 Cuadrs de diálg y parámetrs... 18 Qué sn ls cuadrs de diálg?... 18 Cntrles cmunes... 20 Orígenes de registrs para ls cuadrs de diálg... 29 El diseñadr de frmats de impresión... 29 Filas y Clumnas... 29 Prtada y Cntraprtada... 30 Algritm general de ejecución... 31 Pas de parámetrs y us de macrs... 31 Agrupacines y Gráfics... 32 Funcinamient de las agrupacines... 32 El cntrl de gráfics... 34 3
Guía para desarrllar Reprtes Qué es Códice FX? Es una platafrma basada en Windws para el diseñ, prcesamient y despliegue de infrmes cnstituida pr un diseñadr de reprtes (reprteadr) y un cnjunt de cmpnentes para su ejecución (mtr en tiemp de ejecución) y presentación (visr). El reprteadr permite cnstruir la especificación de un reprte, el mtr en tiemp de ejecución la interpreta y prduce una salida (infrme), mientras que el visr se encarga de la presentación para el usuari. Las especificacines de ls reprtes de Códice están frmads pr: Orígenes de dats. Ests se cnstruyen a partir de una cnexión y cnsultas SQL que permiten btener un cnjunt de registrs, ls cuales serán impress de acuerd a ls frmats de impresión diseñads. Parámetrs. Permiten especificar dats que pueden ser usads cm criteris de filtr en las cnsultas SQL. Diálgs. Ofrecen una interfaz de usuari cn el principal prpósit de slicitar infrmación que se asigna a ls parámetrs del reprte. Frmats de impresión. Es el diseñ que tendrán ls dats en el papel al ser impress. Sub-prgrama. Cnsiste en un cnjunt de rutinas en lenguaje Visual Basic Script que el usuari puede definir para aumentar la funcinalidad del reprte, ya sea realizand cálculs cmplejs, accines sbre ls dats interceptand y respndiend a events durante la ejecución. Otrs recurss. Cnsisten en text simple imágenes que la especificación del reprte cntiene para que ls utilice durante la ejecución. La especificación del reprte se almacena en archivs cn extensión XPD cuy frmat es abiert. Pr su parte, el mtr en tiemp de ejecución prduce un dcument a partir del archiv XPD que cntiene ls dats y es finalmente un infrme. Ls infrmes pueden almacenarse en archivs cn extensión XPR y desplegarse a través de un visr para este frmat. 4
Es imprtante apuntar que ls frmats XPD y XPR están basads en XML, l que facilita su cmprensión, adecuación, adpción y psible implementación en trs sistemas perativs. Qué se puede hacer cn Códice FX? Cnstruir reprtes que presenten infrmación basada en parámetrs que sean suministrads pr el usuari pr tra aplicación. Códice FX prprcina mecanisms para generar reprtes cn parámetrs que permitan filtrar el cnjunt de resultads incrustarse en las cnsultas SQL. En Códice FX se pueden cnstruir cuadrs de diálg (ventanas) que permitan al usuari intrducir ls valres requerids a través de cntrles cn amplias características, Códigs de barras, imágenes y gráficas. Códice FX permite cnstruir reprtes que incluyan códigs de barras (EAN/UPC/Cde 39/Cde128) cn sl dibujarls. Ls reprtes pueden incluir imágenes que estén almacenadas en la base de dats en cualquier ubicación (externa interna al reprte). También es psible incrprar gráficas (barras/líneas/pastel/etc.) de ls dats cn uns cuants clics. Elements que frman un reprte Cnexines Códice FX utiliza la tecnlgía OLE DB para establecer la cnexión y recuperar cnjunts de registrs. Para crear una cnexión a una base de dats puede hacerl de ds frmas. Haga clic en el menú Pryect seleccine Insertar bjet y seleccine Cnexión a base de dats Si desea hacerl pr el explradr de pryects, haga clic en Insertar y seleccines Cnexión a base de dats. En el cuadr de dialg cnexión, establezca un nmbre para la cnexión. Seleccine Cadena de cnexión OLE DB, y haga clic en Diseñar, indique una cadena de cnexión seleccinand el prveedr OLE DB de acuerd al Mtr de base de dats que se esté utilizand. Origen de registrs Un rigen de registrs le permite btener el cntenid de una base de dats mediante una cnsulta SQL. Si n ha cread una cnexión n se pdrá insertar un rigen de registrs. Una 5
cnexión puede cntener un más rígenes de registrs y ests a su vez también pueden tener rígenes de registrs dependientes. Prpiedades de un rigen de registrs: Escriba el nmbre del rigen de registrs (n puede existir ds rígenes de registrs cn el mism nmbre) Especifique un tip de rigen de dnde btendrá ls dats Diseñe la cnsulta SQL que le servirá para filtrar ls dats Especifique ls filtrs y cadenas de rdenación en cas de que sean necesarias En cas de l requiera pdrá pner rígenes de registr dependientes, así cm parámetrs para ls misms que pdrá cnfigurar en las pestañas crrespndientes. Parámetrs Códice FX permite definir parámetrs para ls reprtes, un parámetr es la identificación pr nmbre de un valr que regularmente prviene del exterir y que se utiliza internamente en una cndición de filtr en cnsultas SQL. Permiten especificar dats que pueden ser usads cm criteris de filtr. Puede agregar parámetrs de ds maneras: Desde el menú Pryect seleccines Insertar bjet y seleccine Parámetr Desde el explradr de pryects, seleccinand Insertar y haciend clic en Parámetr. Diálgs En la ventana de parámetrs deberá definir un nmbre, un tip de dat y si desea puede agregarle un valr predeterminad. Ls diálgs frecen una interfaz de usuari cn el principal prpósit de slicitar infrmación que se asigna a ls parámetrs del reprte, esta infrmación servirá para restringir filtrar ls dats de la cnsulta SQL, pueden ser de diferentes tips, cm rang de fechas, rang de hras, un valr numéric cadena. Puede agregar un diálg de ds frmas: 6
Desde el menú Pryect seleccinand la pción Insertar bjet y haciend clic en la pción Dialg. Desde el explradr de pryect dand clic en Insertar y seleccinand Diálg Para cambiar el nmbre de un diálg el títul de la ventana pdrá hacerl en la barra superir del diseñadr de diálg. Frmats de impresión Un frmat de impresión es utilizad para realizar el diseñ del reprte. El principal element que se dibuja sbre un frmat de impresión es la cuadrícula de detalle en la cual se integran ls camps de una base de dats. En el frmat de impresión se definen el tamañ de papel para la impresión, puede seleccinarse un tamañ persnalizad un tamañ estándar cm el tamañ carta u fici, también se define el tamañ de ls márgenes, la unidad de medida (centímetrs, milímetrs pulgadas), la rientación de la hja y si l desea un frmat de cntraprtada que se ejecutará después del frmat principal. Si desea crear etiquetas puede dividir la hja en el númer de filas y clumnas que se requieran. Cnfigurar el frmat de impresión: Tamañ de papel: El tamañ del frmat de impresión sbre el cual se hará el diseñ del reprte. Orientación: Cnfigure esta pción de acuerd a la frma que desea imprimir su reprte, ya que cn esta prpiedad se cnfigura la rientación de la impresra. Márgenes. Muestra una guía para delimitar la hja. Códice FX permite grabar tarjetas cn banda magnética Smart-cards, así que si el frmat de impresión que está cnfigurand es para una tarjeta, seleccine el btón Banda magnética, smart-card y tras pcines avanzadas dnde pdrá realizar las cnfiguracines e incluir ls dats que desea grabar. Imágenes y texts El diseñadr de reprtes de Códice FX incluye ds elements imprtantes, imágenes y texts, ests sn recurss interns que una vez agregads al pryect pueden ser utilizads cuand se desee. 7
Ls recurss interns pueden utilizarse para agregarls al diseñ del reprte dentr de un cntrl. Pr ejempl puede crear un cntrl imagen y elegir la pción de recurs intern y seleccinar una imagen de las que haya agregad. Las imágenes y texts se pueden agregar de ds frmas: Desde el menú Pryect seleccinand Insertar bjet y haciend clic en Text Imagen O bien desde el explradr de pryects en Insertar y seleccinand Imagen Text. Subprgrama El subprgrama permite agregar códig en lenguaje Visual Basic Script y Java Script. El códig se ejecuta durante la ejecución del reprte. Est permite agregar funcinalidad al reprte ejecutand métds, interceptand events, agregand bjets utilizand ls prpis del mtr en tiemp de ejecución. Qué se puede hacer? Cntrlar el ingres de dats en ls diálgs. Interceptar events de un diálg, events de ls cntrles de diálg y events que suceden durante la ejecución del reprte. Utilizar la bibliteca de Códice FX para acceder a la especificación del reprte mediante el bjet XPD. Cn est es psible btener rígenes de registr, valres de parámetrs, imágenes incluidas en el reprte, etc. Mdificar crear nuevs bjets dentr del reprte. Pr ejempl, puede crear un nuev parámetr, mdificar ls valres de un cntrl dentr de un diálg un frmat de impresión. Qué necesit saber para empezar? Códice FX permite escribir un subprgrama en lenguaje Visual Basic Script JavaScript, pr l que l primer que necesita es tener cncimient básic de ests lenguajes. 8
La bibliteca de funcines que están dispnibles en un subprgrama cntiene ls siguientes bjets: ebasic, XPD, XPREngine y edigitaldc. Ests bjets permiten tener acces a ls cmpnentes del reprte y a funcines de prpósit general. El tip de lenguaje se cnfigura en prpiedades del pryect dnde puede seleccinar Visual Basic Script JavaScript. Explrand la interfaz del usuari (Ejempl: Hla mund) 1. Crear un nuev pryect 2. Seleccinar el cntrl text estátic y dibujarl sbre el frmat de impresión. 3. Escriba el text Hla Mund en la venta de prpiedades del cntrl. 4. Presine Cerrar 5. Ejecutar el pryect (vista previa, puede hacerl de la siguiente frma): Seleccine en el menú Pryect y haga clic en Ejecutar. Presine la tecla F5. Seleccine en el menú Archiv y haga clic en Vista preliminar. 6. Guardar el dcument generad (XPR) Haga clic sbre el btón Guardar la barra de herramientas del visr. Escriba el nmbre del archiv y seleccine guardar. El archiv se guarda cn extensión XPR. Nta: el dcument generad (archiv cn extensión xpr) puede ser abiert cn el visr de reprtes de Códice y también cn el diseñadr de Códice. Cnexión, btención y presentación de dats Administrand cnexines a Bases de Dats 9
Códice FX permite crear cnexines cn múltiples bases de dats cm sn: MS Access, MS SQL Server, MySQL, Paradx, Firebird, dbase etc. El diseñadr de cnexines le permite agregar cnexines al pryect de diferentes frmas: Cn el administradr de cnexines en el cual se crea un grup de aplicacines dnde se pueden crear una más cnexines que pueden ser utilizadas en cualquier pryect que desee sin necesidad que crear de nuev la cnexión. Cn el eadaptadr para MaxiCmerci y Déminus el cual se utiliza para crean una cnexión cn la base de dats de ests prducts (sól versión 2006 y anterires). Si tiene instalads cualquiera de ests prducts sól debe seleccinar esta pción y se creará una cnexión cn su base de dats. El adaptadr para Academium funcina de la misma manera que la pción anterir sl que se crea una cnexión cn la base de dats de este Academium de las versines 2005 y 2006. Para cnectarse a cualquier base de dats diseñand una cadena de cnexión seleccine Cadena de cnexión OLE DB. Us del administradr de Cnexines de Grup Execm Esta es la mejr frma de identificar la infrmación de cnexión que será usada en la elabración de reprtes. Indicar una cnexión al reprte usand el administradr de cnexines 1. Inserte una nueva cnexión al pryect (Menú Pryect->Insertar->Cnexión a base de dats) seleccine la aplicación en la lista desplegable de la cual se usara la cnexión predeterminada 10
Nta: el nmbre de una aplicación sirve para clasificar un grup de cnexines. 2. Seleccine cree una nueva cnexión al pryect presinand el btón Cnfigurar, aparecerá la siguiente pantalla Para crear una cnexión a una base de dats, debe dar clic en el btón Nueva cnexión, aparecerá la siguiente pantalla, prprcine ls valres que slicita la ventana de prpiedades de cnexión. 11
Prpiedades del registr de cnexión Nmbre de la cnexión: Es el identificar de la cnexión. Aplicación: Es el nmbre del grup en el que se clasificará. Nmbre de usuari y cntraseña: Sn las credenciales de acces al servidr de la base de dats. Cnexión predeterminada para esta aplicación: Permite indicar la cnexión a utilizar pr defect cuand se slicite acces a una aplicación. Acerca de las cnexines registradas Cada cnexión se identifica cn un nmbre que n debería cntener espacis en blanc ni caracteres especiales. Códice FX y en general cualquier aplicación puede establecer cnexión a un rigen de dats pr nmbre de aplicación est significa que se usaría la cnfiguración de la cnexión marcada cm predeterminada si n existiera ninguna predeterminada se tmara la cnfiguración de la primera que se encuentre. Cada aplicación puede tener una cnexión predeterminada. Cada cnexión registrada puede estar clasificada pr el nmbre de la aplicación que la utiliza. Grup Execm define ls siguientes nmbres de administración para mantener cmpatibilidad cn versines anterires de trs prducts, las cuales sn: Nmbres reservads de aplicacines lddeminus para acceder a las bases de dats (Access 97) de las aplicacines Déminus 2006 y MaxiCmerci 2006 (www.deminus.cm.mx y www.maxicmerci.cm.mx) 12
ldacademium para acceder a las bases de dats (Access 97) de la aplicación Academium versines anterires a 2006 (www.academium.cm.mx ) Diseñand un rigen de registrs (Us del diseñadr de cnsultas) Un rigen de registrs permite btener un cnjunt de registrs de una base de dats mediante una cnsulta SQL. Puede crear un rigen de registrs de varias frmas: desde una tabla, un prcedimient almacenad creand una cnsulta SQL manualmente. Una cnexión puede cntener un más rígenes de registrs y ests asu vez tambien pueden tener rigenes de registrs dependientes. Prpiedades de un rigen de registrs: 1. Escriba el nmbre del rigen de registrs (n puede existir ds rígenes de registrs cn el mism nmbre). 2. Especifique un tip de rigen de dnde btendrá ls dats. 3. Diseñe la cnsulta SQL que le servirá para filtrar ls dats. 4. Especifique ls filtrs y cadenas de rdenación en cas de que sean necesarias En cas de l requiera pdrá pner rígenes de registr dependientes, así cm parámetrs para ls misms que pdrá cnfigurar en las pestañas crrespndientes. El diseñadr de cnsultas SQL El diseñadr de cnsultas SQL permite mediante un entrn visual cnstruir cnsultas SQL que permitan btener ls cnjunts de registrs necesaris. Esta es una herramienta de ds vías, l cual significa que puede dibujar la cnsulta y btener códig SQL a la inversa, escribir 13
SQL y ver su representación gráfica. La ventana del diseñadr está frmada pr varias partes que permiten realizar tdas las tareas necesarias. A) Esquema de la base de dats. Muestra en frma jerárquica las tablas y vistas dispnibles en la cnexión actual. Al desplegar un element se muestran ls camps (clumnas) que l frman, indicándse claves primarias y claves fráneas. B) Infrmación del element seleccinad. Presenta infrmación detallada acerca del element seleccinad en el Esquela de la base de dats. Su prpósit es meramente infrmativ. C) Btnes de acción. Permiten realizar las siguientes accines: Agregar tabla al diagrama. Muestra una lista seleccinable de tablas y vistas dispnibles para que sean incluidas en el Área de diseñ. Ver árbl de sintaxis. Despliega una vista jerárquica (árbl) de ls elements que frman la instrucción SQL crrespndiente al diseñ actual, esta vista es muy útil para analizar la lógica de expresines de filtr (WHERE) pr ejempl. Ejecutar cnsulta (Vista previa de ls dats). Ejecuta la cnsulta que se está diseñand y muestra el cnjunt de resultads. D) Área de diseñ. Está frmada pr ds pestañas: 14
Vista de diseñ. Permite diseñar el diagrama de la cnsulta, es decir marcar ls camps a mstrar, trazar unines entre tablas, etc. Cnsulta SQL. Cntiene el códig SQL crrespndiente a la vista de diseñ, cualquier cambi en el diagrama se reflejará en el códig y viceversa. E) Prpiedades de clumnas. Esta cuadrícula permite establecer ls alias, agrupacines y cndicines de filtr a las clumnas seleccinadas para frmar parte de la cnsulta SQL. 15
Manej de parámetrs Parámetrs en ls reprtes de Códice FX Códice FX permite definir parámetrs para ls reprtes, un parámetr es la identificación pr nmbre de un valr variable que regularmente prviene del exterir y que se utiliza internamente en una cndición de filtr en cnsultas SQL para cualquier tra csa que sea necesari. Generalmente deberá especificar parámetrs para: Establecer ls criteris de filtr (Where/Having) de una cnsulta SQL, pr ejempl indicar un rang de fechas, un valr de límite, etc. Realizar cálculs prcess que dependan de un valr variable usand códig VBS/Javascript en el interir del reprte. Tips de ls parámetrs Ls valres que cntiene un parámetr usualmente sn texts, númers fechas/hras, debid a que pueden ser pasads directamente al mtr de la base de dats se permite especificar exactamente el tip OLE DB al que pertenecen. De manera predeterminada Códice FX asigna el tip VarChar para parámetrs de text, Duble para parámetrs numérics y frece la pción de tratar cm VarChar cm Date, DateTime DBDate a las fechas/hras. Cnsulte la dcumentación de ADO (OLE DB) para cncer mejr ls tips existentes y la dcumentación del mtr de la base de dats para cncer ls tips sprtads. Si n va a utilizar ls parámetrs para ser enviads al mtr de la base de dats y sl serán empleads cm macrs en las cnsultas SQL dentr del códig de sub-prgrama del reprte, realmente n es significativ el tip OLE DB ya que sn prcesads cm cualquier variable del entrn de prgramación sin tips (VBS/Javascript). Sintaxis embebida en SQL Ls parámetrs se asemejan a las variables en que pueden cntener valres que cambian, per se diferencian pr el hech de que sirven de interfaz cn el exterir del reprte (pueden ser establecids pr la aplicación que invca al reprte, pr ejempl) y tienen un tip definid de OLE DB. 16
Ejempl: Supniend que se requiere un infrme que muestre las ventas que sbrepasen un determinad mnt en un períd de tiemp, sería necesari indicarle al reprte que existen 3 valres cambiantes que deben ser tmads en cuenta para la btención del cnjunt de registrs a imprimir. Est 3 valres cambiantes (parámetrs) serían: Mnt, Fecha Inicial y Fecha final. Establecer el valr para ests 3 parámetrs puede hacerse de ds maneras: Creand un diálg en el reprte que permita al usuari capturarls (intern). Dejand que la aplicación que invca al reprte ls establezca mediante códig de prgrama (extern). Para el primer cas debería agregar un Diálg al reprte, clcar un cntrl enumberfield para el Mnt y ds cntrles edatefield para las fechas. En el segund cas, en algún lugar de la aplicación que invca al reprte debería haber 3 sentencias similares a: bjet.getparameter( nmbre_parametr ).Value=Valr Utilizar ls valres de ls parámetrs para establecer el filtr de la cnsulta SQL pdría realizarse a través de una macr el pas del parámetr cm tal al mtr de la base de dats, en el cas de usarse cm macr habría una cláusula Where similar a esta: Where Mnt>@Mnt. Manej de parámetrs de fecha Actualmente n existe un frmat de fecha/hra que sea cmpatible cn tds ls mtres de bases de dats cn plena seguridad, est se debe a que cada DBMS implementa el manej e interpretación de valres de tiemp cm mejr l cnsidera. Aunque existen estándares internacinales, n hay ninguna garantía de que el mtr que esté usand se alinea a ells. Para clarificar esta situación vams a ilustrar cn ejempls. En Access se puede indicar una fecha hra cn el frmat yyyy-mm-dd hh:mm:ss, este mism frmat funcina sin prblemas en MySQL 5.x, aunque curisamente en MS SQLServer n, ya que MS SQL Server interpreta esta cadena dependiend de la cnfiguración de idima del servidr. Est trae el prblema de que el valr 10 de Ener de 2007 14:00:00 en Access y MySQL 5.x será almacenad adecuadamente, per en MS SQL Server si el idima del servidr es Ingles Estads Unids se interpretará cm Octubre 10 de 2007 14:00:00. Para agravar la situación, el utilizar un tip OLE DB de fecha/hra cm DBDate, Date DateTime n resuelve el prblema. 17
La mejr slución es en alguns cass, cnfigurar en Códice FX el parámetr que va a cntener valres de fecha/hra indicand que se traten cm cadenas y especificand un frmat que sea válid para el mtr que se esté usand. Cm se puede bservar en la siguiente imagen: Utilice la siguiente tabla cm guía para cnfigurar sus parámetrs de fecha/hra. Mtr de base de dats Fecha Fecha/Hra MS Access yyyy-mm-dd yyyy-mm-dd hh:mm:ss MySQL 5.x yyyymmdd yyyymmdd hh:mm:ss MS SQL Server 2005 yyyymmdd yyyy-mm-ddthh:mm:ss Cuadrs de diálg y parámetrs Qué sn ls cuadrs de diálg? Ls diálgs frecen una interfaz de usuari cn el principal prpósit de slicitar infrmación que se asigna a ls parámetrs del reprte, esta infrmación servirá para restringir filtrar ls dats de la cnsulta SQL, pueden ser de diferentes tips, cm rang de fechas, rang de hras, un valr numéric cadena. 18
Puede agregar un diálg de ds frmas: Desde el menú Pryect seleccinand la pción Insertar bjet y haciend clic en la pción Dialg. Desde el explradr de pryect dand clic en Insertar y seleccinand Diálg Ejempl de un cuadr de diálg: Para cambiar el nmbre de un diálg el títul de la ventana pdrá hacerl en la barra superir del diseñadr de diálg. Prpiedades principales de un cuadr de diálg En ventana de prpiedades de diálg se muestran las prpiedades generales que se pueden cnfigurar para cada un de ls diálgs que incluya en el reprte. Nmbre: Es un identificadr del diálg. Clr de fnd: Seleccine un clr de fnd del diálg. Titul: Escriba el títul de la venta de diálg, este se muestra en la barra superir del diálg. 19
Métds a ejecutar: Estas prpiedades se utilizan para indicar el nmbre de un métd en el subprgrama que se ejecutará cuand curra un event durante la ejecución del diálg Cntrles cmunes La ventana de diálgs cuenta cn una caja de cntrles que permite seleccinar un cntrl y dibujarl sbre la ventana de dialg. Ests cntrles hacen psible persnalizar el diálg agregand camps de text estátic, camps de text, camps numérics, camps mem, camp fecha, camp hra, camps selección, casillas de verificación, selectr de registrs, btón cmand e imagen. Cada cntrl cuenta cn varias prpiedades, las cuales se pueden mdificar para adaptarlas a sus preferencias cm sn clr de text, tamañ, frmat, etc. Haga clic en el menú Frmat y lueg en prpiedades de element para mstrar la ventana de prpiedades puede hacer clic sbre el btón de la barra de herramientas. A cntinuación se describen ls cntrles que puede dibujar en un diálg. 20
Text estátic. Permite escribir un text en la ventana de dialg que n pdrá ser mdificad cuand se ejecuta el pryect, Si desea agregar un text estátic sbre la ventana de dialg selecciónel haciend clic sbre el icn en la barra de cntrles de dialg dialg el tamañ que desea cupar para el cuadr del text. y dibuje sbre la ventana de Para mdificar el text que desea mstrar en el cntrl haga clic en titul sbre la ventana de dialg. Camp de text El camp de text permite ser asciad a un parámetr para que al mment de ejecutar el pryect el usuari pueda escribir un text y así realizar un filtrad sbre un cnjunt de registrs. 21
Puede agregar un camp de text a la ventana de diálg seleccinand lueg dibuje sbre la ventana de diálg el cntrl camp de text haciend clic y arrastrand el punter hasta la psición deseada. Cuand se crea un camp de text abre la ventana de prpiedades dnde se definen las prpiedades del camp cm sn nmbre, títul, el parámetr asciad, el frmat de salida del parámetr Camp numéric El cntrl de camp numéric permite agregar númers al pryect al mment de estar en ejecución que sn asciads a un parámetr para realizar filtrs. El camp numéric tiene ds camps interns un para text que servirá para escribir el mensaje que visualizara el usuari y el segund dnde recibirá el parámetr ingresad. Puede agregar un camp numer a la ventana de dialg seleccinand en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea para el camp numéric. Cuand se crea un camp numéric abre la ventana de prpiedades dnde se definen ls dats y características principales del camp cm: nmbre, titul, el parámetr asciad, el frmat de salida etc., así cm las prpiedades de diseñ del títul. 22
Camp mem El camp mem es un camp de text multi-linea que permite asciarl a un parámetr, al ejecutar el pryect este puede recibir un text multi-linea, y hacer el filtrad de la cnsulta pr medi del parámetr asciad. Puede agregar un camp mem a la ventana de dialg seleccinand en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea para el cntrl. Cuand se crea un camp mem abre la ventana de prpiedades dnde se definen ls dats y características principales cm nmbre, titul y parámetr asciad, así cm la apariencia del diseñ del títul. Camp fecha 23
El camp fecha es un camp que permite seleccinar una fecha y asciarla a un parámetr especific, para hacer una cnsulta cn una restricción de fecha usand la intrducida pr el usuari ya sea de una fecha específica de un rang de fechas. El cntrl fecha cntiene ds prpiedades que sn fecha inicial y fecha final, las cuales siend iguales el cntrl permitirá que se seleccine cualquier fecha. Cuand la fecha inicial y la fecha final sn diferentes el cntrl sl permitirá que se seleccine una fecha dentr del rang marcad pr ambas fechas. El cntrl cuenta cn btnes de dirección para navegar entre ls meses del añ ya sea hacia delante hacia atrás hasta encntrar la fecha desea y seleccinarla. Puede agregar un camp fecha a la ventana de dialg seleccinand en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el cntrl arrastrand el punter y manteniéndl presinad hasta dibujarl del tamañ desead. Cuand se crea un camp fecha abre la ventana de prpiedades dnde se define nmbre del dialg, titul, parámetr asciad, frmat, así cm la apariencia del títul. Camp hra 24
El camp hra es un camp que permite seleccinar una hra y asciarla a un parámetr especific, para hacer una cnsulta cn una restricción pr hra usand la intrducida pr el usuari ya sea una hra especifica de un rang de hras. El cntrl cuenta cn btnes de flechas para buscar la hra ya sea hacia arriba hacia abaj hasta encntrar la hra desea y seleccinarla. Puede agregar un camp hra a la ventana de dialg seleccinand en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea cupar para el camp hra. Cuand se crea un camp hra abre la ventana de prpiedades dnde se define nmbre del dialg, titul, parámetr asciad y el frmat de salida, asi cm la apariencia del títul. Camp selección El camp selección permite agregar una lista de pcines para seleccinar entre las pcines de la lista y realizar una acción deseada asciada a un parámetr. Tiene ds camps interns un permite agregar text que será el titul del camp. Puede agregar un camp selección a la ventana de dialg seleccinand y haciend clic sbre él en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea cupar para el camp selección. 25
Cuand se crea un camp selección abre la ventana de prpiedades de selección que tiene tres pestañas de cnfiguración en la pestaña general es dnde se define nmbre del dialg, titul, parámetr asciad que al hacer clic en el btón desplegara la lista de parámetrs agregads al pryect. En la segunda pestaña de cnfiguración Apariencia definims el diseñ del text. En la tercer pestaña lista de pción es dnde definims la lista de pción que pdrán ser elegidas al mment de estar en ejecución el pryect a cada una de ests pcines se le ascia un valr. El cntrl permite agregar nuevas pcines a la lista, eliminar y mdificar el rden. Este cntrl es útil para mstrar al usuari una lista de pcines, al seleccinar una el valr de la pción seleccinada se asigna a un parámetr asciad. Casilla de verificación El camp casilla de verificación permite permite activar desactivar una pción vinculada a un parámetr pr ejempl para activar desactivar la impresión de un td un cnjunt de registrs. Puede agregar un camp casilla de verificación a la ventana de dialg seleccinand en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea cupar para la casilla de verificación. 26
Selectr de registrs El cntrl selectr de registr es útil para mstrar el cntenid de un rigen de registrs y darle la psibilidad al usuari de elegir un registr de la base dats para asignarl cm parámetr. Permite realizar búsquedas a través de un camp principal y también mstrar el cntenid cmplet del cnjunt de dats que devuelve un rigen de registrs. Puede agregar un camp selectr de registr a la ventana de dialg seleccinand en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea para el cntrl selectr de registr. Cuand cree un camp selectr de registrs se abrirá la ventana de prpiedades del camp dnde puede indicar el nmbre del cntrl, el titul que desea que aparezca en pantalla al mment de la ejecución. En fuentes de registr vinculadas pdrá seleccinar el rigen de registr que estará asciad a este camp y de dnde tmara ls registrs para listarls, este camp estará asciad a un parámetr. El camp de búsqueda principal es aquel pr el cual se realizara la búsqueda en el cnjunt de registrs, el camp se búsqueda secundari es el resultad de la búsqueda listada para mayr cmprensión del usuari. El valr de retrn representa el valr que el cntrl asignara al parámetr. 27
Btón de cmand El btón de cmand sl es psible agregarle funcinalidad desde códig en el subprgrama. Para agregar un btón de cmand a la ventana de dialg seleccine en la barra de cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea cupar para el btón de cmand. Para cambiar el diseñ del títul estil de text haga clic en muestra de fuente en la barra de estil en la parte inferir derecha de la pantalla, para mdificar el estil del text. Para cambiar el nmbre del cntrl y el titul cámbiels en la barra sbre el dialg. Imagen El cntrl de imagen permite agregar imágenes en la ventana de diálg. Las imágenes puedes ser del tip jpg, bmp, gif, wmf y emf. Para agregar una imagen a la ventana de dialg seleccine cntrles de dialg, dibuje sbre la ventana de dialg el tamañ que desea. en la barra de En la ventana de prpiedades escriba el nmbre del cntrl para identificar la imagen. También puede elegir entre las pcines: Ajustar imagen a cntrl: Redimensina la imagen adaptándla al tamañ del cntrl dibujad en el diálg. Ajustar cntrl a imagen: Redimensina el cntrl adaptándl al tamañ de la imagen. Pestaña Recurs Intern Un recurs intern es un archiv agregad al pryect desde una ubicación en el equip. En esta pestaña se muestra una lista de la imágenes que ya ha agregad al pryect, seleccine una para insertarla al cntrl presine el btón Imprtar imagen para buscar una imagen en el equip. 28
Una vez agregada la imagen al reprte, Códice hace una cpia que se guardará dentr del archiv XPD (definición del reprte), pr l que cualquier cambi al archiv riginal n se reflejará en el resultad del infrme, est es particularmente útil pues a la hra de distribuir el pryect (archiv XPD) n necesita precuparse de llevar ls archivs de imágenes. Orígenes de registrs para ls cuadrs de diálg Para que un cuadr de diálg cumpla su función de filtrar, agrupar, resumir la infrmación que mstrará el reprte, debe tener un rigen de registrs cn una cnsulta SQL. El diseñadr de frmats de impresión Un frmat de impresión es utilizad para realizar el diseñ del reprte. El principal element que se dibuja sbre un frmat de impresión es la cuadrícula de detalle en la cual se integran ls camps de una base de dats. En el frmat de impresión se definen el tamañ de papel para la impresión, puede seleccinarse un tamañ persnalizad un tamañ estándar cm el tamañ carta u fici, también se define el tamañ de ls márgenes, la unidad de medida (centímetrs, milímetrs pulgadas), la rientación de la hja y si l desea un frmat de cntraprtada que se ejecutará después del frmat principal. Si desea crear etiquetas puede dividir la hja en el númer de filas y clumnas que se requieran. Filas y Clumnas Las filas sn las que están de manera hrizntal y las clumnas sn las que están de manera vertical. Un registr (también llamad fila tupla) representa un ítem únic de dats implícitamente estructurads en una tabla. Cada fila de una tabla representa un cnjunt de dats relacinads, y tdas las filas de la misma tabla tienen la misma estructura. Una clumna es un cnjunt de valres de dats de un simple tip particular, un pr cada fila de la tabla. Las clumnas prprcinan la estructura según la cual se cmpnen las filas. 29
Prtada y Cntraprtada La Prtada es el área de trabaj que aparece predeterminada al crear un nuev reprte en Códice FX y es l que se imprimirá al ejecutar el reprte. De frma predeterminada viene cnfigurada en tamañ carta. Tamañ de papel: Elija el tamañ que desea para la hja. Para cambiar el tamañ manualmente elija Persnalizad, ls cuadrs de alt y anch se activarán y ahra puede mdificar sus valres para adecuarls a su preferencia. Medida: Elija el tip de unidad de medida para representar la hja, ests pueden ser centímetrs, milímetrs pulgadas. Anch y Alt: Mdifique ests valres para persnalizar el tamañ de la hja. Elija primer tamañ de hja Persnalizad para pder hacer cambis. Orientación: Indique la rientación de la hja (hrizntal vertical), de frma predeterminada al imprimirse el diseñ del frmat se ajustará la cnfiguración de la impresra. Márgenes: El margen dibuja una guía en el frmat de impresión para delimitar la hja. Etiquetas: Para imprimir etiquetas mdifique el valr de filas y clumnas en el cuadr Etiquetas de acuerd al númer de etiquetas que desea crear. También puede mdificar el tamañ de la etiqueta cambiand ls valres de alt y anch. 30
Si cnfigura el frmat de impresión para imprimir etiquetas el tamañ de la hja que se mstrará para el diseñ será el tamañ de una sl etiqueta. Cuand ejecute el reprte se verán tdas las etiquetas en una sla hja. La Cntraprtada le permite agregar en la creación del reprte un frmat que se imprimirá a cntinuación del frmat que l cntiene. Pr ejempl si desea imprimir credenciales, la cara de la credencial será un frmat de impresión cn ls dats de la persna y éste tendrá asignad un frmat de cntraprtada cn trs detalles cm pr ejempl un códig de barras. Así al ejecutar el reprte se imprimirá una hja cn el frente de la credencial y la siguiente hja será el frmat de cntraprtada. Algritm general de ejecución El mtr en tiemp de ejecución de Códice FX tiene diferentes métds de realizar las tareas cmunes de prcesamient de cnsultas SQL. En ls siguientes apartads se muestra las diferentes frmas de hacer un prces específic cn Orígenes de registr cm pr ejempl la utilización de parámetrs, est permite al usuari elegir el métd que más le cnvenga. Pas de parámetrs y us de macrs Ls parámetrs sn usads para realizar un filtr en la cnsulta realizada a la base de dats, un parámetr puede btener su valr cuand el usuari se l asigna (puede ser pr medi de un diálg) asignarte un valr predeterminad. Así, se hace la cnsulta de acuerd al valr de dich parámetr. Es psible utilizar ls parámetrs de ds maneras diferentes. La primera es agregand el símbl de interrgación en la cnsulta SQL y la segunda es agregand el nmbre de un parámetr precedid del sign @. Ejempl: SELECT * FROM Clientes WHERE TipCliente=? La cnsulta SQL anterir recibe un parámetr, pr l tant es necesari mandar un valr para realizar la cnsulta crrectamente. La manera de funcinar en esta frma es la siguiente: El mtr en tiemp de ejecución manda la cnsulta y el parámetr a la base de dats para btener el cnjunt de registrs. De esta frma el mtr de la base de dats hace el trabaj de entender la cnsulta y sustituir el valr del parámetr. 31
El us de macrs se muestra a cntinuación: SELECT * FROM Clientes WHERE TipCliente=@Parametr1 Cuand se utilizan macrs en las cnsultas el prces que realiza el mtr en tiemp de ejecución es diferente: Primer se btiene el valr de parámetr, lueg se sustituye pne ese valr en la cnsulta SLQ, es decir se mdifica la cnsulta y en lugar del nmbre del parámetr se clca su valr. Pr últim, se envía al mtr de la base de dats la cnsulta cmpleta. Agrupacines y Gráfics Funcinamient de las agrupacines Una de las peracines más útiles sbre una base de dats es realizar filtrs para btener ls dats deseads sin camps extras que n se desean ver. Las cláusulas WHERE y HAVING realizan estas peracines en una cnsulta SQL, per a demás de estas Códice FX incluye un diseñadr de filtrs para hacer más fácil esta tarea. Diferencias entre Filtrs y Cláusulas WHERE/HAVING Las cláusulas Where y Having sn instruccines SQL las cuales se agregan en una cnsulta para realizar un filtr en un cnjunt de registrs de la base de dats. Ls dats btenids mediante un rigen de registrs que tenga incluid es su cnsulta estas cláusulas serán sl ls que se hayan indicad. Pr ejempl, se tiene una cnsulta cm la siguiente: SELECT * FROM Clientes WHERE Tip=1001 Esta cnsulta regresa un cnjunt de registrs dnde ls dats serán sl aquells clientes que tengan un tip de cliente igual a 1001, si un cliente pertenece a tr tip entnces n se mstrarán ls dats de ese cliente. Filtrs Las expresines de filtr del diseñadr de rígenes de registrs permiten realizar filtrs en una cnsulta de manera fácil. A diferencia de Where Having, ls Filtrs realizan su tarea des pues de btener el cnjunt de dats. Pr ejempl si tenems un rigen de registrs que btiene ls dats de una tabla y se desea hace un filtr, se agregaría una expresión de filtr cm sigue: Origen de dats: 32
Expresión de filtrad: Las expresines de filtrads se puede hacer pr medi del editr de filtrs. Expresines de rdenación VS Order By Ls métds de rdenación se utilizan para btener un cnjunt registrs de manera rdenada de acuerd a las especificacines que se indiquen en un rigen de registr. Códice FX tiene ds maneras de realizar las rdenacines, pr medi de Order By escribiend expresines de rdenación. Order By Esta instrucción se utiliza directamente en las cnsultas SQL l que permite btener un cnjunt de registrs ya rdenads desde la base de dats, es decir, cuand el rigen de registrs realice la cnsulta ls dats btenids estarán en el rden cm se indicó. Se puede incluir la expresión Order By de ds maneras. La primera es utilizand el diseñadr de cnsultas y la segunda es añadiéndla directamente sbre la cnsulta SQL. Expresines de rdenación A diferencia del métd Order By las Expresines de Ordenación se añaden cm una prpiedad de un rigen de registrs, pr l tant cuand el rigen de registrs btenga ls dats de la base de dats ests estarán tal cm fuern capturads, es decir n estarán rdenads, el métd de rdenación se aplica cuand el rigen de registrs ya tiene el cnjunt de dats. Tmand en cuenta l anterir la manera más eficaz de realizar una rdenación de ls dats es a través de Order By ya que btiene ls dats ya rdenads de la base de dats, a 33
diferencia de las expresines de rdenación que después de btener ls dats aplica el métd de rdenación. El cntrl de gráfics El cntrl gráfica le permite dibujar una gráfica y asignarle un rigen de registrs de dnde btendrá ls dats. Sl debe cnfigurar las prpiedades cm sn el tip de gráfica las leyendas, etc. y el resultad se verá al ejecutar el reprte. Pestaña general Gráfica: Tip de gráfica: Permite elegir el tip de gráfica que desea crear ya sea de Barras, Líneas, Pastel etc. Brde: Permite elegir el tip de brde de la gráfica ya sea línea simple, dble etc. Fnd: Fnd: Permite definir el clr del fnd de la gráfica. Clr de brde: Permite definir el clr de brde de la gráfica Serie de dats en filas: Al activar la casilla muestra ls dats en filas Mstrar leyendas: Al activar la casilla muestra el text agregad cm leyendas en la gráfica. Mstrar marcadres: Al activar la casilla muestra marcadres en la gráfica generada. Smbra: Al activar la casilla muestra una smbra en la gráfica 34
Pestaña dats Cnexines: Cnexión: Muestra la cnexión hacia la base de dats. Origen de registr: Indica el rigen de registr que se graficará. Mstrar escalas: Permite activar desactivar la impresión de escalas en ls ejes de la grafica Escala: Permite definir la escala, si se realizara de manera autmática cn limites definids pr el usuari. Pestaña títul: Permite definir ls títuls de la grafica, ls ejes etc. Asi cm diseñar el frmat de text. 35
36
37