Índice:


       

Introdução:


       Com o advento da migração do TOTVS Reports da versão 11.8x para as versões superiores a versão 12.1.4, muitas alterações foram feitas principalmente na geração sobre demanda dos dados vinculados a cada componente presente no relatório.

Em relatórios da versão 11.8x, por exemplo, a geração sobre demanda dos dados era realizada no momento da impressão de cada componente, ao contrário dos das versões



1 - Como Funciona?



Como exemplo usaremos o Relatório TesteFormatação . Existem 3 campos nesse relatório:

  • CHAPA
  • NOME
  • SALÁRIO

Iremos utilizar o campo SALÁRIO como base para a explicação sobre a formatação. Observe a imagem abaixo e perceba que o campo SALÁRIO está sem formatação.


Imagem 1 - Relatório TesteFormatação com campo SALÁRIO sem formatação.

1.1 - Configurando a Formatação



Clicando na SmartTag do controle a ser formatado a tela "Texto Tarefas" será apresentada.
 


Imagem 2 - Tela "Texto Tarefas".


Clicando em [...] na Propriedade Formato do Texto a Tela "Editor de Formatar Caracter" será apresentada.
 


Imagem 3 - Tela "Editor de Formatar Caracter".

1.1.1 - Diferentes Categorias de Formatação



Nome das Categorias de FormataçãoDescrição das Categorias de Formatação
DataHoraFormata diferentes valores transformando-os em data (System.DateTime).
NúmeroFormata diferentes valores transformando-os em numéricos.
PorcentoFormata os valores numéricos transformando-os em valores percentuais.
MoedaFormata os valores numéricos transformando-os em valores monetários (acompanhados ou não, dos simbolos monetários).
EspecialTipos especiais de Formatação, como telefone, cpf, cnpj, entre outros.
GeralUtiliza prefixos e sufixos para gerar a máscara de formatação à ser utilizada.



Links que podem auxiliar no entendimento da funcionalidade:

1.2 - Aplicando a Formatação



<content-mark>

Ao escolher o tipo de Formatação, por exemplo, Formato Monetário {0:c2}, ao gerar o relatório o mesmo será devidamente aplicado.

</content-mark>



Imagem 10 - Escolhendo o formato que será aplicado no controle.



Imagem 11 - Relatório TesteFormatação com campo SALÁRIO devidamente formatado.

2 - Restrições da Funcionalidade e Usos Inadequados



  • Não existe implementação, hoje, no Reports que possibilite, a formatação de vários controles ao mesmo tempo.
  • Existe uma funcionalidade chamada SUMÁRIO, disponibilizada ao escolher mais de um controle, onde uma de suas propriedades também é "Formato de texto", porém ela é utilizada internamente nos cálculos à ser realizado pelo SUMÁRIO, ela não tem ligação direta com a propriedade de mesmo nome disponibilizada individualmente em cada controle, explicada acima, no passo a passo.


Imagem 12 - Propriedade "Formato do Texto" do Sumário.

  • A formatação de texto deverá ocorrer individualmente para cada controle.