Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Editar Formatos FTO para Aspel SAE
Editar Formatos FTO para Aspel SAE
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
NDICE
1.
INTRODUCCIN.............................................................................................................................................. 1
1.1
1.2
2.
Definicin .................................................................................................................................................. 1
Objetivo del curso.................................................................................................................................... 1
EDITOR DE REPORTES..................................................................................................................................... 3
2.1
2.2
2.3
2.4
2.5
2.6
Generales ................................................................................................................................................... 3
Editor grfico de reportes (qr2)............................................................................................................. 3
Conceptos bsicos.................................................................................................................................... 3
Estructura general de un reporte........................................................................................................... 4
Barra de herramientas ............................................................................................................................. 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.
Definicin ................................................................................................................................................43
Conceptos bsicos..................................................................................................................................43
Caractersticas del editor de formatos...............................................................................................43
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
1
Tips de uso.
Tipo de reporte.
Ruta de acceso.
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.
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.
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
Aspel-SAE 3.0
2.2
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
Editor de notas
Ruta de acceso: En Aspel-SAE 4.0 desde cualquier mdulo a Reportes/Administrador de Reportes, en AspelBANCO 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.
Campos
Clave
Registros
Direccin
Telfono
Nombre
53-96-85-78
Calle Xola 14
56-84-96-10
58-43-31-44
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.
Como se puede observar las secciones de un reporte se manejan por medio de bandas, cada una de ellas tienen
una funcin diferente.
Encabezado
del reporte
Detalle
Pi del
Reporte
Ahora bien, para generar un reporte se requiere conocer los elementos de un formato, estos se muestran en la
Figura 2.4.-2
Etiquetas
Bandas
Campos de datos
Figura 2.4-2 Elementos del formato
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.
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.
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.
1.
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.
Figura 2.7-4 Definicin de una condicin para indicar que slo se imprimir si se cumple la condicin.
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.
10
Figura 2.7-5 Ejemplo de banda que slo se imprime al cumplir con una expresin.
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.
Figura 2.7-6 Definicin de las propiedades para la impresin del marco en la banda
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.
11
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.
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.
12
Banda de
Detalle
Banda de
Subdetalle
13
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)
14
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.
15
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.
16
2.8
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
17
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.
18
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.
19
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?"
20
Ver datos
El sistema mostrar el resultado de la consulta definida.
21
22
i)
) seleccionar el Informe de la
j)
k)
Agregar lneas a la banda de Encabezado de columna, superior e inferior, mientras que el grosor de
la lnea ser de 2 puntos.
Al hacer la impresin preeliminar verificar que la banda de encabezado de columna se muestre en
cada una de las hojas.
23
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.
24
r)
s)
t)
Mostrar la vista preliminar y verificar que se muestre el total final de los cargos
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.
Agregar una lnea superior a la ltima banda.
25
26
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.
27
Existen tambin una serie de clusulas las cuales permiten condicionar o filtrar la informacin que se est
consultando o manipulando.
Clusula
FROM
WHERE
GROUP BY
HAVING
ORDER BY
Descripcin
Utilizada para especificar la tabla de la cual se van a seleccionar los registros.
Utilizada para especificar las condiciones que deben reunir los registros que se van a
seleccionar.
Utilizada para separar los registros seleccionados en grupos especficos.
Utilizada para expresar la condicin que debe satisfacer cada grupo
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
AND
OR
NOT
Uso
Es el "y" lgico. Evala dos condiciones y devuelve un valor de verdad slo si ambas son
ciertas.
Es el "o" lgico. Evala dos condiciones y devuelve un valor de verdad si alguna de las dos es
cierta.
Negacin lgica. Devuelve el valor contrario de la expresin.
Comparacin:
Operador
<
>
<>
<=
>=
=
BETWEEN
LIKE
IN
Uso
Menor que
Mayor que
Distinto de
Menor Igual que
Mayor Igual que
Igual que
Utilizado para especificar un intervalo de valores
Utilizado para comparar de un modelo, solo para cadenas de texto.
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.
28
Funcin
AVG
COUNT
SUM
MAX
MIN
Descripcin
Utilizada para calcular el promedio de los valores de un campo determinado.
Utilizada para devolver el nmero de registros de la seleccin.
Utilizada para devolver la suma de todos los valores de un campo determinado
Utilizada para devolver el valor ms alto de un campo especificado
Utilizada para devolver el valor ms bajo de un campo especificado
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.
29
Seleccionar
la consulta
creada
Pulsar el
botn para
ver los
resultados
SELECT
Selecciona los registros de una tabla.
Sintaxis:
SELECT * FROM Tabla
SELECT Tabla.Campo1, Tabla.Campo2, Tabla.Campo3, FROM Tabla
30
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
31
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 <= 50000
ORDER BY CCLIE ASC
\* Devuelve el Catlogo de clientes donde el saldo sea mayor o igual a 15,000 y menor o igual a 50,000, se puede
usar AND para concatenar evaluaciones de campos diferentes. Esta consulta tambin se puedo haber escrito con
el operador BETWEEN.
BETWEEN
Extrae un rango especfico de datos provenientes de algn campo de una tabla.
Sintaxis:
SELECT Campos FROM Tabla
WHERE Campo BETWEEN dato_Inicial AND Dato_Final
Ejemplo:
SELECT * FROM CLIE01
WHERE SALDO BETWEEN 15000 AND 50000
ORDER BY CCLIE ASC
DISTINCT
Omite los registros que contienen datos duplicados en los campos seleccionados. Para que los valores de cada
campo listado en la instruccin SELECT se incluyan en la consulta deben ser nicos.
Sintaxis:
SELECT DISTINCT Campos FROM Tabla
Ejemplo:
SELECT DISTINCT CVE_ART FROM FA0TY1
\* Esta tabla almacena las partidas de las ventas y por lo tanto, al ejecutar esta consulta se eliminarn los
valores repetidos y slo aparecer uno de ellos, para ver la diferencia, se debe ejecutar la sentencia que mostrara
todos los registros, por ejemplo: SELECT CVE_ART FROM FA0TY1 ORDER BY CVE_ART, dicha sentencia mostrar
todos los registros, incluyendo los que se repitan de forma ordenada y se notar la diferencia.
Notas del asistente:
32
33
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.
34
35
Valor
Al seleccionar Valor, se deber especificar un valor de acuerdo al tipo de datos que se haya seleccionado.
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.
Notas del asistente:
36
Seleccionar
el tipo PDF
se podr modificar.
37
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.
Se asigna
nombre al
Query.
Se escriben las
instrucciones
del el Query.
Se asigna el
conjunto de
datos maestro.
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.
38
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
39
k)
l)
m)
n)
o)
p)
q)
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.
40
41
42
3.
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
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.
43
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.
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.
Encabezados
44
Contenido
del reporte
Totales
3.4.4-1 Totales
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.
Notas del asistente:
45
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
<=
Menor igual 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:
46
Ejemplos de Sintaxis
Ajusta 50
Ancho_Caracter 10
Asigna <100>, [100-001F] + <43> /12
Brinca
Caracteres 80
Centra 80, <27>
Comentarios "-BALANCE-"
Correo
Dato <10>, CUENTA INICIAL ->
Define
Disco
Encabezados
Escribe 5, Descripcin, 15, <27>
Fencabezados
Fin
Font Arial, 12
Impresor 2
Inicia Factura
Mascara "###,###,###.##"
Pantalla
Raya 4,5, "-"
Redondeo <100>
Salta 1
Si <34> = 0
Sifn
Sino
Termina
Tipo 1
Traduce 45, <101>, "E", "PESO / PESOS"
47
Ejemplos de Sintaxis
@SI[<34> > <36>, <34>10, <36> /210]
@RED[<34>,1]
@CTA[100-001,F]
@CTA[100-001,F,1]
@CTA[<46>,<47>,F]
@CTA[<46>,<47>,F,1]
@CTA[100-001,500-001,F]
@CTA[100-001,500-001,F1]
@RAN[2100-000..2199-999,F]
@INPC[12,2003]
@RAN[R11,F]
@MFC[ <025>,"dd/mm/aa","E"]
@SUBCADENA[<20>,5,7]
@SDIARIO[100-002]
@DEPRECIA[T1,0199,0199,C,0199,1299]
@DEPRECIAC[T1,0199,0199,O]
@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
ABRE DDMMAA
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.
48
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 <campo libre>, <campo> 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
49
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 <Campo a imprimir>
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 <Nmero de campo>, (Longitud del campo) , "Nombre del campo"
UBICACIN:
Parmetros, Encabezados y Partidas.
FUNCIONA EN:
Aspel-SAE, Aspel-NOI, Aspel-COI, Aspel-BANCO y Aspel-PROD
50
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), <Variable o Campo> 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
51
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.
52
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 <Campo o Variable>, (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 <campo a comparar> (operador lgico) <campo de comparacin> 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:
53
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.
54
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), <Campo numrico>, "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 cual se encarga de localiza la sub-cuenta que tenga movimientos y
efecta los procesos indicados y los imprime al final de la ltima sub-cuenta, o bien, debajo de
cada una de stas; esto depende de cmo se haya ordenado el ciclo Auxiliares dentro del formato.
Este ciclo presenta nicamente los datos de las partidas, no de la pliza completa.
CTA (Cuenta)
Recorre el catlogo de cuentas, en el cual se ubica en la primera cuenta del catlogo, efecta los
procesos indicados y prosigue con la siguiente cuenta hasta que llega al final del archivo.
55
POL (Plizas)
Lee el archivo de plizas, ejecuta los procesos para la pliza en que se ubica y prosigue con la
siguiente hasta terminar de leer todo el.
PAR (Partidas-Plizas)
Al leer una pliza esta se posiciona y lee las partidas posesionndose desde la primera partida de
la pliza, realiza los diferentes procesos solicitados y contina con las siguientes partidas hasta
que llega al final de la pliza.
DP (Departamento)
El sistema recorrer el archivo de las cuentas a travs de los departamentos, esto siempre y
cuando el sistema est configurado para el uso de departamento.
ACT (Activos)
Este ciclo lee el catlogo de activos, es posible crear reportes con la informacin de este catlogo,
el catlogo se recorre en base a la clave del activo.
Ciclos definidos en NOI
TB (Trabajadores)
Su funcin es recorrer el catlogo de trabajadores; iniciando desde la primer clave y realizando los
clculos para ese trabajador. Al terminar, pasa a la siguiente trabajador y repite el proceso hasta
recorrer todos los registros.
PD (Percepciones y Deducciones)
Lee el archivo de percepciones y deducciones en la cual se posiciona en el primer concepto de
percepcin, ejecuta los clculos por trabajador y al terminar pasa a la siguiente percepcin; ejecuta
los mismos procesos anteriores y al terminar con la lectura de las percepciones inicia con los
conceptos de deduccin.
P (Percepciones)
Este ciclo solo lee solo las percepciones que se encuentran definidas en el catlogo de
percepciones y deducciones, ejecutando los clculos solicitados para cada uno de los trabajadores
pasando al siguiente concepto de percepcin hasta terminar con el ltimo concepto definido en
este catlogo.
D (Deducciones)
Al igual que el ciclo anterior este se encargar de leer solo las deducciones desde el primer
concepto registrado en el catlogo de percepciones y deducciones; ejecuta las operaciones
solicitadas por cada uno de los trabajadores y pasa al siguiente concepto de deduccin. Este
proceso se repite hasta leer la ltima deduccin.
Ciclos definidos en PROD
Insumos
Como todos los ciclos que leen desde el primer insumos registrado mostrando los datos
solicitados y continuando al siguiente hasta leer el ltimo insumos registrado en el catlogo.
Procesos
Con este ciclo se puede extraer la informacin de todos los procesos definidos en el sistema
leyendo uno por uno y generando una relacin desde el primer proceso hasta llegar al ltimo
proceso registra dentro de este catlogo.
Sustitut
Este es otro de los catlogos que se manejan en Prod por lo que funciona igual que los dos
anteriores, solo que este muestra desde por medio de las claves una lista de los sustitutos
registrados dentro de este catlogo.
Notas del asistente:
56
Prodterm
La finalidad de este ciclo es recorrer las claves de los productos terminados, recorriendo una a una
las cabezas de los documentos y con ello presentar los registros que conforman al producto
terminado.
Componente (Producto Terminado)
Este ciclo se encarga de leer las partidas o componentes de los productos terminados. Este ciclo va
acompaado del ciclo Prodterm.
Agenda
Este es otro de los ciclos que se debe de definir dentro del ciclo Prodterm, su funcin es presentar
la planeacin de un producto terminado.
Orden
La funcin de este ciclo es leer el archivo de rdenes de produccin y con ello obtener una lista de
todas las rdenes registradas dentro de este archivo.
Seguimiento
Recorre el archivo de seguimiento que se ha empleado en una orden ya que hay que recordar que
esta puede ser de forma directa, por entrada a fabricacin, etc. Solo las rdenes que muestran son
la que cuentan con el estatus de activa.
Programacin
Este ciclo es parecido al de seguimiento, con la diferencia e que este ciclo obtiene la programacin
que se le ha hecho a un orden sin su respectivo seguimiento. Este ciclo debe de ejecutarse dentro
del ciclo de Orden.
Componente (Orden)
Lee las partidas de los componentes de los productos terminados, este ciclo debe de estar definido
dentro del de orden, es igual al de componente ciclo de Orden (producto terminado).
Segxcomp
Con este ciclo se obtiene los movimientos tanto de entrada como de salida al inventario por cada
uno de los componentes, este ciclo debe de ir acompaado de otro ciclo que es componente
(orden).
Ciclos definidos en SAE
Factura, Remisin, Pedido, Cotizacin y Devolucin
Estos cinco ciclos se utilizan dentro del mdulo de Facturacin dependiendo del documento que se
vaya a utilizar, por ejemplo al definir el ciclo de Inicia Factura el sistema ejecuta las instrucciones
solicitadas en la cabeza de los documentos, este proceso lo recorre uno por uno.
Recepcin, Orden y Devolucin
As como el modulo de facturacin cuenta con sus ciclos para cada documento de ventas, el
modulo de compras cuenta con sus respectivos ciclos, que operan de igual forma que los ciclos de
facturacin leyendo o recorriendo las cabezas de los documentos.
Partida
Este ciclo se define dentro de los ciclos mencionados con anterioridad su funcin es que vaya
recorriendo cada una de las partidas, comenzando desde el primer movimiento en el documento y
ejecutando las instrucciones solicitadas para que con ello pase a la siguiente hasta llegar a la
ultima.
57
Serie
El ciclo se utiliza para la lectura de los productos que manejan nmeros de serie por tal motivo
este ciclo se define dentro del ciclo anterior (partida) y su funcin es leer los nmeros de serie que
corresponden a cada producto de la partida.
CLI_PRO
Este ciclo se encarga de leer los registros de clientes y/o proveedores ejecutando las instrucciones
definidas y como todos los ciclos lo hace registro por registro hasta terminar.
DOCTO
Revisa todos los documentos que estn asociados a cada cliente y/o proveedor, ejecutando las
instrucciones solicitadas, este ciclo se recomienda utilizarlo dentro del ciclo CLI_PRO.
Movimiento
Este ciclo consiste en recorrer los movimientos al inventario guindose por el primer concepto
definido en este catlogo, ejecuta las instrucciones requeridas y pasa al siguiente concepto hasta
llegar al ltimo.
Filtro
Este es un auxiliar del ciclo de movimiento y su funcin es llevar un control al momento de
cambio del producto, ambos ciclos van a permitir que los documentos sean ordenados por
producto.
3.7
Generacin de formatos (*.fto)
Una vez terminado de explicar cada uno de los comandos que se pueden utilizar en el editor de formatos para
poder elaborar reportes que se acoplen a las necesidades de la empresa con ayuda de sus respectivos ciclos se
procede a realizar un ejercicio elaborando un formato.
Los sistemas Aspel permiten utilizar un editor de formatos para modificar o crear los formatos de impresin de
documentos y reportes. Esto permite reportar la informacin de la empresa satisfaciendo las necesidades ms
exigentes.
En la ventana que se presenta se puede escoger entre cualquiera de los formatos que se manejan para
renombrarlos (conservando la terminacin .FTO), y as modificar sus parmetros adecundolos a las necesidades
de la empresa.
Desde el administrador de reportes, con el botn
del editor.
58
a) Para este ejercicio se elabora un formato similar al de una factura, para ello es necesario entrar
al sistema de Aspel-SAE y verificar que dentro de las aplicaciones asociadas est configurado el
notepad.exe que se encuentra en Utileras Configuracin Aplicaciones asociadas Editor de
textos.
b) Una vez configurado el sistema, se procede a entrar al mdulo de Facturacin, Men Reportes,
Administrador de reportes, donde se crear el Archivo *.FTO para la emisin de una factura,
primeramente con la Estructura General que se requiere y posteriormente se agregarn
elementos para el uso de la mayora de los comandos.
Indicar que
se agrega un
nuevo fto.
59
com **************************************************
com ***** Definicin de los parmetros del reporte ***
\\ ***************************************************
Pantalla
Mascara "###,###,###.##"
Caracteres 250
Ancho_caracteres 132
Asigna <01>, "/"
Asigna <02>, "PESO/PESOS"
Asigna <04>, "E"
Font "arial",8
com **************************************************
com ****** Definicion de encabezados ****************
com **************************************************
tipo 1
Define_encabezado
Escribe 1, "Curso de Editores"
Asigna <106>,0
Asigna <106>, <106>+1
Escribe 1, "No. de pagina", 15, <106>
Dato <001>, 20,"Dame tu nombre"
Salta 2
Escribe 1,<001>
Salta 2
tipo 2
Raya 1,100,"="
Ajusta 4.5
Fencabezados
com ***************************************************
com **** Definicin de partidas y/o ciclos de lectura**
com ***************************************************
Inicia FACTURA
Encabezado
Ajusta 7
\NUMERO DE LINEAS PARA EL AREA DE PARTIDAS
Asigna <108>,31
\Contador de lineas
Asigna <107>,0
Asigna <199>,0
Asigna <200>,0
\Inicia la impresin de las partidas
Inicia Partida
Asigna <199>,<199>+<072>
Asigna <200>,<200>+1
Si <072> <> 0
\Controla el numero de lineas de la partida
Notas del asistente:
60
61
dos veces para tener el recibo del trabajador y el recibo de acuse para la empresa, cosa que es muy laboriosa para
estar armando los juegos de recibos. Pues el formato solo permite emitir un solo recibo por trabajador como se
muestra en la siguiente imagen.
La solucin es la siguiente:
a) Abrir el Bloc de Notas y escribir el cdigo que se muestra a continuacin:
62
Com ******************************************************************
Com *****
ASPEL MEXICO, S.A. DE C.V.
*****
Com ***** Curso de Editores
*****
Com ***** Formato para la impresin de 2 recibos, sugerido para *****
Com ***** papel de la lnea de formas ASPEL. Enva un recibo *****
Com ***** de 4.7 X 8.5 pulgadas.
*****
Com ***** Para la impresion de este formato, es necesario *****
Com ***** que ajuste el tamao de la hoja en Especificar
*****
Com ***** Impresora / Configurar
*****
Com ***** Las medidas asignadas en centimetros son :
*****
Com ***** Ancho: 21.60
*****
Com ***** Largo: 23.70
*****
Com ***** ASPEL-NOI Windows 4.0
*****
Com ******************************************************************
Com ***** Definicin de Mscara, Tipo de Letra, Lneas por hoja *****
Com ***** y Lneas para Partida *****
PAN
Tipo
Font "Arial", 9
Asigna <120>, 2
Asigna <121>, 12
Asigna <122>, 0
Asigna <123>, 0
Completa"
63
Inicia TB
Si <45> <> 4
\\Inicia el primer Ciclo del recibo
Si <122> > 0
Ajusta <121> * <122>
Sifin
Encabezado
Inicia PD
Asigna <123>,<123> + 1
Si <123> >= 12
Asigna <123>,0
Asigna <122>,<122> + 1
Si <122> > (<120> - 1)
Asigna <122>, 0
Brinca
Sino
Ajusta <121> * <122>
Sifin
Encabezado
Sifin
Si <072> <> 0
Escribe 1, <070>, 7, <071>, 25, <072>
Sino
Escribe 1, "
"
Sifin
Si <077> <> 0
Escribe 43, <075>, 49, <076>, 67, <077>
Sifin
Termina
Asigna <123>,0
Ajusta 10 + ( <121>*<122> )
Escribe 1, "Total Percepciones ", 25, <079>
Escribe 43, "Total Deducciones " , 67, <080>
salto 1
Escribe 1, "Neto Pagado
", 25, <082>
Escribe 1, "Total en Efectivo " , 25, <082>-<081>
Asigna <122>, <122> + 1
Si <122> = <120>
Asigna <122>, 0
Brinca
SiFin
Sifin
\\Termina el Primer ciclo
Si <45> <> 4
\\Inicia el segundo Ciclo del recibo
Si <122> > 0
Ajusta <121> * <122>
Sifin
Encabezado
Inicia PD
Asigna <123>,<123> + 1
Si <123> >= 12
Asigna <123>,0
Asigna <122>,<122> + 1
Si <122> > (<120> - 1)
Asigna <122>, 0
Brinca
Sino
Notas del asistente:
64
Sifin
Termina
b)
c)
d)
e)
f)
g)
65
66
67
68
i)
Realizar las modificaciones para que el resto de los rubros de muestren de la misma forma.
69