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

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

Image Modified
Imagem 2 - Tela "Texto Tarefas".

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

Image Modified
Imagem 3 - Tela "Editor de Formatar Caracter".

1.1.1 - Diferentes Categorias de Formatação

---

Nome das Categorias de Formatação	Descrição das Categorias de Formatação
DataHora	Formata diferentes valores transformando-os em data (System.DateTime).
Número	Formata diferentes valores transformando-os em numéricos.
Porcento	Formata os valores numéricos transformando-os em valores percentuais.
Moeda	Formata os valores numéricos transformando-os em valores monetários (acompanhados ou não, dos simbolos monetários).
Especial	Tipos especiais de Formatação, como telefone, cpf, cnpj, entre outros.
Geral	Utiliza prefixos e sufixos para gerar a máscara de formatação à ser utilizada.

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>

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

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

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

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