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

Nome das Categorias de FormataçãoDescrição das Categorias de Formatação


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

Image Added

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.
Card
id2
labelNúmero

Diferentes tipos de Formatos:

Deck of Cards
idFonte de Dados
Card
id1
labelDataHora

Image Removed

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