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.

...

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:

Image Added

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.

• • Spool
    Direciona o relatório para impressão via configuração do Windows® das impressoras instaladas.
  • E-mail
    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:
    [email protected]
  • 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:

smtp.totvs.com.br

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.

Image Added

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:

Image Added

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

• •  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

• • Titulo
    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 de Relatório, clique em Gestão de Empresas.
   

Image Added

2. São apresentadas as opções de filtro.

Image Added

3. Marque os níveis da Gestão de Empresas que deverão ser filtrados e preencha os filtros De/Até conforme desejado.

Image Added

4. Após a confirmação do filtro, clique em Imprimir.

Image Added

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.

Image Added

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.

Image Added

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

Image Added

Visualização de layout

Permite visualizar como será impresso o relatório para o layout configurado.

Image Added

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

Image Added

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

Image Added

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.

Image Added

Para separação das seções, pode-se aplicar borda superior, inferior e laterais, basta clicar em cada lado.

Image Added

...

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.

Image Added

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:

• Titulo
  É 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.

Image Added

Image Added

...

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.

Image Added

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.

Image Added

...

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:

Image Added

...

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ítuloDefine 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.

Image Added

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.