CoPrint Chart Server.
Soporte de Gráficos de Negocio en CoPrint.

CoPrint/400 © CPI Software

Objetivo

Un ejemplo de página con gráficos puede verse en este pdf:
http://cpis.es/Public/PruebaBg2.pdf

Implementación

Las operaciones relativas a la inserción de un Gráfico son bgNew,bgVal,bgEnd,Image.
Veamos un ejemplo:

;;bgNew,1,bar1.cbg,bar,1serie,4elem,400px,200px
;;bgVal,1,1,1245
;;bgVal,1,2,1027
;;bgVal,1,3,190
;;bgVal,1,4,2200
;;bgEnd
;;Image,*BG,D

• bgNew establece el comienzo de la definición de un Gráfico.
• bar1.cbg (nombre libre) es el "ini" asociado a este gráfico
• 1serie y 4elem indica las series y elementos que tiene el gráfico.
  1/4 indica que solo son visibles 4 elem (ventas de 4 trimestres, p.e.)
  2/4 indica 4 elem con 2 series c.u. (ventas y gastos de 4 trim p.e.)
• 400px,200px indica el tamaño en pixels de ancho y alto
• bgVal se usa para el valor de cada serie,elemento.
• bgEnd indica el fin de la definición
• Image con el valor especial *BG indica la impresión de la "imagen" del Gráfico.

Ahora veamos el formato del fichero "ini" asociado a cada gráfico. Este fichero debe residir en C:\CPI\CoPrint\User\ (en el directorio User debajo del programa coprin1.exe)

Ejemplo de ini cbg para 1 serie de valores:

[General]
Title1=Demo de Gráfico de Barras CoPrint
TitleAxis="Consumo Euros"
TitleItem="Zonas"
Items=Norte,Sur,Este,Oeste
bgColor=59
Format=# €
[Serie1]
color=55

Ejemplo de ini cbg para 2 series de valores:

[General]
Title1=Gráfico de Barras CoPrint 2 series
*TitleAxis="Consumo en Unidades"
TitleItem="www.CoPrint.info"
Items=t1,t2,t3,t4
Format=#
bgColor=51
Serie=Producto
[Serie1]
Title=Soft
Color=54
[Serie2]
Title=Hard
Color=55

;;bgVal,1,1,1245
;;bgVal,2,1,1032
;;bgVal,1,2,1027
;;bgVal,2,2,1334
;;bgVal,1,3,190
;;bgVal,2,3,410
;;bgVal,1,4,2200
;;bgVal,2,4,2900

Los valores mas importantes del "ini" son

• Title1 el titulo de cabecera del grafico
• TitleAxis Titulo para los valores (Euros, Consumo,...)
• TitleItem Titulo para los elementos en general (meses, zonas...)
• Items Titulos para cada elemento separado por comas
• Format para datos numericos poner # y añadirle € o lo que se quiera
• bgColor es el color de fondo del grafico
• Serie (no confundir con seccion SerieN) es el titulo del apartado donde se imprime el titulo de cada serie

• Title el titulo de esa serie de valores
• Color el color de las barras de esa serie

Uso de Colores

Formato de Datos

Para facilitar la generación de datos desde el iSeries, los valores de serie, elemento y valor pueden tener espacios delante/detras o ceros por la izquierda, etc.

En ;;bgNew tambien se permiten cosas como 12elementos o 12items o 12, sólo para que pueda quedar mas documentado.

Prueba simple

• Si no estás seguro de tener una versión reciente de CoPrint, mejor actualízala antes.

Si no te has leido nada de lo anterior, vamos con un ejemplo completo y que se puede imprimir realmente y todo!

El ejemplo imprime una hoja con tres gráficos.

Para el ejemplo debes conseguir el fichero CoPrinBG_ejemplo.zip, con el que hay que hacer lo siguiente:

• los tres ficheros *.cbg (inis) extraerlos a c:\cpi\coprint\user
• el fichero WCHART2.txt extraerlo a cualquier directorio y subirlo por FTP como miembro WCHART2 al fichero QAPIXCPI de la biblioteca TEXTCPIU.

Para ejecutar el ejemplo vamos a utilizar la funcion WA del PDM.

WRKMBRPDM FILE(TEXTCPIU/QAPIXCPI) MBR(WCHART*)

Esto nos da la lista de miembros en la que estará nuestro WCHART2 que hemos subido con FTP.

Ahora vamos a comprobar si tenemos la funcion WA en PDM

El resultado debe ser una hoja con tres gráficos de direfentes colores y tamaños. Ahora te toca leerte el miembro de prueba WCHART2 y los tres inis para aprender las funciones.

Nota:
Lo has adivinado si no lo sabías ya!
Este programa wAddServer y su opcion de PDM WA son estupendos para pruebas!