Versões comparadas

Chave

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

...

Índice:

...

TOTVS Reports

...

Versões:

...

12.1.x

...

Ocorrência:

...

Formatação

...

Ambiente:

...

 

...

Passo a passo:

Índice
excludeExpressão (Geral)|Conteúdo

1 - Como Funciona?

 

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

  • CHAPA
  • NOME
  • SALÁRIO

...


       

Índice
exclude.*ndice:

Introdução


A propriedade Arredondar Valor faz com que valores formatados sejam ou não arredondados. Essa propriedade está presente nos seguintes controles do relatório:


Informações
iconfalse
Deck of Cards
idI
Card
labelTexto

Image Added

Card
labelExpressão

Image Added

Card
labelFórmula

Image Added

Card
labelTotalizador

Image Added


Um relatório foi criado para demonstrar a diferença entre a propriedade Arredondar Valor marcada e desmarcada.


Image Added


Esse relatório contém todos os quatros controles citados acima. Os controles Expressao1, Texto1 e Formula1 trazem como resultado o valor 4,0190.

O formato utilizado é o {0:n2}.


Informações
titleFORMATAÇÂO

Para saber mais sobre formatação veja: Formatação (Passo a Passo).


Demonstração:

Informações
iconfalse
Deck of Cards
idI
Card
labelPropriedade Arredondar Valor marcada.


Image Added


Podemos perceber que o relatório gerado trouxe os quatro campos com o valor 4,02, que é exatamente o valor 4,0190 formatado com duas casas decimais e devidamente arredondado.


Card
labelPropriedade Arredondar Valor desmarcada.

Image Added


O valor gerado agora para os quatro controles é 4,01, que é o valor 4,0190 formatado com duas casas decimais, porém seu valor não foi arredondado, foi simplesmente truncado, ou seja, anda-se com a virgula, sem qualquer outra alteração.

Informações
titleVERSIONAMENTO
A propriedade Arredondar Valor está disponível a partir das versões 12.1.15 ou superiores.




Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.01.XX

Informações
iconfalse

Processo: Propriedade Arredondar Valor

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

Image Removed
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 Removed
Imagem 2 - Tela "Texto Tarefas".

...

Image Removed
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
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 Auxiliares

Links que podem auxiliar no entendimento da funcionalidade:

1.2 - Aplicando a Formatação

...

 

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

 

Image Removed
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 Removed
Imagem 12 - Propriedade "Formato do Texto" do Sumário.

...

Observações:

...