Escolar Documentos
Profissional Documentos
Cultura Documentos
RM Reports
Formatando Relatórios pelo Designer
1. Introdução ........................................................................................................................................................................ 3
1.1. Objetivo do Treinamento ........................................................................................................................................... 3
1.2. Conceito ..................................................................................................................................................................... 3
1.3. Definições Básicas ...................................................................................................................................................... 4
1.4. Conhecendo o Designer do RM Reports ................................................................................................................... 10
1.5. Deslocando os Painéis e Barra de Ferramentas ........................................................................................................ 11
1.6. Ajustando Campos e Grupos .................................................................................................................................... 11
1.7. Ajustando Outros Campos e Grupos......................................................................................................................... 13
1.8. Incluindo um Título e um Logotipo ........................................................................................................................... 14
1.9. Condições de Formatação ........................................................................................................................................ 15
1.10. Adicionando Novas Tabelas da Base de Dados ......................................................................................................... 16
1.11. Incluindo Consultas SQL ........................................................................................................................................... 17
1.12. Relacionamento entre Tabelas ................................................................................................................................. 18
1.13. Aumentando a Quantidade de Registros no Preview ............................................................................................... 19
1.14. Quantidade de Registros no Preview ........................................................................................................................ 19
1.15. Executando o Relatório na Visão .............................................................................................................................. 20
1.16. Conclusão ................................................................................................................................................................. 21
2 Versão 11.80
Formatando Relatórios pelo Designer
1. Introdução
Olá!
Seja bem-vindo ao treinamento Formatando Relatórios pelo Designer do curso RM Reports – Gerador de Relatórios
.NET da TOTVS.
1.2. Conceito
Neste treinamento você aprenderá como utilizar os componentes disponíveis no designer do RM Reports e como
manipulá-los para criar relatórios avançados, contendo recursos com cabeçalhos, imagens, consultas SQL e outros
disponíveis no Gerador de Relatórios .NET.
Versão 11.80 3
Formatando Relatórios pelo Designer
Árvore do Relatório
4 Versão 11.80
Formatando Relatórios pelo Designer
Barra de Ferramentas
Contém os controles comuns e avançados para o relatório, como as imagens, filtros, expressões, gráficos, matrizes,
tabelas, entre outros.
Versão 11.80 5
Formatando Relatórios pelo Designer
Barra de Propriedades
Apresenta as propriedades de cada componente do relatório. As propriedades exibidas podem variar de acordo com
o componente selecionado.
6 Versão 11.80
Formatando Relatórios pelo Designer
Designer do RM Reports
É o local onde são realizadas as formatações e personalização de grupos, campos, assim como os demais
componentes do relatório.
Grupos do Relatório
• Margem Superior.
• Cabeçalho do Relatório.
• Cabeçalho da Página.
• Cabeçalho do Detalhe.
• Detalhe.
• Subdetalhe.
• Rodapé.
• Rodapé do Detalhe.
• Rodapé do Relatório.
• Rodapé da Página.
• Margem Inferior.
Informações da Página
As informações da página apresentam os dados do relatório, como Número de Páginas, Data e Hora, Nome do
Relatório, Usuário etc.
Versão 11.80 7
Formatando Relatórios pelo Designer
Lista de Campos
Exibe os campos das tabelas e consultas SQL para inclusão nos grupos do relatório.
Margens
As margens delimitam as dimensões do Relatório. Você pode ajustá-las de acordo com o tamanho do papel do
relatório, bastando arrastá-las.
Menus do RM Reports
Exibidos na parte superior do designer, os menus do RM Reports reúnem funcionalidades divididas em três grupos:
Início: Apresenta os botões para gravação do relatório, filtros e adição de tabelas e consultas SQL aos grupos do
relatório.
Layout: Reúne funcionalidades de formatação de fonte dos campos, alinhamento e posicionamento dos campos.
Exibição: Possui botões para a geração do relatório exibição das barras de ferramentas e zoom do relatório.
8 Versão 11.80
Formatando Relatórios pelo Designer
Pin
O Pin serve para fixar uma janela no relatório e não permitir que ela seja recolhida automaticamente.
Smart Tag
A Smart Tag ou Marca Inteligente é uma pequena caixa de propriedades apresentada sobre os controles do RM
Reports. Ela possui algumas propriedades que não são apresentadas na barra de Propriedades.
Versão 11.80 9
Formatando Relatórios pelo Designer
O designer do RM Reports é o local onde são adequados os campos e controles adicionados ao relatório, para
efetuar uma boa apresentação.
Aqui são apresentados os vários controles, desde os mais simples como as imagens, até os mais complexos, como os
gráficos.
O designer será apresentado após finalizar todas as etapas do Assistente de Criação de Relatórios ou ao clicar duas
vezes sobre o relatório na visão de relatórios.
1) Ferramentas
Ao lado esquerdo da janela há o painel de ferramentas. Este painel contém muitos dos controles que serão
utilizados na formatação de nossos relatórios. Nele existem os controles comuns e controles avançados.
2) Exibindo as Ferramentas
Se você não consegue visualizar este painel, acesse a opção de menu Exibição. Ela está localizada na parte superior
da janela ao lado direito. Depois acesse a opção Janelas e escolha ferramentas. Esta opção exibe ou oculta a barra
de ferramentas do RM Reports, bem como as outras barras existentes.
10 Versão 11.80
Formatando Relatórios pelo Designer
3) Árvore de Relatório
Do lado direito há o Painel de Árvore de Relatório. Este painel apresenta os grupos e os controles presentes em
cada grupo. Assim, podemos ter uma visão macro de todo o relatório. Ao clicar sobre um item, ele será realçado no
grupo do relatório.
4) Lista de Campos
Existe o Painel de Lista de Campos. Este painel lista as tabelas utilizadas no relatório e seus respectivos campos. Os
campos que apresentam o sinal de (+) mostram que há tabelas relacionadas àquele campo.
5) Propriedades
O Painel de Propriedades é responsável pela definição das características do controle selecionado. As características
de um controle são chamadas de propriedades.
Existem propriedades comuns a vários controles como, por exemplo, fonte e cor para os controles texto e campo da
base. Há também propriedades especificas do controle como a propriedade imagem de um controle imagem. As
propriedades podem variar de acordo com o tipo de controle selecionado.
A janela de propriedades pode ser acionada também ao selecionar um controle e pressionar a tecla F4.
Você pode definir a posição dos painéis e da barra de ferramentas. Basta clicar sobre a barra de título e arrastá-la
para um dos locais que são exibidos.
Acesse o Designer do Relatório e clique sobre a barra de título do painel, arrastando-a para um dos locais que
aparecem.
Redimensionando Campos
Os campos que estão na cor rosa estão sobrepostos ou fora das margens dos relatórios. Para ajustar é preciso
diminuir seu tamanho.
Selecione o campo desejado e com a ajuda do mouse altere o seu tamanho. Quando o cursor do mouse estiver no
formato de uma cruz, clique e arraste o campo para que sua posição seja alterada.
Ao fazer o mesmo movimento nas extremidades do campo o cursor se transformará em uma seta dupla, permitindo
alterar suas dimensões.
Versão 11.80 11
Formatando Relatórios pelo Designer
Ajuste os campos do grupo funcionários para que seja possível inserir o campo Salário na frente do campo Nome.
Após o ajuste dos campos, é necessário reajustar também o tamanho do grupo. Para isso, posicione o cursor sobre a
divisória do grupo desejado até o formato do cursor adotar a forma de duas setas. Em seguida arraste o grupo
redimensionando-o.
Veja o resultado. O grupo está bem ajustado, bem como seus campos.
Agora o campo de Totalização do salário por seção será posicionado abaixo do campo Salário do grupo de
funcionários. Assim, o relatório será gerado com este campo abaixo do campo Salário, que está no grupo acima.
Lembre-se que o Assistente foi definido para totalizar o campo Salário em toda Quebra de Grupo. O campo
Totalizador foi criado quando esta propriedade foi definida.
Quando gerarmos o relatório, a cada término de geração dos dados de grupo, haverá um totalizador dos controles
escolhidos.
Após acessar o Painel de Ferramentas e selecionar o controle de Texto, clique ao lado do campo de Totalização do
salário.
Selecione então a propriedade Texto e altere o seu conteúdo para Total do Salário.
Também é possível alterar o texto diretamente no controle ao aplicar um duplo clique sobre o campo.
Pré-visualização
Agora que o relatório já tem um formato vamos fazer um preview, ou seja, uma pré-visualização. Acesse a opção de
menu Exibição e selecione o item Pré-visualizar.
Agora já existe o preview do relatório. Veja as seções com seus respectivos funcionários.
Observe também que são apresentadas seções que não contém funcionários. Isso pode ser modificado em outro
momento.
Agora volte para a formatação do relatório. Clique no X na parte superior do preview para fechá-lo.
12 Versão 11.80
Formatando Relatórios pelo Designer
Quase todo relatório precisa ter uma ordenação e quebra. Esta ordenação organiza as informações impressas no
relatório. Ela é feita a partir de um controle do tipo campo da base inserido no designer, enquanto a quebra fará a
separação dos dados por grupo ou página do relatório, por exemplo.
Clique logo acima da descrição Cabeçalho do detalhe, em uma pequena seta que está apontando para a direita, a
Smart Tag ou Marca Inteligente.
Faça isso para o Cabeçalho de detalhe. Ao clicar na seta, uma nova janela de propriedades será apresentada. Clique
nas reticências à direita do campo Ordenação/Quebra.
Novamente outra janela será apresentada. Vá até a propriedade Nome do Campo e selecione na lista o campo
desejado para a ordenação e quebra.
Faça um preview para verificar o efeito da modificação. Então, selecione a opção de menu Exibição, como já vimos
antes e depois da seleção do botão Pré-visualizar.
Os funcionários não aparecem. Para isso, role a barra de rolagem localizada à direita e será possível visualizar todos
os dados.
O que foi alterado é a ordenação realizada que apresenta primeiro as Seções que não possuem funcionários.
Feche o preview no X e volte para a formatação para realizar o ajuste.
Efetue a correção para que o relatório mostre apenas as seções que contêm funcionários.
1. Selecione o grupo Detalhe2, clique na Smart tag, logo acima da descrição, Detalhe2. Na nova janela
desmarque a opção Imprimir sem Dados.
2. Selecione o grupo Detalhe2 e clique com o botão direito do mouse, selecione Propriedades. Na opção
Comportamentos em Propriedades, Imprimir sem Dados deve estar como falso.
Gere o relatório. Agora o relatório será gerado apenas com as seções que contêm funcionários.
Versão 11.80 13
Formatando Relatórios pelo Designer
Pode-se formatar o campo salário, para que seja apresentado o símbolo e formatação de moedas.
Selecione o campo Salário e clique na Smart Tag que aparece em sua borda superior direita. Será apresentada a
janela de formatação. Clique nas reticências à frente da propriedade Formato do Texto.
Na janela apresentada, selecione a categoria moeda e o tipo padrão C2, que significa duas casas decimais. Clique em
OK e, em seguida, em qualquer área de formatação do relatório para fechar a janela aberta.
Faça também a formatação para o campo que totaliza os salários. Ele se encontra logo abaixo do campo Salário com
a descrição Sum (Salário). Depois faça um preview.
Para adicionar um título ao relatório, acesse Ferramentas/Texto. Clique no controle e depois dentro do designer do
Relatório. Para incluir o logotipo, acesse Ferramentas/Imagem. Clique no controle e depois dentro do designer do
Relatório.
Primeiro, altere a largura do grupo cabeçalho Detalhe 1. Posicione o mouse sobre o grupo e o arraste para baixo.
Inserindo um logotipo
Inserido e selecionado o controle, clique sobre a smart tag e será apresentada a janela com algumas propriedades
do controle. Selecione a propriedade imagem e localize o arquivo de imagem desejado.
Incluindo um título
Para adicionar um texto ao cabeçalho, selecione o controle texto no painel de ferramentas e clique sobre o grupo
desejado. Agora, selecione o controle adicionado. Dê um duplo-clique sobre o controle para alterar seu texto.
Preencha o controle como Listagem de Funcionários/Seções. Após a alteração, redimensione o controle texto e
posicione-o da forma adequada.
Com o controle selecionado pressione F4 para alterar a fonte, o estilo da fonte e o tamanho.
14 Versão 11.80
Formatando Relatórios pelo Designer
É possível alterar a cor dos campos Código e Descrição da Seção. Para isso, acesse Salvar a alteração/Exibição/Pré-
Visualizar.
Selecione os campos Código e Descrição da Seção. Para isso, clique sobre o campo Código, mantenha a tecla Control
(Ctrl) pressionada e clique sobre o campo Descrição. Com os campos selecionados pressione F4.
Existe ainda uma maneira de formatar o campo Salário, a partir de uma Condição de Formatação, para que ele fique
vermelho, caso o salário seja menor que um determinado valor.
Para isso, selecione o campo Salário, clique na smart tag do campo e escolha Regras de Formatação.
Para adicionar a nova regra clique sobre Adicionar uma Regra de Formatação.
Selecione, ao lado direito, a fonte de dados e o membro de dados. Devem ser, respectivamente, Tabelas Disponíveis
e Funcionários. Em seguida clique na propriedade Condição que está acima.
Nesta janela escolha a função Field localizada à esquerda. Após selecioná-la, serão apresentados os campos à direita.
Selecione então o campo Salário e clique duas vezes sobre ele.
O campo Salário ficará visível no painel superior. Digite o operador menor que ( < ), salte um espaço e digite 2000.
Feito isso clique em Ok.
Agora clique sobre o símbolo de + localizado na propriedade Formatação. Será aberta uma lista de novas
propriedades e pode-se então definir a propriedade Cor de Frente para Vermelho. Feito isso, clique em Fechar.
Depois de criada a regra de formatação, agora é preciso adicionar esta regra para que seja aplicada no controle. Para
isso, selecione a regra criada e clique na seta que aponta para a direita, localizada na separação dos painéis.
Clique em Ok.
Faça um preview do relatório. Vejam o logotipo adicionado, as fontes de descrição da seção alteradas e o campo
Salário respeitando a formatação.
Versão 11.80 15
Formatando Relatórios pelo Designer
Apresentaremos como adicionar os dependentes dos funcionários ao relatório. Assim, é possível aprender como
criar novos grupos sem a utilização do Assistente de Criação de Relatórios.
Na janela de Adicionar fontes de dados escolha a guia Tabelas da Base e no campo Pesquisar, como não se sabe o
nome da tabela, digite Dependentes. Na tabela de dependentes deve ter, como descrição, a palavra dependentes.
Serão listadas as tabelas que contêm a palavra dependentes em sua descrição. Escolha então Dependentes do
Funcionário. Clique em Adicionar e depois em OK.
É preciso adicionar o novo grupo que conterá os dependentes. Para isso, clique com o botão direito do mouse no
grupo RptDetailBand1, ou seja, Detalhe 1, que é o grupo que contêm os funcionários. Escolha Inserir Sub-relatório e
depois Dependentes do Funcionário.
Tem-se agora um novo grupo. Nele adicione os campos da tabela de dependentes de funcionários.
Acesse o painel Lista de Campos. Selecione a tabela Dependentes de Funcionários. Clique em + à esquerda da
tabela para visualizar os campos. Insira os campos desejados.
Adicione o CPF do dependente. Para isso clique sobre o campo e o arraste para o grupo criado.
Faça o mesmo para Data de Nascimento e Nome do Dependente. Agora ajuste a posição dos campos e a largura do
grupo.
Adicione um cabeçalho de detalhe para o grupo criado. Clique com o botão direito do mouse sobre o grupo
Detalhe3. Na opção de menu que se abre escolha Inserir Seção, Cabeçalho de Detalhe.
Agora adicione os controles Texto para representar os campos da base de Dependentes. Selecione o controle Texto
no painel de ferramentas e depois clique sobre o grupo Cabeçalho.
Faça a edição do controle, clicando duas vezes e altere sua propriedade texto. Para facilitar, faça a cópia do controle
de texto e cole duas vezes. Assim, têm-se mais dois controles Texto. Clique com o botão direito do mouse sobre o
controle e selecione Copiar. Agora clique em uma área livre do grupo e clique em Colar. Altere o texto dos controles
para representar os campos desejados.
Posicione os controles adequadamente acima dos controles do grupo Detalhe3, grupo de Dependentes de
Funcionários.
Para alterar a formatação dos controles de Texto selecione todos os controles desejados. Clique sobre o primeiro
controle e mantendo a tecla Control (Ctrl) pressionada clique sobre os outros controles. Agora acesse a propriedade
Fonte no painel de Propriedades e altere a fonte para negrito. Pressione OK.
16 Versão 11.80
Formatando Relatórios pelo Designer
Observe que a formatação é imediatamente aplicada na janela de formatação. Assim, não há necessidade imediata
de fazer um preview para verificar o resultado.
Para formatar o campo Data de Nascimento clique sobre o campo e depois acesse o menu pela smart tag. Clique na
propriedade Formato do Texto.
Clique na categoria DataHora e, do lado direito, escolha o formato dd/mm/yyyy (dia/mês/ano). Desta forma, a data
será formatada com dia, mês e ano com quatro dígitos. Depois clique em OK.
Veja a impressão dos dependentes. Tem-se a formatação correta do campo Data de Nascimento.
Dica
Uma dica para este relatório é evitar que o cabeçalho de dependentes seja impresso para funcionários que não têm
dependentes, já que isso pode gerar um efeito não desejado ao relatório.
Para fazer isso, clique na smart tag do grupo Dependentes do Funcionário e desmarque a opção Imprimir sem
Dados.
Ou então selecione o grupo Detalhe2 e clique com o botão direito do mouse e depois selecione Propriedades. Na
opção Comportamentos selecione a opção Falso, em Imprimir sem Dados.
É importante que o grupo de Seções apresente o código e a descrição do departamento destas seções.
Para isso, primeiro aumente a largura do grupo Detalhe2. Agora adicione uma sentença SQL em nosso relatório e
não uma tabela, assim como foi feito com Dependentes.
Crie um filtro para trazer poucas sentenças SQL já cadastradas ou selecione uma existente. Depois selecione
Executar.
Na janela de consulta SQL você pode criar uma nova consulta. Para isso, clique no botão Incluir na barra de
ferramentas superior.
Versão 11.80 17
Formatando Relatórios pelo Designer
Crie uma sentença SQL que vai retornar os campos Código do Departamento e Nome da Tabela de Departamentos.
Como é desejado que a sentença seja executada para cada Seção gerada, deve-se adicionar à consulta os
parâmetros CODCOLIGADA e CODDEPARTAMENTO.
Estes parâmetros têm este nome porque são os mesmos nomes dos campos na tabela de seções. Este procedimento
é necessário para que os parâmetros da consulta sejam preenchidos automaticamente com os valores dos campos
das seções.
Muita atenção à utilização da expressão NOLOCK na sentença SQL, a fim de evitarmos bloqueios desnecessários no
banco.
Preencha sua consulta SQL da mesma maneira que exibida na figura. Depois clique em OK.
Adicione os campos no grupo de Seções. Clique sobre o campo desejado e arraste-o para o grupo Seções.
Posicione os campos para uma boa apresentação. Selecione os campos adicionados para formatarmos sua cor. No
painel de propriedades selecione a propriedade Cor de Fora e escolha a cor desejada.
Observe também que o cabeçalho do grupo dependentes só é impresso para o funcionário que possui dependente,
alteração feita no último tópico. Feche a janela de preview e volte para a formatação do relatório.
Agora, apresentaremos como verificar e alterar o relacionamento entre as tabelas e qual propriedade guarda os
relacionamentos entre as tabelas pai e filha. Para isso, é necessário já que já exista um processo para facilitar a
confecção dos relatórios.
Acesse o painel de propriedades. Observe que o grupo SubDetalhe2 está em destaque no topo do painel de
propriedades. Posicione o mouse sobre o texto da propriedade Caminho e veja que é apresentada uma dica com o
conteúdo da propriedade. Clique sobre a propriedade Caminho.
Esta é a janela de Caminho de Relacionamento. É por meio dela que determinamos o relacionamento entre os
grupos pai e filho. Clique em Cancelar, pois neste momento não serão efetuadas alterações.
É possível gerar e gravar um preview do relatório na janela de Visão de relatórios. Isso facilita o entendimento do
relatório ao procurar os relatórios pela visão.
18 Versão 11.80
Formatando Relatórios pelo Designer
Atenção: o preview é fixo e será apresentado com os dados gerados exatamente iguais para todos os usuários que
tiverem acesso ao relatório na janela de visão de relatórios.
Observe que depois de gerar o relatório no designer serão apresentados apenas 10 registros. Isso acontece porque
geralmente na formatação do relatório é possível apenas uma pré-visualização de fato, e não é necessário que todos
os registros sejam gerados todas as vezes que se aplica um preview.
Em outros casos é necessário apresentar mais registros, e para isso foi alterada a propriedade Linhas para o
preview, no painel de propriedades. Observe que o componente selecionado logo abaixo da barra de título das
propriedades é o rptReport1 Relatório e somente se ele estiver selecionado a propriedade será exibida.
Altere a propriedade para “0”, caso queira gerar um relatório por completo, ou seja, com todos os registros dos
campos correspondentes.
Versão 11.80 19
Formatando Relatórios pelo Designer
Assim, foi concluída a formatação do relatório. Agora apresentaremos a visão de relatórios. Feche o designer.
Selecione o relatório que foi criado marcando sua caixa ao lado do código. Depois acesse a opção Processos e
escolha Gerar Relatório.
Esta janela cria filtros para as informações desejadas no relatório. Escolha seções e clique no botão que contém as
reticências ( ... ).
Esta é a janela de filtro padrão do ERP da linha RM. É possível criar um filtro para as seções menores ou iguais a 02.
Após isso, clique em Salvar.
Na janela de filtros é possível ver a condição de filtro criada. Para isso, avance.
Além de gerar o relatório, é possível enviá-lo para um e-mail ou grupo de pessoas. Selecione a opção de Envio por E-
mail e avance.
20 Versão 11.80
Formatando Relatórios pelo Designer
Escolha um destinatário da lista de usuários cadastrados no Sistema ou digite livremente. Após fazer isso, avance
para o próximo passo.
Escolha um assunto para o e-mail que será enviado, e um texto para o corpo da mensagem. Em seguida avance.
É possível escolher o formato em que o relatório será gerado. Veja também há diversas opções como PDF, CSV,
planilha do excel, arquivo texto, entre outros. Selecione o formato PDF e avance.
Veja como o relatório será apresentado. Se desejar, você pode enviar para impressão.
1.16. Conclusão
Versão 11.80 21