EDIÇÃO DE TEMPLATES

PROJECTO COLIBRI RCP 5.0

2009
Esta guia destina-se aos utilizadores da versão 5.0 do Projecto Colibri RCP.

Os utilizadores da versão PRO podem editar todos os seus templates e acrescentar nos campos
através do Colibri, os utilizadores da versão FREE podem personalizar os seus templates mas
não poderão acrescentar novos campos aos seus templates.
BIRT RCP DESIGNER

O BIRT RCP Designer é composto por 4 vistas principais:

1. Palette
2. Editor Area
3. Outline
4. Property editor

• Na vista de Palette, podemos encontrar os componentes para adicionar ao

nosso layout;
• Na vista Editor Area, podemos visualizar o layout do nosso template;
• Na vista Outline, temos todos os componentes do nosso template.
• Na vista Property Editor, é a vista utilizada para definirmos as
propriedades de cada um dos nosso componentes.

Para fazer download gratuito, podem utilizar o site oficial:

http://download.eclipse.org/birt/downloads/ - RCP Designer versão 2.5.0
PROCESSO DE EDIÇÃO DE TEMPLATES – EXPORTAR

Para aceder à área de templates no Colibri, abra as Preferências (Menu Ficheiro >
Preferências) e seleccione a opção Templates.

Seleccione o template que pretende editar e carregue em Exportar.

Importante: Uma diferença relativamente à versão 4.0, é que ao exportar o seu

template adicionalmente irá ser exportado um ficheiro com o mesmo nome, mas
com extensão *.rptfetch (será explicado nos proximos passos)
PROCESSO DE EDIÇÃO DE TEMPLATES – EDITAR

1) Abra o BIRT.exe
2) Aceda ao Menu: File > Open File
3) Seleccione o ficheiro que exportou

Como exemplo: Vamos editar a cor das colunas da tabela.

Para isso seleccionamos as várias labels que estão inseridas nas colunas da tabela
(tecla CTRL) para selecção múltipla
Acedemos à vista Property Editor, opção General, Background Color e
seleccionamos a opção Black. Seleccionamos agora a opção Color e seleccionamos
a opção White.

Aceda ao Menu File > Save para gravar as alterações e feche o BIRT.exe

Importante

Os plugins utilizados na versão 5.0 do Projecto Colibri, encontram-se na versão

2.3.2 (ainda não se encontra disponível a versão 2.5 para incorporar no Projecto
Colibri) por este motivo temos de trocar no XML o número da versão, para ao
templates poderem ser utilizados no Colibri.

Para isso abrimos o ficheiro 101 – Existencias – Preço de custo.rptdesign com o

Wordpad.
Alteramos a versão para 3.2.17

Gravamos as alterações.

PROCESSO DE EDIÇÃO DE TEMPLATES – IMPORTAR

Agora que os templates estão editados vamos importar no Colibri.

Acedemos ao menu Preferências> Templates seleccionamos o template que

editamos, 101 – Existências – Preço de Custo e carregamos em Importar.

Seleccionamos os templates na nossa directoria e carregue em Abrir.

Nota: Antes de editar verifique se tem na mesma directoria os dois ficheiros com o
mesmo nome:

101 – Existências – Preço de custo.rptdesign

101 – Existências – Preço de custo.rptfetch

Só desta forma pode utilizar o template correctamente.

Para Pré-visualizar o Mapa, acedemos a Artigos> Ficheiro de Artigos

Seleccionamos o mapa 101, e carregamos em Prever Relatório.

Preview:
O RPTFETCH

Uma das diferenças relativamente à versão 4.0 é a utilização dos ficheiros

rptfetch.

Na edição do template se aceder à vista Outline e expandir o Nó: Datasets irá

encontrar todos os campos da tabela à sua disposição para incorporar no seu
template.

De forma a optimizar os templates utilizamos o rptfetch para indicar quais os

campos que estão de facto a ser utilizados no nosso report, que são todos aqueles
que estão na vista layout.

Seguindo o exemplo do ficheiro 101 – Existencias – Preço de custo.rptdesign,

podemos ver que no layout do template apenas estamos a utilizar os campos:

• D1-2
• D1-5
• D1-13
• D1-24
• D1-21
• D2-6

Para visualizar quais são os campos correspondentes, clicamos sobre Datasets >
d1-artigos na vista Outline
Na janela de Propriedades que irá surgir, carregue sobre a opção Output
Columns, assim podemos ver que:

• D1-2 corresponde ao campo: 1-artigos: Código

• D1-5 corresponde ao campo: 1-artigos: Descrição

Isto facilita na identificação dos campos que estamos a utilizar, assim se

acrescentarmos mais um campo ao nosso layout apenas temos que identificar qual
a referencia deste campo.

Como exemplo vamos acrescentar o campo: Data Criação ao nosso template

Na janela de propriedades identificamos que D1-4 representa o campo: 1-artigos:

Data Criação

Gravamos as alterações do nosso template.

No Colibri, acedemos ao menu de Preferencias> Templates

Duplo clique sobre o template que editamos e passamos o campo Data de Criação
de Tabela para layout.

Nota: Apenas na versão PRO poderá acrescentar novos campos aos seus
templates, na versão FREE todas as opções de adicionar novos campos estão
inactivas.