Produto:

Framework

Ocorrência:

 Totvs Reports

Passo a passo:

Objetivo:

O objetivo

dessa página é detalhar a funcionalidade

“quebra por máscara” disponível no Totvs Reports.

Esse recurso faz com que os dados localizados em uma banda de detalhe sejam agrupados por determinadas posições de máscara.

Como Configurar:

a) - No design do relatório, selecione a banda de "Cabeçalho de

detalhe";

Image Modified

b) - Na janela de propriedades

da banda selecione

"Quebra por máscara";

Image Modified

c) - Será aberta uma janela para o usuário informar os dados da quebra

. O usuário poderá adicionar ou remover uma ou mais quebras por máscara.

Image Removed

Image Added

• Tabela:
 selecione
•  Selecione a tabela
que possui o campo a ser quebrado pela máscara (todas as tabelas do relatório serão listadas);Coluna: selecione a coluna cujo valor será quebrado de acordo com a máscara de quebra (todas
• do campo que será utilizado na quebra por máscara.
  Somente as tabelas inclusas no relatório serão listadas.
  
  

• Coluna: Selecione a coluna que seus dados serão utilizados na quebra por máscara.
  Todas as colunas da tabela serão listadas

)

• .
  
  

• Controle:
serão
• Serão listados
nesse componente
• todos os controles (Campos da Base) localizados na banda de "cabeçalho de
grupo" em questão (somente controles que possuem ligação com campos de tabelas serão listados).
O controle selecionado receberá o valor da quebra no processo de geração do relatório. Essa informação
• detalhe".
  Trata-se de uma informação opcional. Ela poderá ser útil em
caso de relatório
• relatórios que
necessitam
• precisem mostrar
o
• novo valor após
sua quebra
• a quebra.
  Serão listados somente controles que possuem ligação com campos de tabelas serão listados.
  
  

• Quebra:

o

• O usuário deverá informar interrogações "?" e/ou asterisco

"*" conforme exemplo abaixo

• *** para definir a quebra. Exemplo:
  
  Ex: Configuração da quebra: ***?? [ 3 asteriscos e 2 interrogações

.

• ]
  Código da Seção = 001.05
  

  Uso de Interrogação ( ? ):

permite

• Permite a quebra sempre que

se verificar

• encontrar variação nos códigos.

Neste caso

• No exemplo acima, o valor "05" será recuperado pelas posições ( 4º e 5º

posição

• );

  Uso de Asteriscos ( * ):

o uso de asteriscos simplesmente

• Simplesmente permite a classificação de dígitos tantos quantos forem os asteriscos

utilizados.Em ambos os casos (asterisco e interrogação), estes símbolos podem ser

• utilizados

como variáveis no início ou final do código desejado

• .
  

• a ordenação e quebra do código de centro de custo com várias interrogações, dependendo do tamanho do campo ou número de níveis. EX: 01.01 mascara de ordenação: ????? (os dois níveis mais o ponto que os separa).

• 
  

• Ordenação decrescente:

caso

• Caso esteja configurando uma ordenação, informe se ela será de forma decrescente ou crescente (padrão). Para ordem decrescente, marque (habilite) o campo.


No exemplo acima foi selecionado a tabela "PFunc", o campo "CodSecao", o controle "CodSecao1" e a quebra "***??".
Nesse caso, o resultado será o seguinte: O reports listará os funcionários, incluindo uma quebra pela 4º e 5º posição da seção do funcionário.O valor da quebra será disponibilizado no controle "CodSecao1".

• 
  
  

  Informações
  icon false title OBSERVAÇÃO:
  Ao clicar no botão "+Adicionar", as informações de ligação do controle serão validadas. Serão inclusos somente a "tabela" e o "campo" da ligação correspondente a "tabela" e o "campo" do agrupamento. Caso contrário, será exibido uma mensagem.

  
  Impressão de relatórios:
  
  1) - No exemplo abaixo, não houve nenhum tipo de quebra:

  Image Added
  
  2) - No exemplo abaixo, houve uma quebra pela campo Código da seção (não houve quebra por máscara).

  Para configurar uma quebra normal (sem quebra por máscara), basta usar a propriedade "Ordenação/Quebra" da banda de "cabeçalho de detalhe".
  
  Image Added
  
  3) - No exemplo abaixo, houve uma quebra por máscara (escopo de documento).

  O campo código da seção foi quebrado e agrupado pelas duas últimas posições.
  
  Image Added