Diferencia entre revisiones de «Cómo crear o modificar un impreso»

De WikiDgp21
Saltar a: navegación, buscar
(Crear documento nuevo a partir de otro)
(Introducción)
 
(No se muestran 36 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
 
En este tutorial se explica como buscar,añadir y modificar impresos.
 
En este tutorial se explica como buscar,añadir y modificar impresos.
  
Iglobalgest utiliza [http://reporting.pentaho.com JfreeReport] para generar impresos e informes.
+
== Introducción==
  
El diseño de los impresos se guarda en archivos XML que encontraremos en la ''Gestión de documentos'', estos XML están relacionados con formatos de impresión los cuales se encuentran en ''Informes''.
+
Iglobalgest utiliza internamente [http://reporting.pentaho.com Pentaho/JfreeReport] para generar impresos e informes.
  
 +
Es un potente generador de impresos Open Source que permite personalizar los impresos con características avanzadas, entre ellas incluir imágenes, marcas de agua, campos calculados y mas.
 +
 +
El diseño de un impreso o informe se almacena en un fichero XML.
 +
 +
La documentación relativa al formato XML utilizado en la definición de impresos se encuentra en esta guía:
 +
 +
[[Media:Pentaho_advanced_Reporting_Guide.pdf|Pentaho Advanced Reporting Guide]]
 +
 +
 +
El diseño de los impresos de la aplicacióm los encontraremos en la ''Gestión de documentos'', estos XML están relacionados con formatos de impresión los cuales se encuentran en ''Informes''.
 +
 +
Para modificar cómodamente un fichero XML recomendamos un editor que sea capaz de reconocer la sintaxis XML y colorearla, eso nos facilitará mucho la edición del documento. Si no se dispone de ninguno, una buena opción és la aplicación de código abierto y gratuita [http://codelite.org"CodeLite"]. Para pequeñas modificaciones puede hacerse con el bloc de notas (Notepad).
 +
 +
== IMPORTANTE! ==
 +
: Definir correctamente la codificación del documento, para los impresos: ISO-8859-1.
 +
Esta sería la página de configuración donde se establece la codificación del documento en el editor [http://codelite.org"CodeLite"]
 +
[[Imagen:screenshot_codificacion_codelite.png|thumb|center|250px|Pantallazo preferencias de codificación en CodeLite]]
 +
 +
En el documento xml se hace referencia a los campos de la aplicación mediante la etiqueta 'fieldname', en el siguiente documento están relacionados todos los campos que pueden mostrarse en los distintos impresos que genera la aplicación,su significado, tipo y longitud:
 +
 +
[[Media:Relación de campos impresos Iglobalgest.pdf|Relación de campos de los impresos de Iglobalgest]]
 +
 +
Tanto para crear un nuevo impreso como para modificar uno existente, lo primero que hay que hacer es localizar el impreso que queremos modificar o bien el impreso a partir del cual queremos crear otro.
  
 
== Localizamos el impreso a modificar ==
 
== Localizamos el impreso a modificar ==
Línea 16: Línea 39:
  
  
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y seguidamente introducimos la descripción que deseamos buscar, pulsamos el botón ''buscar'' [[Imagen:Boto_63.png|20px]] y aparecerá la lista de todos los ''Informes'' que están relacionados con la búsqueda, la referencia XML que nos interese la anotaremos ya que se usara para otra pantalla.  
+
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y seguidamente introducimos la descripción que deseamos buscar, pulsamos el botón ''buscar'' [[Imagen:Boto_63.png|20px]] y aparecerá la lista de todos los ''Informes'' que están relacionados con la búsqueda, la referencia XML nos indica la referencia del documento que controla la impresión del impreso.  
  
Ejemplo: Usaremos el de "Facturas" el cual tiene el numero 23 de referencia XML, dicho numero lo anotaremos para posteriormente usarlo(Ver imagen para mas información).
 
  
  
== Crear o modificar XML de impresos ==
+
Otra forma de localizar el documento XML que controla la impresión de un formato es la siguiente:
 +
En el dialogo de impresión:
 +
[[Imagen:dgimp001_1.png|thumb|center|250px|Diàlogo de impresión]]
  
 +
Desplegamos los formatos como si fueramos a seleccionar otro formato de impresión distinto, pulsando 2 veces la tecla de desplazamiento a la derecha veremos la referencia del documento que corresponde al formato concreto.
  
Para poder crear y modificar un impreso hay que dirigirse a:
+
 
 +
 
 +
'''Importante:''': Los impresos con referencias XML por debajo del 10.000, corresponden a los modelos estándares que vienen por defecto con la aplicación.  Estos modelos se actualizan con la aplicación, por tanto no deben modificarse porque se perderían los cambios realizados en la próxima actualización. Si se quiere personalizar un impreso estándar debe realizarse una copia del mismo y añadirlo como nuevo formato como se explica en la sección [[#Crear un nuevo impreso | Crear un nuevo impreso]].
 +
 
 +
== Modificar un impreso ==
 +
 
 +
Una vez localizado el impreso que queremos modificar accedemos a él para editarlo:
 +
 
 +
Acceder a la Gestión de documentos:
 +
 
 +
*''Gestión de documentos → Gestión de documentos
 +
 
 +
[[Imagen:dgen110.png|thumb|center|250px|Pantalla de Gestión de documentos - dgen110]]
 +
 
 +
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y escribimos la referencia anteriormente buscada de ''Informes'' en el campo ''referencia'', una vez hecho pulsamos ''buscar'' [[Imagen:Boto_63.png|20px]] y nos aparecerá en la lista la referencia deseada.
 +
 
 +
Procedemos a editar el documento clicando el botón  ''Editar documento'' [[Imagen:Boto_111.png|20px]], nos pedirá confirmación y se abrirá con la aplicación predeterminada para los archivos xml que tenga nuestro sistema operativo. Es muy importante como se ha indicado anteriormente que sea un editor de textos, tipo Notepad o algo  más avanzado, si no se dispone de ninguno puede utilizar la aplicación de código abierto y gratuita [http://codelite.org"CodeLite"].
 +
 
 +
A partir de aquí puede continuar en la sección [[#Modificar documento | Modificar documento ]]
 +
 
 +
== Crear un nuevo impreso ==
 +
 
 +
Para crear un nuevo impreso se recomienda que se parta de otro similar.
 +
 
 +
El procedimiento es el siguiente:
 +
 
 +
Acceder a la Gestión de documentos:
  
 
*''Gestión de documentos → Gestión de documentos
 
*''Gestión de documentos → Gestión de documentos
  
[[Imagen:dgen110.png|thumb|center|250px|Pantalla de Gestion de documentos - dgen110]]
+
[[Imagen:dgen110.png|thumb|center|250px|Pantalla de Gestión de documentos - dgen110]]
  
  
Línea 60: Línea 111:
 
==== Modificar documento ====
 
==== Modificar documento ====
  
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y escribimos la referencia anteriormente creada en el campo ''referencia'', una vez hecho pulsamos ''buscar'' [[Imagen:Boto_63.png|20px]] y nos aparecera en la lista la referencia a modificar.
+
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y escribimos la referencia anteriormente creada en el campo ''referencia'', una vez hecho pulsamos ''buscar'' [[Imagen:Boto_63.png|20px]] y nos aparecerá en la lista la referencia a modificar.
  
 
Ejemplo: Buscamos la 10001 o superior y nos aparecera la referencia creada anteriormente.
 
Ejemplo: Buscamos la 10001 o superior y nos aparecera la referencia creada anteriormente.
  
Para modificar el archibo XML hay que presionar a ''Editar documento'' [[Imagen:Boto_111.png|20px]], seguidamente se abrirá un documento XML el cual poder modificar.
+
Para modificar el archibo XML hay que presionar a ''Editar documento'' [[Imagen:Boto_111.png|20px]], seguidamente se abrirá un documento XML con el editor que tengamos predeterminado en nuestro sistema.
  
[[Imagen:dgen110_3.png|thumb|center|250px|Pantalla de Gestion de documentos - dgen110]]
+
'''Importante!:''' Debemos modificar el documento con un editor de textos, no con un procesador de textos tipo Word o similar. Si no dispone de ninguno, una buena opción és la aplicación de código abierto y gratuita [http://codelite.org"CodeLite"].
 +
 
 +
La documentación de los formatos utilizados en la definición de impresos podemos encontrarla en el siguiente enlace:
 +
 
 +
[[Media:Pentaho_advanced_Reporting_Guide.pdf|Pentaho Advanced Reporting Guide]]
 +
 
 +
[[Imagen:dgen110_3.png|thumb|center|250px|Pantalla de Gestión de documentos - dgen110]]
  
 
Mientras tengamos el documento XML abierto podremos realizar pruebas de impresión, cuando seleccionemos en cualquier pantalla el botón de ''imprimir'' [[Imagen:Boto_110.png|20px]] se nos dará la opción de probar el archivo XML que se esta modificando en ese momento, dicha opción solo estará disponible siendo administrador.
 
Mientras tengamos el documento XML abierto podremos realizar pruebas de impresión, cuando seleccionemos en cualquier pantalla el botón de ''imprimir'' [[Imagen:Boto_110.png|20px]] se nos dará la opción de probar el archivo XML que se esta modificando en ese momento, dicha opción solo estará disponible siendo administrador.
Línea 76: Línea 133:
 
[[Imagen:dgen450.png|thumb|center|250px|Mantenimiento - dgen0450]]
 
[[Imagen:dgen450.png|thumb|center|250px|Mantenimiento - dgen0450]]
  
Pulsamos el botón ''imprimir'' [[Imagen:Boto_110.png|20px]] y seleccionamos "Probar" y "Previsualizar", seguidamente pulsamos "Aceptar" y java nos creara un pdf donde se mostrara la información del XML que estemos modificando en ese instante.
+
Pulsamos el botón ''imprimir'' [[Imagen:Boto_110.png|20px]]y se mostrará el diálogo de impresión:
 
+
 
+
Una vez terminadas las modificaciones del documento XML, este lo cerraremos y en la pantalla de ''Gestión de documentos'' pulsaremos el botón ''Exportación de documentos'' [[Imagen:Boto_expor.png|20px]] , de esta forma guardaremos los cambios de forma definitiva.
+
 
+
  
 +
[[Imagen:dgimp001_2.png|thumb|center|250px|Diálogo de impresión]]
  
 +
Seleccionamos "Probar" y "Previsualizar", seguidamente pulsamos "Aceptar" y java nos creara un pdf donde se mostrara la información del XML que estemos modificando en ese instante.
  
  
 +
Una vez terminadas las modificaciones del documento XML, este lo cerraremos y en la pantalla de ''Gestión de documentos'' pulsaremos el botón ''Exportación de documentos'' [[Imagen:Boto_expor.png|20px]] , de esta forma guardaremos los cambios de forma definitiva.
  
 
== Proceso de añadir nuevo impreso ==
 
== Proceso de añadir nuevo impreso ==
Línea 95: Línea 151:
 
[[Imagen:dgen013.png|thumb|left|250px|Pantalla de Informes - dgen013]]
 
[[Imagen:dgen013.png|thumb|left|250px|Pantalla de Informes - dgen013]]
  
Buscaremos el "Origen de datos" correspondiente a las modificaciones de arriba.  
+
Buscaremos el "Origen de datos" que corresponde al impreso que acabamos de crear.  
  
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y seguidamente ponemos la descripción que deseamos buscar, pulsamos el botón ''buscar'' [[Imagen:Boto_63.png|20px]] y aparecerá la lista de todos los ''Informes'' que están relacionados con la búsqueda.
+
Pulsamos el  botón ''seleccionar'' [[Imagen:Boto_007.png|20px]] y seguidamente ponemos la descripción del informe que queremos crear, pulsamos el botón ''buscar'' [[Imagen:Boto_63.png|20px]] y aparecerá la lista de todos los ''Informes'' existentes.
  
 
Ejemplo: En este caso buscaremos por la descripcion "Facturas", el numero de "Origen de datos" lo anotaremos ya que el nuevo informe usara el mismo origen de datos que facturas.
 
Ejemplo: En este caso buscaremos por la descripcion "Facturas", el numero de "Origen de datos" lo anotaremos ya que el nuevo informe usara el mismo origen de datos que facturas.
Línea 103: Línea 159:
  
  
Pulsando sobre ''Nuevo'' [[Imagen:Boto_006.png|20px]] o ''F2'' nos permite rellenar los campos para crear un nuevo formato de impreso.
+
Pulsando sobre ''Nuevo'' [[Imagen:Boto_006.png|20px]] o ''F2'' crearemos la entrada para el un nuevo formato de impreso.
  
  
Línea 116: Línea 172:
  
 
----
 
----
 
 
  
 
== Campos de Informes ==
 
== Campos de Informes ==

Revisión actual del 10:55 22 feb 2021

En este tutorial se explica como buscar,añadir y modificar impresos.

Introducción

Iglobalgest utiliza internamente Pentaho/JfreeReport para generar impresos e informes.

Es un potente generador de impresos Open Source que permite personalizar los impresos con características avanzadas, entre ellas incluir imágenes, marcas de agua, campos calculados y mas.

El diseño de un impreso o informe se almacena en un fichero XML.

La documentación relativa al formato XML utilizado en la definición de impresos se encuentra en esta guía:

Pentaho Advanced Reporting Guide


El diseño de los impresos de la aplicacióm los encontraremos en la Gestión de documentos, estos XML están relacionados con formatos de impresión los cuales se encuentran en Informes.

Para modificar cómodamente un fichero XML recomendamos un editor que sea capaz de reconocer la sintaxis XML y colorearla, eso nos facilitará mucho la edición del documento. Si no se dispone de ninguno, una buena opción és la aplicación de código abierto y gratuita "CodeLite". Para pequeñas modificaciones puede hacerse con el bloc de notas (Notepad).

IMPORTANTE!

Definir correctamente la codificación del documento, para los impresos: ISO-8859-1.

Esta sería la página de configuración donde se establece la codificación del documento en el editor "CodeLite"

Pantallazo preferencias de codificación en CodeLite

En el documento xml se hace referencia a los campos de la aplicación mediante la etiqueta 'fieldname', en el siguiente documento están relacionados todos los campos que pueden mostrarse en los distintos impresos que genera la aplicación,su significado, tipo y longitud:

Relación de campos de los impresos de Iglobalgest

Tanto para crear un nuevo impreso como para modificar uno existente, lo primero que hay que hacer es localizar el impreso que queremos modificar o bien el impreso a partir del cual queremos crear otro.

Localizamos el impreso a modificar

Para poder localizar un impreso hay que dirigirse a:

  • Configuración y utilidades → De sistema → Configuración de informes → Informes
Pantalla de Informes - dgen013


Pulsamos el botón seleccionar Boto 007.png y seguidamente introducimos la descripción que deseamos buscar, pulsamos el botón buscar Boto 63.png y aparecerá la lista de todos los Informes que están relacionados con la búsqueda, la referencia XML nos indica la referencia del documento que controla la impresión del impreso.


Otra forma de localizar el documento XML que controla la impresión de un formato es la siguiente: En el dialogo de impresión:

Diàlogo de impresión

Desplegamos los formatos como si fueramos a seleccionar otro formato de impresión distinto, pulsando 2 veces la tecla de desplazamiento a la derecha veremos la referencia del documento que corresponde al formato concreto.


Importante:: Los impresos con referencias XML por debajo del 10.000, corresponden a los modelos estándares que vienen por defecto con la aplicación. Estos modelos se actualizan con la aplicación, por tanto no deben modificarse porque se perderían los cambios realizados en la próxima actualización. Si se quiere personalizar un impreso estándar debe realizarse una copia del mismo y añadirlo como nuevo formato como se explica en la sección Crear un nuevo impreso.

Modificar un impreso

Una vez localizado el impreso que queremos modificar accedemos a él para editarlo:

Acceder a la Gestión de documentos:

  • Gestión de documentos → Gestión de documentos
Pantalla de Gestión de documentos - dgen110

Pulsamos el botón seleccionar Boto 007.png y escribimos la referencia anteriormente buscada de Informes en el campo referencia, una vez hecho pulsamos buscar Boto 63.png y nos aparecerá en la lista la referencia deseada.

Procedemos a editar el documento clicando el botón Editar documento Boto 111.png, nos pedirá confirmación y se abrirá con la aplicación predeterminada para los archivos xml que tenga nuestro sistema operativo. Es muy importante como se ha indicado anteriormente que sea un editor de textos, tipo Notepad o algo más avanzado, si no se dispone de ninguno puede utilizar la aplicación de código abierto y gratuita "CodeLite".

A partir de aquí puede continuar en la sección Modificar documento

Crear un nuevo impreso

Para crear un nuevo impreso se recomienda que se parta de otro similar.

El procedimiento es el siguiente:

Acceder a la Gestión de documentos:

  • Gestión de documentos → Gestión de documentos
Pantalla de Gestión de documentos - dgen110


Crear documento nuevo a partir de otro

Pulsamos el botón seleccionar Boto 007.png y escribimos la referencia anteriormente buscada de Informes en el campo referencia, una vez hecho pulsamos buscar Boto 63.png y nos aparecerá en la lista la referencia deseada.

Pantalla de Gestión de documentos - dgen110

Seleccionamos la referencia que deseamos duplicar para que tenga un nuevo archivo XML, para ello pulsamos sobre Guardar como Boto 061.png.

Una vez duplicado tendremos que realizar una búsqueda general, pulsamos el botón seleccionar Boto 007.png y dejamos el campo de referencia vacío, pulsamos buscar Boto 63.png y nos aparecerá la nueva referencia en primer lugar en la lista con el campo título llamado Copia-"Nombre de documento", o bien buscamos la ultima referencia creada que tendrá un numero superior a 10000.

Ejemplo: Si hacemos dichos pasos en la referencia 23 esta sera "Copia-Impreso factura estándar" y tendrá la referencia 10001 o superior.


Pantalla de Gestión de documentos - dgen110


Para cambiar el título de el nuevo documento pulsaremos Modificar o F6 Boto 008.png nos dirigimos al campo título y ponemos el nombre que deseemos.

Ejemplo: ponemos en título "Impreso factura estándar con logo".

Una vez acabado de definir los campos clicamos sobre Guardar Boto 011.png o F5.


Nota: Todas las referencias inferiores a 10000 son las que vienen por defecto en la aplicación, todas las que creemos nuevas serán superiores a dicho número y serán las únicas modificables.

Modificar documento

Pulsamos el botón seleccionar Boto 007.png y escribimos la referencia anteriormente creada en el campo referencia, una vez hecho pulsamos buscar Boto 63.png y nos aparecerá en la lista la referencia a modificar.

Ejemplo: Buscamos la 10001 o superior y nos aparecera la referencia creada anteriormente.

Para modificar el archibo XML hay que presionar a Editar documento Boto 111.png, seguidamente se abrirá un documento XML con el editor que tengamos predeterminado en nuestro sistema.

Importante!: Debemos modificar el documento con un editor de textos, no con un procesador de textos tipo Word o similar. Si no dispone de ninguno, una buena opción és la aplicación de código abierto y gratuita "CodeLite".

La documentación de los formatos utilizados en la definición de impresos podemos encontrarla en el siguiente enlace:

Pentaho Advanced Reporting Guide

Pantalla de Gestión de documentos - dgen110

Mientras tengamos el documento XML abierto podremos realizar pruebas de impresión, cuando seleccionemos en cualquier pantalla el botón de imprimir Boto 110.png se nos dará la opción de probar el archivo XML que se esta modificando en ese momento, dicha opción solo estará disponible siendo administrador.

Ejemplo: Nos dirigimos a:

  • Gestión General → Ventas → Facturas → Mantenimiento
Mantenimiento - dgen0450

Pulsamos el botón imprimir Boto 110.pngy se mostrará el diálogo de impresión:

Diálogo de impresión

Seleccionamos "Probar" y "Previsualizar", seguidamente pulsamos "Aceptar" y java nos creara un pdf donde se mostrara la información del XML que estemos modificando en ese instante.


Una vez terminadas las modificaciones del documento XML, este lo cerraremos y en la pantalla de Gestión de documentos pulsaremos el botón Exportación de documentos Boto expor.png , de esta forma guardaremos los cambios de forma definitiva.

Proceso de añadir nuevo impreso

Para poder añadir un nuevo impreso hay que dirigirse a:

  • Configuración y utilidades → De sistema → Configuración de informes → Informes
Pantalla de Informes - dgen013

Buscaremos el "Origen de datos" que corresponde al impreso que acabamos de crear.

Pulsamos el botón seleccionar Boto 007.png y seguidamente ponemos la descripción del informe que queremos crear, pulsamos el botón buscar Boto 63.png y aparecerá la lista de todos los Informes existentes.

Ejemplo: En este caso buscaremos por la descripcion "Facturas", el numero de "Origen de datos" lo anotaremos ya que el nuevo informe usara el mismo origen de datos que facturas.


Pulsando sobre Nuevo Boto 006.png o F2 crearemos la entrada para el un nuevo formato de impreso.


Ejemplo: en Origen de datos añadimos la pantalla "10", en Formato añadimos el numero "20" para que aparezca el segundo en el orden de la lista a la hora de imprimir, en descripción ponemos "Factura con logo", y en Ref. XML el numero de referencia que creamos anteriormente en "Gestión de Documentos", este debe de ser superior a 10000.

Pantalla de Informes - dgen013

Nota: Para saber que hay que introducir en cada campo revise el apartado de "Campos de Informes" de esta documentación.

Una vez acabado de definir los campos clicamos sobre Guardar Boto 011.png o F5 y procedemos al siguiente nuevo formato de impresion.



Campos de Informes

Origen de datos

Campo numérico en el que especificaremos a que pantalla se usara el nuevo formato de impreso.

Formato

Campo numérico en el que especificaremos el numero de orden de la lista a la hora de seleccionar un formato de impreso.

Descripción
Ref. XML

Campo numérico en el que especificaremos el numero de referencia, la referencia que usara es la misma que esta definida en Gestión de documentos.