4941622 rave report no delphi

Introduo ao Rave Reports

Captulo 1

Mdulo II

O

Rave Reports desenvolvido e mantido pela empresa Nevrona Designs (www.nevrona.com). A partir do Delphi 7 o Rave Reports tornou-se a ferramenta padro para gerao de relatrios, pelos desenvolvedores Delphi. A Nevrona

desenvolveu uma edio exclusiva para os produtos Borland, o Rave Reports Borland Edition Version (Rave BEX). Apesar de ser distribudo junto ao Delphi a partir da verso 7, o Rave no uma ferramenta nova no mercado. Na verdade, o Rave uma nova verso do Report Printer, ferramenta que est sendo mantida e desenvolvida desde a primeira verso do Delphi.

Principais caractersticas e funcionalidades O Rave possui um ambiente totalmente visual para criao de relatrios. O Rave Visual Designer semelhante a IDE do Delphi, possuindo paleta de componentes e janelas parecidas com o Object Inspector e Object TreeView; Com o Rave possvel criar relatrios para aplicaes VCL, CLX e VCL.NET desenvolvidas em Delphi 6 a 2005 ou C++ Builder 6. Utilizando a verso para Linux podemos criar aplicaes multiplataforma utilizando o Kylix; Habilita o desenvolvimento de relatrios com acesso direto ao banco de dados, utilizando diversas tecnologias, como: BDE, dbExpress, ADO e IBX. Possui ainda um editor visual para criao de instrues SQL integrado ao ambiente; Salva relatrios nos formatos RTF, HTML, PDF e texto. Possui ainda um formato proprietrio (NDR); Possui diversas ferramentas para formatao dos relatrios, como alinhamento e posicionamento de objetos; Todos os relatrios da aplicao podem ser salvos em um nico arquivo Rave (RAV). O Rave trabalha com o conceito de projetos, onde um projeto pode conter vrios relatrios; Os relatrios podem ser distribudos separadamente do executvel da aplicao ou embutidos dentro do mesmo; Os relatrios so baseados em pginas, regies e bandas; O Rave possibilita visualizar e testar os relatrios em tempo de projeto a partir do Rave Visual Designer; Disponibiliza a criao de pginas globais para serem usadas como base para vrios relatrios; Total acesso aos objetos do relatrio a partir da aplicao Delphi; Atravs da tecnologia de espelhamento, possvel reutilizar contedo e objeto entre os relatrios do projeto Rave; Componentes para suporte a cdigo de barras; Linguagem de programao prpria (Rave Language) para codificao de eventos do relatrio;

Relatrios no Delphi

Treinamento a Distncia

Wizards para criao de relatrios simples e mestre / detalhe; Possui um servidor web (verso Server) para disponibilizar relatrios em browsers; Disponibiliza um ambiente de desenvolvimento de relatrios para o usurio final, onde o usurio pode alterar e criar seus prprios relatrios. Dependendo do nvel de conhecimento do usurio final, o Rave disponibiliza trs nveis de acesso: beginner, intermediate e advanced; Suporte para as verses 4 a 2005 do Delphi e 4 a 6 do C++ Builder.

Relatrios no Delphi 3

Captulo 2Conhecendo o Rave Visual Designer

Mdulo II

O

Rave Reports possui um ambiente totalmente visual para a criao de relatrios, o Rave Reports Visual Designer. A partir do Visual Designer possvel criar relatrios stand-alone ou vinculados a uma aplicao Delphi.

Relatrios stand-alone, acessam diretamente o banco para selecionar os dados a serem impressos, independente de uma aplicao feita em Delphi, por exemplo.

Nos exemplos deste mdulo do curso foi utilizado a verso 5.0.8 do Rave, que est para download no site da Borland, para usurios registrados. Voc tambm pode utilizar a verso que acompanha o Delphi 7 ou a verso Demo (5.1.3), que esta para download no site da Nevrona.

Ou seja, voc pode utilizar esse curso em vrias verses do Rave (inclusive a verso .NET, guardando claro, algumas caractersticas). Voc pode acessar o Rave Visual Designer a partir da IDE do Delphi de duas maneiras: selecionando o menu Tools|Rave Designer do Delphi ou adicionando um RvProject (Rave) ao projeto e selecionando a opo Rave Visual Designer a partir do menu de contexto do componente (Figura 2.1).

Menu de contexto refere-se ao menu de opes que aparece ao clicar com o boto direito do mouse sobre um determinado componente ou rea.

Relatrios no Delphi


Figura 2.1. Acessando o Rave Visual Designer atravs da IDE do Delphi O Rave Visual Designer pode ser acessado diretamente a partir do Windows. Execute o arquivo Rave.exe que est na pasta Rave5, no diretrio de instalao do Delphi.

Voc pode executar o ambiente visual do Rave a partir do Windows desde que a IDE do Delphi esteja aberta. A verso Borland Edition (BEX) do Rave est vinculado aos produtos da Borland (Delphi e C++ Builder).

Veja o Rave Reports Visual Designer em execuo na Figura 2.2.

Figura 2.2. Rave Visual Designer do Rave Reports



Ao executar o Visual Designer voc perceber que ele possui vrias semelhanas a IDE do Delphi, como a paleta de componentes na parte superior e o Property Panel (equivalente ao Object Inspector) esquerda.

O Page no Page onde todos os objetos do relatrio residem. a rea onde o layout do relatrio feito. Um relatrio Rave pode possuir vrios Pages. Eles podem ser acessados a partir do Project Tree (equivalente ao Object TreeView) localizado na parte direita da janela do Rave Visual Designer (Figura 2.3).

Figura 2.3. Acessando os Page do relatrio a partir do TreeView

Property PanelNo Property Panel possvel acessar e alterar as propriedades de todos os componentes do relatrio. Bastante semelhante ao Object Inspector do Delphi, o Property Panel mostra a propriedade em negrito quando seu valor padro alterado. Outra caracterstica, fica por conta da ajuda localizada na parte inferior da janela do Property Panel, que mostra um texto explicativo sobre a propriedade selecionada (Figura 2.4).



Figura 2.4. Property Panel do Rave Visual Designer

Project TreeA partir do Project Tree possvel acessar todos os relatrios e objetos do projeto. Localizado na parte esquerda da janela do Rave Visual Designer, semelhante ao Object TreeView do Delphi (Figura 2.5).

Figura 2.5. Project Tree para navegao entre os objetos do projeto Rave O Project Tree possui trs elementos principais em sua rvore: Report Library, Global Page Catalog e Data View Dictionary.

Report Library abaixo do Report Library que todos os relatrios e seus objetos so mostrados. Os elementos dentro do Report Library so mostrados de forma hierrquica (Figura 2.6).



Figura 2.6. Objetos da seo Report Library Utilizando o Project Tree possvel selecionar qualquer objeto de qualquer relatrio do projeto. Veremos ainda neste captulo os componentes no-visuais, cuja nica forma de acessar suas propriedades a partir do Project Tree, pois eles, ao contrrio dos componentes no-visuais da VCL do Delphi, no aparecem em tempo de designer no Page.

Global Page CatalogO Global Page Catalog do Project Tree lista todas as pginas globais definidas no projeto Rave. Pginas globais so utilizadas como templates, ou relatrio base para os demais relatrios do projeto. Em uma pgina global podemos definir cabealhos, rodaps, sumrios, que podem ser espelhados nos relatrios do projeto. Como o Report Library, o Global Page Catalog lista as pginas globais e seus elementos de forma hierrquica (Figura 2.7).

Figura 2.7. Pginas globais do projeto Rave Para adicionar uma pgina global ao projeto, basta selecionar a opo File|New Global Page a partir do menu principal do Rave Visual Designer ou atravs do boto na barra de botes principal. disponvel

Data View DictionaryNo Data View Dictionary so mostrados todos os objetos relacionados a banco de dados e segurana. Todas as conexes feitas diretamente ao banco de dados ou a partir de uma aplicao Delphi so listadas no Data View Dictionary (Figura 2.8).



Figura 2.8. Data View Dictionary listando todas as conexes com o banco Podem ser adicionados ao Data View Dictionary os seguintes Data Objects: Data Lookup Security Controller; Database Connection; Direct Data View; Driver Data View; Simple Security Controller.

Veremos cada um dos Data Object listados anteriormente durante o decorrer do curso.

Para adicionar um Data Object ao projeto, selecione a opo File|New Data Object a partir do menu principal do Rave Visual Designer ou clique no boto botes principal. disponvel na barra de

Os campos listados abaixo dos Driver Data View e Data View ficam disponveis para todos os relatrios do projeto.

Rave Event EditorO Rave possui uma linguagem de script que permite a implementao de eventos nos relatrios, a Rave Language. O Event Editor onde toda a codificao dos eventos realizada e onde definimos quais eventos sero implementados. O Rave possui um compilador prprio para validar os scripts inseridos nos eventos, o RaveCC compiler. A Figura 2.9 mostra um exemplo de script para o evento OnGetText do DataText1.



Figura 2.9. Janela Event Editor para denio de scripts

Componentes do Rave Visual DesignerO Rave Visual Designer possui vrios componentes (visuais e no-visuais) para serem usados na construo de relatrios. Alm da biblioteca de componentes disponveis junto com a instalao do Rave, possvel adicionar novos componentes na IDE. Como no Delphi, novos pacotes de componentes podem ser instalados para a utilizao nos relatrios do projeto. Para adicionar um novo pacote de componentes acesse o menu Edit|Preferences>Packages ou clique no boto principal. Os componentes do Rave Visual Designer so classificados em trs grupos: Visuais: Componentes com cone de fundo cinza (Figura 2.10); disponvel na barra de botes

Figura 2.10. Componentes visuais Visuais com acesso a dados: Componentes com cone de fundo cinza, sinalizados com um crculo vermelho (Figura 2.11);

Figura 2.11. Componentes visuais com acesso a dados No-visuais: Componentes com cone de fundo verde (Figura 2.12).

Figura 2.12. Componentes no-visuais



Conhecendo os componentes e ferramentas de formataoO Rave Visual Designer trs por padro quatro paletas de componentes e seis paletas com ferramentas para formatao dos objetos do relatrio, que veremos a seguir: Drawing

Possui os componentes visuais para a criao de formas geomtricas, como quadrados, retngulos, crculos, linhas etc. Componentes: Line, HLine, VLine, Rectangle, Square, Ellipse e Circle; Bar Code

Possui os componentes para impresso de cdigos de barras. Componentes: PostNetBarCode, I2of5BarCode, Code39BarCode, Code128BarCode, UPCBarCode e EANBarCode; Standard

Possui os componentes visuais e no-visuais para uso nos relatrios. Componentes: Text, Memo, Section, Bitmap, MetaFile, FontMaster e PageNumInit; Report

Possui os componentes visuais e no-visuais com e sem acesso a dados para uso nos relatrios. Componentes: DataText, DataMemo, CalcText, DataMirrorSection, Region, Band, DataBand, DataCycle, CalcOp, CalcTotal e CalcController; Zoom

Possui opes para redimensionar a rea de designer do relatrio (Page Designer). Opes: Zoom Tool, Zoom In, Zoom Out, Zoom to Selected Objects, Zoom to Page Width e Zoom to Whole Page. Colors

Possui diversas opes de cores para serem usadas em componentes que possuem propriedades relacionadas a cores, como por exemplo as propriedades Color (DataText), BorderColor (Rectangle) e FillColor (Rectangle).



Lines

Possui algumas opes de formatao a serem usadas em conjunto com os componentes da paleta Drawing. A opo Line Width utilizada para alterar a largura da borda do componente selecionado. Quando o item Hairline est selecionado, habilitada a opo Line Style para definir o estilo da borda do componente. A opo Line Width equivalente a propriedade BorderWidth, enquanto que a opo Line Style equivalente a propriedade BorderStyle.

A paleta Lines s habilitada quando um componente da paleta Drawing selecionado no relatrio.

Fills Fills

Possui diversas opes de formatao para serem usadas nos seguintes componentes da paleta Drawing: Rectangle, Square, Ellipse e Circle. Quando um desses selecionado, a paleta Fills habilitada. As opes disponveis na paleta Fills so as mesmas disponveis na propriedade FillStyle. Opes: Solid Fill, Horizontal Fill, Forward Diagonal Fill, Vertical Fill, B ackward Diagonal Fill, Crosshatch Fill, Diagonal Crosshatch Fill e No Fill.

A cor utilizada nas opes da paleta Fills definida na propriedade FillColor.

Fonts

Possui vrias opes para formatao de fonte. Essa paleta habilitada sempre que um componente que possua a propriedade Font selecionado. possvel alterar o nome da fonte, tamanho, estilo e posicionamento. Opes: Font Name, Font Size, Bold, Italic, Underline, Left Justify, Center Justify e Right Justify.



Alignment

utilizada para alinhar e posicionar componentes visuais dentro do relatrio. bastante til para o alinhamento de vrios componentes ao mesmo tempo. Alm das opes gerais de alinhamento, possvel enviar um componente para trs ou para frente de outro componente. Utilizando as ltimas quatro opes da paleta possvel mover o componente selecionado em qualquer direo dentro do relatrio.

A janela PreferencesO Rave Visual Designer possui uma janela para configuraes gerais, a janela Preferences. Selecione a opo Edit|Preferences a partir do menu principal do Rave Designer ou pressione o boto para abrir a janela Preferences (Figura 2.13).

Figura 2.13. Janela Preferences para denio de conguraes gerais do Rave Visual Designer A partir da janela Preferences possvel configurar diversas opes do Rave Visual Designer. Para as propriedades numricas dos componentes possvel definir o nmero de casas decimais a ser utilizada para a preciso das mesmas, utilizando a opo Decimal Points Shown (Environment), por exemplo. Dentro da opo Designer possvel configurar a valor de incremento para o zoom do Page, como tambm as bordas e cores a serem usadas. Na opo Defaults pode-se definir o tamanho do papel a ser usado por padro, como tambm a unidade de medida a ser utilizada nos relatrios. Selecionando Printing possvel definir o destino da impresso, como Preview ou Print, alm do estado da janela de preview, como: maximizado, minimizado ou normal. Na seo Packages temos a opo de instalar novos pacotes de componentes Rave



dentro da IDE (veremos como realizar essa opo no captulo de Dicas). Selecionando a opo Shortcuts podemos definir teclas de atalhos para as principais opes disponveis no Rave Visual Designer.

Menu PrincipalO menu principal do Rave Designer divide-se em cinco categorias: File, Zoom, Edit, Tools e Help. As principais opes esto localizadas no menu File, que so: New: cria um novo projeto Rave (RAV); Open: abre um projeto Rave existente; Reopen Project: mostra uma lista dos ltimos projetos acessados; Save: salva o projeto atual; Save as: salva o projeto atual em outro diretrio ou com outro nome; Import: possvel importar objetos e relatrios de outro projeto Rave para dentro do projeto atual; Export: podemos exportar objetos e relatrios do projeto atual para outro projeto Rave; New Report: cria um novo relatrio no projeto corrente; New Global Page: cria uma nova pgina global no projeto atual; New Report Page: cria uma nova pgina para o relatrio selecionado no projeto corrente; New Data Object: cria um novo objeto dentro do projeto atual; Execute Report: executa o relatrio selecionado no projeto corrente; Exit: fecha o Rave Visual Designer. O menu Zoom trs opes semelhantes a paleta Zoom, que so aplicadas sobre o Page da pgina do relatrio selecionado. O menu Edit trs opes padres, como recortar, copiar e colar. O menu Tools trs dois assistentes para criao de relatrios: Simple Table e Master/Detail Report. Utilizando os wizards possvel criar relatrios simples rapidamente. O menu Help trs informaes sobre a verso do Rave, atalhos para o arquivo de ajuda do Rave Designer, atualizaes e suporte tcnico.


4941622 rave report no delphi

Documents