Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice:


       

Índice
exclude.*ndice:

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.

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

Diferentes Categorias de Formatação



Deck of Cards
idFonte de Dados
Card
id1
labelDataHora
Formata diferentes valores transformando-os em data (System.DateTime).

Card
id2
labelNúmero
Formata diferentes valores transformando-os em numéricos.

Dica

Ao utilizar uma máscara numérica contendo com '#' significa que o dígito é opcional, o que irá representar um vazio quando não houver valores. Para tornar a representação do dígito obrigatória basta utilizar o carácter '0'. Com isso, a posição do dígito sempre será informada.

Abaixo seguem alguns exemplos para simplificar para simplificar o entendimento. Qualquer dúvida estou à disposição para esclarecimentos.

Exemplos:

O número *012* com uma das máscaras ('#', '##', '###', '####', '#0', '#00', ... ) resultará em *12* (perceba que não é obrigatório exibir o número insignificante '0')

Os números *012* ou mesmo o número *12* com máscara '000' resultará em *012* (perceba que mesmo o número insignificante '0' será exibido pois essa máscara obriga a exibição de 3 dígitos)

Card
id3
labelPorcento
Formata os valores numéricos transformando-os em valores percentuais.

Card
id4
labelMoeda
Formata os valores numéricos transformando-os em valores monetários (acompanhados ou não, dos símbolos monetários).

Card
id5
labelEspecial
Tipos especiais de Formatação, como telefone, cpf, cnpj, entre outros.

Card
id6
labelGeral

Utiliza prefixos e sufixos para gerar a máscara de formatação à ser utilizada.

Informações
iconfalse
titleLinks Auxiliares

Links que podem auxiliar no entendimento da funcionalidade:

Aplicando a Formatação



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

HTML
</content-mark>



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



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

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.


Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.01.XX

Informações
iconfalse

Processo: Formatação

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: 10/10/2017

Informações
iconfalse

Autores:

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gustavo Naves De Castro

Philippe Fernandes Lima Gonçalves

SARAH ROLAND CAMPOS LISBOA

Wesley Avelino De Carvalho


http://tdn.totvs.com/x/kIcpE