Gerador de Relatórios

Copyright ® 2016
By Softplan Ltda.

Rodovia SC 401, km 1, n°10.

ParqTec Alfa
Florianópolis – SC
88030-000
Telefone: (48) 3027-8000
Home Page: http://www.softplan.com.br

Sugestões para a apostila: eadsienge@softplan.com.br

Todos os direitos reservados.

Este manual não pode ser reproduzido, total ou parcialmente, sem autorização da Softplan.
Clientes que adquiriram o software Sienge estão autorizados a reproduzir o manual para uso
interno a fins didáticos.

Elaboração e redação: Consultoria e Equipe de Ensino – Unidade Indústria da Construção –

UNIC.
Sumário

Gerador de Relatórios ................................................................................................................... 4

O que é? .................................................................................................................................... 4
Como Funciona? ....................................................................................................................... 4
Facilidades e Benefícios ........................................................................................................... 4
Como Funciona o Gerador de Relatórios no Sienge? .................................................................. 4
Itens de Menu ............................................................................................................................ 4
Tela de Consulta ....................................................................................................................... 5
Emissão de Relatório ................................................................................................................ 5
Funcionamentos Através de Modelos ....................................................................................... 6
Download dos Arquivos de Modelo do Sienge ......................................................................... 6
Eclipse ........................................................................................................................................... 7
O que é? .................................................................................................................................... 7
Plug-in BIRT .............................................................................................................................. 7
Onde Encontrar? ....................................................................................................................... 7
Como Instalar? .......................................................................................................................... 8
Como baixar um modelo do Sienge ........................................................................................ 13
Vá ao canto inferior direito da tela e clique no botão Modelos. Ao abrir os modelos
cadastrados, selecione um para baixar e depois editar. Para baixar, clique no ícone para
download . ......................................................................................................................... 14
Como Abrir um Modelo ........................................................................................................... 14
Como Gerar/Alterar um Modelo de Relatório? ........................................................................ 17
Adicionar ou Remover Linhas/Colunas nas Tabelas de Relatório.......................................... 18
Criando rótulos para colunas novas ........................................................................................ 19
Adicionar Campos nas Linhas/Colunas .................................................................................. 20
Agrupamentos ......................................................................................................................... 20
Totalizações ............................................................................................................................ 22
Campos Computados .............................................................................................................. 23
Ordenação em Tabelas e Ordenação por Agrupamentos ...................................................... 27
Como Importar?........................................................................................................................... 28
Importando Modelos no Sienge .............................................................................................. 28
Dicas para Utilização ................................................................................................................... 30
Gerador de Relatórios

O que é?

Um gerador de relatórios é uma ferramenta utilizada para proporcionar aos usuários de um

sistema a flexibilidade para montar seus próprios relatórios. Ele permite que o usuário configure
e personalize seus relatórios, sem a necessidade de solicitar desenvolvimento aos
fornecedores do software.

Como Funciona?

Através de plataformas de configurações simplificadas, os modelos de relatórios são gerados e

utilizados sem que haja intervenção do fornecedor de software. Estas plataformas utilizam
comandos básicos de programação, esquemas de clique e arraste, menus e funções similares
às dos programas de edição de planilhas, texto e apresentações.

Facilidades e Benefícios

Com o Gerador de Relatórios do Sienge, todas as informações necessárias para o cruzamento

de dados serão disponibilizados pela Softplan, bem como modelos pré-configurados com as
principais operações dos sistemas.
Os benefícios dessa ferramenta são percebidos principalmente no auxílio aos tomadores de
decisões e na exatidão de informações nas operações do Sienge.

Como Funciona o Gerador de Relatórios no Sienge?

Itens de Menu

Os relatórios configuráveis, chamados assim devido à possibilidade de configuração e

personalização dos modelos pré-cadastrados, serão disponibilizados nos sistemas como um
novo item de menu, à medida que forem liberados pela Softplan.

4
Tela de Consulta

Através da tela de consulta dos relatórios configuráveis, vamos fazer a seleção dos
parâmetros, o que possibilita a inserção de parâmetros básicos e avançados e a seleção de
modelos.

Emissão de Relatório

Para emitir um relatório configurável utilizando o modelo existente, neste caso, pré-configurado
pela Softplan, basta que usuário insira os parâmetros necessários para consulta e clique em
Visualizar. Os relatórios serão abertos em uma nova janela e permitem que o usuário faça a
navegação através de botões de operações.

5
 Alternar tabelas de conteúdos: permite realizar a busca pelos agrupamentos
configurados no relatório.

Exportar dados: exporta os dados selecionados em .csv.

Exportar relatório: exporta o relatório em .xls, .doc, .pdf, .ppt, entre outros.

Imprimir: realiza a impressão do relatório em HTML ou PDF.

Botões de navegação: permitem navegar entre as páginas do relatório.

Funcionamentos Através de Modelos

Os relatórios configuráveis são editados e manipulados através da criação de modelos, ou

seja, a Softplan disponibiliza no Sienge um modelo pré-cadastrado com as configurações
iniciais de banco de dados, programação e principais campos. Este modelo deverá ser aberto
na ferramenta de edição (Eclipse com plug-in BIRT). Para realizar a personalização dos
relatórios configuráveis, devemos buscar o “modelo padrão” no Sienge, realizar o download,
editá-lo na ferramenta e salvá-lo para posterior importação do novo modelo criado para o
Sienge.

Download dos Arquivos de Modelo do Sienge

Através do botão Modelos podemos visualizar todos os modelos disponíveis para utilização.
Nesta página também veremos como realizar o download e adicionar modelos já editados.

6
Eclipse

O que é?

Um IDE – Integrated Development Environment (Ambiente de Desenvolvimento Integrado) - é

um software que contém um conjunto de funcionalidades embutidas, cuja finalidade é prover
um modo mais fácil e interativo de construir e manipular seus programas.

Plug-in BIRT

O Eclipse BIRT é uma solução de Business Intelligence, de origem comercial, cedida pela
empresa Actuate Corporation© à comunidade Open Source há alguns anos atrás. O Eclipse
BIRT traz plugins no Eclipse que permitem a confecção visual de relatórios incluindo quebras e
totalizações, cubos, consultas tipo planilha, sub-relatórios e muitos outros recursos, obtidos
com funções de “arrasta e solta” e conhecimentos básicos de programação.

Onde Encontrar?

Através do site da Eclipse Foundation é possível realizar download das versões mais
atualizadas da ferramenta: http://eclipse.org/BIRT
Também existem diversos fóruns, discussões e tutoriais. Porém, a maioria deles disponibilizado
na língua inglesa.

7
Importante: para utilização do eclipse é necessária a instalação prévia do JDK – Java
Development Kit que pode ser encontrado em
http://www.oracle.com/technetwork/pt/java/javase/overview/index.html

Como Instalar?

Atenção: Todos os computadores que realizarão a manipulação dos modelos de relatórios

configuráveis devem possuir o eclipse instalado na máquina.
Acesse o link http://www.oracle.com/technetwork/pt/java/javase/downloads/index.html
Aceite os termos de uso do software.

Escolha seu sistema operacional (Use Windows x86 para versão 32bits e x64 para 64bits).

Clique duas vezes no arquivo de instalação.

Clique em instalar.

8
Após o termino da instalação, clique em fechar.

Faça o download do Eclipse/BIRT em http://www.eclipse.org/birt/

9
Clique em “Download Birt 4.4.0”.

Escolha a versão All-in-One e clique em “Download Now”.

Ou acesse diretamente o link https://www.eclipse.org/downloads/packages/eclipse-ide-java-

and-report-developers/lunar
Escolha seu sistema operacional.

10
Extraia os arquivos compactados usando Winzip ou Winrar (http://www.win-
rar.com/download.html?&L=0).

Acesse a pasta que acabou de ser descompactada e crie um atralho do executável do Eclipse
na área de trabalho.

11
Uma das características do Eclipse é que ele não é um software que será instalado em seu
computador. Isto é, ele é um arquivo compactado que, após efetuar o download, você deve
descompactá-lo em um diretório de preferência. Após descompactar o arquivo você terá a
seguinte estrutura:

Para iniciarmos o Eclipse devemos clicar sobre o ícone. Irá abrir uma janela dizendo para
selecionar o workspace desejado (workspace é o local padrão em que o eclipse armazena os
projetos criados), após selecionar o workspace clique em OK e a seguinte tela será aberta:

12
Como baixar um modelo do Sienge

É possível baixar um modelo de relatório a partir do Sienge e sobre o mesmo realizar

alterações. Para esta operação você pode acessar um local do sistema onde há um ou mais
modelos cadastrados, como por exemplo: Financeiro > Contas a Pagar > Relatórios
Configuráveis > Contas a Pagar.

13
Vá ao canto inferior direito da tela e clique no botão Modelos. Ao abrir os modelos cadastrados,

selecione um para baixar e depois editar. Para baixar, clique no ícone para download .

Como Abrir um Modelo

Após iniciar o Eclipse, é necessário configurá-lo para que a visualização seja feita no modo de
Report Design (Desenho de Relatório). Para isso clique em Window > Open Perspective >
Report Design.

Depois de configurada a forma de visualização, siga os passos para abrir os modelos de

relatórios configuráveis.

14
Principais funcionalidades que serão utilizadas para edição/criação de novos modelos:

Palette: Conjunto de componentes visuais que serão utilizados no relatório.

15
Data Explorer > Data Sets > XMLDataSet: Nesta opção é possível visualizar os campos do
Sienge que estão disponíveis para inserção nos relatórios configuráveis.

Report Parameters: Estes parâmetros serão utilizados para compor o cabeçalho do relatório.

Aba layout: É onde faremos a alteração do conteúdo do relatório.

16
Aba Master Page: É o cabeçalho do relatório.

Como Gerar/Alterar um Modelo de Relatório?

Através do componente Table na Palette de edição, será possível adicionar tabelas para
criação de dados de um relatório.
Ao selecionar um campo da tabela existente, aparecerão para o usuário as definições das
tabelas e opções de edições desta tabela em Property Editor – Report.

17
Principais itens do Property Editor:

General: possibilita alterar dados básicos como nome, cores de fundo e fontes.
Padding: altera o tamanho dos campos.
Border: formata as bordas da tabela.
Margin: altera margens da tabela.
Hyperlink: insere link no campo da tabela.
Page Break: insere quebras de páginas nas tabelas.
Visibility: possibilita esconder elementos de um campo.

Adicionar ou Remover Linhas/Colunas nas Tabelas de Relatório

Para remover linhas ou colunas dos modelos de tabelas dos relatórios, semelhante ao Excel,
basta clicar com o botão direito do mouse na linha ou coluna e clicar em Delete.

Para inserir uma nova linha ou coluna na tabela clique com o botão direito em Insert.

18
Criando rótulos para colunas novas

Para criar qualquer elemento novo é necessário ir na aba Pallete e arrastar o item que se quer.
Neste caso o item é o Label.

19
Adicionar Campos nas Linhas/Colunas

Para inserir campos nas linhas ou colunas, acesse Data Explorer > Data Set > XMLDataSet,
clique no campo que deseja adicionar e arraste até a posição para inserção do campo.

Agrupamentos

Ao clicar no botão Table, os agrupamentos existentes serão mostrados através do ícone

. A tela de criação e edição de um agrupamento são iguais. Para adicionar um novo

agrupamento, clique com o botão direito no ícone de agrupamento e depois em Insert Group >
Above/Below. Clicando em Above, você insere um agrupamento acima do selecionado, e em
Below, insere o agrupamento abaixo.

20
Para finalizar, você deve nomear o agrupamento e escolher, no campo Group On, a expressão
que deseja utilizar para agrupar as informações.

Se a intenção for editar um o agrupamento, deve-se clicar em Edit Group. Então abrirá a
seguinte tela:

21
Totalizações

As totalizações são utilizadas para agregar uma operação (soma, subtração, divisão, etc.) ao
relatório. Para adicionar uma totalização, você deve utilizar o componente Aggregation, em
Quick Tools da sua Palette. Após clicar e arrastar o componente para o relatório, você deve
escolher um nome a ser mostrado, um valor da célula (tempo, data, decimal, etc.), uma função
(média, soma, percentual, etc.) e uma expressão (item que você quer totalizar).

22
É possível, também, indicar se você deseja totalizar a tabela ou os agrupamentos.

Campos Computados

Um campo computado é a união entre campos para a visualização em um único espaço.

Através das colunas existentes é possível realizar a criação de novos campos para inserção
nos relatórios. Os campos computados servem para elaborar estes campos adicionais aos do

23
Sienge e constantes no XMLDataSet. Para adicionar um novo campo computado, você deverá
clicar duas vezes em XMLDataSet e acessar Computed Columns. Após os passos anteriores,
clicar no botão New e preencher o nome da coluna, o tipo de dado e as totalizações ou
expressões.

Para inserir uma função no campo computado, clique duas vezes no botão e configure sua
expressão através dos campos disponíveis no XMLDataSet, operações matemáticas e seleção
de dados.

24
Clicando na parte inferior em Available Data Sets, ficará destacada a opção XMLDataSet, e
clicando nesta, aparecerá uma listagem ao lado com campos que podem ser selecionados
para o relatório. Clicando duas vezes no campo desejado ele aparecerá na parte de cima,
como por exemplo dataSetRow[“campo selecionado”].

25
Por se tratar de um campo computado, ainda resta inserir mais um campo que ficará ligado ao
primeiro, isto é, os dois campos estarão ligados por + “_”+. Em outras palavras, a ligação é
feita com o operador + (adição) auxiliados por um campo literal descrito entre aspas (“ ”).

26
No exemplo acima é possível ver que o campo computado é constituído pelas informações do
valor do título (valorTítulo) e pela quantidade total de parcelas (quantidadeTotalDeParcelas),
separados por um traço inferior (underline) descrito entre aspas (“_”).
Os campos criados através dos campos computados serão disponibilizados na listagem do
XMLDataSet após o último campo adicionado.

Ordenação em Tabelas e Ordenação por Agrupamentos

A ordenação dos dados nos relatórios serve para personalizar a sequencia que deverão
aparecer as informações. Estas opções de ordenação são acessadas no Property Editor na
aba Sorting. Ao adicionar uma nova ordenação, você deverá selecionar o campo a ser
considerado no relatório e a ordem crescente ou decrescente. Nesta ordenação, o eclipse
utiliza o comando e a ordem que são apresentadas na aba Sorting.

27
Para ordenar um agrupamento, basta clicar duas vezes no botão de agrupamento ,
acessar a aba Sorting e adicionar a ordenação desejada.

Como Importar?

Importando Modelos no Sienge

Para realizar a importação dos modelos no Sienge, acesse o botão de modelos apresentado no
final da tela de consulta dos relatórios configuráveis, conforme abaixo.

28
Na tela de modelos clique no botão Adicionar, descreva o nome do modelo, selecione o arquivo
e salve para confirmar a operação.

29
Dicas para Utilização

• Para obtenção de um relatório visualmente melhor, procure seguir os padrões de cores,

bordas e alinhamentos dos modelos pré-configurados e do Sienge.
• Inserir uma Label entre linhas para distanciar as informações e aperfeiçoar o layout do
relatório.
• Acesse as propriedades da Table (Property Editor) e células dos modelos para analisar as
principais opções dos componentes.
• Utilize a aba Preview para acompanhar a montagem final do seu relatório.
• Observe os exemplos dos campos, componentes e propriedades do modelo pré-configurado
para, posteriormente, editar e criar seus próprios modelos.
• Renomeie o arquivo de modelo editado conforme desejar e diferencie os modelos pré-
configurados dos seus editados.
• Para inserir o nome do componente (campo, totalização, etc.) insira uma Label com o texto
desejado na coluna ao lado de onde será apresentada a informação.

30