rave report no delphi

Mód

ulo

II

Introdução ao Rave ReportsCapítulo 1

Relatórios no Delphi

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

padrão para geração de relatórios, pelos desenvolvedores Delphi. A Nevrona

desenvolveu uma edição exclusiva para os produtos Borland, o Rave Reports Borland

Edition Version (Rave BEX).

Apesar de ser distribuído junto ao Delphi a partir da versão 7, o Rave não é uma ferra-

menta nova no mercado. Na verdade, o Rave é uma nova versão do Report Printer, ferra-

menta que está sendo mantida e desenvolvida desde a primeira versão do Delphi.

Principais características e funcionalidades• O Rave possui um ambiente totalmente visual para criação de relatórios. O Rave Visual

Designer é semelhante a IDE do Delphi, possuindo paleta de componentes e janelas pa-

recidas com o Object Inspector e Object TreeView;

• Com o Rave é possível criar relatórios para aplicações VCL, CLX e VCL.NET desenvolvi-

das em Delphi 6 a 2005 ou C++ Builder 6. Utilizando a versão para Linux podemos criar

aplicações multiplataforma utilizando o Kylix;

• Habilita o desenvolvimento de relatórios com acesso direto ao banco de dados, uti-

lizando diversas tecnologias, como: BDE, dbExpress, ADO e IBX. Possui ainda um editor

visual para criação de instruções SQL integrado ao ambiente;

• Salva relatórios nos formatos RTF, HTML, PDF e texto. Possui ainda um formato

proprietário (NDR);

• Possui diversas ferramentas para formatação dos relatórios, como alinhamento e

posicionamento de objetos;

• Todos os relatórios da aplicação podem ser salvos em um único arquivo Rave (RAV).

O Rave trabalha com o conceito de projetos, onde um projeto pode conter vários rela-

tórios;

• Os relatórios podem ser distribuídos separadamente do executável da aplicação ou

embutidos dentro do mesmo;

• Os relatórios são baseados em páginas, regiões e bandas;

• O Rave possibilita visualizar e testar os relatórios em tempo de projeto a partir do

Rave Visual Designer;

• Disponibiliza a criação de páginas globais para serem usadas como base para vários

relatórios;

• Total acesso aos objetos do relatório a partir da aplicação Delphi;

• Através da tecnologia de “espelhamento”, é possível reutilizar conteúdo e objeto

entre os relatórios do projeto Rave;

• Componentes para suporte a código de barras;

• Linguagem de programação própria (Rave Language) para codificação de eventos do

relatório;

3Relatórios no Delphi

Treinamento a Distância

• Wizards para criação de relatórios simples e mestre / detalhe;

• Possui um servidor web (versão Server) para disponibilizar relatórios em browsers;

• Disponibiliza um ambiente de desenvolvimento de relatórios para o usuário final,

onde o usuário pode alterar e criar seus próprios relatórios. Dependendo do nível de

conhecimento do usuário final, o Rave disponibiliza três níveis de acesso: beginner,

intermediate e advanced;

• Suporte para as versões 4 a 2005 do Delphi e 4 a 6 do C++ Builder.

Mód

ulo

II

Conhecendo o Rave Visual Designer

Capítulo 2

Relatórios no Delphi

O Rave Reports possui um ambiente totalmente visual para a criação de relató-

rios, o Rave Reports Visual Designer. A partir do Visual Designer é possível criar

relatórios stand-alone ou vinculados a uma aplicação Delphi.

Relatórios stand-alone, acessam diretamente o banco para selecionar os dados

a serem impressos, independente de uma aplicação feita em Delphi, por exemplo.

Nos exemplos deste módulo do curso foi utilizado a versão 5.0.8 do Rave, que

está para download no site da Borland, para usuários registrados. Você também

pode utilizar a versão que acompanha o Delphi 7 ou a versão Demo (5.1.3), que

esta para download no site da Nevrona.

Ou seja, você pode utilizar esse curso em várias versões do Rave (inclusive a versão .NET,

guardando é claro, algumas características).

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 opção Rave Visual Designer a partir do menu de contexto do

componente (Figura 2.1).

Menu de contexto refere-se ao menu de opções que aparece ao clicar com o

botão direito do mouse sobre um determinado componente ou área.



Figura 2.1. Acessando o Rave Visual Designer através 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 diretório de instalação do Delphi.

Você pode executar o ambiente visual do Rave a partir do Windows desde que a

IDE do Delphi esteja aberta. A versão Borland Edition (BEX) do Rave está vinculado

aos produtos da Borland (Delphi e C++ Builder).

Veja o Rave Reports Visual Designer em execução na Figura 2.2.

Figura 2.2. Rave Visual Designer do Rave Reports



Ao executar o Visual Designer você perceberá que ele possui várias semelhanças 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 relatório residem. É a área onde o layout do relató-

rio é feito. Um relatório Rave pode possuir vários 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 relatório a partir do TreeView

Property PanelNo Property Panel é possível acessar e alterar as propriedades de todos os componentes

do relatório. Bastante semelhante ao Object Inspector do Delphi, o Property Panel mostra

a propriedade em negrito quando seu valor padrão é alterado.

Outra característica, 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 é possível acessar todos os relatórios e objetos do projeto. Locali-

zado na parte esquerda da janela do Rave Visual Designer, é semelhante ao Object TreeView

do Delphi (Figura 2.5).

Figura 2.5. Project Tree para navegação entre os objetos do projeto Rave

O Project Tree possui três elementos principais em sua árvore: Report Library, Global Page

Catalog e Data View Dictionary.

Report LibraryÉ abaixo do Report Library que todos os relatórios e seus objetos são mostrados. Os ele-

mentos dentro do Report Library são mostrados de forma hierárquica (Figura 2.6).



Figura 2.6. Objetos da seção Report Library

Utilizando o Project Tree é possível selecionar qualquer objeto de qualquer relatório do

projeto. Veremos ainda neste capítulo os componentes não-visuais, cuja única forma de

acessar suas propriedades é a partir do Project Tree, pois eles, ao contrário dos componen-

tes não-visuais da VCL do Delphi, não aparecem em tempo de designer no Page.

Global Page CatalogO Global Page Catalog do Project Tree lista todas as páginas globais definidas no projeto

Rave. Páginas globais são utilizadas como templates, ou relatório base para os demais

relatórios do projeto. Em uma página global podemos definir cabeçalhos, rodapés, su-

mários, que podem ser “espelhados” nos relatórios do projeto. Como o Report Library,

o Global Page Catalog lista as páginas globais e seus elementos de forma hierárquica

(Figura 2.7).

Figura 2.7. Páginas globais do projeto Rave

Para adicionar uma página global ao projeto, basta selecionar a opção File|New Global

Page a partir do menu principal do Rave Visual Designer ou através do botão disponível

na barra de botões principal.

Data View DictionaryNo Data View Dictionary são mostrados todos os objetos relacionados a banco de dados e

segurança. Todas as conexões feitas diretamente ao banco de dados ou a partir de uma

aplicação Delphi são listadas no Data View Dictionary (Figura 2.8).



Figura 2.8. Data View Dictionary listando todas as conexões 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 opção File|New Data Object a partir

do menu principal do Rave Visual Designer ou clique no botão disponível na barra de

botões principal.

Os campos listados abaixo dos Driver Data View e Data View ficam disponíveis

para todos os relatórios do projeto.

Rave Event EditorO Rave possui uma linguagem de script que permite a implementação de eventos nos

relatórios, a Rave Language. O Event Editor é onde toda a codificação dos eventos é realiza-

da e onde definimos quais eventos serão implementados. O Rave possui um compilador

próprio para validar os scripts inseridos nos eventos, o RaveCC compiler. A Figura 2.9 mos-

tra um exemplo de script para o evento OnGetText do DataText1.



Figura 2.9. Janela Event Editor para definição de scripts

Componentes do Rave Visual Designer O Rave Visual Designer possui vários componentes (visuais e não-visuais) para serem usa-

dos na construção de relatórios. Além da biblioteca de componentes disponíveis junto

com a instalação do Rave, é possível adicionar novos componentes na IDE.

Como no Delphi, novos pacotes de componentes podem ser instalados para a utiliza-

ção nos relatórios do projeto. Para adicionar um novo pacote de componentes acesse

o menu Edit|Preferences>Packages ou clique no botão disponível na barra de botões

principal.

Os componentes do Rave Visual Designer são classificados em três grupos:

• Visuais: Componentes com ícone de fundo cinza (Figura 2.10);

Figura 2.10. Componentes visuais

• Visuais com acesso a dados: Componentes com ícone de fundo cinza, sinalizados com

um círculo vermelho (Figura 2.11);

Figura 2.11. Componentes visuais com acesso a dados

• Não-visuais: Componentes com ícone de fundo verde (Figura 2.12).

Figura 2.12. Componentes não-visuais



Conhecendo os componentes e ferramentas de formataçãoO Rave Visual Designer trás por padrão quatro paletas de componentes e seis paletas com

ferramentas para formatação dos objetos do relatório, que veremos a seguir:

Drawing

Possui os componentes visuais para a criação de formas geométricas, como quadrados,

retângulos, círculos, linhas etc. Componentes: Line, HLine, VLine, Rectangle, Square, Ellipse

e Circle;

Bar Code

Possui os componentes para impressão de códigos de barras. Componentes: PostNetBarCode,

I2of5BarCode, Code39BarCode, Code128BarCode, UPCBarCode e EANBarCode;

Standard

Possui os componentes visuais e não-visuais para uso nos relatórios. Componentes: Text,

Memo, Section, Bitmap, MetaFile, FontMaster e PageNumInit;

Report

Possui os componentes visuais e não-visuais com e sem acesso a dados para uso nos

relatórios. Componentes: DataText, DataMemo, CalcText, DataMirrorSection, Region, Band,

DataBand, DataCycle, CalcOp, CalcTotal e CalcController;

Zoom

Possui opções para redimensionar a área de designer do relatório (Page Designer).

Opções: Zoom Tool, Zoom In, Zoom Out, Zoom to Selected Objects, Zoom to Page Width e

Zoom to Whole Page.

Colors

Possui diversas opções 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 opções de formatação a serem usadas em conjunto com os componen-

tes da paleta Drawing. A opção Line Width é utilizada para alterar a largura da borda do

componente selecionado. Quando o item Hairline está selecionado, é habilitada a opção

Line Style para definir o estilo da borda do componente. A opção Line Width é equivalente

a propriedade BorderWidth, enquanto que a opção Line Style é equivalente a propriedade

BorderStyle.

A paleta Lines só é habilitada quando um componente da paleta Drawing é sele-

cionado no relatório.

Fills

Fills

Possui diversas opções de formatação para serem usadas nos seguintes componentes

da paleta Drawing: Rectangle, Square, Ellipse e Circle. Quando um desses é selecionado, a

paleta Fills é habilitada. As opções disponíveis na paleta Fills são as mesmas disponíveis na

propriedade FillStyle. Opções: 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 opções da paleta Fills é definida na propriedade FillColor.

Fonts

Possui várias opções para formatação de fonte. Essa paleta é habilitada sempre que

um componente que possua a propriedade Font é selecionado. É possível alterar o nome

da fonte, tamanho, estilo e posicionamento. Opções: Font Name, Font Size, Bold, Italic,

Underline, Left Justify, Center Justify e Right Justify.



Alignment

É utilizada para alinhar e posicionar componentes visuais dentro do relatório. É bastan-

te útil para o alinhamento de vários componentes ao mesmo tempo. Além das opções

gerais de alinhamento, é possível enviar um componente para trás ou para frente de

outro componente.

Utilizando as últimas quatro opções da paleta é possível mover o componente selecio-

nado em qualquer direção dentro do relatório.

A janela PreferencesO Rave Visual Designer possui uma janela para configurações gerais, a janela Preferences.

Selecione a opção Edit|Preferences a partir do menu principal do Rave Designer ou pressio-

ne o botão para abrir a janela Preferences (Figura 2.13).

Figura 2.13. Janela Preferences para definição de configurações gerais do Rave Visual Designer

A partir da janela Preferences é possível configurar diversas opções do Rave Visual

Designer. Para as propriedades numéricas dos componentes é possível definir o número

de casas decimais a ser utilizada para a precisão das mesmas, utilizando a opção Decimal

Points Shown (Environment), por exemplo.

Dentro da opção Designer é possível configurar a valor de incremento para o zoom do

Page, como também as bordas e cores a serem usadas. Na opção Defaults pode-se definir

o tamanho do papel a ser usado por padrão, como também a unidade de medida a ser

utilizada nos relatórios.

Selecionando Printing é possível definir o destino da impressão, como Preview ou Print,

além do estado da janela de preview, como: maximizado, minimizado ou normal.

Na seção Packages temos a opção de instalar novos pacotes de componentes Rave



dentro da IDE (veremos como realizar essa opção no capítulo de Dicas). Selecionando a

opção Shortcuts podemos definir teclas de atalhos para as principais opções disponíveis

no Rave Visual Designer.

Menu PrincipalO menu principal do Rave Designer divide-se em cinco categorias: File, Zoom, Edit, Tools

e Help.

As principais opções estão localizadas no menu File, que são:

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 diretório ou com outro nome;

Import: é possível importar objetos e relatórios de outro projeto Rave para dentro do

projeto atual;

Export: podemos exportar objetos e relatórios do projeto atual para outro projeto

Rave;

New Report: cria um novo relatório no projeto corrente;

New Global Page: cria uma nova página global no projeto atual;

New Report Page: cria uma nova página para o relatório selecionado no projeto cor-

rente;

New Data Object: cria um novo objeto dentro do projeto atual;

Execute Report: executa o relatório selecionado no projeto corrente;

Exit: fecha o Rave Visual Designer.

O menu Zoom trás opções semelhantes a paleta Zoom, que são aplicadas sobre o Page

da página do relatório selecionado. O menu Edit trás opções padrões, como recortar,

copiar e colar.

O menu Tools trás dois assistentes para criação de relatórios: Simple Table e Master/Detail

Report. Utilizando os wizards é possível criar relatórios simples rapidamente.

O menu Help trás informações sobre a versão do Rave, atalhos para o arquivo de ajuda do

Rave Designer, atualizações e suporte técnico.

rave report no delphi

Documents