Editor Formatos QR2

73
Editor de Reportes Guía Curso Distribuidor

Transcript of Editor Formatos QR2

  • Editor de Reportes Gua Curso Distribuidor

  • Elaborada por: Soporte Tcnico Aspel de Mxico, S. A. de C. V. Cerrada de Suiza #17 Col. San Jernimo Aculco Del. Magdalena Contreras C.P. 10400 Mxico, D. F. Agosto 2007 ASPEL es una marca registrada de Aspel de Mxico, S. A. de C. V. Asimismo Aspel de Mxico S. A. de C. V. se reserva el derecho de revisar peridicamente este documento y hacer cambios en el contenido del mismo, si lo considera necesario. Todas las marcas comerciales que se mencionan en este documento son marcas registradas por sus respectivas compaas. Cualquier duda o comentario al respecto de este documento, favor de notificarlo a: [email protected]

  • NDICE

    1. INTRODUCCIN.............................................................................................................................................. 1 1.1 Definicin .................................................................................................................................................. 1 1.2 Objetivo del curso.................................................................................................................................... 1

    2. EDITOR DE REPORTES..................................................................................................................................... 3 2.1 Generales ................................................................................................................................................... 3 2.2 Editor grfico de reportes (qr2) ............................................................................................................. 3 2.3 Conceptos bsicos.................................................................................................................................... 3 2.4 Estructura general de un reporte........................................................................................................... 4 2.5 Barra de herramientas ............................................................................................................................. 6 2.6 Propiedades del elemento de un reporte ............................................................................................. 7

    2.6.1 Cmo modificar un elemento del reporte?.............................................................................. 8 2.7 Barra de elementos del reporte ............................................................................................................. 8 2.8 Crear un nuevo reporte .........................................................................................................................17 2.9 Campos de la base de datos .................................................................................................................17 2.10 Configuracin de base de datos.......................................................................................................18 2.11 Ver una presentacin preliminar y grabar el reporte ..................................................................21

    Prctica 1: Creacin de un reporte de cuentas en Aspel-COI. .....................................................22 Prctica 2: Creacin de un reporte con formato en Aspel-SAE. ..................................................25

    2.12 Generacin de consultas mediante el lenguaje SQL (querys) ...................................................26 2.12.1 Sentencias SQL...........................................................................................................................27 2.12.2 Comandos DML ..........................................................................................................................27

    2.12.2.1 Instrucciones de consulta ................................................................................................29 2.12.2.2 Predicado en consultas ....................................................................................................31 2.12.2.3 Funciones de Agrupacin .................................................................................................33 2.12.2.4 Operadores especiales .....................................................................................................35

    2.13 Parmetros en las consultas.............................................................................................................35 2.14 Exportacin de un reporte o documento a formato PDF ............................................................36 2.15 Modificar un reporte..........................................................................................................................37 Prctica 3: Modificacin de un reporte de Facturas Digitales utilizando consultas dinmicas......39

    3. EDITOR DE FORMATOS (*.FTO).................................................................................................................43 3.1 Definicin ................................................................................................................................................43 3.2 Conceptos bsicos..................................................................................................................................43 3.3 Caractersticas del editor de formatos...............................................................................................43 3.4 Estructura general de los formatos.....................................................................................................44

    3.4.1 Parmetros del reporte.............................................................................................................44 3.4.2 Encabezados................................................................................................................................44 3.4.3 Contenido del reporte y/o partidas y ciclos .........................................................................45 3.4.4 Totales .........................................................................................................................................45

    3.5 Edicin de formatos ...............................................................................................................................45 3.5.1 Operadores ..............................................................................................................................45

    3.5.1.1 Aritmticos ........................................................................................................................46 3.5.1.2 Lgicos ................................................................................................................................46 3.5.1.3 Comparacin......................................................................................................................46

    3.5.2 Campos .....................................................................................................................................46 3.5.2.1 Campos asignados por el sistema ..................................................................................46 3.5.2.2 Campos libres numricos y alfanumricos ...................................................................46

    3.5.3 Comandos con sintaxis ..........................................................................................................47 3.6 Ciclos de lectura .....................................................................................................................................55 3.7 Generacin de formatos (*.fto) ...........................................................................................................58

    Prctica 4: Elaboracin de un formato para factura en fto..........................................................58 Prctica 5: Elaboracin de un formato para recibos con copia en Aspel-NOI. .........................62 Prctica 6: Modificacin de formato para Balance General. ........................................................68

  • Simbologa: t Tips de uso. Tipo de reporte. Ruta de acceso. 1 Advertencia. Prctica

    Requisitos: ; Conocimientos del sistema operativo MS-Windows NT4.0, 2000, XP, 2003 o superior. ; Conocimientos de por lo menos un sistemas Aspel. ; Conocimientos bsicos de programacin yPara el instructor. Software a utilizar: ; Aspel-SAE 4.0 ; Aspel-COI 5.x ; Aspel-NOI 4.x ; Bloc de Notas de Windows Bases de datos: ; Se utilizarn bases de datos de ejemplos de los sistemas de Aspel-SAE, Aspel-COI y Aspel-NOI.

    Nombre del participante: Centro de capacitacin: Nombre del instructor: Correo electrnico: Fecha:

  • Notas del asistente: Gua Curso Editores 1

    1. INTRODUCCIN

    1.1 Definicin Una caracterstica muy importante de los sistemas informticos son los Reportes mediante los cuales se brinda informacin veraz y oportuna al personal operativo, administrativo, gerencial y accionistas de la empresa, facilitando as la ejecucin de sus actividades, la toma de decisiones, la definicin de los objetivos y en general datos que permitan conocer la situacin financiera de la empresa. Los sistemas Aspel, dependiendo del sistema y nmero de versin cuentan con diferentes editores de Reportes que permiten al usuario obtener la informacin que se requiera de acuerdo a las necesidades de la operacin y los procesos administrativos de la empresa. Dado que los sistemas Aspel han ido evolucionando, las versiones ms recientes como Aspel-CAJA 1.0, Aspel-SAE 4.0, Aspel-COI 5.0, y Aspel-BANCO 3.0 cuentan con un editor de Reportes grfico que proporciona al usuario una herramienta para realizar adecuaciones sobre los formatos, el ordenamiento de la informacin, ejecutar filtros especficos, obtener informes ms elaborados, los reportes generados con esta herramienta tienen la extensin *.qr2. Por otro lado, tanto las versiones anteriores a las mencionadas, como las nuevas -incluyendo Aspel-NOI 4.0 y Aspel-PROD 2.0-, incluyen un Editor de reportes propio, el cual mediante un conjunto de instrucciones (pseudo lenguaje de programacin) permite realizar la edicin de los reportes con extensin *.fto. 1.2 Objetivo del curso Al trmino de este curso el Asistente podr modificar o disear nuevos reportes en los sistemas de la lnea Aspel en cualquiera de sus versiones, conocer las ventajas, caractersticas y condiciones para utilizar los diferentes Editores de formatos y podr obtener finalmente, los reportes e informes de acuerdo a las necesidades de informacin de la empresa.

  • Notas del asistente: Gua Curso Editores 2

  • Notas del asistente: Gua Curso Editores 3

    2. EDITOR DE REPORTES

    2.1 Generales Dado que los sistemas Aspel ofrecen diferentes Editores de reportes, es necesario identificar la versin del sistema Aspel desde el cual se desea generar o modificar un reporte ya que de ello depende la herramienta que se tendr disponible para obtener el documento o reporte con las caractersticas deseadas. La correcta eleccin del editor depender de la versin del sistema y las caractersticas del reporte deseado.

    Sistema.versin Editor tradicional (fto) Editor de notas Editor grfico (qr2)

    Aspel-SAE 3.0 Aspel-SAE 4.0 Aspel-COI 4.0 Aspel-COI 5.x Aspel-NOI 3.x Aspel-NOI 4.x Aspel-BANCO 2.5 Aspel-BANCO 3.0 Aspel-PROD 1.7 Aspel-PROD 2.0 Aspel.-CAJA 1.0

    2.2 Editor grfico de reportes (qr2) Ruta de acceso: En Aspel-SAE 4.0 desde cualquier mdulo a Reportes/Administrador de Reportes, en Aspel-BANCO 3.0 en el men Reportes/Administrador de reportes. En Aspel-COI 5.0 desde el men Reportes/ Reportes del usuario. En Aspel-CAJA 1.0 en le men Archivo / Editor de Reportes desde el Administrador de Catlogos / Tiendas, seleccionar la tienda y la caja y dar clic derecho sobre la caja Editar el formato de la nota de venta de esta caja. El Editor grfico de reportes es una herramienta que permite tener gran flexibilidad y mayores alcances en la edicin y personalizacin de reportes. Entre las caractersticas principales que hacen de este un editor flexible, est la generacin de consultas en lenguaje SQL que permiten la obtencin de informacin de las bases de datos de los diferentes sistemas, de esta manera se podr incluir o formar un reporte con la informacin de las diferentes tablas que componen cada mdulo. Un formato o reporte diseado por este medio genera un archivo con la extensin *.qr2. 2.3 Conceptos bsicos Antes de empezar con la edicin de estos reportes, se revisarn algunos conceptos generales. Base de Datos: Es un conjunto de informacin organizada en estructuras lgicas llamadas Tablas, las cuales a su vez, se encuentran relacionadas entre s. Tablas. Son archivos compuestos por campos y registros, por ejemplo: un archivo con informacin de direcciones, nmeros de partes o facturas.

  • Notas del asistente: Gua Curso Editores 4

    Query. Es un conjunto de instrucciones que permite mostrar una serie de registros provenientes de una tabla que cumplen con determinado criterio. Conjunto de Datos (Dataset). Est compuesto de comandos, clusulas, operadores y funciones, estos elementos se combinan en las instrucciones para actualizar y manipular la base de datos. Almacenan datos en una memoria cach desconectada. La estructura de un conjunto de datos es similar a la de una base de datos relacional; expone un modelo jerrquico de tablas, filas y columnas. Adems, contiene restricciones y relaciones definidas para el conjunto de datos. Alias. Los Alias son nombres o identificadores alternos para las rutas de acceso o bases de datos. Etiqueta. Conjunto de caracteres unido a un grupo de datos que sirve para identificarlo. Maestro. Es la tabla principal y de mayor importancia, de la cual se extrae la informacin que se est definiendo. La definicin de una tabla como maestro se realiza en las propiedades de las tablas disponibles o al generar un nuevo query, el maestro est asociado en el valor del parmetro desde otra Tabla de datos. 2.4 Estructura general de un reporte Conocer la estructura general de un reporte es de suma importancia, pues siempre que se modifique alguno de ellos se debe identificar en qu seccin del reporte se est trabajando. Las diferentes secciones que forman un reporte se muestran en la Figura 2.4-1 y son:

    Encabezado del Reporte: sta seccin se utiliza para colocar datos como el nombre de la empresa, ttulos del reporte, entre otros y las bandas que regularmente se agregan son, la banda de ttulo, encabezado de pgina, y encabezado de columna, estas se disean por medio de una banda estndar, en donde se puede configurar los datos generales que ayuden a identificar el reporte.

    Detalle del Reporte: Esta seccin se utiliza para colocar la informacin detallada que conformar el reporte como listado de productos, partidas de una factura, lista de cuentas, artculos, etc. En sta seccin se pueden insertar las bandas siguientes: Bandas de subdetalle, Grupo de bandas, Banda hija.

    Pi del reporte: Se utiliza para colocar la informacin final del reporte como totales y datos finales, las bandas ms comunes para sta seccin son sumas, pi de pgina, entre otras.

    58-43-31-44Calz. Morelos 5214Karina Cevallos Garca3

    56-84-96-10Calle Xola 14Alejandra Mrquez Torres2

    53-96-85-78Av. De las Torres 53Juan Hernndez Soto1

    TelfonoDireccinNombreClave

    58-43-31-44Calz. Morelos 5214Karina Cevallos Garca3

    56-84-96-10Calle Xola 14Alejandra Mrquez Torres2

    53-96-85-78Av. De las Torres 53Juan Hernndez Soto1

    TelfonoDireccinNombreClave

    Campos

    Registros

    Figura 2.3-1 Estructura de una tabla

  • Notas del asistente: Gua Curso Editores 5

    Como se puede observar las secciones de un reporte se manejan por medio de bandas, cada una de ellas tienen una funcin diferente. Ahora bien, para generar un reporte se requiere conocer los elementos de un formato, estos se muestran en la Figura 2.4.-2

    Encabezado del reporte

    Detalle

    Figura 2.4.-1 Estructura general de un reporte

    Pi del Reporte

  • Notas del asistente: Gua Curso Editores 6

    Los tres elementos ms importantes de un formato son las "Etiquetas", los "Campos de datos" y las Bandas. Las etiquetas (Label) son usadas para imprimir texto, por ejemplo, un ttulo o datos que no tienen conexin con la base de datos. Los campos de datos (Datafield) son un punto de referencia para que el "Reporteador" obtenga su informacin de un "Conjunto de datos" (Dataset) y la coloque en el rea del reporte donde se estableci el "Campo de datos". Usualmente las etiquetas son colocadas para referenciar a los campos de datos, con el objetivo de hacer que el reporte sea ms entendible, mientras que las bandas, son las reas donde se colocan las etiquetas mencionadas. 2.5 Barra de herramientas La barra de herramientas se conforma por botones que al dar clic en ellos, ejecutan de inmediato las funciones ms importantes del Editor de reportes, estos se muestran en la Figura 2.5-1. Se pueden cambiar algunas propiedades de los elementos del reporte que se est utilizando, directamente con los botones de la barra de herramientas, al hacer clic sobre cada botn y se desplegar el dilogo donde se definen las propiedades de los elementos.

    Figura 2.5-1 Barra de herramientas.

    Etiquetas

    Campos de datos

    Figura 2.4-2 Elementos del formato

    Bandas

  • Notas del asistente: Gua Curso Editores 7

    Botones Funcin

    Estos botones se utilizan para crear un reporte en blanco, guardar los cambios y abrir un reporte existente.

    Para guardar el reporte con un nombre y ubicacin diferente, imprimir y mostrar una vista preliminar.

    Con estos botones los elementos de reporte pueden ser cortados, copiados o pegados desde el portapapeles del diseador de reportes.

    Estos botones son usados para colocar un elemento de reporte atrs o arriba de otros elementos de reporte, en el caso de elementos sobre puestos.

    Estos botones se utilizan para configurar la impresin del reporte, para modificar y/o generar un nuevo query, adems de mostrar las tablas disponibles en el reporte.

    Los elementos (como etiquetas o valores de campos) del reporte, pueden ser alineados en la presentacin del reporte con los botones de la barra que se muestra en la figura 2.5-2. Algunos de ellos slo estn disponibles cuando varios elementos estn seleccionados.

    Para utilizar estas funciones, se debe seleccionar los elementos, figuras, imgenes, etc., con la tecla u y haciendo clic sobre los elementos que se desea modificar su ubicacin en el reporte, ya sean: figuras, imgenes, etc., se pueden seleccionar varios elementos al mismo tiempo mientras estos formen parte de la misma banda, o se trate de los elementos que formen parte del reporte en general. Una vez seleccionados los elementos se debe elegir el tipo de alineacin requerida con los botones de la barra anterior. En algunas ocasiones, se requiere de cambiar la presentacin de los textos (tipo de letra, tamao, alineacin, etc.) para una mejor apariencia del reporte, para ello ser de gran ayuda la barra de formato de texto que se muestra en la figura 2.5-3: Con sta banda se puede cambiar la fuente del texto, tamao, color, atributo, alineacin o bien, agregar un marco alrededor de la etiqueta. 2.6 Propiedades del elemento de un reporte Despus de editar las propiedades del elemento de reporte de acuerdo a los requerimientos, se debe presionar el botn "Aceptar" para cerrar el dilogo y aceptar los cambios. Si en lugar de Aceptar se da clic en "Cancelar", todos los cambios sern ignorados, si por ejemplo, se estaba insertando un nuevo elemento, ste no ser agregado al reporte. La descripcin acerca de las diferentes propiedades de cada elemento de reporte se localiza en la descripcin individual de cada elemento.

    Figura 2.5-2 Barra de herramientas auxiliar par modificar presentaciones.

    Figura 2.5-3 Barra de herramientas para dar formato al texto.

  • Notas del asistente: Gua Curso Editores 8

    2.6.1 Cmo modificar un elemento del reporte? Las propiedades de un elemento del reporte pueden ser cambiadas en cualquier momento durante el diseo del reporte. Para ello se selecciona el elemento deseado y al hacer doble clic con el botn izquierdo del ratn, o presionar el botn derecho y seleccionar la opcin "Editar" del men flotante, el dilogo de propiedades para el elemento de reporte seleccionado aparecer y es el mismo dilogo que aparece cuando se inserta un nuevo elemento de reporte. La imagen 2.6.1-1 muestra el dilogo de propiedades para una "etiqueta". 2.7 Barra de elementos del reporte Los botones para agregar los Elementos del reporte se encuentran en la parte superior de la ventana del diseador.

    2.7-1 Barra de elementos. Para agregar un elemento al reporte se debe presionar el botn y despus hacer clic en el reporte en el lugar donde se quiere que sea insertado el elemento. Despus se podr mover el elemento de reporte a cualquier otro lugar. Cuando se agregue nuevas bandas de reportes no importar donde se haga clic, ya que la posicin de cada banda se determina automticamente dependiendo el tipo de cada una de ellas (Encabezado, Ttulo, Pie de pgina, etc). A continuacin se muestra la funcin de cada uno de los elementos del reporte.

    Seleccionar / mover elemento. Se utiliza para seleccionar elementos, cambiarlos de posicin o modificar su tamao.

    Banda estndar. Una banda es el elemento de un informe que representa una seccin en la cual se pueden agrupar campos que tienen alguna caracterstica en comn

    Todas las bandas del reporte son agregadas mediante el mismo botn ubicado dentro de la barra de herramientas. Por cada banda, se deben definir ciertas caractersticas:

    Figura 2.6.1-1 Modificacin del elemento de un reporte.

  • Notas del asistente: Gua Curso Editores 9

    1. Tipo: El tipo de banda es seleccionado en el dilogo de propiedades de la banda que se despliega.

    Dependiendo el tipo de banda que se defina, es la presentacin de la mismas en el cuerpo del reporte, los tipos de banda con los que se cuentan son: Ttulo: La banda de ttulo se imprimir en la primera pgina del reporte como un ttulo de

    reporte. Encabezado de pgina: La informacin definida en la banda se imprimir en la parte superior de

    cada pgina del reporte. Encabezado de columna: El encabezado de columna es utilizado con reportes que tienen varias

    columnas, en este caso, el sistema en cada pgina del reporte imprimir el encabezado de columnas.

    Detalle: La banda de detalle es la ms importante de un reporte. Se imprime una vez por cada registro de datos de la tabla principal del reporte.

    Encabezado de grupo: El encabezado de grupo se refiere al formato o ttulo que se le dar a cada columna de datos para identificarlos, el encabezado de grupo no se imprime.

    Pie de grupo: El pie de grupo se imprime al final de cada grupo, antes de que un nuevo grupo comience a imprimirse. Para mayor informacin sobre grupos, se debe consultar la seccin donde se describe el Grupo de bandas.

    Sumas: Las sumas se refieren a los totales de las expresiones especificadas dentro de la banda en el reporte. Se pueden definir etiquetas para identificar los totales.

    Pie de pgina: La banda definida de esta manera, se imprime en la parte inferior de cada pgina del reporte.

    Banda de Repetir: Permite repetir los elementos que se encuentren dentro de dicha banda el nmero de veces que se indique en las propiedades.

    Figura 2.7-2 Propiedades de una banda estndar.

  • Notas del asistente: Gua Curso Editores 10

    2. Opciones de impresin de una banda: Uno de los datos que se definen por banda son las opciones de impresin, (Figura 2.7-3) con ellas se puede definir cada cuando se imprime la banda que se est modificando, por ejemplo, el total de un reporte slo se debe imprimir el final del reporte, en cambio los encabezados de columnas se deben imprimir en cada pgina del reporte.

    A continuacin se describen las diferentes opciones de impresin:

    Descartar en pgina Inicial: Al marcar esta opcin la banda se omite en la primer pgina del reporte. Descartar en pgina Final: Al marcar esta opcin la banda se omite en la ltima pgina del reporte. Numerar pginas: Con esta opcin se numeran las pginas tantas veces como se imprima la banda. Pginas Impares solamente: Solamente se imprimir la banda en pginas Impares. Numerar al final de la Pgina: Sirve para numerar en la parte inferior de la pgina. Forzar nueva pgina: Cada que se imprima la banda se har en una hoja nueva. Forzar nueva columna: Cuando se llegue a esta banda la impresin comenzar en otra columna.

    Adems de las opciones anteriores, es posible indicar alguna expresin o condicionante para permitir o no la impresin de la banda en el reporte, mediante la opcin:

    Cundo es til esta opcin? por ejemplo, dentro de Aspel-SAE 4.0 en el reporte de Acumulados de Clientes, se desea imprimir nicamente aquellos clientes que tengan Ventas Anuales mayores a $100,000.00, por lo tanto la expresin quedara as: dtsClie_Cat.VTAS>100000.

    Figura 2.7-3 Opciones de impresin de una banda estndar.

    Figura 2.7-4 Definicin de una condicin para indicar que slo se imprimir si se cumple la condicin.

  • Notas del asistente: Gua Curso Editores 11

    3. Agregando un marco a la banda: Se puede incluir un marco a la banda, para delimitar informacin

    si as se desea, con diferentes estilos de lneas y colores.

    4. Encadenar con la banda: Esta opcin relaciona dos bandas para que sus datos estn relacionados,

    el sistema mostrar todas las bandas que estn en el reporte para que se pueda elegir a la que se desea encadenar o relacionar.

    Figura 2.7-6 Definicin de las propiedades para la impresin del marco en la banda

    Figura 2.7-5 Ejemplo de banda que slo se imprime al cumplir con una expresin.

    Figura 2.7-7 Propiedades de la banda estndar

  • Notas del asistente: Gua Curso Editores 12

    Banda hija

    Una banda hija es una banda que es ligada a otra banda de reporte y la cual se imprimir debajo de su banda padre. De esta manera, se podr imprimir una banda adicional despus de cada banda de detalle. La ventaja de utilizar bandas hija en lugar de slo cambiar el tamao de la banda padre para hacer que alcancen ms elementos de reporte es que stas pueden ser, si es necesario, un salto de pgina entre una banda y su hija, y la banda hija puede imprimirse independientemente de su banda padre, an si la banda padre no se imprime. Se debe usar bandas hija si se tienen elementos de reporte con la propiedad "Ajustar" puesta en verdadero y si se desea imprimir el elemento abajo como un campo ajustable. En este caso, se deben colocar todos los elementos que sern movidos hacia abajo automticamente a causa de los elementos con auto estrechamiento antes de ellos en la banda hija. A diferencia de la banda padre, para una banda hija es forzoso especificar una banda padre.

    Banda de subdetalle Una banda de subdetalle es una clasificacin de la banda de detalle, pero es un integrante de la banda de detalle real. Por ejemplo: Si se quiere imprimir un reporte de los clientes con datos como direccin, correo, telfono, etc, y por cada cliente imprimir la lista de los contactos que se tiene, se deber usar una banda de subdetalle para imprimir los contactos debajo de cada cliente. Para usar esta tabla, es necesario que se cree una conexin a la tabla correspondiente (llamada "Tabla maestra") mediante la opcin de Configuracin de base de datos. En una banda de subdetalle se debe definir:

    Tabla: En este campo se debe definir el Conjunto de datos del cual se tomar la informacin para la banda de subdetalle.

    Color: Esta propiedad define el color del fondo de la banda del reporte. Maestro (tabla principal): "Maestra" es la tabla de mayor importancia para la tabla de subdetalle. Por

    cada registro de datos en la tabla maestra se imprimir una lista de subdetalle. Siguiendo con el ejemplo planteado anteriormente, por cada cliente se imprimir su listado de contactos, por ello en el campo Maestro se defini la tabla: dtsClie_Cat.

    Figura 2.7-8 Propiedades de una banda hija

  • Notas del asistente: Gua Curso Editores 13

    Ejemplo de una banda de subdetalle ya asociada a la tabla principal Figura 2.7-10 y una vista previa del reporte de catlogo de clientes con sus contactos.

    Banda de Subdetalle

    Banda de Detalle

    Figura 2.7-10 Vista preliminar del reporte

    Figura 2.7-9 Banda de Subdetalle.

  • Notas del asistente: Gua Curso Editores 14

    Grupo de bandas

    Un grupo de bandas es utilizado para estructurar informacin en grupos de registros de datos. Por ejemplo: si quieres imprimir una lista de direcciones, puedes agregar algunos espacios antes de que inicie cada nueva letra e insertar algn subttulo, o puedes agrupar direcciones por ciudad o estado. Internamente los grupos son manejados de la siguiente manera: antes de imprimir un registro de datos, el generador del reporte verifica si el resultado de la expresin del grupo es diferente del resultado de la expresin del ltimo registro de datos. Si esto es as, el grupo se imprimir, de otra forma no. De esta manera, los datos pueden ser agrupados con gran flexibilidad, dado que puedes utilizar las expresiones para aproximaciones o cualquier otro tipo de clculos. Cuando se define un grupo de bandas, es necesario especificar un Maestro, as como una banda de pie de grupo. A continuacin se describir de manera general cada una de las herramientas que se pueden utilizar dentro de un Reporte qr2.

    Etiquetas / Label Una etiqueta sirve para imprimir texto esttico, por ejemplo, texto que se imprime exactamente igual a como se despliega durante el diseo del reporte.

    Memos Un memo es usado para imprimir texto que tiene ms de una lnea. As como las etiquetas, un memo despliega texto en un color y tipo de letra. Si quiere usar texto con formato, debers utilizar un campo de Texto con formato (Richtext)

    Figura 2.7-9 Propiedades de la banda de grupo.

  • Notas del asistente: Gua Curso Editores 15

    Imgenes

    Un elemento imagen es un mapa de bits de un archivo en formato *.BMP,*.WMF,*.EMF o *.ICO que se inserta en el reporte.

    Figuras Este elemento de reporte puede ser utilizado para dibujar (horizontalmente o verticalmente) lneas, crculos y rectngulos.

    Campos del sistema

    Este elemento es utilizado para desplegar informacin del sistema como la hora o la fecha, el nmero de pgina, etc.

    Campo de datos

    Mediante un campo de datos se puede agregar algn campo obtenido mediante alguna Tabla o Query del Reporte.

    Figura 2.7-10 Propiedades del campo del sistema

    Figura 2.7-11 Propiedades de un campo de datos

  • Notas del asistente: Gua Curso Editores 16

    El campo Formato se utiliza para definir la mscara del dato a desplegar, por ejemplo: ###,###,###.##

    Imgenes desde un campo de datos Mientras que un campo de datos se utiliza para desplegar texto desde un registro de una base de datos, se puede utilizar este elemento de reporte para desplegar imgenes que se encuentren almacenadas en una base de datos.

    Campo de expresiones Un campo calculado (campo de expresiones) es utilizado para desplegar texto o datos que son calculados por medio de una expresin o frmula. Puedes realizar clculos numricos, manipulacin de cadenas, concatenacin de campos de datos y mucho ms.

    La posibilidad de Agregar un campo calculado slo se presenta al utilizar un reporte con formato qr2. Slo es necesario indicar la expresin con la cul se calcular el valor del campo a imprimir.

    Texto de comando El texto con formato es un elemento de reporte que puede desplegar mltiples lneas de texto con diferentes tipos de letra, colores y formatos. En el dilogo de propiedades del texto con formato presiona el botn "Editar" para desplegar el editor de texto desde donde se pueden editar las propiedades del texto con formato.

    Texto con formato desde un campo de datos

    Este elemento de reporte despliega texto con formato de un campo de datos.

    Figura 2.7-12 Propiedades de un campo calculado

  • Notas del asistente: Gua Curso Editores 17

    2.8 Crear un nuevo reporte Ruta de acceso: Reportes / Administrador de Reportes / haciendo clic sobre el botn . Desde el Administrador de reportes se agrega un nuevo reporte o se modifica alguno que ya est previamente configurado, para adaptarlo a las necesidades de la empresa. Si se est creando un nuevo reporte, el sistema mostrar el reporte en blanco, de tal manera, que se podrn ir agregando: las bandas, etiquetas, base de datos, etc, segn se requiera. Para configurar el reporte se deben considerar los siguientes aspectos: 2.9 Campos de la base de datos

    Se activa al abrirse el reporte o con el botn y consiste en una lista con todos los campos disponibles y manejados en tu sistema de Aspel para la base de datos y catlogo seleccionado. Por ejemplo, en la figura 2.9-1 se muestran los campos de la base de datos de Aspel-COI del catlogo de cuentas.

    Figura 2.8-1 Nuevo reporte en Aspel-COI 5.5

    Figura 2.9-1 Campos de la base de datos

  • Notas del asistente: Gua Curso Editores 18

    Para la edicin y modificacin de los campos que se listan en esta ventana se podrn realizar desde la opcin de base de datos:

    Los botones (Editar, Aadir, Borrar, Aadir campos calculados y asociados) en este dilogo estarn deshabilitados si no se tiene acceso a la edicin de los campos de la base de datos.

    Se pueden remover (borrar) campos individuales de una base de datos, pero stos nunca ms estarn disponibles en el diseador de reportes, o bien se pueden editar las propiedades del campo.

    Una etiqueta puede ser asociada a cada campo de dato, la cual es usada como un nombre de alias en el diseador de reportes. De esta manera, se pueden tener nombres de campos descriptivos sin que la base de datos fsicamente los tenga, por ejemplo, el campo "NUM_CTA" puede ser reemplazado con "Cuenta, esto mediante el botn Editar.

    Se utiliza la lnea de edicin "Formato" dentro del botn Editar, para dar formato a los campos numricos (ver Formato de campos numricos) y la opcin "Precisin" determina hasta cuantos dgitos decimales se desplegarn despus del punto decimal.

    2.10 Configuracin de base de datos Ruta de acceso: Desde el Diseador de Reportes, con el botn En la mayora de los casos cada reporte necesita de al menos un "Conjunto de datos", el cual proporcionar los registros de datos para el reporte. Se puede definir todos los "Conjuntos de datos" y sus relaciones mediante el programa de configuracin de bases de datos. El dilogo que el sistema presenta, muestra la base de datos principal para el reporte, que ser la base de datos que el reporte recorrer y de la cual imprimir todos los registros de datos. Debajo de la tabla principal del reporte se encuentra la lista de todas las bases de datos disponibles para el reporte.

    Figura 2.10-1 Configuracin base de datos

  • Notas del asistente: Gua Curso Editores 19

    Nuevo/ Query Desde aqu se podr proporcionar una consulta (query) en lenguaje SQL y si la consulta tiene parmetros, se podrn establecer sus valores. Propiedades Muestra un dilogo con la configuracin de la consulta (query) seleccionada. Si los campos de este dilogo estn deshabilitados, no se podr cambiar la configuracin de la base de datos. Se debe establecer el nombre de la consulta, la cual ser utilizada por el diseador del reporte cuando un conjunto de datos necesite ser seleccionado. Este nombre es como un alias y no afectar fsicamente el nombre de la consulta. Por omisin el nombre propuesto es Dataset1, tal vez quieras cambiar el nombre a "Cuentas" para ser un poco ms descriptivo. El nombre no afectar la impresin del reporte, slo es utilizado durante el diseo.

    Figura 2.11-1 Creacin de consulta

    Figura 2.12-1 Propiedades de la consulta

  • Notas del asistente: Gua Curso Editores 20

    Campos Segn la tabla seleccionada este botn desplegar todos los campos que contiene dicha tabla. Borrar Este botn permite borrar las tablas que se encuentren agregadas dentro de esta seccin, el sistema enviar el siguiente mensaje antes de eliminar dicha tabla: "Si borra esta tabla, todos los elementos que la usan sern invlidos. Continuar?"

    Figura 2.13-1 Campos de la tabla

    Figura 2.14-1 Borrado de consulta

  • Notas del asistente: Gua Curso Editores 21

    Ver datos El sistema mostrar el resultado de la consulta definida. 2.11 Ver una presentacin preliminar y grabar el reporte Durante todo el proceso de creacin del reporte, se podr obtener una Presentacin preliminar, con el botn d l el reporte aparecer en pantalla tal y como se imprimir y se podr verificar la orientacin del reporte

    Figura 2.15-1 Vista de los datos de la consulta

    Figura 2.16-1 Presentacin preliminar del reporte

  • Notas del asistente: Gua Curso Editores 22

    Prctica 1: Creacin de un reporte de cuentas en Aspel-COI. A continuacin se generar un nuevo reporte desde Aspel-COI, el cul tendr como finalidad mostrar el catlogo de cuentas, agregando ciertas caractersticas.

    a) Ingresar a Aspel-COI e ingresar al Administrador de Reportes. b) En la seccin Grupos seleccionar Cuentas c) Hacer clic en el botn Nuevo. d) Por default se muestran 2 bandas, la de Encabezado de Pgina y Ttulo, se debe eliminar la banda de

    Ttulo. e) Agregar las bandas de Encabezado de Columna y Detalle. f) En la banda de Encabezado de Pgina, realizar lo siguiente:

    Centrar el nombre de la empresa. Agregar una etiqueta con la leyenda Catlogo de Cuentas, cambiar el tamao de letra a 18

    pts., color azul y centrado. Agregar un campo del sistema con la fecha y colocarlo del lado izquierdo. Agregar un segundo campo del sistema con el nmero de pgina. En la banda de Encabezado de Columna, agregar las etiquetas: Cuenta, Descripcin, Total de

    Cargos, Total de Abonos y Saldo Final. En la banda de detalle, agregar de la lista flotante los campos de: Cuenta, Descripcin de la

    cuenta, Total de cargos, Total de abonos y Saldo final. El resultado deber ser similar al mostrado en la figura 2.16-2.

    g) Guardar el reporte con el nombre de cat_ctas.qr2 h) Generar la presentacin preliminar del reporte, la cual ser similar a la mostrada en la figura 2.16-3:

    Figura 2.16-2 Creacin del reporte.

    Figura 2.16.3 Presentacin preeliminar del reporte.

  • Notas del asistente: Gua Curso Editores 23

    i) Dentro de la configuracin de Base de datos (pulsando el botn ) seleccionar el Informe de la Tabla que ser: Catlogo de cuentas.

    j) Agregar lneas a la banda de Encabezado de columna, superior e inferior, mientras que el grosor de la lnea ser de 2 puntos.

    k) Al hacer la impresin preeliminar verificar que la banda de encabezado de columna se muestre en cada una de las hojas.

    Figura 2.16.4 Seleccionando el informe de la tabla.

    Figura 2.16.5 Presentacin preeliminar del reporte.

  • Notas del asistente: Gua Curso Editores 24

    l) En la banda de Detalle, dar doble clic en el campo Total de Cargos y en la opcin Formato, colocar la siguiente mscara: ###,###,##0.00 e indicar la alineacin Derecha.

    m) Mostrar la vista preliminar, Qu efecto tuvo la mscara escrita anteriormente sobre los valores de la columna?

    n) Realizar la misma accin del inciso k en las siguientes 2 columnas.

    o) Agregar la banda de nombre Sumas.

    p) Insertar un campo de Expresin con el botn . q) En la seccin de nombre Expresin, escribir la operacin SUM(qryCuentas.DEBECONTAB) como se

    muestra en la figura 2.16-7, adems del formato y alineacin indicados.

    Figura 2.16.6 Presentacin preeliminar del reporte con formato de valores.

    Figura 2.16.7 Propiedades del campo calculado o de expresin.

  • Notas del asistente: Gua Curso Editores 25

    r) Mostrar la vista preliminar y verificar que se muestre el total final de los cargos s) Insertar otros dos campos de operaciones para mostrar el total de las siguientes columnas, adems

    de agregar una etiqueta con el nombre Totales del costado izquierdo. El resultado deber de ser parecido al de la figura 2.16-8.

    t) Agregar una lnea superior a la ltima banda.

    Prctica 2: Creacin de un reporte con formato en Aspel-SAE. A continuacin se generar un reporte desde Aspel-SAE en donde se pretende mostrar el monto de crdito disponible para cada cliente.

    a) En Aspel-SAE, ingresar al Administrador de Reportes desde el catlogo de clientes. b) Seleccionar el grupo de Catlogo de Clientes. c) Agregar un nuevo reporte. d) Insertar las bandas de Encabezado de Columna, Detalle, Sumas y Pi de Pgina. e) En la banda de Encabezado de pgina, insertar la imagen de nombre empaque_sae2_previa.jpg que

    se encuentra en el DAC\Centro de Asistencia, colocar dicha imagen al costado derecho del nombre de la empresa.

    f) En la banda de Ttulo, agregar el texto: Reporte de crditos disponibles. g) En la banda de Encabezado de Columna, colocar las siguientes etiquetas: Clave, Cliente, Vendedor,

    Ultimo Pago, Lim. Cred., Saldo y Cred. Disponible. h) En la banda de Detalles, colocar los campos de: Clave del Cliente, Nombre, Vendedor, Fecha del

    ltimo pago, el lmite de crdito y el saldo. i) Insertar un campo de expresin que permita obtener la diferencia del lmite de crdito con el saldo

    actual del cliente, utilizando la siguiente frmula: dtsClie_Cat.LIM_CRED - dtsClie_Cat.SALDO. j) En la banda de Sumas, colocar con un campo del sistema, el nmero de registros impresos, la

    etiqueta Total de saldos y la suma de los saldos con un campo de expresin y la siguiente frmula: SUM(dtsClie_Cat.SALDO).

    k) En la ltima banda colocar la fecha y hora del sistema adems del nmero de pgina utilizando campos del sistema.

    l) Las cantidades debern de tener los separadores correspondientes de decimales y millares, adems de estar alineados a la izquierda.

    m) Agregar los bordes necesarios para que se muestre el reporte como se observa en la figura 2.16-9.

    Figura 2.16-8 Ejemplo del resultado de los campos calculados.

  • Notas del asistente: Gua Curso Editores 26

    2.12 Generacin de consultas mediante el lenguaje SQL (querys) Las consultas permiten explotar y manipular la informacin de una forma extraordinaria, haciendo uso de SQL proveniente del acrnimo Structure Query Lenguaje (Lenguaje estructurado de Consultas). Este lenguaje contiene una sintaxis universal en la mayor parte de su diccionario, por lo cual su aprendizaje y aplicacin viene acompaado de muchos beneficios. Para poder emitir Reportes resumen y mostrar la informacin de manera clara, es necesario seleccionar los registros que cumplan con las caractersticas de la informacin que se desea obtener, y esto se puede lograr definiendo ciertos filtros. Para lograrlo, no basta con obtener los campos directamente de las tablas, y es necesario elaborar querys o consultas precisas que slo arrojen los registros que cumplan todas las condiciones establecidas. El uso de consultas optimiza el tiempo para la emisin de los reportes.

    Figura 2.16-9 Ejemplo del reporte generado en Aspel-SAE

  • Notas del asistente: Gua Curso Editores 27

    2.12.1 Sentencias SQL Las sentencias SQL pertenecen a dos categoras principales: Lenguaje de Definicin de Datos, DDL y Lenguaje de Manipulacin de Datos, DML. Estos dos lenguajes no son lenguajes en s mismos, sino que es una forma de clasificar las sentencias de lenguaje SQL en funcin de su cometido. La diferencia principal reside en que el DDL crea objetos en la base de datos y sus efectos se pueden ver en el diccionario de la base de datos; mientras que el DML es el que permite consultar, insertar, modificar y eliminar la informacin almacenada en los objetos de la base de datos. Cuando se ejecutan las sentencias DDL de SQL, el SGBD confirma la transaccin actual antes y despus de cada una de las sentencias DDL. En cambio, las sentencias DML no llevan implcito el commit y se pueden deshacer. Existe pues un problema al mezclar sentencias DML con DDL, ya que estas ltimas pueden confirmar las primeras de manera involuntaria e implcita, lo que en ocasiones puede ser un problema. Nota: Cuando un query marca (closed), es debido a que al editar el query se est haciendo referencia a algn archivo que No existe, por lo cual el query no est disponible. Para corregirlo bastar con editar el query e indicar el nombre de algn archivo que Si exista. 2.12.2 Comandos DML Para efectos del Editor grfico de reportes solo se considerarn los comandos DML:

    Comando Descripcin

    SELECT Utilizado para consultar registros de la base de datos que satisfagan un criterio determinado.

    INSERT Utilizado para cargar bloques de registros en la base de datos en una nica operacin.

    Figura 2.17.1-1 Referencias no validas en la consulta.

  • Notas del asistente: Gua Curso Editores 28

    Existen tambin una serie de clusulas las cuales permiten condicionar o filtrar la informacin que se est consultando o manipulando.

    Clusula Descripcin

    FROM Utilizada para especificar la tabla de la cual se van a seleccionar los registros.

    WHERE Utilizada para especificar las condiciones que deben reunir los registros que se van a seleccionar.

    GROUP BY Utilizada para separar los registros seleccionados en grupos especficos.

    HAVING Utilizada para expresar la condicin que debe satisfacer cada grupo

    ORDER BY Utilizada para ordenar los registros seleccionados de acuerdo con un orden especfico Ascendente o Descendente (ASC/DESC)

    Al utilizar condiciones o clusulas necesariamente se deben utilizar operadores los cuales se encargarn de evaluar en base aciertos criterios la clusula especfica, los cuales se clasificarn en:

    Lgicos Comparacin.

    Lgicos:

    Operador Uso

    AND Es el "y" lgico. Evala dos condiciones y devuelve un valor de verdad slo si ambas son ciertas.

    OR Es el "o" lgico. Evala dos condiciones y devuelve un valor de verdad si alguna de las dos es cierta.

    NOT Negacin lgica. Devuelve el valor contrario de la expresin.

    Comparacin:

    Operador Uso

    < Menor que

    > Mayor que

    Distinto de

    = Mayor Igual que

    = Igual que

    BETWEEN Utilizado para especificar un intervalo de valores

    LIKE Utilizado para comparar de un modelo, solo para cadenas de texto.

    IN Utilizado para especificar registros de una base de datos.

    Las funciones de agregado se usan dentro de una clusula SELECT en grupos de registros para devolver un nico valor que se aplica a un grupo de registros.

  • Notas del asistente: Gua Curso Editores 29

    Funcin Descripcin

    AVG Utilizada para calcular el promedio de los valores de un campo determinado.

    COUNT Utilizada para devolver el nmero de registros de la seleccin.

    SUM Utilizada para devolver la suma de todos los valores de un campo determinado

    MAX Utilizada para devolver el valor ms alto de un campo especificado

    MIN Utilizada para devolver el valor ms bajo de un campo especificado

    2.12.2.1 Instrucciones de consulta Son aqullas instrucciones SQL que nos permiten seleccionar un conjunto de registros estableciendo filtros. Para verificar el resultado de las instrucciones que a continuacin se mencionan, se debe hacer lo siguiente:

    a) Abrir Aspel-SAE e ingresar al Administrador de Reportes de cualquier mdulo.

    b) Crear un nuevo reporte qr2 desde el botn .

    c) En el Diseador de Reportes, hacer clic en el botn de para agregar un nuevo query. d) Colocar la instruccin dentro del campo destinado para ello, como se aprecia en la figura 2.17.2.1-1.

    e) Al aceptar la consulta, sta se mostrar en el listado, slo bastar seleccionarla y pulsar el botn de Ver datos para conocer el resultado.

    Figura 2.17.2.1-1 Generando un query en el Diseador de Reportes

  • Notas del asistente: Gua Curso Editores 30

    SELECT Selecciona los registros de una tabla. Sintaxis: SELECT * FROM Tabla SELECT Tabla.Campo1, Tabla.Campo2, Tabla.Campo3, FROM Tabla

    Figura 2.17.2.1-2 Ejemplo del query generado

    Seleccionar la consulta creada

    Pulsar el botn para ver los resultados

    Figura 2.17.2.1-3 Resultado del query generado.

  • Notas del asistente: Gua Curso Editores 31

    Ejemplos: SELECT * FROM CLIE01 \* Selecciona todos los registros de la tabla del Catlogo de clientes. SELECT CLIE01.NUM_REG, CLIE01.CCLIE, CLIE01.NOMBRE, CLIE01.LIM_CRED, CLIE01.SALDO FROM CLIE01 \* Selecciona explcitamente los campos: CLIE01.NUM_REG, CLIE01.CCLIE, CLIE01.NOMBRE, CLIE01.LIM_CRED, CLIE01.SALDO del Catlogo de clientes, en vez de mandar llamar todas las columnas con el comodn (*), se recomienda que en lo sumo posible se use el nombre de la tabla y nombre del campo separados por un punto (.) ya que es posible que al escribir una consulta donde se haga referencia a dos tablas y en ambas tablas exista un campo con el mismo nombre se pueda saber a cual se hace referencia. AS Es una funcionalidad del lenguaje que permite establecer un alias a un campo u operacin es decir, llamar a un campo por un nombre distinto del que tiene establecido en su estructura. Sintaxis: SELECT (Tabla.Campo1) AS Alias FROM Tabla Ejemplo: SELECT (CLIE01.LIM_CRED) AS LIMITE_CREDITO FROM CLIE01 \* El campo CLIE01.LIM_CRED se le puede llamar completamente LIMITE_CREDITO. 2.12.2.2 Predicado en consultas Estas consultas son aquellas donde se le indicar una serie de clusulas para que la informacin sea filtrada por criterios especficos. WHERE Se utiliza para indicar criterios de seleccin en relacin a un o ms campos, haciendo uso de operadores lgicos y aritmticos. Sintaxis: SELECT Campos FROM Tabla WHERE Campo [Operador] Criterio Ejemplo: SELECT * FROM CLIE01 WHERE Status = A \* Devuelve todos los registros del Catlogo de clientes que tengan estatus Activo A. ORDER BY Este comando ordena los registros por el campo indicado en un orden especifico, que de forma predeterminada es Ascendente ASC o puede ser Descendente con al indicacin DESC. Sintaxis: SELECT Campos FROM Tabla ORDER BY Campo ASC/DESC

  • Notas del asistente: Gua Curso Editores 32

    Ejemplos: SELECT * FROM CLIE01 ORDER BY NOMBRE ASC \* Devuelve el Catlogo de clientes ordenado alfabticamente. SELECT * FROM CLIE01 WHERE STATUS = A ORDER BY Nombre DESC \* Devuelve el Catlogo de clientes donde STATUS sea Activo A, ordenado alfabticamente, en orden descendente. En este caso se utilizo el operador =, sin embargo se pueden hacer evaluaciones mas especificas con los operadores , , =, etc. SELECT * FROM CLIE01 WHERE SALDO >= 15000 ORDER BY CCLIE ASC \* Devuelve el Catlogo de clientes donde el saldo sea mayor o igual a 15,000, ordenado de forma ascendentemente por la clave. Se pueden hacer bsquedas mas especificas anidndolas por medio de AND. SELECT * FROM CLIE01 WHERE SALDO >= 15000 AND SALDO

  • Notas del asistente: Gua Curso Editores 33

    2.12.2.3 Funciones de Agrupacin Estas funciones permiten agrupar informacin ya sea por igualdad en los datos de los campos o por la aplicacin de alguna funcin aritmtica. Al ser usadas implica que se deben aplicar a cada uno de los campos que se invoquen en la consulta, por lo tanto se va hacer omisin del comodn (*). Algunas de ellas solo son aplicables a campos que tengan algn tipo de datos numrico. GROUP BY Combina los registros con valores idnticos, en la lista de campos especificados, en un nico registro. Para cada registro se crea un valor sumario s se incluyera una funcin SQL agregada, como por ejemplo Sum o Count, en la instruccin SELECT. Sintaxis: SELECT campos FROM tabla WHERE criterios GROUP BY campos del grupo Ejemplo: SELECT FA0TY1.CVE_DOC FROM FA0TY1 GROUP BY FA0TY1.CVE_DOC \* Devuelve una lista agrupada de los documentos generados en las partidas, que se podra comparar con la lista de los encabezados para saber que existen los mismos documentos en un archivo y otro. GROUP BY es opcional. Los valores de resumen se omiten si no existe una funcin SQL agregada en la instruccin SELECT. Los valores Null en los campos GROUP BY se agrupan y no se omiten. No obstante, los valores Null no se evalan en ninguna de las funciones SQL agregadas. Se utiliza la clusula WHERE para excluir aquellas filas que no se desean agrupar, y la clusula HAVING para filtrar los registros una vez agrupados. AVG Calcula la media (promedio) de un grupo de registros. La media calculada por Avg es la media aritmtica (la suma de los valores dividido por el nmero de valores). La funcin Avg no incluye ningn campo Null en el clculo y forzosamente utiliza un alias para el campo. Sintaxis: SELECT AVG (CampoX) AS Alias FROM Tabla Ejemplo: SELECT AVG(CLIE01.SALDO) AS PROM_SALDO FROM CLIE01 \* Devuelve la media o promedio del saldo de los clientes. COUNT Calcula el nmero de registros devueltos por una consulta y forzosamente utiliza un alias para el campo. Sintaxis: SELECT COUNT (CampoX) AS Alias FROM Tabla Ejemplo: SELECT COUNT (FACT01.CVE_DOC) AS CLAVE_DOC FROM FACT01 WHERE FACT01.TIP_DOC = "P" \* Devuelve el numero pedidos que existen en el catlogo de facturas.

  • Notas del asistente: Gua Curso Editores 34

    MIN / MAX Devuelven el mnimo o el mximo de un conjunto de valores contenidos en un campo especifico de una consulta, y forzosamente utiliza un alias para el campo. Sintaxis: SELECT MAX (CampoX) AS Alias FROM Tabla SELECT MIN (CampoX) AS Alias FROM Tabla Ejemplo: SELECT MAX (CLIE01.SALDO) AS Max_SALDO FROM CLIE01 \* Devuelve el registro de clientes que tenga el mayor saldo y se puede hacer lo contrario usando la funcin MIN. SUM Devuelve la suma del conjunto de valores contenido en un campo especfico de una consulta y forzosamente utiliza un alias para el campo. Sintaxis: SELECT SUM (campoX) AS Alias FROM tabla Ejemplo: SELECT SUM(CLIE01.SALDO) AS TOTAL_SALDO FROM CLIE01 \* Devuelve la suma del saldo de todos los clientes, en un campo llamado TOTAL_SALDO. As como las funciones AVG, SUM, MIN y MAX, tambin existen algunas otras funciones de tipo estadstico. HAVING Especifica qu registros agrupados se muestran en una instruccin SELECT con una clusula GROUP BY. HAVING es similar a WHERE, que determina los registros que se seleccionan. Despus de que los registros se agrupen con GROUP BY, HAVING determina qu registros se muestran. Sintaxis: SELECT campos FROM tabla WHERE criterios GROUP BY campos HAVING FUNCION(criteriosdegrupo) Ejemplo: SELECT FA0TY1.TIP_DOC, FA0TY1.CVE_DOC, COUNT(FA0TY1.CVE_ART) AS DOCTOS FROM FA0TY1 GROUP BY FA0TY1.TIP_DOC, FA0TY1.CVE_DOC HAVING COUNT(FA0TY1.CVE_DOC) = "2" \* Toma del archivo de partidas, aquellos registros que contienen nicamente 2 partidas, y los agrupa por Tipo de Documento y Clave del Documento y colocando en una tercera columna el nmero de partidas que est contando, si se desea, se puede modificar el valor 2 para verificar los resultados.

  • Notas del asistente: Gua Curso Editores 35

    2.12.2.4 Operadores especiales IN Es ocasiones es necesario la recuperacin de informacin que se encuentra contenida en una tabla que no se encuentra en la base de datos que ejecutar la consulta o que en ese momento no se encuentra abierta, esta situacin la podemos solventar con la palabra reservada IN. Sintaxis: SELECT Campos FROM Tabla IN Valores/Tabla/Ruta Tipo SELECT * FROM CLIE01 WHERE Nombre In ('Gruas y Maniobras Madrid S.A.') \* Busca los registros que contengan en el campo nombre cualquiera de las coincidencias indicadas. 2.13 Parmetros en las consultas En ocasiones es necesario que el usuario proporcione algn dato mediante una ventana de captura que complemente las condiciones para emitir el Reporte de acuerdo a los requerimientos. Para ello, en la definicin de un query es posible recibir parmetros en base a tres posibles criterios: un valor fijo, un dato capturado por el usuario o un campo como resultado de otra consulta previa. Para identificar cuando un query hace referencia a algunos parmetros, al ingresar a la configuracin de la Bases de datos, seleccionar un query, y consultar sus propiedades, un parmetro puede distinguirse por los dos puntos que le anteceden al nombre del campo.

    Ejemplo: Se requiere imprimir un reporte con datos especficos pero por cada cliente, para ste caso, se agrega la siguiente instruccin:

    SELECT * FROM CLIE01 WHERE CCLIE =:CLAVE_CLIENTE

    El campo CLAVE_CLIENTE es un campo que se espera adopte su valor de acuerdo a la definicin establecida para dicho parmetros.

    Figura 2.18-1 Definicin y asignacin de valor a los parmetros de un query

  • Notas del asistente: Gua Curso Editores 36

    Las tres posibilidades para asignar el valor a un Parmetro son: Valor Al seleccionar Valor, se deber especificar un valor de acuerdo al tipo de datos que se haya seleccionado.

    Verificar datos antes de imprimir El dato ser solicitado mediante una ventana al usuario, pidiendo el valor de acuerdo al tipo de datos seleccionado en los parmetros de la variable.

    Asignar valor desde el conjunto de datos maestro El parmetro tomar su valor de acuerdo al conjunto de registros que fueron resultado del otro query maestro asignando el query a que pertenece el parmetro. Es decir, se crea una dependencia del query en que se utiliza el parmetro de un query anterior o con mayor prioridad.

    2.14 Exportacin de un reporte o documento a formato PDF Una caracterstica importante que se incluy en Aspel-SAE 4.0 mediante el Editor de reportes es la exportacin a formato PDF, el cual permite enviar un Reporte con una mejor presentacin. Un ejemplo de su uso puede ser el envo de una cotizacin a un cliente. Para poder hacer uso de esta caracterstica es necesario que se utilice un formato qr2 para la emisin del

    documento o reporte., cuando se tenga la vista preliminar, se debe hacer clic en el botn . A continuacin el sistema presentar el dilogo Salvar reporte donde se deber especificar el directorio y nombre para guardar el archivo y el tipo, que en ste caso ser PDF.

    Figura 2.19-1 Exportacin a formato PDF de una cotizacin.

  • Notas del asistente: Gua Curso Editores 37

    2.15 Modificar un reporte Consiste en poder modificar cualquiera de los reportes que ya estn previamente configurados y se puede modificar un reporte de acuerdo a las necesidades de informacin. Por ejemplo, supngase que se requiere modificar el reporte que se utiliza para la impresin de facturas digitales, llamado Emisin de facturas digitales.qr2 de Aspel-SAE para agregar a los datos del cliente los datos de CODIGO, TELEFONO, COLONIA, los cuales no se estn desplegando en el formato por omisin. Existen dos formas para poder modificar un reporte qr2:

    1. Generar un query dinmico con un formato para Factura Electrnica a) En Aspel-SAE, acceder al Administrador de reportes desde el modulo de Facturas y Vendedores, se

    elige el reporte Facturas Digitales y con el botn se podr modificar.

    b) Ya desde el diseador de reportes y en la barra de herramientas seleccionar la opcin Configuracin

    de base de datos agregar nuevo query.

    Figura 2.19-2 Seleccionando el tipo de documento.

    Seleccionar el tipo PDF

    Figura 2.20-1 Modificacin de un formato preestablecido.

  • Notas del asistente: Gua Curso Editores 38

    c) Indicar la instruccin SQL: SELECT CODIGO, TELEFONO, COLONIA FROM CLIE01 WHERE CCLIE=

    :CVE_CLPV, en el botn de parmetros indicar para el campo CVE_CLPV la opcin Asignar valor desde el conjunto de datos maestro y para la lista desplegable de la tabla Maestra indicar el valor dtsFacturasDeta.

    d) Guardar el query y desde la nueva tabla disponible de nombre CLIENTES seleccionar los campos COLONIA, CODIGO, TELEFONO del nuevo query que se gener en el paso C, y arrastrarlo hasta la seccin de detalle de partidas del reporte qr2 en el lugar campo de descuento.

    Figura 2.20-2. Creacin nueva consulta y asignacin del valor.

    Se asigna nombre al Query.

    Se escriben las instrucciones del el Query.

    Se asigna el conjunto de datos maestro.

  • Notas del asistente: Gua Curso Editores 39

    Qu se logra con las acciones anteriores?, al momento de escribir el query SELECT CODIGO, TELEFONO, COLONIA FROM CLIE01 WHERE CCLIE= :CVE_CLPV, se est indicando que de la tabla CLIE01, se muestren los campos de CODIGO, TELEFONO y COLONIA, donde el campo CCLIE (que contiene la clave del cliente) tome el valor del campo CVE_CLPV que proviene del query o tabla llamada dtsFactElec (que es el conjunto de datos maestro), de tal forma que cuando la factura sea emitida al cliente 8, nicamente se tomarn los datos de dicho cliente para los campos de CODIGO, TELEFONO y COLONIA. Prctica 3: Modificacin de un reporte de Facturas Digitales utilizando consultas dinmicas. Modificacin del reporte Emisin de facturas digitales.qr2 con la adicin de los siguientes elementos adicionales:

    Datos del consignatario (cuando en el campo CONSIGNAR colocamos una clave de cliente a donde se va a enviar la mercanca), dichos campos deben ser colocados en la cabecera.

    Informacin aduanera de cada producto, que incluye Nombre de la aduana, Fecha y Nmero de pedimento.

    Una funcin para sumar el nmero de artculos. Observaciones del documento.

    Para ello:

    a) Acceder al Administrador de reportes, modificar el reporte de Emisin de Facturas digitales.qr2 y desde la barra de herramientas seleccionar la opcin 'Configuracin de base de datos' y agregar un nuevo query. En nombre de la consulta se deber poner Consig.

    b) Indicar la instruccin SQL: SELECT * FROM CLIE01 WHERE CCLIE =:CVE_CONS En el botn de parmetros indicar para el campo CVE_CONS la opcin 'Asignar valor desde el conjunto de datos maestro' y para la lista desplegable de la tabla 'Maestra' indicar el valor 'dtsFactElect'.

    c) Guardar el query y agregar uno nuevo. d) En nombre de la consulta se deber poner Clientes. e) Indicar la instruccin SQL: SELECT * FROM CLIE01 WHERE CCLIE =:CVE_CLPV

    En el botn de parmetros indicar para el campo CVE_CLPV la opcin 'Asignar valor desde el conjunto de datos maestro' y para la lista desplegable de la tabla 'Maestra' indicar el valor dtsFactElect

    f) Guardar el query y agregar uno nuevo. g) En nombre de la consulta se deber poner Inventarios h) Indicar la instruccin SQL: SELECT * FROM INVE01 WHERE CLV_ART =:CVE_ART

    En el botn de parmetros indicar para el campo CVE_ART la opcin 'Asignar valor desde el conjunto de datos maestro' y para la lista desplegable de la tabla 'Maestra' indicar el valor dtsParCFD

    i) Guardar el query y agregar uno nuevo. j) En nombre de la consulta se deber poner Pedimentos

    Figura 2.20-3 Seleccin de los campos

  • Notas del asistente: Gua Curso Editores 40

    k) Indicar la instruccin SQL: SELECT * FROM LTPD01 WHERE CVE_ART =:CVE_ART En el botn de parmetros indicar para el campo CVE_ART la opcin 'Asignar valor desde el conjunto de datos maestro' y para la lista desplegable de la tabla 'Maestra' indicar el valor dtsParCFD

    l) Guardar el query y agregar uno nuevo. m) En nombre de la consulta se deber poner Obs_Fact n) Indicar la instruccin SQL: SELECT OBS_FACT FROM FACT01 WHERE CVE_DOC =:CVE_DOC

    En el botn de parmetros indicar para el campo CVE_DOC la opcin 'Asignar valor desde el conjunto de datos maestro' y para la lista desplegable de la tabla 'Maestra' indicar el valor dtsFactElect

    o) En nombre de la consulta se deber poner Observ p) Indicar la instruccin SQL: SELECT * FROM OFAC01 WHERE NUM_REG = :OBS_FACT

    En el botn de parmetros indicar para el campo OBS_FACT la opcin 'Asignar valor desde el conjunto de datos maestro' y para la lista desplegable de la tabla 'Maestra' indicar el valor Obs_Fact.

    q) Guardar los querys.

    Consig Este query se utiliza para poder colocar los datos del consignatario en la factura, ya que enlaza la tabla de clientes en el campo de la clave del cliente, con un campo en la tabla de facturas llamado CVE_CONS. Clientes Se utiliza para traer datos adicionales del cliente, por ejemplo, datos de los campos libres. Inventarios Se utiliza para traer datos adicionales de inventarios por ejemplo, datos de los campos libres. Pedimentos Para traer el pedimento correspondiente a cada producto. Obs_Fact La razn de colocar sta consulta, es por que en el query que viene por default de nombre dtsFactElect no muestra el campo de OBS_FACT, de sta forma se enlaza dicha consulta con la tabla principal de las facturas por medio de su clave de documento. Observ Se coloco para traer el dato de la observacin de la tabla OFAC01 y que se relaciona en la factura.

    r) En la banda Datos adicionales de CFD se debera agregar una etiqueta TOTAL DE ARTICULOS y un campo calculado con la siguiente expresin SUM(dtsParCFD.CANT), as como el campo X_OBSERV que se gener en el query del inciso p, arrastrarlo hasta esta seccin poniendo como etiqueta Observaciones del documento.

    El reporte debe reflejarse como el que se muestra en la figura 2.20-4.

  • Notas del asistente: Gua Curso Editores 41

    Figura 2.20-4: Ejemplo del repote modificado para factura electrnica.

  • Notas del asistente: Gua Curso Editores 42

    Figura 2.20-5: Ejemplo del resultado del reporte.

  • Notas del asistente: Gua Curso Editores 43

    3. EDITOR DE FORMATOS (*.FTO)

    3.1 Definicin Para la elaboracin de un reporte en el editor de formatos, se tiene una serie de comandos, frmulas, campos y operadores, cada uno de ellos puede variar dependiendo del sistema en que se est elaborando dicho formato. En las versiones Aspel-NOI 4.0 y Aspel-PROD 2.0 se podrn generar reportes con la estructura de los formatos tradicionales FTO desde la opcin reportes del usuario, as mismo desde el administrador de reportes con los sistemas Aspel-BANCO 3.0, Aspel-COI 5.0, y Aspel-SAE 4.0. Adicionalmente podrs consultar y generar reportes con formato FTO utilizando los comandos y campos del editor de formatos tradicional. Dentro de esta gua se explica de manera general el uso del editor en cualquiera de los sistemas, las particularidades que puedan tener cada uno de los sistemas se explicar en su momento. 3.2 Conceptos bsicos

    Campo. Un campo es un espacio que guarda la informacin de los archivos de datos del sistema en uso.

    Ciclo. Permite recorrer los archivos de datos del sistema en uso, con la peculiaridad de que se definen una sola vez y se ejecutan cuantas veces sea necesario.

    Formato. Un formato se compone de una serie de instrucciones a travs de las cuales se le indica al

    sistema que ejecute los comandos, ciclos y campos definidos dentro del mismo y se representa en pantalla o impresora.

    Comando: Es una palabra que el sistema reconoce como una orden y la ejecuta.

    Longitud: Tamao que tiene cada uno de los campos determinado en nmero de caracteres. La longitud

    puede ser definida de acuerdo al campo, o en campos numricos se utiliza una longitud definida por una mscara.

    3.3 Caractersticas del editor de formatos

    Los sistemas Aspel reconocen en su editor de formatos a los archivos con la extensin *.FTO ya que facilita su localizacin.

    Existen dos maneras de ejecutar un formato:

    a. En lnea: Dentro de los mdulos de los sistemas, cuando se graba un documento, a continuacin muestra la ventana de: emisin de documentos, nombre del formato (ya sea el sugerido por el sistema el que se haya diseado) y la ruta donde se encuentra el mismo. Tambin dentro de esta ventana de emisin de documentos se tiene la opcin de editar un formato.

    b. Men de REPORTES: Al elegir la opcin emisin de documentos, muestra la ventana de emisin de reportes, en la cual se podr elegir entre varias opciones de filtrado para la emisin, adems el nombre del formato y la ruta donde se encuentra el archivo *.FTO.

    Permite utilizar la mayora de los campos que contiene el sistema en la edicin de los formatos, algunos

    de ellos ya tienen clculos definidos. Cuenta con campos libres, en los cuales se pueden realizar operaciones de clculo o de asignacin de

    valores que facilitan el diseo del formato.

    Los comandos se encuentran en espaol, los cuales permitirn controlar y procesar los datos, todos ellos tambin reconocidos por el sistema por las tres primeras letras que forman su nombre y aceptando indistintamente maysculas o minsculas.

  • Notas del asistente: Gua Curso Editores 44

    Se utiliza una aplicacin asociada para la edicin de cualquier formato, este puede ser cualquier editor de textos, por ejemplo:

    - Bloc de notas - Edit.com

    Los campos que se utilizan dentro del editor de formatos, pueden cambiar de una versin a otra, de un sistema a otro e incluso de un modulo a otro.

    La estructura que contiene el editor de formatos es igual para todos los sistemas. La razn social se imprime automticamente en cualquier formato del sistema que este en uso, esto es

    por proteccin del sistema adquirido. 3.4 Estructura general de los formatos Todos los formatos que instalan los sistemas contienen esquemticamente la misma distribucin, esta es:

    a. Parmetros del reporte. b. Encabezados. c. Contenido del reporte. d. Totales.

    3.4.1 Parmetros del reporte Se indica al sistema las caractersticas generales que tendr el reporte, como son: nmero de caracteres, tipo de letra, definicin de la mscara para las cantidades, dispositivo de salida del formato, etc.

    2.4.1.1 Parmetros del reporte 3.4.2 Encabezados Define las cualidades del encabezado que lleva el reporte, como la lnea divisoria, titulo del reporte, textos, espacios entre stos y las lneas, etc.

    Parmetros del Reporte

    3.4.1-1 Parmetros del reporte.

    Encabezados

    3.4.2-1 Encabezados del reporte

  • Notas del asistente: Gua Curso Editores 45

    3.4.3 Contenido del reporte y/o partidas y ciclos Define los campos que mostrar el contenido del reporte, es decir, los valores a emitir, con los clculos que se quieran aadir y las especificaciones o textos complementarios que acompaen a dichas cantidades. 3.4.4 Totales Esta es la ltima parte de un formato, la definicin de los totales en un reporte, muestra las cantidades correspondientes y las anotaciones finales que se quieran incluir, como una firma, una raya, etc. Dentro de esta estructura, existen comandos que se utilizan con mayor frecuencia dentro de cierta parte del formato, algunos otros se utilizan indistintamente en cualquier parte del formato. 3.5 Edicin de formatos La edicin de formatos permite al usuario poder utilizar los campos definidos por el sistema, as como realizar operaciones utilizando los operadores y campos utilizando los comandos adecuados. Para ello se procede a realizar una lista de los operadores, y los comandos as como una lista de los ciclos que se manejan en cada uno de los sistemas. 3.5.1 Operadores Para realizar clculos sobre el contenido de ciertos campos, el editor cuenta con los siguientes operadores: Operadores Aritmticos y Operadores Lgicos.

    Contenido del reporte

    3.4.3-1 Contenido del reporte y/o partidas y ciclos

    Totales

    3.4.4-1 Totales

  • Notas del asistente: Gua Curso Editores 46

    3.5.1.1 Aritmticos Nos permiten realizar operaciones numricas con las variables.

    Operadores aritmticos

    + Suma

    - Resta

    * Multiplicacin

    / Divisin

    3.5.1.2 Lgicos Se usan en combinacin de los operadores de comparacin cuando la expresin de la condicin lo requiere.

    Operadores lgicos

    And Y

    Or O

    ! No

    3.5.1.3 Comparacin Se utilizan principalmente en nuestras condiciones para comparar dos variables y verificar si cumple o no la propiedad del operador.

    Operadores de comparacin

    == Igualdad

    != Desigual

    < Menor que

    Mayor que

    >= Mayor igual que

    3.5.2 Campos Los campos estn organizados por cada sistema, en algunos casos por mdulo y estn clasificados por nmero y con una longitud. Existen dos tipos de campos:

    a. Campos asignados por el sistema. b. Campos libres numricos y alfanumricos.

    3.5.2.1 Campos asignados por el sistema Todos los campos asignados por el sistema contienen informacin especfica de los catlogos y funciones, en algunos sistemas, los campos pueden estar divididos por mdulos como seria el caso del sistema Aspel-SAE, esto tiene como finalidad que las consultas de los campos sea ms rpida y sencilla. 3.5.2.2 Campos libres numricos y alfanumricos Los campos libres numricos se pueden utilizar para poder asignar algn valor o realizar alguna operacin y el resultado se guarde en esa variable o campo. Los campos libres alfanumricos adems de poder determinar o asignar algn texto y el valor, se pueden utilizar para solicitar informacin al momento de la emisin del reporte.

  • Notas del asistente: Gua Curso Editores 47

    3.5.3 Comandos con sintaxis A continuacin se muestra una lista en orden alfabtico de todos los comandos con un ejemplo de cmo se pueden utilizar, cabe sealar que algunos comandos son especficos de cada sistema y por tal motivo no se pueden emplear para otros sistemas.

    Descripcin Ejemplos de Sintaxis

    Ajusta Ajusta 50

    Ancho_Carcter Ancho_Caracter 10

    Asigna Asigna , [100-001F] + /12

    Brinca Brinca

    Caracteres Caracteres 80

    Centra Centra 80,

    Comentarios Comentarios "-BALANCE-"

    Correo Correo

    Dato Dato , CUENTA INICIAL ->

    Define Define

    Disco Disco

    Encabezados Encabezados

    Escribe Escribe 5, Descripcin, 15,

    Fencabezados Fencabezados

    Fin Fin

    Font Font Arial, 12

    Impresor Impresor 2

    Inicia Inicia Factura

    Mascara Mascara "###,###,###.##"

    Pantalla Pantalla

    Raya Raya 4,5, "-"

    Redondeo Redondeo

    Salta Salta 1

    Si Si = 0

    Sifn Sifn

    Sino Sino

    Termina Termina

    Tipo Tipo 1

    Traduce Traduce 45, , "E", "PESO / PESOS"

  • Notas del asistente: Gua Curso Editores 48

    Frmulas del editor Ejemplos de Sintaxis

    @SI[Cond., Verdad, Falso] @SI[ > , 10, /210]

    @RED[Valor, Redondeo] @RED[,1]

    @CTA[Cuenta,Subfijo] @CTA[100-001,F]

    @CTA[Cuenta,Subfijo,Dpto] @CTA[100-001,F,1]

    @CTA[#Campo1>,,Subfijo] @CTA[,,F]

    @CTA[,,Subfijo,Dpto] @CTA[,,F,1]

    @CTA[Cuenta1,Cuenta2,Subfijo] @CTA[100-001,500-001,F]

    @CTA[Cuenta1,Cuenta2,Subfijo,Dpto] @CTA[100-001,500-001,F1]

    @RAN[Cuenta1..Cuenta2,Sufijo] @RAN[2100-000..2199-999,F]

    @INPC[Mes,Ao] @INPC[12,2003]

    @RAN[R#rango,Subfijo] @RAN[R11,F]

    @MFC[campo, "Formato", "Idioma" (E o I)" ] @MFC[ ,"dd/mm/aa","E"]

    @SUBCADENA[Cadena,Desde,Cuantos] @SUBCADENA[,5,7]

    @SDIARIO[No.cuenta] @SDIARIO[100-002]

    @DEPRECIA[,,, ,,]{Periodo}

    @DEPRECIA[T1,0199,0199,C,0199,1299]

    @DEPRECIAC[,,, ,,]{Periodo}

    @DEPRECIAC[T1,0199,0199,O]

    @EMPRESA[Sufijo] @EMPRESA [E]

    Abre Su funcin es indicarle al sistema el periodo que se va a trabajar, de manera que abra los archivos correspondientes a dicha fecha. Es muy til, ya que permite procesar datos de una fecha diferente a la que se est trabajando. Sintaxis:

    ABRE MMAA (sin comillas) ASPEL-COI ABRE DDMMAA (con comillas) ASPEL-NOI

    Ubicacin:

    Parmetros. Funciona en:

    Aspel-NOI y Aspel-COI. Ajusta A travs de este comando, permite indicarle al sistema que comience a escribir las partidas o movimientos a partir de determinada lnea que indiques. Es til sobre todo cuando los encabezados difieren en longitud, en cuanto a lneas de impresin. Sintaxis:

    Ajusta (Rengln de posicin del cursor) Ubicacin:

    Encabezados y Totales. Funciona en:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD.

  • Notas del asistente: Gua Curso Editores 49

    Ancho_Caracteres Este comando permite delimitar el ancho que tendr una cadena de caracteres, pero no trunca lo escrito, sino que contina en la lnea de abajo. Sintaxis:

    Ancho_Caracteres (Nmero de caracteres) Ubicacin:

    Parmetros, Encabezados, Partidas y Totales. Funciona en:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD Asigna Con este comando se puede asignar un valor a una variable libre, el resultado de la operacin, un clculo o bien datos alimentados a travs de otro comando llamado dato o asignar el contenido de otra variable. Sintaxis:

    Asigna , o dato o clculo o texto

    Ubicacin: Encabezados, Partidas y Totales.

    Funciona en: Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

    Brinca Este comando indica al sistema que cambie hasta el inicio de la siguiente pgina, es decir, saltar las lneas que queden entre la ltima lnea impresa y el inicio de la siguiente pgina. Este comando se define una sola vez, al final del formato, antes del comando FIN, con la finalidad de que la impresin no se desfase entre un documento y otro. Sintaxis:

    Brinca

    Ubicacin: Totales.

    Funciona en: Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

    Caracteres Este comando le indica al sistema la columna hasta la cual debe imprimir, dependiendo del tipo de letra que se tenga definido. Es idntico al de Ancho_Caracteres, con la diferencia de que corta la cadena de caracteres. Sintaxis:

    Caracteres (Nmero de caracteres)

    UBICACIN: Parmetros, Encabezado, Partidas y Totales.

    FUNCIONA EN: Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

  • Notas del asistente: Gua Curso Editores 50

    Centra La funcin de este comando es la de centrar un texto o contenido de una variable dentro de un documento. Sintaxis:

    Centra (Total de caracteres en que se va a centrar), "Texto" o

    UBICACIN: Encabezado y Totales.

    FUNCIONA EN: Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

    Comentarios Es recomendable que al momento de elaborar un formato, este se vaya documentando de acuerdo a su estructura; es decir, describiendo para qu sirve cada parte del formato. Al editar un formato, podemos observar que muestra los pasos en los que esta dividido para la impresin, por ejemplo: Definicin de encabezados, Inicio de partidas, etc. Cuando se documenta un formato, le estamos permitiendo a un futuro usuario entender ms rpidamente el funcionamiento y secuencia que seguir el sistema para ejecutarlo. Sintaxis:

    Comentarios (Texto) \ (Texto) BICACIN:

    Parmetros, Encabezados, Ciclos y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Correo Al definir este comando en un formato, el sistema solicita un nombre para generar un archivo con el resultado del formato y al mismo tiempo abre la aplicacin de correo electrnico que se tiene definida en la PC e incluye en un e-mail el archivo creado. Sintaxis:

    Correo UBICACIN:

    Parmetros FUNCIONA EN:

    Aspel-SAE. Dato Permite capturar datos al momento de emitir un formato. Los datos capturados pueden usarse para imprimirlos directamente o para realizar clculos u operaciones que realice el sistema de manera interna. Cabe mencionar que los datos no quedan registrados en el archivo, ni dentro del formato. Sintaxis:

    Dato , (Longitud del campo) , "Nombre del campo" UBICACIN:

    Parmetros, Encabezados y Partidas. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

  • Notas del asistente: Gua Curso Editores 51

    Escribe El comando escribe tiene como finalidad mandar a impresin el contenido de una variable, texto u operacin realizada dentro del reporte, para ello es muy importante definir la columna donde inicia la impresin de estos datos para no tener problemas de que se desfase el reporte. Sintaxis:

    Escribe (Nmero de columna), o Valor o "Texto" UBICACIN:

    Encabezados, Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD Fencabezados Este comando indica que se a terminado de definir las instrucciones del contenido del encabezado. Sintaxis:

    Fencabezados UBICACIN:

    Encabezados. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

    Fin Este comando da por terminada la definicin del formato, por lo que se define en la ltima lnea del formato. Si se definen despus de este comando otras instrucciones, el sistema las va a ignorar. Sintaxis:

    Fin UBICACIN:

    Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD Font Este comando permite manejar diferentes tipos y tamaos de letra. Permite darle una mejor presentacin al reporte. Sintaxis:

    Font "Tipo de letra", Tamao UBICACIN:

    Parmetros, Encabezados, Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD

  • Notas del asistente: Gua Curso Editores 52

    Impresor El comando impresor manda el contenido del formato a papel, es decir, enva el reporte a un impresor. Sintaxis:

    Impresor (Nmero de Impresor o Nombre del impresor) UBICACIN:

    Parmetros.

    FUNCIONA EN: Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD.

    Inicia El comando inicia se define dentro de las partidas y tiene como finalidad realizar la lectura del ciclo definido y con ello ejecutar las instrucciones definidas, por cada inicia que se utilice se debe definir un termina. Sintaxis:

    Inicia (Nombre del ciclo) UBICACIN:

    Partidas. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Mscara Tiene como finalidad que al momento de mandar a impresin cantidades o sus respectivos montos estos sean definidos despus de este comando, se toma en cuenta la distribucin de las comas y puntos. Sintaxis:

    Mascara UBICACIN:

    Parmetros, Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Pantalla Con este comando tambin se puede ver el resultado del reporte en una presentacin preliminar. Para ello es recomendable utilizar este comando antes de enviar un reporte a impresin, lo que permite verificar que la informacin sea la correcta. Sintaxis:

    Pantalla UBICACIN:

    Parmetros. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD.

  • Notas del asistente: Gua Curso Editores 53

    Raya La funcin de este comando es repetir varias veces un carcter al momento de mandar a impresin el formato, partiendo de la columna que se indico y del nmero de veces que se especifique. Sintaxis:

    Raya (Nmero de columna), (# de veces que debe repetirse), "Carcter a imprimir"

    UBICACIN:

    Encabezados, Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Redondeo La finalidad es que todas las cantidades o cifras sean redondeadas. Las variables a las que se puede realizar el redondeo son a todos los campos numricos definidos por el sistema y las variables numricas definidas por el usuario utilizando el comando asigna. No se podr redondear directamente un clculo, primero se tiene que asignar a una variable. Sintaxis:

    Redondeo , (Precisin) UBICACIN:

    Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Salta Su funcin es indicar al sistema que deje un espacio dependiendo del nmero de lneas de impresin. El sistema avanza el nmero de lneas indicado, menos una, es decir, si se especifica Salta 3, el sistema solo dejara 2 lneas en blanco. Se debe de tener cuidado en definir el nmero de lneas a saltar, de manera que no exceda el tamao del reporte. Sintaxis:

    Salta (Nmero de lneas) UBICACIN:

    Parmetros, Encabezados, Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Si Este comando se utiliza para iniciar un condicional o comparacin dentro del formato. Es recomendado cuando se necesita que una serie de acciones se ejecuten para un cierto nmero de elementos que cumplan con el requisito definido, este comando puede ir acompaado por el comando sino y por cada comando si debe de llevar un sifin. Sintaxis:

    Si (operador lgico) o (valor a comparar) u operacin

    UBICACIN:

    Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD.

  • Notas del asistente: Gua Curso Editores 54

    Sino La funcin del comando sino es para indicar que si no se cumpli la primera condicin ejecuta otras. Sintaxis :

    Sino UBICACIN:

    Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Sifin Indica el final de las instrucciones que conforman la condicional y es necesario especificarla siempre, para que el sistema sepa que termina la condicional. Sintaxis:

    Sifin UBICACIN:

    Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Termina Concluye con la lectura del ciclo, por lo que junto con las instrucciones y operaciones definidas desde el comando inicia, con ello termina la impresin e los movimientos. Sintaxis:

    Termina (Nombre del ciclo) UBICACIN:

    Partidas. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. Tipo Determina el tipo de letra que va a ser utilizando para la impresin, a diferencia del comando font, este comando utiliza el tipo de letra que esta definido en las propiedades del impresor. Sintaxis:

    Tipo (1 o 2) UBICACIN:

    Parmetros, Encabezados, Partidas y Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD.

  • Notas del asistente: Gua Curso Editores 55

    Traduce La funcin de este comando es el de convertir o traducir el contenido de un campos numrico en letra, realizando esta traduccin en dos idiomas que son el Ingles y el espaol. Sintaxis:

    Traduce (Nmero de columna), , "E"spaol o "I"ngls, "MONEDA/MONEDAS"

    UBICACIN:

    Totales. FUNCIONA EN:

    Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD. 3.6 Ciclos de lectura Cada sistema cuenta con sus propios ciclos, en los cuales permite la lectura de los registros y que estos se vayan leyendo de acuerdo a los diferentes campos. En algunos sistemas no hay restriccin de en cuanto al uso de manejar varios ciclos. Ciclos definidos en BANCO

    MOV (Movimiento) Es utilizado dentro de los formatos de reportes de movimientos y representa el ciclo base para la generacin del reporte. POL (Pliza) Se utiliza para obtener informacin de las plizas con las que se contabilizo el movimiento bancario y slo se usa para los formatos de reportes de movimientos. PAR (Partida de la pliza) Se utiliza para la impresin de las plizas de egresos cuando al momento de contabilizar en lnea los cheques y en los reportes de movimientos. Para el segundo caso es indispensable que exista el ciclo POL. MOVPAR (Partidas de movimientos) Este ciclo es empleado para poder obtener un desglose por cada uno de los movimientos que se hayan realizando, presentando cada uno de los conceptos que se hayan utilizado en el movimiento.

    CHQPAR (Partidad por cheque) Se puede emitir en el formato de un cheque normal, mostrando adems en forma desglosada cada uno de los conceptos involucrados en l.

    Ciclos definidos en COI

    AUX (Auxiliar) Lee el archivo de auxiliares, en cua