ManualdeEntrenamiento

1eraEdicinenEspaol

7.7
EquipoAgata

TraduccinalEspaol:

MisserineCarvajal(misserinec@ferrominera.com)TraduccinallenguageEspaol
MiguelAngelCasanova(miguelacg1@hotmail.com)Revisinyadaptacin

Colaboracin
VersinenPortugues
SOLISCooperativadeSolucionesLibres
esarrolloJamielSpezia(jamiel@solis.coop.br)
ElisngelaBeatrizAndres(elisand
re
s
@
soli
s.c
oop
.br)Documentacin
AnaPaulaFiegenbaum(ana@
s
o
li
s
.coo
p
.b
r)RevisinPortugues

Venezuela,PuertoOrdaz,Juniode2008

INDICE
Pg.

INTRODUCCIN..........................................................................................................................5
1INSTALANDOAGATAREPORTYSUSPREREQUISITOS...............................................6
1.1InstalacinenLinux..............................................................................................................6
1.1.1InstalandoPHP5.2.4..........................................................................................................6
1.1.2InstalandoPHPGTK2.0.1..............................................................................................10
1.1.3VersinPreCompiladadelosPreRequisitos.................................................................10
1.1.4InstalandoAgataReport7.7.............................................................................................12
1.2InstalacinenWindows......................................................................................................12
1.2.1InstalacindeDCOM(DistributedComponentObjectModel)......................................12
1.2.2InstalacindeMDAC(MicrosoftDataAccessComponents).........................................13
1.2.3InstalandoAgataReport...................................................................................................13
1.2.4DIAVisualizadoryEditordeDiagramas.....................................................................13
2INICIANDOAGATAREPORT...............................................................................................15
2.1ConectandoalaBasedeDatos...........................................................................................16
3REPORTES................................................................................................................................19
3.1IniciandolaconstruccindeReportes................................................................................19
3.2AgregandoCamposalReporte...........................................................................................22
3.3RestringiendoColumnas....................................................................................................25
3.4AjustandolosReportes........................................................................................................29
3.5DescriodasFunes(DescripcindelasFunciones)......................................................32
3.6VisualizandoelReporte......................................................................................................37
4DICCIONARIODEDATOS.....................................................................................................38
4.1FamiliadeTablas................................................................................................................40
4.2CombinacionesentreTablas...............................................................................................41
4.3DescripcindelosDatos.....................................................................................................37
4.4GuardandosuDiccionariodeDatos....................................................................................38
5AGRUPADORES......................................................................................................................40
5.1ComparacinentreDatosdelasColumnasdelasTablas..................................................40
5.2CabealhoeRodap(EncabezadoyPiedePgina)...........................................................45
6GENERACINDEGRAFICOS...............................................................................................46
6.1Resultados...........................................................................................................................46
6.2TiposdeGrficos................................................................................................................47
7HERRAMIENTASDEMEZCLADO.......................................................................................53
7.1DescripcindelasPestaasInferioresdelaPestaaHerramientasdeMezclado..............55
7.1.1Cabealho(Encabezado)..................................................................................................55
7.1.2CabealhodoGrupo(EncabezadodelGrupo).................................................................56
7.2Detalhes(Detalles)..............................................................................................................57
7.3RodapdoGrupo(PiedePginadelGrupo)......................................................................59
7.4Rodap(PiedePgina).......................................................................................................61
7.5GeradordeEtiquetas(GeneradordeEtiquetas)..................................................................64
7.5.1VisualizacinRpidadelReporte....................................................................................65
7.5.2ExportarcomoArchivoPDF............................................................................................65
7.5.3ConfiguracindelaPgina..............................................................................................64

3
7.5.4InsertarArchivo................................................................................................................64
7.5.5InsertarImagen.................................................................................................................64
7.5.6InsertarImagendeFondo.................................................................................................64
7.5.7TabulacinHorizontal......................................................................................................64
7.5.8TabulacinVertical..........................................................................................................65
7.5.9RotacindeTexto............................................................................................................65
7.5.10InsertarCaracterEspecial...............................................................................................65
7.5.11InsertarFecha/Hora........................................................................................................65
7.5.12NuevoRectngulo..........................................................................................................65
7.5.13NuevoRectnguloRedondeado.....................................................................................65
7.5.14NuevaElipse..................................................................................................................67
7.5.15InsertarLnea..................................................................................................................67
7.5.16ColordeFuente..............................................................................................................67
7.5.17SaltodePgina...............................................................................................................67
7.5.18NuevoCdigodeBarras................................................................................................67
7.5.19AlturadelaLnea...........................................................................................................70
7.6BotonesdeFormatodeTexto.............................................................................................70
8INSERTANDODOCUMENTODEOPENOFFICE.ORG.......................................................71
8.1Header(CorrespondealEncabezado).................................................................................73
8.2Details(CorrespondealCuerpo,enAgataserialaPestaaDetalles):................................74
8.3Footer(CorrespondealEncabezado,enAgataseriaIgualalPiedePgina).....................73
9MENUS......................................................................................................................................76
9.1Arquivo(Archivo)...............................................................................................................76
9.1.1ConectaraoBancodeDados(ConectaralaBasedeDatos)...........................................76
9.1.2NovoRelatrio(NuevoReporte).....................................................................................76
9.1.3AbrirRelatrio(AbrirReporte).......................................................................................76
9.1.4SalvarRelatrio(GuardarReporte).................................................................................76
9.1.5SalvarComo(GuardarComo).........................................................................................76
9.1.6SalvaSQL(GuardarSQL)...............................................................................................77
9.1.7PropriedadesdoRelatrio(PropiedadesdelReporte).....................................................77
9.1.8ParmetrosPersonalizados(ParmetrosPersonalizados)................................................78
9.1.9ConfiguraesdePgina(ConfiguracionesdePgina)...................................................78
9.1.10Sair(Salir)......................................................................................................................79
9.2Relatrio(Reporte)..............................................................................................................80
9.2.1VisualizaoRpidadoRelatrio(VisualizacinRpidadelReporte)..........................80
9.2.2ExportarRelatrioparaArquivoTXT(ExportarReportecomoarchivoTXT)..............80
9.2.3ExportarRelatrioparaArquivoPDF(ExportarReportecomoArchivoPDF)..............80
9.2.4ExportarRelatrioparaArquivoHTML(ExportarReportecomoarchivoHTML).......82
9.2.5ExportarRelatrioparaArquivoXML(ExportarReportecomoArchivoXML)...........82
9.2.6ExportarRelatrioparaArquivoCSV(ExportarReportecomoArchivoCSV).............82
9.2.7ExportarRelatrioparaArquivoSXW(ExportarReportecomoArchivoSXW)...........82
9.2.8ExportarcomoFormulrioTXT(ExportarcomoFormularioTXT)...............................82
9.2.9ExportarcomoHTMLemFrames(ExportarcomoHTMLenFrames)..........................82
9.3Ferramentas(Herramientas)................................................................................................83
9.3.1DicionriodeDados(DiccionariodeDatos)...................................................................83
9.3.2PrefernciasdoSistema(PreferenciasdelSistema)........................................................83
9.3.3ConfiguraesdoLayout(ConfiguracionesdeLayout)..................................................85
9.3.4ModelosdeEtiquetas.......................................................................................................86
9.3.5CriarDiagrama(CrearDiagrama)....................................................................................86
9.3.6RepositriodeFunes(RepositoriodeFunciones)........................................................89

4
10MDULOWEB......................................................................................................................90
10.1InstalandooMduloWeb(InstalandoelMduloWeb)...................................................90
10.2MdulodeAcessoaoAgataviaWeb(MdulodeAccesoaAgatavaWeb).................91
10.3PartedoSQL(PartedelSQL)...........................................................................................92
10.4Quebras(Agrupadores).....................................................................................................93
10.5Grfico...............................................................................................................................94
10.6MesclagemdeRelatrio(MezcladodelReporte).............................................................95

INTRODUCCIN

Agata Report es un generador de reportes capaz de exportarlos en diversos

formatos de archivos. Tambin permite la produccin de grficos, la generacin de
cdigos de barras, diagramas, comparaciones entre tablasy clculos, adems de
posibilitar la inclusinde imgenes. An posibilita trabajar con funciones y parmetros
personalizados.
Laversinenlaquesebasaestemanualesdelasadecuacionesymejorasdela
versin Agata Report 7.6 rc1 que se utiliz como punto de partida para realizar los
cambiosnecesariosenelcodigofuenteyadaptarloporprimeravezparatrabajarbajo
PHP5yPHPGTK2.Aunquelaversin7.7aunestenfasededesarrolloynoest
estable,brinda oportunidadparalaspersonasqueestninteresadasentrabajarenla
mejoradelasfuturasversiones.
Vale mencionar que las pruebas de la versin de Agata Report Alpha 7.7 se
realiz en ambiente LINUX, especficamente en UBUNTU 7.10 y 8.04. Aun no se ha
probadoenotrasdistribuciones,nisehaadecuadoparaejecutarseenWINDOWS.
En este manual ser abordado un paso a paso de cmo utilizar las diversas
funcionesdeAgata.

1INSTALANDOAGATAREPORTYSUSPREREQUISITOS
Usted puede realizarla Instalacin delos prerequisitos de dos maneras. A
travsdelacompilacinde cada prerequisito (siguiendolos subcaptulos abajo) o
porelpaquete precompilado (subcaptulo 1.1.3 VersinPreCompilada delos Pre
Requisitos).

1.1InstalacinenLinux
AntesdeinstalaroPHPGTK,certifquesedequelossiguientespaquetesestn
instalados:

libgtk2.00

libgtk2.0dev

Para garantizar una visualizacin agradable y soporte a temas para sus

aplicacionesGTK,instaleelsiguientepaquete:

gtkengines0.12

Esrecomendablequeinstalelaversinprecompilada.

1.1.1InstalandoPHP5.2.4
HagaladescargadePHP5.2.4enellinksiguiente:
http://dow
nl
o
ad.
c
odi
g
olivre
.org.br/ph
p
gtk/php
4.3.1.tar.gz

ysalveloeneldirectorio/usr/local/src.

Enla Instalacin de PHP, necesita habilitar el soporte ala base de datos. Por
ejemplo,MySQL,PostgreSQL,OracleoInterbase.
Para habilitar el soporte a PostgreSQL, necesitatenerelmismo instalado. Dela
misma manera sucede con Oracle. Ya para SQLServer o Sybase, necesita tener
FreeTds(ww
w
.freetds
.org)instalado.
# cd /usr/local/src
# tar -xzvf php-4.3.1.tar.gz
# cd php-4.3.1
#./configure
--enable-dbase [Habilita soporte a DBF]
--with-pear [Habilita abstraccin de BD]
--with-gd [Habilita generacin de imgenes]
para MySQL:
[Habilita soporte a MySQL]
--with-mysql
para PostgreSQL:
[Habilita soporte a PostgreSQL]
--with-pgsql=<directorio de postgresql>
para Oracle:
[Habilita soporte a Oracle]
--with-oci8=<directorio de oracle>
para Informix:
[Habilita soporte a Informix]
--with-informix=<directorio de informix>
para Interbase y Firebird:
[Habilita soporte a Internase y Firebird]
--with-interbase=<directorio de firebird>
para SQLServer y Sybase:
[Habilita soporte a SQLServer y Sybase]
--with-mssql=<directorio de freetds>
#
#
#
#
#
#

make
make install
rm -f /usr/bin/php*
ln -sf /usr/local/bin/php /usr/bin/php
ln -sf /usr/local/bin/phpize /usr/bin/phpize
ln -sf /usr/local/bin/php-config /usr/bin/php-config

10

1.1.2InstalandoPHPGTK2.0.1
HagaladescargadePHPGTK2.0.1enlasiguientedireccin:
http://gtk.php.net/do_download.php?download_file=phpgtk2.0.1.tar.gz
ygurdeloen/usr/local/src.
# cd /usr/local/src
# tar -xzvf PHP-GTK-2.0.1.tar.gz
# cd PHP-GTK-2.0.1
# aclocal
# ./buildconf
# ./configureenablephpgtkenabledebugenablescintillawithextrawith
htmlwithspell
Si ocurre algn error, digite nuevamente:
# aclocal
# ./buildconf
# ./configure --enable-php-gtk --enable-debug
scintilla --with-extra --with-html --with-spell

--enable-

Y, finalmente:
# make
# make install
ParacorrerAgataWEB,PHP5debetenersoporteaDOM en el servidor,que
es una biblioteca utilizada para la manipulacin de documentos XML (Extended
MarkupLanguage).Instalarconlaopcinwith-dom.

1.1.3VersinPreCompiladadelosPreRequisitos
ParafacilitarlaInstalacindePHPGTKenLinux,puedeutilizarestepaquetede
PHPGTK precompilado para MySQLyPostgreSQL, que permitelarpida
InstalacindePHPGTKensistemasLinux.Estepaqueteyavienecontodosestos
prerequisitos:

PHP5;

11

PHPGTK2;

GD(generacindeimgenes);

BibliotecasdeMySQL;

BibliotecasdePostgreSQL;

BibliotecasdeFirebird;

BibliotecasdeSQLite;

GtkScintilla;

libglade;

libjpeg;

libpng;

libxml.

Hagaladescargadelarchivophpgtk.tar.gzde:
http://gtk.php.net/do_download.php?download_file=phpgtk2.0.1.tar.gz

ParalaInstalacin,guardeelarchivoeneldirectorio/usr/localdesuLinuxysiga
lassiguientesinstrucciones:
- Cambie al usuario root
# cd /usr/local/src/
# tar -xzvf phpgtk2.0.1.tar.gz
# chmod 777 php-gtk-2.0.0beta -Rf
# ln -sf /usr/local/src/phpgtk2.0.0beta/php/bin/php
/usr/bin/php
#lnsf/usr/local/src/phpgtk2.0.0beta/php/bin/php
/usr/local/bin/php
#exit
Pruebe php-gtk
#php/usr/local/src/phpgtk2.0.0beta/sample/gtk.php

12

UsuariosdeDebianyConectivapodrnnecesitarlabibliotecalibstdc++.

1.1.4InstalandoAgataReport7.7
Descarguelaltimaversin(AgataReport7.7)desde:
http://sourceforge.net/projects/agatareport/
Descomprima el archivo:
# unzip agata-7.6.zip
# chmod 777 agata -Rf
# cd agata
Corra Agata Report
# php agata.php
Sitodosalebien,Agataaparecerenlapantalla.

1.2InstalacinenWindows
NOTA:NosehacreadoaunlaversinALPHAparaWindows.Lasinstruccionesquesiguenson
lasmismasqueaplicanparalasversionesanterioresdeAGATAREPORT.

SigalaInstalacinpasoapaso.

1.2.1InstalacindeDCOM(DistributedComponentObjectModel)
Descargueeinstale:dcom95.exe(paraWindows95)
http://dow
nl
o
ad.
c
odi
g
olivre
.org.br/ph
p
gtk/dc
o
m
9
5
.ex
e

dcom98.exe(paraWindows98).
http://dow
nl
o
ad.
c
odi
g
olivre
.org.br/ph
p
gtk/dc
o
m
9
8
.ex
e

ParaWindowsME,XPyNTnoesnecesario.

13

1.2.2InstalacindeMDAC(MicrosoftDataAccessComponents)
Descargueeinstale:mdac_typ.exe
http://dow
nl
o
ad.
c
odi
g
olivre
.org.br/ph
p
gtk/mda
c
_
typ
.ex
e

1.2.3InstalandoAgataReport
WindowsXP

Descargueydescomprimaelarchivoagata.zipeneldirectorio"C:\"
http://sourceforge.net/projects/agatareport/agata_report_alpha_7.7.zip
Reinicieelcomputador.
CreeunaccesodirectoparaelarchivoC:\agata\agata.batenelescritorioylisto.
LINUX
Descargueydescomprimaelarchivoagata.zipeneldirectorio"/opt/"
http://sourceforge.net/projects/agatareport/agata_report_alpha_7.7.zip
Desdelaconsolaejecuteelsiguientecdigo:
#cd/opt/agata
#/opt/agata#phpagata.php
Observacin:Esteprocedimientoesindicadoparalaconexinalabasededatos
PostgreSQL y MySQL. Para utilizar Agata Report con otrasbasesdedatos,visitela
seccinFAQdelapginadelproyecto(www.
a
gata.org.br).
1.2.4DIAVisualizadoryEditordeDiagramas
Descargue el archivo dia0.96.15setup.zip en el Centro de Descargas de
SourceForgeeinstalelo.Hagaclicenellink:
htt
p://prdow
n
loa
ds.so
urceforge.net/diainstaller/dia0.92
.21setup
.zip?download
EnUBUNTU:
Debetenerpermisoscomorootparainstalarelpaquetedesdeelrepositorio:

Escribaenlaconsola:
#aptgetinstalldiagnome

14

15

2INICIANDOAGATAREPORT

LasiguientepantallaaparecercuandoAgatafuerecargado:

Figura1:PantallaInicialdeAgata

Enellaseleccionaremoseltemayelidiomadeseado.
Language:seleccionaelidiomaenqueAgatasercargado.
Theme:DefinelaestructuradecoloresdeAgata.

16

2.1ConectandoalaBasedeDatos

Agregarnueva
conexindeBases
deDatos

Figura2

Enesteejemploconectaremoslabasededatossamples,queyavieneenAgata.
Enellaencontramosdiversosejemplosdereportes.
Para conectar a samples.db, dentro del campoNomedo Bancode Dados
(NombredelaBasedeDatos),informamoslarutadelacarpetadondefueinstalado
Agata.Porejemplo:
/home/usuario/agata/samples.db,yenelcampoTipodeBancodeDados
(TipodeBasedeDatos)seleccionelaopcin:native-sqlite.
SID/DSN/HostdoBanco:lugardondelabasededatosseencuentra.
Senha:contraseaparaconectarsealabasededatos.
NomedoBancodeDados:nombredelabasededatos.
TipodeBancodeDados:tipodebasededatosdondelosdatosquedan
almacenados.EnelejemplodePostgreSQL,seleccionamoslaopcinnativepgsql.
UsuriodoBancodeDados:usuarioutilizadoparaconectarnosalabasede
datos.

17

Diccionario de Datos: Agata ofrece la posibilidad de definir un diccionario

paralabasededatos.Losdiccionariostienelafinalidaddenombrarlastablasysus
campos para una visualizacin ms amigable, adems de definirlasrelaciones
entrelastablas.
Adicionar:inserteunanuevabasededatosalasopcionesdeconexin.(Figura
3)

Figura3

Deletar:eliminaunabasededatosdelalistadeconexiones.(Figura4)

Figura4

Si una opcin en la ventana Nome do Projeto (Nombre del Proyecto) no

fuese seleccionada, la siguiente pantalla (Figura 5) aparecer. Por tanto,
debemos seleccionar el nombre de projecto a ser excludo, antes de
confirmarlaexclusin.

Figura5

Si laconexin ala basededatosesexitosa, el siguiente mensaje aparecer

(Figura6):

18

Figura6

AhorapasaremosatrabajarenAgataReport.
Recuerdeutilizarellenguajecorrespondientealabasededatosenqueest
conectado.

19

3REPORTES

3.1IniciandolaconstruccindeReportes
Finalizadalaconexinconlabasededatos,aparecerlasiguientepantalla:

Descripcinde
ReporteEsta
descripcin
apareceraen
Internetjuntoal
Reporte

Figura7

Aqupodradigitarun
Selectamanolibre

Estamos ahora e n la pa n ta ll a inicial de Agata d onde haremos las

respectivas seleccionesparalaconstruccindelosreportesydemsitems.
ObservelapestaaTabelas(Tablas), enellaencontramoslas tablas contenidas
enlabasededatosalacualAgatafueconectada.
Usted podr visualizar dentro de Samples algunos reportes ya listos, con
diversosejemplosdecomoutilizarAgata.

19

Descrio do Relatrio (Descripcin de Reporte): sirve para describir el

contenido del reporte, por si quisieramos documentar algo sobre el reporte creado.
(Figura8)

Figura8

Select a mano libre: si quisieramos insertar un cdigo digitndolo, e n este

campo podemos traer el select de tabla, editarlo y enviarlo nuevamente para
dentrodetabla.Utilizamoslosbotonesdeflechaparaesto.(Figura9)

20

Figura9

OffSet:seleccionaa partir decuallneadelatabla Agataexhibir los

registros.Por ejemplo,si el nmerofuese 3,serexhibidoa partir delregistro
de lnea nmero4.(Figura10)
Limit:limitaelnmeroderegistrosquesernexhibidosenelreporte.(Figura
10)
Valoresdistintos:ocultaregistrosduplicados.(Figura10)

21

Figura10

Seleccionando el botn indicado en la figura 11, sern listados los SQLs

guardados para se utilizados enlos reportes. Podemos tambin guardarun
SQLatravsdelmenArquivo> SalvarSQL(Archivo>GuardarSQL),la
diferenciaen este caso es que ser guardado apenas el SQL, singuardarel
reporte.

Figura11

AlladodelcampoquecontienelosSQLsguardados,existentresbotonesque
posibilitan,crearnuevacarpeta,excluirSQLsguardadosyabrirunSQLexistente.

3.2AgregandoCamposalReporte
Primero,elegimoslatabladedondedeseamosseleccionarloscampos.Haga
estoenlapestaa Tabelas(Tablas), haciendo clic sobre el nombre dela tabla y
seleccionando el botn Solicitar Tabelas (Solicitar Tablas) debajo de la lista de
tablas.
Observe en la figura 12, donde la tabla seleccionada fue l a de nombre
List_of_Cities,quedespusdesersolicitadalatablaapareceenelcampoEstruturadas
Tabelas(EstructuradelasTablas).
Sihacemosclic e n e l s m b o l o de [+] (ms) allado del nombre de l a tabla,
sus campossernmostrados.
Juno(ConexinoEnlace):estebotnsirveparaunirmsdeunatabla.

Limpar(Limpiar):estebotnsirvepararemoverlastablasadicionadas
dentrodeEstruturadasTabelas(EstructuradelasTablas).
VeaelcampoEstruturadasTabelas(EstructuradelasTablas),dentrodeel
encontramosloscamposdelastablassolicitadas.

Figura12

Haciendoclicderechosobreelnombredelatabla,tenemoslaopcindeexcluir
lamismaodeabrirla.
Ahora veamos l o que sucedecuando seleccionamos una delas tablas dentro
de Estrutura das Tabelas(EstructuradelasTablas). Note que lapestaa Seleo
(Seleccin)aparece.(Figura13)

Figura13

En ella podemos dar un nuevo nombre a la columna de la tabla que

seleccionamos. Por ejemplo, si quisieramos alterar el nombre City_code para
Cdigo da Cidade; note que al lado del botn Seleciona esta coluna
( Se lec c iona e s ta c olum na ) dentro de la p e sta a Seleo(Seleccin),
tiene un campo, donde podr ser declarado un nuevo nombre para esta
columna. Basta sustituir el nombre y hacer clic en Selecionar esta Coluna
(Seleccionarestacolumna).
Listo,ahoratenemoslacolumnaCity_code,comoCdigodaCidade.(Figura14)

Figura14

AplicarFuno(AplicarFuncin):podemosseleccionarfuncionespara
resultadosenelreporte.Porejemplo,calcularlamediaaritmtica.
Ordenao(Ordenacin): podemos ordenarlosdatos delascolumnas delas
tablasen ordencrecienteodecreciente.
Obs.:SeleccionelasfuncionesantesdehacerclicenelbotnSelecioneesta
Coluna(SeleccioneestaColumna).
Observeque ahora, enl a se cci n d e Consulta, l a columna tiene referencia
con el nuevonombredadoalamisma.

3.3RestringiendoColumnas
Tambin podemos hacer restricciones en las columnas. En la pestaa
Restries(Restricciones)tenemosalgunasfuncionesparaesto.(Figura15)

Figura15

Para haceruna restriccin debemos seleccionar la columna dela tabla

dentro dela Estrutura das Tabelas(EstructuradelasTablas), hacer clic enla
pestaa referente a restriccin y determinar el valor deseado a el. Por ejemplo:
seleccionamos la colmuna nome, hacemosclicenelbotn[ = ] einformamoselvalor
Joo. En el campo Expresso(Expresin), quedar as: nome = 'Joo'. Cuando el
reportefueregenerado,selistarapenaslosnombresconelvalorigualaJoo.
Concluidoel procesoderestriccindebemoshacerclicenelbotn aplicar,
aselpasarlarestriccinparadentrodelaConsulta.
ObserveelcampoConsulta.EneltenemoslistadoslosCamposseleccionados
delastablas,losnombresdelasTabelas(Tablas),lasRestries(Restricciones)de
lastablas,Quebras(break)ylaOrdenao(Ordenacin).
Tenemos la posibilidad de Inserir Parmetro (Insertar Parmetro)
personalizado, utilizando este botn.Elparmetro ser requeridoenla generacin del
reporte.(Figura16)

Figura16

Parmetro(Parmetro):nombredelparmetroqueestsiendocreado.(Figura
17)
Mask(Mscara):incluyeunamscaraparaelparmetro.Cuandoqueremos
unamscaranumrica,utilizamosel9paraindicarelformatodelamisma,porejemplo:
99999999;Enlamscaradetextoutilizamoslaletraz,porejemplo:zzzzzzzz.(Figura
17)
Value(Valor):Valorestndardelparmetro.Obs.:Noesobligatoriollenar
estecampo.(Figura17)

Figura17

Paraeditarlosparmetroscreados,ascomoexcluirycrearnuevosparmetros,
debemosiralmenArquivo>ParmetrosPersonalizados(Archivo>Parmetros
Personalizados).
Despus de crear el parmetro, basta utilizar el botn Inserir Parmetro

(InsertarParmetro),paramostrarlalistadenombresdeparmetroscreados.

29

Para que el parmetro creado pueda ser utilizado en los mdulos del
reporte, encabezado,pie de pagina yen otroslugaresosecciones, utilizamos el
smbolo $

(dolar) delante del

nombre

del

parmetro.

Por

ejemplo:

$nome_do_parametro.

3.4AjustandolosReportes
LapestaaAjustessirvepara ajustarloscamposdelastablas. Por ejemplo,
tenemosuncampollamadosalrioyesteapenaspresentavaloresnumricos,
sincifra.Podemos agregarelvalordemonedaaelatravsdeloscamposdeesta
pestaa. As, cuando el reporte sea generado, los valores numricos de esta
columnasepresentarndeestamanera:R$9.999,99.
Tenemos la parte Coluna (Columna), en la izquierda, donde aparecen las
columnasselecionadasyaladerecha,lapresentacindelacolumna(lamanera
enqueellaesformateada).(Figura18)

Figura18

30

31

Caracteres: define elancho dela columna enla generacin del reporteen

formato de texto. El valor recomendadoeslamitaddelvalordelcampo Pontos
(Puntos).Porejemplo:Pontos:60;Caracteres:30.
Pontos(Puntos):defineelanchodelacolumnaparagenerarelreporteen
PDF. El valor recomendado es el doble del valor del campo Caracteres. Por
ejemplo:Pontos:60;Caracteres:30.
Alinhamento (Alineacin): define como el texto de la columna ser
alineado:enelcentro,izquierdaoderecha.
Formato: este campo define elformatode columna. Por ejemplo: 200,00 es
elvalorsinformato;insertandoelsmbolodemonedabrasilera(R$)dentrodeeste
campoaparecerdelasiguientemanera,R$200,00.(Figuras19y20)
Haciendo clic en el botn al lado de este campo Formato, l a v e n t a n a
representada por la figura 19 se abrir. En la otra pestaa de la misma ventana
encontraremos algunos ejemplos de formatos para campos, que tambin pueden ser
personalizados.(Figura20)

Figura19

Figura20

Funes(Funciones): funcionespara modificar l os campos seleccionados. Por

ejemplo, unacolumna contiene una fecha en el siguiente formato: aaaa/dd/
mm(dondeaaaa =ao, dd=da,mm = mes);noobstante,deseamos quela
mismaaparezcaenelreporteconelformato:dd/mm/aaaa. Encontramos dentro

32
delas funcioneslistasunacarpetaconfuncionesparafechas,lacarpetatime; as,
podemosaplicarunafuncindefecha a la

columna,quesermostradadelamaneradeseada.(Figura21)
Tambin podemos crear nuestras propias funciones, basta ir al men
Ferramentas(Herramientas)yseleccionarlaopcinRepositriodeFunes
(RepositoriodeFunciones).EstasfuncionessoncreadasenPHP.

Figura21

3.5DescriodasFunes(DescripcindelasFunciones)
contrib
RepositorioparafuncionesrealizadasporusuariosyenviadasalequipodeAgataReport.
Cuandocreamosfunciones,esimportanteguardarlasencontrib,queeslacarpetade
contribucindenuevasfunciones.
general
a_return_value:retornaunvalorqueseapasadoporparmetro.
math

a_abs:mantieneelvalorsiemprepositivo.

33

34

a_cos:devuelveelcosenodelnmeroalcuallafuncinfueaplicada.
a_log:retornaelalgoritmonaturaldeunvalor.
a_round:formateaunvalornumricopara2digitosdespusdelacoma.
a_sin:retornaelsenodelnmero.
a_sqrt:calculalarazcuadradadeunnmero.
a_tan:devuelveelvalortangentedelnmero.
numbers
a_accumulate_value:acumulavalores.
a_rownum_counter:completaconcerosalaizquierdaparaqueel
nmeroquedecon3digitos.
a_to_palabra:transformaunvalornumricoenpalabra,enestecasopara
espaol.
a_to_words:transformaunvalornumricoenpalabra,enestecasopara
ingls.
strings
a_first_letter:retornalaprimeraletradelcampo.
a_len:retornaelnmerodecaracteresquecontieneuncampo.
a_lower:transformaletrasmaysculasenminsculas.
a_reverse:retornalaspalabrasenordeninverso.
a_to_number:transformaunapalabraenunnmero.

a_trim:quitacaracteresnosignificativos.
a_upper:transformaletrasminsculasenmaysculas.
time
weekday:retornaeldadelasemana.
Yyyymmdd2ddmmyyyy:formatealafechadelatabladeao,mesydia
paradia,mesyao.
Observe:Lasfuncionessoncreadasconlaletraa,deAgata,adelante.Esto
sirve para no tener problemas problemas con las funneses del propio programa,
ahora le aconsejamos usar esta abreviatura siempre que una nueva funcin
seacreada.
Campos:noaconsejamoslautilizacindeesta

parte, puesesten

desarrollo.
Ligaes entre banco de dados(Combinacionesentrebasesdedatos):
no aconsejamos la utilizacin deesta parte,puesanestsiendoajustada. Ella
permitirlacombinacindedatosentretablasdiferentes.(Figura22)

Figura22

Formatao Condicional (Formato Condicional): no aconsejamos la

utilizacin de esta parte, debidoaqueestsiendoperfeccionadaporelmomento.
Permitir definir ciertosformatosde colores para partes de columnas y lneas del
reporte.Por ejemplo: sideseamosquesiemprequetengamoseltotalnegativo,sea
mostradoconel fondo rojo,utilizamos la formataocondicionalparaesto.Esto
eselvalordelresultadodeunafuncinaplicadaalacolumnadeunatabla.

3.6VisualizandoelReporte
Podemostenerunarpidavisindecomoestquedandonuestroreporte,
haciendoclicenelmenRelatrio>Visualizaorpidadorelatrio(Reporte
>Visualizacinrpidadelreporte).
Enseguidaseabreestaventana:

Figura23

4DICCIONARIODEDATOS

Permite asociar nuevos nombres a las tablas y columnas de una base de

datos. Estas nuevas etiquetas son guardadas en el diccionario, sin hacer
modificacionesenlabasededatos,ysoncargadosconlabasededatoscuandoel
diccionarioesseleccionado.
Podemos crear ms de un diccionario para unabasededatos, pues cuando
Agata e s cargado, en la pantalla de conexin con la base de datos, escojemos el
diccionarioasercargado.

Figura24

Observe en el ejemplo de arriba, tenemos en el campo Estrutura das

Tabelas(EstructuradelasTablas) la tabla tomadadel Diccionario de Datos, con el
nombre List of Cities, y tenemos l a tabla e n su estado original con el nombre de
States Table. Observe tambin los nombres de las columnas de estas tablas, que
tambinfueronrenombradas.
ParaaccederalDiccionariodeDatos,hacemosclicenelmenFerramentas>
DicionriodeDados(Herramientas>DiccionariodeDatos)ylasiguientepantalla

esmostrada:

Figura25

Enelejemplodearribautilizamos una tabla llamada analysis dentrodel campo

Tabelas(Tablas)ycambiamossunombreparaAnalise.

4.1FamiliadeTablas
La pestaa Famlia de Tabelas (Familia de Tablas) permite hacer el
agrupamientoentrevariastablas. Podemoshaceruna clasificacin delas tablas
por familias, donde es posible agrupar ms de una tabla, creando diferentes
gruposfamiliares.
Por ejemplo,tenemosdiversas tablas y queremoscrear relacionesdegrupos
entreellas,comotablaedad,nombre,telfono,siendoqueestaspertenezcanal
grupollamadoDatos.

Figura26

4.2CombinacionesentreTablas
Permitehacercombinacionesentrelastablasdeunabasededatos.Paraesto,
debemoshacerclicenelbotn Carregar estrutura do Banco de Dados(Cargar
estructuradelaBasedeDatos), para cargarl astablasdelabasededatosdeseada.
Enellateralizquierdo,d onde dice Estrutura das Tabelas (FK), tenemos l a s
LlavesoClavesForneas,yaladerecha,enEstruturadasTabelas(PK),tenemos
lasLlavesoClavesPrimariasdelastablas.(Figura27)

37

Figura27

Seleccionamos la tabla dentro del campo Estrutura da Tabela (FK), haciendo

clic en el smbolo [+] (ms) al lado dela tabla, abriendola para mostrar los
campos. Despus, seleccionamoselcampoquedeseamosrelacionar,hacemos
lomismoen Estrutura da Tabela (PK) y, despus de haber seleccionado las
columnasdeseadas,hacemosclicenelbotnLigarTabelas(CombinarTablas).

4.3DescripcindelosDatos
LapestaaDescrio dos Dados(DescripcindelosDatos) permitedescribir
losdatosdelastablas.(Figura28)

38

Figura28

Paradescribirlatablaysuscolumnas,hacemosclicsobrelacolumnadentrode
EstruturadaTabela(EstructuradelaTabla).Enseguida,digitamosdentrodel
campo Descrio dos dados(DescripcindelosDatos),la descripcindela
columna y, finalmente, hacemosclicenelbotn Adicionar(Agregar) ylisto.
Ahora para la tabla analysis tenemos la descripcin Contienelosdatosdelos
anlisishechosporellaboratorio.

4.4GuardandosuDiccionariodeDatos
Despus de hechas las modificaciones hacemos clic en el botn Salvar
Dicionrio ( G u a r d a r D i c c i o n a r i o ) y damos un nombre para el diccionario.
(Figura29)

39

Figura29

Por defecto, el diccionario ser guardado dentro de la carpeta dictionary, de

Agata,conlaextensin.agt.

40

5AGRUPADORES

5.1ComparacinentreDatosdelasColumnasdelasTablas
Aqu podemos hacer comparaciones con valoresenelreporte, agrupando
susdatos.Porejemplo,siquisieramoslamediadevaloresdeunacolumna,comosi
fueselamediasalarialdeunacolumnallamadasalario,seleccionamosestacolumna
yle aplicamoslafuncinmedia.Enelresultadodelreportesermostradalamedia
delosvalores.

Figura30

En la seccin Configurar Agrupamentos (Configurar Agrupamientos), en

Quebras (Agrupadores) seleccionamos la columna a ser insertada. En la pa rte
do nde te nemos la opci n Aplicar Funo(AplicarFuncin), podemos insertarla
columnayunafuncinasociadaaella.
EnelcampoFormatodefinimoselformatodeestacolumna.

41

Rtulo: define un nombre para la funcin. Por ejemplo, la funcin soma

(suma)esaplicadaaunacolumnallamadaidade(edad), l a p o d e m o s n o m b r a r
e n e l r o t u l o c o m o Suma deEdades; cuando el reporte f u e r e g e n e r a d o
a p a r e c e r e s c r i t o SumadeEdadesyelrespectivovalor.
Enelejemplopresentadoenlafigura31,tomamosunacolumnallamadaCity
Codeyleaplicamoslafuncindesumaydemedia.

Figura31

Elresultadoenlavisualizacindelreporteesrepresentadoenlafigura32.Obs.:
Cuandopasamoselmouseencimadelosniveles,losagrupamientossonmostrados.

Figura32

Dentrodeunagrupamientopodemostenervariasformulas,ascomotambin
dentrodeunamismacolumna.

42

Figura33

Ahoraveamosesteejemplo,conelsegundoniveldecomparacinentre
tablas.

Figura34

43

Siquisieramosqueelreporteexhibalasopcionesqueaparecenallado
derechoinferiordelaventanadebemosmarcarlasmismas.
Mostrar Colunas de Grupo: escoge repetir estas columnas en detalles,
mostrandolacolumnaprincipalnuevamente.
Exibirdetalhes:exhibelosdetallesdelascolumnas,lorestantedelosdatosde
latabla.
Exibirrtulosdototal:exhibeelrotulodadoalacolumna.
Exibeidentificao:exhibelaidentificacindelacolumna.
Exibenumerao:exhibelanumeracinseparadaporagrupamientos.

Exportara
PDF

Exportara
HTML

Exportar
aTXT

ExportaraXML
ExportaraCSV
ExportaraSXW

Figura35

Observelatabladearriba,dondetenemosagrupadosloscamposCityCode
yCityDescription,porNodo1e2.

44

EnesteotroejemplogeneradoenPDF,agrupamos(quebramos)losdatosporlos
mesesyobtuvimosesteresultado.(Figura36)

Figura36

5.2CabealhoeRodap(EncabezadoyPiedePgina)
Podemos agregaralencabezadoypiedepgina, imgenes y smbolos, as
comoutilizarparmetroscreados.
EnlapestaaCabealhoseRodaps(EncabezadoyPiedePgina)podemos
agregarunencabezadoyunpiedepginaalreporte,que ser visualizadocuando sea
exportadoaalgntipodearchivo.(Figura37)
Podemosalinearelcontenidoalaizquierda,alcentrooaladerechayarribadel
campodedigitacinparaelencabezadoypiedepginatenemostresbotones:
Abrir:sirveparainsertarunaimagenalencabezadoypiedepgina.
Inserircaractereespecial:insertauncarcterespecialaltexto.
Inserirdata/hora:insertalafechaolahoraactualaldocumento.

Insertarcaracterespecial
Abrir

Figura37

Insertarfecha/hora

46

6GENERACINDEGRAFICOS

Los grficos generados, por patrn, sern guardadosenlacarpeta output de

Agata.Podemoscreargrficoconlneasycolumnas,ydarttuloalgrficoysus
ejes.

Figura38

Para crear el grfico, seleccionamos la columna Campos, dentro del campo,

marcamoslasopcionesquedeseamosparaestegrficoyhacemosclicenelbotn
coneldiseodelgrficoqueencontremosmsadecuado,ypresionamoselbotnGerar
(Generar).Despusabrirunaventanasolicitandoelnombreparaelgrfico.
SideseamosselecionarmsdeunacolumnadebemospresionarlateclaCTRLy
hacerclicsobrelacolumnaaseragregada.

6.1Resultados

47

HTML:marcamosestaopcinsielarchivodebesergeneradoenformato
HTML.

OpenOffice:marcamosestaopcinsielarchivodebesergeneradoenformato
detexto.
Grfico + dados: debajodelgrficosernlistadoslosdatosdelascolumnas
seleccionadas.
ExibirValores:presentalosvaloresjuntoalascolumnasolneasdelatabla.
Dimenso(Dimensin):alteraeltamaodelgrfico.
Legenda: slo ser exhibida si es seleccionada la opcin de orientacin Por
Linhas(PorLneas).
Permiteladefinicindelacolumnadelatablaqueservirdelegenda.(Figura39)

Figura39

6.2TiposdeGrficos
Tenemoslaposibilidaddehacergrficosdecuatromaneras:

Porlneaydelneas;

48

Porlneaydecolumnas;

Porcolumnaydelneas;y

Por

columnaydecolumnas.
Acontinuacindescribimoslasopciones:
PorLinha(PorLnea):listalosvaloresatravsdelneasenelgrfico.(Vea
Figura42)
EjemplodetablaparaelGrficoporLneas:

Cidade

2005

2006

Montenegro

20

30

Lajeado

40

60

PorColuna(PorColumna):listalosvaloresatravsdecolumnasenelgrfico.
(VeaFigura43)
EjemplodetablaparaelGrficoporColumnas:
A

B
1
3
2
2
3
1

Figura40:BotnparagenerargrficosdelneasFigura41:Botnparagenerargrficosde
columnas

Paragenerarelgrficodelafigura43utilizamoslosdatosabajo.(Figura42)

Figura42

Ejemplodegrficoporlnea,decolumnasyenelformatoHTML.(Figura43)

Figura43

Ejemplodegrficoporcolumnas,delneasyenelformatoHTML.(Figura44)

Figura44

Paratenerun grficomscomplementado,tambindebemosllenarelcampo
deTtulo,ylosdemscampos.

53

7HERRAMIENTASDEMEZCLADO

En este mdulo podemos generar reportes con apariencia personalizada,

adems de mezclar datos de nuestro reporte con documentos de
OpenOffice.org.
Observemosun ejemployalisto para acompaarmejorlasexplicaciones. En
losejemplosutilizamosellabel_photo.agt,queestdentrodelacarpetasamples,en
el campo Relatrios (Reportes) de Agata. Despus de tener abierto el archivo,
podemosseguiradelante.(Figura45)

Figura45

Primero debemos h acer l a seleccin principal en la parte de los SQLs.

Normalmenteenestaseleccin,verificamoslosdatosqueutilizamosenelEncabezado
delmezclado.Enelejemplo,tenemoslaseleccindeCustomerysudireccin.
Para irnos a la parte de mezclado, debemos seleccionar la cuarta pestaa

lateraldeAgata.(Figura46)

54

55

Figura46

AhoraestamosenelmdulodemezcladodereportesdeAgata.

7.1DescripcindelasPestaasInferioresdelaPestaaHerramientasde
Mezclado
Enesta parte alternamos entre los registros de la base de datos y l a s
p a r t e s denuestrodocumentoquesergenerado.Podemoseditarelencabezado,
encabezadodel grupo, detalles, piedepginadel grupo ypie de pgina. Abajo
siguenlasexplicacionesdetalladasdecadapestaa.

7.1.1Cabealho(Encabezado)
Eneldefinimoselencabezadoinicialdelapgina,esdecir,laprimeraparte
a ser mostrada en el reporte. Por ejemplo: un ttulo para este reporte, o
informacionesdelaempresa,oanalgunascolumnasdelastablasdelaconsultahecha
enelSQL.

56

Paraincluirunacolumna,debemosseleccionarlaenelcampodondeaparecen
losdatosdelastablasdelSQLyhacerclicenlaflechahaciaabajo.(Figura47)
Observequealinsertarunacolumnaenlamezcla,ellaaparecerdiferentede
queenelcampo,comoporejemplolaColumna1:CustomerCode,aparecercomo
$var1,siincluimoslaColuna2,ellaserexhibidacomo$var2,yasenla
secuencia.UtilizaremosmsadelanteestareferenciaqueAgatadaalcampo($varn),para
hacerlasrelacionesentrelosdatosdelaConsultaprincipalydelaSubConsulta.

Figura47

7.1.2CabealhodoGrupo(EncabezadodelGrupo)
En el Cabealho do Grupo (Encabezado del Grupo) creamos el
encabezado para las columnas que sern insertadas en la pestaa Detalles
(Detalles). Es el encabezado de la tabla que haremos con los registros dela
basededatos.

57

Para que los campos tenganla misma posicinenla visualizacin, esdecir,

para que queden como una tabla, debemos tratar de mantener las mismas
tabulaciones en el Cabealho do Grupo (Encabezado del Grupo) y en Detalles
(Detalles).

Figura48

7.2Detalhes(Detalles)

EnlapestaaDetalles(Detalles)creamoslaparteinternadenuestrapgina,
esdecir,elreporteensi.

Dentro deesta pestaaencontramos la Seo deSubPesquisa(Seccinde

SubConsulta), que lista los campos seleccionados en la subconsulta as como, las
tablas,restricciones, quiebrasyordenacin. Este recurso existe para permitiruna
consultamsenlabasededatos,ademsdelaconsultaprincipal.

58

55

Figura49

SihacemosclicenelbotnSubPesquisa(SubConsulta),a lade re cha de la

pa ntalla (figura 49), abrir unaventanaparalaseleccindelosdatosdelastablasde
lasubconsulta.(Figura50)

Figura50

56

Losprocedimientosparaelusodeestaventanasonsimilaresalosutilizados
parahacerlaconsultaprincipal,enlaprimerapestaalateral,lapestaadeSQLs.
Analizando el ejemplo de photo_label.agt, hemos solicitado el campo
CustomerCodedelatabla"Customer",enlaconsultaprincipal, y a travs dela
subconsulta, buscamos las tablas sales y product, y de estas restringimos las
siguientes columnas: sales.ref_product = product.code and sales.ref_customer =
$var1(Coluna1:CustomerCode).
Esnecesario que la subconsulta tengarelacinconlaconsultaprincipaly
hacemosestocuandoasociamosuna$varqueserefierea unacolumnadelatabla
que est en la consulta principal. La ltima restriccin hecha en la subconsulta
(sales.ref_customer=$var1)debeexistirparaquelasubconsultamuestrelosvalores
demaneracorrecta.
Observe en la figura 51 que, cuando abrimos la pestaa Restries
(Restricciones) de la subconsulta, tenemos un nuevo botn, Colunas do
Relatrio(ColumnasdelReporte), que no existe en la pestaa de la consulta
principal.

Figura51

Estebotnsirveparaasociarlasubconsultaalaconsultaprincipal.

57

58

Enelencontramoslosnombresdeloscamposdelaprimeraconsultaysilos
agregaramosalarestriccinsernexhibidoscomo$varn.Porejemplo:$var1.(Figura
52)

Figura52

Despushacemoslasrestriccionesydemsajustes,yha ce moscli cenel

bo t nSalvarSubRelatrio(GuardarSubReporte).
LaventanasecerraryvolveralapestaaDetalhes(Detalles),entonces
podemosinsertarloscamposdelasubconsulta.
Observequelosnombresmostradosparaloscamposdelasubconsultason
$subfield1,$subfield2,...,$subfieldn,diferentedeloscamposdelaconsultaprincipal,
queson$varn.
Enlapestaadestacadaenlafigura53hacemoslosajustes(lasdescripciones
delasopcionesestnenelsubcaptulo3.4)paraloscamposdelastablas.

59

Figura53

Aqupodemoshacerlosajustesparalascolumnasde
lastablasdelasubconsulta.

OBSERVACIN:Paraqueelencabezadodelatablaylosregistrosdebajodel
quedenenlamisma posicinalmomentodesergeneradoelreporte, debemos utilizar
el mismovalor enlastabulaciones,tantoenelCabealhodoGrupo(Encabezadodel
Grupo)comoenDetalles(Detalles).
Encasodequelosdatosdelascolumnasnoentrenenlamismapgina,el
restanteserpasado para la prxima hojayasAgata continuar listandolos, hasta
llegaralfinaldelosregistrosdeestatabla.

7.3RodapdoGrupo(PiedePginadelGrupo)
EnlconstruimoslospiedepginasdelascolumnasagregadasenDetalles
(Detalles),sinolvidarnosdeutilizarlasmismastabulacionesparaqueelreportetenga
unalineamientoadecuado.
Podemosaplicarfunciones(lasdescripcionesestnenelsubcaptulo3.5)alas
columnas.Porejemplo:funcindesuma,parasabereltotaldeunacolumna.Cuando

60

insertamoslafuncinsermostradacomounavariable($subfield),seguidadela
funcin;digamosquelafuncinqueusamosesladesuma,esmostradaas
$subfiled_sum.

Figura54

7.4Rodap(PiedePgina)
EnelPiedePgina, insertamosel texto final delreporte. Enesta seccinno
tenemosopcionesen la pantalla para insertar loscampos, ms si hicieramos eso
manualmente, colocando directamente el nombre d e l a v a r i a b l e d e l a
c o l u m n a , tambin funcionar.Porejemplo:$var1 (primera variabledelaconsulta
principal)o$subfield1(primeravariabledelasubconsulta).

Figura55

Enlafigura56podemosverelresultadodelaexportacinaPDF,del
reporteusadocomoejemplo.

63

Figura56

Onerecordperpage:estaopcinpermitegenerarunagrabacinporpgina.
Observe que todas lasconfiguracionesde formatoshechas, son insertadas a
travs de variablesysolopodemosvisualizarcomoestelreportecuandoelmismoes
exportado, o cuando es visualizado en la Visualizao rpida do relatrio
(Visualizacinrpidadelreporte).

64

7.5GeradordeEtiquetas(GeneradordeEtiquetas)
Enlapestaadegeneracindeetiquetas, cuando insertamos unacolumna de
unatabla,debemos saber que automticamente ser generada una etiqueta con el
contenido decadaregistrodeaquellacolumna.
Tambin tenemos las opciones deformato de textoydems botones que
podemos utilizar, como enla pestaa Ferramenta de Mesclagem(Herramientade
Mezclado).
Enloscamposdebajodellugardeinsercindelosdatos, podemos alterar las
configuraciones de las etiquetas y tener la opcin de seleccionar un modelo listo
utilizandoelbotnAbrirModelosdeEtiquetas.

Figura57

Tambinpodemosgenerarlasetiquetasconimgenes.Lasimgenespueden
provenirdelabasededatosodecualquierotrodirectorio.
Enlafigura58podemosverunejemplodeetiquetas.

65

Figura58

Verifiqueenlafigura59losbotonesdelabarrasuperior.

Figura59

Semencionaacontinuacin,enelmismoorden,ladescripcindeloselementos
delabarradeherramientas.

7.5.1VisualizacinRpidadelReporte
Generaunavisualizacinrpidadeloqueseestrealizando.Esmuytilpara
vercomoestnquedandolosformatosaplicados.

7.5.2ExportarcomoArchivoPDF
ExportaelreporteenformatoPDF.

64

7.5.3ConfiguracindelaPgina
Configuralasdimensiones,alturadelpiedepgina,orientacinymrgenesde
lapgina.

7.5.4InsertarArchivo
Anexaelcontenidodeotroarchivoalcontenidodelformulario.Porejemplo:un
archivoconlaextensintxt,quecontengauntextoserinsertadoenelformulario.

7.5.5InsertarImagen
Insertaunaimagen.
OBS.:laimageninsertadanopuedeserredimensionada,ellasemostraren
elreporteeneltamaoqueposeeelarchivo.

7.5.6InsertarImagendeFondo
Permiteinsertarunaimagendefondo.

7.5.7TabulacinHorizontal
Tabulacin es un espacio desde el margen hasta el texto. Este botn nos
permite insertarunatabulacinhorizontalconuntamaopreestablecido, eneste caso,
elespacioesdesdeelmargenizquierdohastaeltexto.

65

7.5.8TabulacinVertical
Insertaunatabulacinverticalconuntamaopreestablecido,enestecaso,
desdeelmargensuperiorhastaeltexto.

7.5.9RotacindeTexto
Podemosrotareltextoalaizquierda,aladerecha,haciaabajo,haciaarribao
algunosgrados.Estetipodeformatoseaplicasolamentea uncampoquees abierto
al hacer clic en el botn, donde podemos digitar el texto, que debe recibir este
formato.

7.5.10InsertarCaracterEspecial
Insertacaracteresespecialesaltexto.

7.5.11InsertarFecha/Hora
Insertalahora,da,mesyaocorriente,enformadevariable.

7.5.12NuevoRectngulo
Insertaunrectngulodondepodemosdefinirlaalturaycoloresderellenoyde
lneas.

7.5.13NuevoRectnguloRedondeado
Insertaunrectnguloconesquinasredondeadas.Podemosdefinirloscoloresy
demspropiedadesdeesterectngulo.

66

7.5.14NuevaElipse
Insertaunaelipse.Podemosdefinirsucoloryotraspropiedades.

7.5.15InsertarLnea
Insertaunalneaverticaluhorizontal,contamaodefinido.

7.5.16ColordeFuente
Alteraelcolordeltexto.

7.5.17SaltodePgina
Inserta un saltode pgina. Si queremos que el texto continue e nla prxima
pgina al llegar en un determinado espacio de la hoja, insertamos un Salto de
Pgina.
7.5.18NuevoCdigodeBarras
Genera cdigos de barras a partir delos datos de una columna dela tabla,
dondecadacolumnacorrespondeaunavariable.Cadacolumnaestransformadaen
unavariableyelconjuntode$varestransformadoencdigodebarras.(Figura59)
Cdigo: selecciona la columna para la cual sern generados los cdigos de
barras. Acolumna es referenciada con $var, seguida de una numeracin. Observe
quedentrodelpropiomdulodondeestamos,enlapestaaCabealhodoGrupo
(EncabezadodelGrupo), tenemosel campo referenciado como Coluna1: nombre
dela tabla: nombre dela columna,si insertamos este campo, aparecer como
$var1.

Altura:defineunaalturaparaelcdigoasergenerado.
Largodelcaracter:definelalarguradelcdigoasergenerado.
ExhibirTexto:debemosdesmarcar esta opcinsi queremosqueslolas
barrasdelcdigoseanmostradas,seneltexto.

Figura60

ParavisualizarcomoquedaronloscdigosutilizamoselbotnVisualizacin
rpidadelreportedelabarradeherramientasdelmdulo.
Abajo,tenemosunejemplodecdigosdebarras(figura61),ademsdeun
ejemplodeetiquetasconimgenes(figura62).

Figura61

Figura62

7.5.19AlturadelaLnea
Defineunaalturaparalalnea.

7.6BotonesdeFormatodeTexto
En la barra representada por la figura 63 podemos formatear el texto,
escogiendo lafuente,elestiloytamao,enseguidatenemosunbotnenformade
flechahaciaabajo,queaplicaloscambioshechos.
Enelprximocampotenemosunacajaparaseleccionarlosdatos dela
tabla, enlacual estamos trabajando, basta abrirla caja (combobox),seleccionarla
columna y hacer clic en el botn de forma de flecha hacia abajo, para insertar la
columnaeneldocumento.

Figura63

8INSERTANDODOCUMENTODEOPENOFFICE.ORG

PodemosgenerarundocumentoenOpenOffice.orgparaagregarlosdatosdel
reporte.Hacemosestocreandoprimeramenteunarchivoeneleditormencionado.
Veamospasoapasocomosehace.
Vamosatrabajarutilizandoelreportelabel_photo.agtqueestdentrodela
carpetasamples,queposeeAgata.
Despus de abrir el reporte, entramos en el mdulo de generacin de
documentoscomoseindicaenlafiguradeabajoyseleccionamoslapestaauopcin
OpenOfficeDocument.

Figura64

Observequetenemosunmodeloindicandocomodebemosproseguirenla
creacindeldocumentoenOpenOffice.org.Observeloqueestescritoenverde

enlapantalla,esoserutilizadoenelEditormsadelante.

70

8.1Header(CorrespondealEncabezado)
Debemos abrir OpenOffice.org Writer, hacer clic en el men Inserir >
Seo(Insertar>Seccin)ydigitarelnombredelaseccindeencabezadoqueest
indicada en Agata como section header. Para esto, digitamos dentro del campo
Nova seo(NuevaSeccin), la palabra header y en seguida hacemos clic en
Inserir(Insertar).

Figura65

Acabamosdeinsertar elespacio paracolocarelcontenidodel encabezado,lo

queen Agata se refiere ala pestaa Cabealho (Encabezado) contenida en
FerramentasdeMesclagem(HerramientasdeMezclado).
Enlpodemosinsertarloscamposdelatabladelasiguientemanera[nomedo
campo], $var. Cuando fueregenerado el documento con los datos, se mostrar el
valordecadaregistrodelatablaenunapginadiferente.Enelejemplotenemos
las variables [Customer Code], que exhibeen cada pgina un cdigo diferente, y
[CustomerName]querepresentaelnombre.

71

Figura66

8.2Details(CorrespondealCuerpo,enAgataserialaPestaaDetalles):
Agregaelcontenidodelascolumnas. Creamos la tabla en OpenOffice.org y
dentro de los campos de ella agrega los $subfields. Si nos fijaramos en la
pestaa Detalhes (Detalles) de la parte de Ferramentas de Mesclagem
(HerramientasdeMezclado), tenemos los campos de la tabla referenciados de la
misma manera. No olvide prestar atencin al nombre de la columna, pues cada
$subfield representa una columna y en el documento creado debemos incluir una
columnaparacada$subfielddiferenteenlatabla.
Dela misma manera podemos adicionar estos campos en cualquier parte del
documento,yaqueellayoutesdefinidolibremente.

72

Sicolocaramosmenoslneasenlatabla,ylacantidaddedatosennuestra
tabla delabasededatoslosupera, el automticamente genera otra pgina con el
mismo encabezadoypiedepginadelaprimera,llenandolatablaconlosdatosde
losdemsregistrosdelabasededatos.

Figura67

Fjeseque podemos agregarfunciones de clculos ala tabla. Enla figura 67

tenemosel $subfield5 y le aplicamosla funcin sum, e nese caso $subfield5_sum.
As,lsumarlosvaloresdelacolumna,osea,todoslos$subfield5.
Veamosloquecadaclculohace:
_sum:sumalosvaloresdelacolumna,dejandodisponibleeltotaldelos
valores.
_avg:retornalamediaentrelosvaloresdelacolumna.
_count:retornalacantidaddeelementoscontenidosenlascolumnas.

73

_min:retornaelmenorvalordelacolumna.
_max:retornaelvalormximocontenidoenlacolumna.

8.3Footer(CorrespondealEncabezado,enAgataseriaIgualalPiede
Pgina)
Ahoravamos aagregarloscampos quedeben sergeneradosapartirdela
tablacontenidaenAgata.
En footer debemos insertar el contenido de la misma manera en que es
insertado en la pestaa Rodap (Pie de Pgina). Por ejemplo, en la figura 68,
insertamoselcampoquecontienelasdirecciones,quefueagregadocomo$var4.

Figura68

74

Despus de hacer las configuraciones de formato y agregar los campos,

vamos unir este documento de OpenOffice.org a Agata, para entonces generar el
nuevodocumentoconlosdatosreferentesaloscamposinsertados.
Debemos guardar el archivo hecho en OpenOffice.org y despus de esto,
volver aAgata,enlapestaadelmdulodegeraodedocumento(mdulode
generacindedocumento),enlapestaaOpenOfficeDocument.Hacemosclicenel
botnabrirybuscamoselarchivoguardadoanteriormente.Despusloseleccionamos,
hacemos clicenel botn Generar, colocamosunnombrepara el archivo desaliday
secrearcomoundocumentodeOpenOffice.org.
Despus,podemosabrirelarchivoenOpenOffice.orgparavercomoquedo.
Veaelejemploenlafigura69:

Figura69

Enelejemplo,estamosapenasvisualizandounapgina,mssibajaramoslabarra
dedesplazamiento,enlasotraspginasveremosquelosdatosvancambiando.

75

Losdatossernlistadosporpginas,sinembargo,sinoquisieramosqueselistende
estamanera,bastadesmarcarlaopcinOneRecordperPage.
Enelejemplodelacolumnadondetenemoslosdatos,aplicamosunformatode
hora creado.En este casousted puede crear formatos, usandoel Repositrio de
Funes(RepositoriodeFunciones) del men Ferramentas (Herramientas) de
Agata.

76

9MENUS

9.1Arquivo(Archivo)

9.1.1ConectaraoBancodeDados(ConectaralaBasedeDatos)
LlamalaventanainicialdeAgata,solicitandolosdatosparalaconexinalabase
dedatos,dondesonagregadasyremovidaslasconexionesconlabasededatos.

9.1.2NovoRelatrio(NuevoReporte)
Sirveparacrearunnuevoreporte.

9.1.3AbrirRelatrio(AbrirReporte)
Abreunreporteexistente.

9.1.4SalvarRelatrio(GuardarReporte)
Guardaelreportequeseestrealizando.

9.1.5SalvarComo(GuardarComo)
Permiteguardarelreporteenotrosformatosdearchivo.

77

9.1.6SalvaSQL(GuardarSQL)
GuardaelSQLgeneradoenelreporte,singuardarelreporte.

9.1.7PropriedadesdoRelatrio(PropiedadesdelReporte)

Figura70

Ajustesparaelreporte.

Figura71

78

9.1.8ParmetrosPersonalizados(ParmetrosPersonalizados)

Figura72

HagaclicenelbotnAdicionar(Agregar)paraagregarunnuevoparmetro.

Figura73

9.1.9ConfiguraesdePgina(ConfiguracionesdePgina)
ConfiguralapginaparaserexportadaenPDF.Siellargodelosdatos
fuese mayor que el tamao de la pgina del archivo, las informaciones no
aparecern,porestoesimportanteestaconfiguracin.
Uncarcternormalmenteequivaleadospixeles,osea,elvalorencaracteresdebe
ser,normalmente,lamitaddelvalordelospixeles.

79

Figura74

Figura75

9.1.10Sair(Salir)
CierraAgataypreguntasielreportedebeserguardado,encasodequeestenose
hayaguardadoanteriormente.

9.2Relatrio(Reporte)

9.2.1VisualizaoRpidadoRelatrio(VisualizacinRpidadelReporte)
Creaunavisualizacinrpidadelreportequeseestconstruyendo,apenaspara
verladisposicindeloscamposdelatablaenlahojaysusdatos.
OBS.: Almomentode exportarelreporte,laventanarepresentadaenla
figura 76, ser cargada en algunas situaciones. Esta ventana permite que se
escojaunlayoutparasureporte.

Figura76

ParaeditarlosLayoutbastairalmenFerramentas>Configuraode
Layout(Herramientas>ConfiguracindeLayout)

9.2.2ExportarRelatrioparaArquivoTXT(ExportarReportecomoarchivo
TXT)
PermiteexportarelreporteenelformatodearchivodetextoTXT.
9.2.3ExportarRelatrioparaArquivoPDF(ExportarReportecomoArchivo
PDF)
PermiteexportarelreporteenelformatodearchivoPDF.

82

9.2.4ExportarRelatrioparaArquivoHTML(ExportarReportecomo
archivoHTML)
ExportaelreporteenelformatodearchivoHTMLypuedesertransferidoa
Web.

9.2.5ExportarRelatrioparaArquivoXML(ExportarReportecomoArchivo
XML)
ExportaelreporteenelformatodearchivoXML.

9.2.6ExportarRelatrioparaArquivoCSV(ExportarReportecomoArchivo
CSV)
ExportaelreporteenelformatodearchivoCVS.

9.2.7ExportarRelatrioparaArquivoSXW(ExportarReportecomo
ArchivoSXW)
ExportaelreporteenelformatodearchivoSXW.

9.2.8ExportarcomoFormulrioTXT(ExportarcomoFormularioTXT)
ExportaelreportealformatodearchivoTXT.

9.2.9ExportarcomoHTMLemFrames(ExportarcomoHTMLenFrames)
ExportaelreportealformatodearchivoHTMLenframes.

83

9.3Ferramentas(Herramientas)

9.3.1DicionriodeDados(DiccionariodeDatos)
Esposibleencontrarmsinformacinenelcaptulo 4,referenteaestetema.

9.3.2PrefernciasdoSistema(PreferenciasdelSistema)
Definel as preferenciasdeAgata, comodirectoriodeInstalacin,salidade
reportes,dentreotrascarpetasdelsistema.
Configurao:Geral:(Configuracin:General:)definimoslasrutasparalos
archivosdeAgata.

Figura77

Configurao: Visualizadores: (Configuracin: Visualizadores:) cuando el

archivoseaexportado,Agatallamarelprogramaquecargaestaextensinde
archivoqueustedseleccion.Aqusepuededefinircualesprogramascargarn

estosarchivos.

84

85

Figura78

9.3.3ConfiguraesdoLayout(ConfiguracionesdeLayout)
Podemos cambiar los colores de los layouts aplicados en la salida de los
archivos. Estas configuraciones sern aplicadas cuando exportamos los mismos,
paraunformatoPDF,TXT,etc.Tambinesposiblecrearunnuevolayout.

Figura79

86

9.3.4ModelosdeEtiquetas
Altera datosde etiquetas existentes como modelos y permitelacreacinde
nuevosmodelosdeetiquetas.

Figura80

Figura81

9.3.5CriarDiagrama(CrearDiagrama)
Creaundiagramaapartirdelascolumnasseleccionadasdelastablasylas
exportaparaunarchivodediagrama,deDia(.DIA).

87

Figura82

Seleccionamos la columna de la tabla en el campo Escolha as tabelas

(Seleccione las tablas), y hacemos clic en Adicionar (Agregar), despus
seleccionamostodaslascolumnas(sosteniendolatecla Ctrl y haciendo clic
encima del nombre), yhacemoslos respectivos ajustes en los campos de
configuracin. Despusdeesto, hacemos clic en Criar Diagrama (Crear
Diagrama)yeldiagramaesgeneradoapartirdelosdatosincluidos,comoen
elejemplodelafigura83.


Figura83

88

89

9.3.6RepositriodeFunes(RepositoriodeFunciones)

Figura84

Aqu puedenser creadas y editadas funciones existentes e nAgata, ascomo

tambinpuedenprobarsefunciones.
Algunasobservacionesimportantesson:

LasfuncionessiempredebensercreadasenPHP;

Siemprequeseagregueunanuevafuncinse
recomienda,questatengalaletra(A)adelante,porejemplo:a_func;

Agatacargalasfuncionesjuntoconelprogramaunavezabierto,entonces

sihubierealgunaalteracinenlasfunciones, para cargarla debe cerrary

abrirAgatanuevamente,paraquelaalteracinseavlida.

90

10MDULOWEB

10.1InstalandooMduloWeb(InstalandoelMduloWeb)
Para instalar AgataWeb basta copiar el contenido de la subcarpeta /web
dentro de Agata y dejarla disponible sobre algn servidor Web (Apache o IIS).
Agatadebeestarinstaladaenelservidor.
Elarchivollamado ag
a
taw
e
b
.ini, contenido enAgataWeb, deber contener el
lugar de Instalacin de Agata Report en el servidor y el idioma de AgataWeb
utilizado.
Agata
web
agataweb.ini//<==EDITEESTEARQUIVO!!
index.php
sheet1.php
sheet2.php
sheet3.php
sheet4.php
start.php
site.css
...

91

Para disfrutar de los reportes no se olvide de copiar las carpetas reports y

projectsenelservidor(dentrodeldirectoriodondeAgataestinstalado).
Laprimeracarpetareportscontienelosarchivosconlosreportesylacarpeta
projectscontienelosproyectosconlasconfiguracionesdeconexinalasbasesde
datos.
Agata
projects
reports
functions
images
Para correr AgataWeb, PHP5 debe tener soporte a DOM en el servidor
(instalarconwithdom).TambinPHP.INIdebeseguiralgunasconfiguraciones:

magic_quotes_gpc = Off
register_argc_argv = On
allow_call_time_pass_reference = On
memory_limit = 128M
display_errors = On
error_reporting = E_ALL & ~E_NOTICE
No
se
olvide
de
cambiar
el
httpd.conf
configuracin de Apache):
DirectoryIndex index.php index.html

(Archivo

de

10.2MdulodeAcessoaoAgataviaWeb(MdulodeAccesoaAgatava
Web)
En AgataWeb, apenas generamosreportes, no podemos conectarnosala
basededatosyhacerseleccindetablas,apenastrabajamosconreportesguardados
previamenteconlastablaspreseleccionadas.

92

Enlafigura85tenemoslapantallainicialdelmduloWeb,cuandoescargada
enelnavegador,cargalaestructuradelascarpetasyreportesguardadosenAgata.

Figura85

Debemoshacerclicenelarchivodelreporteparaabrirlo.

10.3PartedoSQL(PartedelSQL)
Enla figura 86 tenemos el primer mdulo.Dondeen Agata solicitamos las
tablas y columnas; en el mdulo Web, apenas podemos dejar marcadas las que
deseamosdelasqueyaestnsolicitadasenelreporte.

91
90

Figura86

EnlapantallasepresentaelNombredelProyecto,abajovemoselnombreylugar
dondeseencuentra el archivo que abrimos y m s a b a j o u n c a m p o q u e
l i s t a l a s c o l u m n a s d e l a t a b l a , otroconelnombredelatablayotroconsus
restricciones.
Visualicemosnuestroreporteparavercomoquedo. Hagamosclicenelbotn
Proceder,yseabrirlasiguienteventana.

92

Figura87

Aqu podemos c r e a r restriciones y ordenar n uestrosdatos delas tablas,

hechoestohacemosclicenelbotnProcedernuevamente.

Figura88

93

Enestapantalla(Figura89)podemosseleccionarellayoutparanuestroreporte,
yenquetipodearchivosergenerado.HagaclicenelbotnDownloadparafinalizar.

Figura89

10.4Quebras(Agrupadores)
Enestemduloapenassonmostradoslosagrupadorescontenidosenel
reporteylasrespectivasfuncionesaplicadasalmismo.

94

Figura90

10.5Grfico
Apartirdelascolumnascontenidasenelreportepodemosgenerarlosgrficos
delneasycolumnas.

95

Figura91

10.6MesclagemdeRelatrio(MezcladodelReporte)
En el mdulo Web no tenemos la opcin de la pestaa para mezclar con
OpenOffice.org
TenemossolamentelasFerramentasdemesclagem(HerramientasdeMezclado)
yel Gerador de etiquetas(Generadordeetiquetas), ylaspestaasinferioresson:
Cabealho, Cabealho do Grupo, Detalhes, Rodap do Grupo e Rodap
(Encabezado,EncabezadodelGrupo,Detalles,PiedePginadelGrupoyPiede
Pgina).

96

Figura92

Eneste mdulo exportamos e l a rch i vo d i re c to a PDF atravs

dela opcin, Exportar parar arquivo PDF(ExportaraArchivoPDF), enla
parteinferiordelapantalla.(Figura92)