Capítulo 1

Introdução ao Rave Reports

Módulo 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
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;

Relató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.

Relatórios no Delphi 3
Capítulo 2
Conhecendo o Rave
Visual Designer

Módulo II
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.

Relatórios no Delphi
 Treinamento a Distância

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

Relatórios no Delphi 6
 Treinamento a Distância

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 Panel
No 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).

Relatórios no Delphi 7
 Treinamento a Distância

Figura 2.4. Property Panel do Rave Visual Designer

Project Tree
A 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).

Relatórios no Delphi 8
 Treinamento a Distância

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 Catalog

O 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 Dictionary

No 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).

Relatórios no Delphi 9
 Treinamento a Distância

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 Editor

O 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.

Relatórios no Delphi 10
 Treinamento a Distância

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

Relatórios no Delphi 11
 Treinamento a Distância

Conhecendo os componentes e ferramentas de formatação

O 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).

Relatórios no Delphi 12
 Treinamento a Distância

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.

Relatórios no Delphi 13
 Treinamento a Distância

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 Preferences
O 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

Relatórios no Delphi 14
 Treinamento a Distância

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 Principal
O 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.

Relatórios no Delphi 15