Histórico da Página
Configurando Relatórios Personalizáveis
O Microsiga Protheus® oferece o recurso personalização para alguns relatórios de cadastros e movimentações. Ele tem como principais funcionalidades a definição de cores, estilos, tamanho, fontes, quebras, máscara das células para cada seção, criação de fórmulas e funções (Soma, Média, etc.), possibilidade de salvar as configurações por usuário e criação de gráfico.
Com a funcionalidade de Relatórios Personalizáveis, o usuário pode modificar os relatórios padrões, criando seus próprios layouts.
Vale lembrar que nem todos os relatórios são personalizáveis. Por exemplo, relatórios com layouts pré-definidos por lei e formulários (boletos, notas-fiscais, etc) não poderão ser alterados.
Os relatórios personalizados são gravados com extensão .PRT, diferenciando-se dos relatórios-padrão que recebem a extensão .##R.
Importante: Para utilizar os relatórios personalizáveis, o parâmetro MV_TREPORT (tipo numérico) deve ser alterado no módulo Configurador, conforme uma das opções que seguem:
É possível a impressão de arquivos ODF por meio da ferramenta TReport (R4), para Windows e Linux. Arquivo em PDF é possível imprimir ao utilizar a classe FWMSPrinter. |
Procedimentos
Para imprimir relatórios:
1. | Ao selecionar o relatório, é apresentada a tela abaixo: |
O Sistema apresenta na janela as possibilidades de configuração da impressão:
Impressão
A caixa de listagem apresentada deve ser utilizada conforme o meio de saída do relatório. Veja a seguir.
• | Arquivo |
O relatório será gravado em disco com o nome apresentado. Caso seja escolhida a opção Servidor ele é gravado no diretório determinado na senha do usuário, através do Configurador, sendo este sempre no servidor (padrão \SPOOL\).
Na escolha da opção Local é aberta uma janela para que seja escolhido o local onde o relatório será gravado na máquina local, do usuário logado.
Dica: O relatório gerado a partir desta opção pode ser impresso ou enviado por e-mail após ser apresentado na tela. |
• | Spool |
Direciona o relatório para impressão via configuração do Windows® das impressoras instaladas.
• |
Envia o relatório por e-mail (Internet). Para isto, devem ser configurados os seguintes parâmetros no módulo Configurador:
• | MV_RELACNT |
Define a conta de e-mail para identificar a proveniência dos relatórios.
Exemplo:
• | MV_RELPSW |
Define a senha da conta de e-mail para envio dos relatórios.
• | MV_RELSERV |
Define o servidor da conta de e-mail para o envio do relatório.
• | MV_EXCELEX |
Define o nome do executável do programa de planilha do Linux
Exemplo:
Quando selecionada esta opção, deve-se informar, no campo em destaque na figura abaixo, o e-mail para o qual o relatório deve ser remetido.
2. | Após preencher todos os dados necessários e clicar em Imprimir para enviar o relatório, o Sistema apresentará a janela de Nova Mensagem, com as seguintes informações: |
• | Assunto: |
Neste campo será apresentada a sugestão de assunto para o e-mail.
• | Descrição: |
Informa a descrição do relatório que será enviado.
• | Receber cópia do e-mail |
Selecione esta caixa para receber uma cópia do e-mail que será enviado.
Dica: É possível enviar o relatório gerado para mais de um usuário. Isto pode ser feito através do cadastramento de grupos de e-mail. Consulte o tópico Grupos de E-mails para mais detalhes. |
• | Planilha: |
Exporta o relatório para o Microsoft Excel® no formato XML
• | HTML: |
Gera o relatório no formato HTML. Além disso, os relatórios gerados podem ser ampliados ou reduzidos na visualização.
• | Servidor/Local: |
Para as impressões Arquivo, Spool, e HTML pode-se escolher entre imprimir no Servidor ou na Estação de trabalho (Local). No módulo Configurador pode ser definido se o usuário pode imprimir Servidor ou Local.
Papel
• | Tamanho do papel |
Selecione o tamanho do papel em que o relatório será impresso.
As especificações de tamanho do papel são as do padrão do mercado, conforme o formato escolhido, o Protheus irá ajustar a impressão.
• | Formato da impressão |
Selecione o formato de impressão, clicando nas opção Retrato ou Paisagem, fazendo assim que o relatório seja impresso na orientação vertical ou horizontal, respectivamente.
Configurações
• | Título |
Caso queira alterar a opção sugerida pelo Sistema, digite o cabeçalho do relatório.
• | Ordem |
Escolha a ordem em que as informações serão apresentadas no relatório, clicando em uma das chaves disponíveis.
• | Layout |
Permite selecionar o modelo de relatório para impressão, à medida que novos leiautes forem gravados para um relatório, seus nomes serão listados nessa caixa
• | Preview |
Faz a exibição do relatório gerado na tela, possibilitando, na seqüência, o seu envio para impressora ou a cancelamento da impressão.
• | Executar em segundo plano |
Essa opção permite que o relatório seja gerado e enviado para a fila de impressão, enquanto o usuário pode executar outras tarefas no Sistema.
Parâmetros
A configuração de parâmetros segue o mesmo procedimento que os relatórios padrão. Porém, alguns relatórios personalizados dos módulos de Recursos Humanos trazem uma nova funcionalidade, em que é possível imprimir intervalos não sequenciais de dados. Para mais informações, consulte o tópico Configurando Intervalo de Dados em Parâmetros.
• | Clique em Imprimir para iniciar a impressão ou em Personalizar para prosseguir com as configurações do relatório. Esta opção apresenta janelas para construção de uma nova aparência para o relatório. |
Gestão de Empresas
Disponibilizada uma nova funcionalidade nos relatórios (TREPORT) que permite a execução de filtros utilizando o conceito de Gestão de Empresas.
1. | Na janela de Opções do Relatório, clique em Gestão de Empresas. |
2. | São apresentadas as opções de filtro. |
3. | Marque os níveis da Gestão de Empresas que deverão ser filtrados e preencha os filtros De/Até conforme desejado. |
Dica: A apresentação dos níveis para filtro do relatório é variável e depende da configuração do layout do Grupo de Empresas, como no exemplo: EEEEUUUUFFFF. |
4. | Após a confirmação do filtro, clique em Imprimir. |
5. As informações serão apresentadas de acordo com o filtro selecionado e na última página impressa serão apresentados os totais para cada nível do Gestão de Empresas.
Personalizar
No lado esquerdo da janela Personalizar, apresentam-se as seções do relatório, que representam os diferentes grupos de informações exibidos, por exemplo, os dados do Relatório de Comissões são divididos nas seções ou quebras: Relatório de Comissões, Identificação do Vendedor, Dados dos Títulos e Valores Totais.
Seção Principal
A primeira seção é a principal que define as características gerais de todo o relatório.
Para a seção principal é possível definir:
Propriedades
• | Altura da linha |
A altura padrão para todas as linhas do relatório. É recomendável que essa configuração seja definida considerando o tamanho da fonte utilizada.
Para cada seção também é possível definir a altura das linhas. O Sistema aplica de forma diferenciada as alturas das linhas.
• | Espaçamento entre colunas |
Define o espaçamento em pontos (caracter) entre as colunas
• | Margem esquerda |
A margem esquerda em pontos (caracter) para todo o relatório. Também será possível definir a margem esquerda de cada seção, criando indentações na disposição dos dados.
• | Número inicial da página |
O número da página do relatório em que deve-se iniciar a impressão. Esse recurso é útil quando deseja-se reiniciar a impressão a partir de uma página do relatório.
• | Fonte |
A fonte e o tamanho de letra que será utilizada em todo relatório. São listadas todas as fontes disponíveis no ambiente operacional, porém, o tamanho da fonte está limitado a 16 pontos.
• | Negrito |
A fonte utilizada no relatório pode ser impressa mais grossa que o comum.
• | Sublinhado |
A fonte utilizada no relatório pode ser impressa sublinhada, marcada.
• | Imprimir |
Define a apresentação ou inibição dos dados de: cabeçalho do relatório, rodapé, páginas inicial de configuração dos parâmetros, informações ou observações adicionais, respeita a permissão da senha do usuário.
Layouts
Permite excluir os layouts de impressão salvos.
Visualização de layout
Permite visualizar como será impresso o relatório para o layout configurado.
Seções Específicas
Ao abrir a árvore das seções, são apresentadas as seções específicas do relatório, que podem receber atributos individualmente. Basta posicionar sobre o título da seção e configurá-la.
Por exemplo:
Para a seção Vendedor, utiliza-se destaque com bordas e para a seção Dados dos Títulos, destaque em cor.
Note que existem três áreas para configuração das seções: Propriedades (apresentada automaticamente); Células e Filtro (apresentadas na parte inferior da janela).
Para as seções específicas é possível definir:
Propriedades
Imprimir
Definem-se os dados dos itens da seção devem ser impressos. Caso a seção seja inibida, somente seus totais de valores serão apresentados, como em um relatório sintético.
• | Título da seção |
Define se será ou não impressa o título da seção.
• | Células em linha |
Definem-se as células (campos) serão apresentadas em formato colunas ou em linhas. Se marcada a opção Linhas, em Colunas (células em linha), é possível definir quantas células por linha devem ser impressas.
Cabeçalho das Células
Define se os cabeçalhos das células (nomes dos campos) devem ser exibidos.
• | No topo da página |
Configura a apresentação do cabeçalho acima de cada célula (topo da página).
• | Após as quebras |
Repete o cabeçalho sempre que houver quebra de página.
Altura e Espaçamento entre Linhas
A altura da linha e o espaçamento entre linhas podem ser ajustados. É recomendável que essa configuração seja definida considerando o tamanho de fonte utilizado.
Margem Esquerda
O espaço em pontos para margem esquerda da seção. Para a impressão será considerada a margem do relatório mais a margem da seção.
Quebra de Linha na Impressão de Colunas
Quando o relatório possui muitas colunas, dependendo do tamanho da fonte utilizada, pode ocasionar o truncamento de informações. Assim, com essa opção marcada, se não couberem todas as colunas na mesma linha, o Sistema continuará a impressão dos dados na linha seguinte.
Ajustar Células
Se for utilizado um tamanho grande de fonte, pode ser necessário ajustar o tamanho da colunas para que seja possível balancear o espaço utilizado e prevenir que os dados não sejam truncados.
O Sistema proporcionaliza automaticamente todos os tamanhos das colunas, aproximando as informações conforme a quantidade de posições dos campos. Mesmo assim, pode ocorrer o truncamento dos títulos e dos dados da coluna caso não haja espaço suficiente.
Também é possível realizar o ajuste individual de células, veja no tópico Células.
Quebrar Página Antes
Marque essa opção para imprimir cada seção em uma nova página.
Cor
Pode-se definir cores em RBG para o fundo e para a fonte da seção. No primeiro botão, define-se a cor de fundo e no segundo botão, a cor da fonte.
Para seleção, selecione a cor desejada do lado esquerdo da janela ou gire o triângulo na direção da cor desejada e arrasta-se o ponto interno até o tom desejado. Ou digitam-se as quantidades de Vermelho, Verde e Azul para compor a cor.
Borda
É possível imprimir linhas para separar as informações das seções, utilizando o recurso de bordas. No primeiro botão, define-se a borda para a célula e no segundo botão, define-se a borda para o cabeçalho da célula.
Para separação das seções, pode-se aplicar borda superior, inferior e laterais, basta clicar em cada lado.
Células
Cada seção apresenta um conjunto de células.
As células são as colunas dos campos apresentados pelas seções do relatório. Para adicionar ou inibir colunas, e definir seus atributos, basta clicar sobre a barra Célula apresentada na parte inferior da janela.
No lado esquerdo, são relacionados os campos das tabelas de dados utilizadas no relatório.
No lado direito Células são relacionados os campos selecionados para apresentação na seção que está sendo definida.
Para adicionar ou remover células na seção, basta clicar sobre elas e utilizar os botões com as setas. As células também podem ser movimentadas para cima ou para baixo, modificando suas posições no relatório.
Na lado direito da janela, são definidas as propriedades de cada célula:
• | Título |
É sugerido o título do campo, mas, pode ser alterado.
• | Tamanho |
Quantidade de posições reservadas para exibição dos dados da célula. É sugerido o tamanho do campo.
• | Máscara |
Formato para apresentação dos dados em sintaxe AdvPL. É sugerida a máscara padrão do campo.
• | Alinhamento e Alinhamento do Título |
Alinhamento dos dados das células e do título. Com o alinhamento automático, o Sistema analisa o tipo do campo e alinha à esquerda se caractere, memo, data ou lógico e à direita, se numérico, desde que esteja configurado no Dicionário de Dados (SX3).
• | Auto ajustar |
Da mesma forma que o ajuste da seção, é possível definir individualmente o ajuste automático da largura da célula.
• | Quebra linhas para texto longo |
Se o campo for do tipo caracter ou memo, será efetuada a quebra automática de linha para exibição de todo o texto.
• | Considerar o tamanho do cabeçalho |
Caso o tamanho do dado a ser impresso for menor que o cabeçalho, será considerado o tamanho do cabeçalho.
Se essa caixa não for habilitada, até mesmo o título da célula poderá ser cortado para que seja possível ajustar a visualização dos dados.
• | Cor e Borda |
Da mesma forma que a configuração da seção, pode-se especificar bordas, cor de fundo e fonte especificamente para uma célula.
• | Condicional |
Permite criar, editar excluir condições para impressão dos dados com cores diferenciadas.
Fórmulas
A criação de fórmulas permite realizar cálculos com as células selecionadas para o relatório. É possível criar estruturas complexas de fórmulas, utilizando comandos em AdvPL.
A elaboração de fórmulas deve ser realizada de forma criteriosa, pois, pode comprometer a performance do processamento do relatório. Para cada linha impressa da célula, o Sistema precisa calcular a fórmula novamente.
Para defini-las, clica-se no campo Fórmula e, em seguida, na Seta.
Será apresentada a tela a seguir, onde no lado direito da janela, são relacionadas as células do relatório.
Para utilizar uma célula na fórmula, dê um duplo clique sobre ela. A área da fórmula, irá representá-la como CELL (<ordem>). A partir daí, as fórmulas podem ser compostas com funções AdvPL, utilizando comandos de repetição como If, While, For, ou com simples operações matemáticas.
Acumuladores
Os acumuladores permitem criar células com total, média, mínimo e máximo baseado em outras células numéricas e também criar células de contagem de ocorrências baseado em qualquer dado.
Para defini-los, clica-se no campo Acumulador e, em seguida, na Seta.
A partir de um acumulador também são criados gráficos para apresentação ao final do relatório.
A tela a seguir é apresentada:
Acumulador
• | Tipo |
Define o tipo do acumulador que será criado: se totalizador, valor mínimo, valor máximo, média ou contador de ocorrências.
• | Agrupar por |
Os acumuladores são criados baseados em uma célula agrupadora, por exemplo: para criar um acumulador que totalize as comissões faturadas pela venda de cada cliente, é necessário os valores precisam ser agrupados por cliente.
Nesse caso, basta dar um duplo clique sobre o nome da célula Cliente, na relação de células à direita, para incluí-la no campo Agrupar por. É possível agrupar o acumulador por mais de uma célula.
• | Fórmula |
É o dado que será acumulado. Por exemplo: Comissão.
Nesse caso, basta dar um duplo clique sobre o nome da célula Comissão, na relação de células à direita, para incluí-la no campo Fórmula.
Pode-se utilizar expressões em AdvPl®para composição do acumulador.
• | Imprimir no final do relatório |
Os acumuladores podem ser impressos separadamente ao final de relatório como uma estatística dos dados apresentados.
Gráfico
• | Tipo |
A partir do Acumulador pode-se criar diferentes tipos de gráficos (barra, linha, pizza etc). Os gráficos são gravados em arquivos .BMP, com o mesmo nome do arquivo do relatório.
Se existirem vários acumuladores com gráficos, os arquivos .BMP serão gravados em seqüência (matr1501.bmp, matr1502.bmp, etc) no diretório de spool. Se excluído o arquivo .BMP, o gráfico deixará de ser exibido.
• | Nome |
Define um nome para o gráfico.
• | Nome da série |
Define o nome para a série do gráfico.
• | Imprimir no final do relatório |
O gráfico será apresentado ao final do relatório.
Célula
• | Título |
Define um título para a célula.
• | Tamanho |
Define o tamanho da célula para a série do gráfico.
• | Máscara |
Define o formato do dado que será impresso.
• | Imprimir |
Um acumulador pode ser utilizado apenas para criação de gráfico, assim, se não houver interesse em apresentá-lo no relatório, basta desmarcar esta opção.
Filtros
Os filtros selecionam os dados do relatório, a partir de condições definidas pelo usuário. Para definir um filtro, são utilizadas as tabelas da seção principal.
Portanto, para definir um filtro, posicione sobre a seção principal, e clique na barra Filtro apresentada na parte inferior da janela.
Os campos da tabela principal estarão disponíveis para composição dos filtros.
Após a configuração do relatório, clique em Salvar para gravar o modelo e utilizá-lo sempre que necessário.
Em seguida, na janela inicial de configuração do relatório, clique em OK para gerar o relatório.