Expressão (Geral)

 

Produto:

TOTVS Reports

Versões:

12.1.XX

Ocorrência:

 

Ambiente:

 

Passo a passo

1 - Expressão (Entendendo as Propriedades)


 

O componente expressão tem várias propriedades, e o entendimento das mesmas é necessário para uma correta configuração do componente.

1.1 - Propriedades Presentes na Smart Tag


 

Ao adicionar um componente Expressão, o usuário observará uma pequena seta do lado direito superior do componente. A clicar na seta, uma pequena janela será mostrada com algumas propriedades, essas propriedades são muito importantes para a correta configuração do componente.

 

 

Essas propriedades são:

NomeVersãoDescrição
1Expressão12.1.xDefine a expressão que será validada e executada pelo "motor" do relatório, afim de apresentar um valor.
2Formato12.1.xFormata o valor final gerado pelo componente expressão.
3Arredondar Valor12.1.15 (ou superiores)Arredondamento facultativo do valor após a aplicação da formatação. (Valor Padrão: Campo Marcado)

 

1.1.1 - Propriedade Expressão


 

Ao clicar no botão [...] do lado direito da caixa de texto, vinculados a propriedade Expressão, uma tela será apresentada:
 

 

Nela temos duas funcionalidades:

NomeVersãoDescrição
1Funções12.1.xDispõe de diversas funções, que varia de Lógicas a Estatísticas, para facilitar a construção de uma expressão.
2Parâmetros12.1.xDispõe de componentes do relatório, campos da base e campos de consultas SQL, para tornar a expressão mais dinâmica.

 

1.1.2 - Funcionalidade Funções


 

As funções disponíveis são:

NomeDescrição 
1Lógico
  • Comandos lógicos;
  • Apresentação de resultado conforme condições.

Funções Disponíveis:

NomeParâmetrosDescrição
1If
ParâmetroTipos possíveis
1Teste
  • Boolean
2Verdadeiro
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
3Falso
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String

Promove resultado condicional, ou
seja, pode ser apresentado um re-
sultado definido como verdadeiro,
ou pode ser apresentado um resul-
tado definido como falso. 

2Conversão
  • Comandos de conversão;
  • Realiza a conversão de tipos;
  • Necessário para o bom funcionamento caso se
    utilize como parâmetro de outras funções.

Funções Disponíveis:

NomeParâmetrosDescrição
1Boolean
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte um objeto em um valor
lógico.
2DateTime
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte um objeto em um valor
Data/Hora.
3Decimal
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte um objeto em um valor
numérico decimal (fracionário
ou não).
4Enum
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte um objeto em um valor
Enumerado .
5Integer
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte um objeto em um valor
inteiro. 
6Object
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte qualquer outro tipo em
um objeto. 
7String
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
Converte um objeto em um valor
alfanumérico .
3Matemática
  • Comandos matemáticos;
  • Permite arredondamentos, truncamentos, calculo
    com ângulos, etc... 

Funções Disponíveis:

NomeDescrição
1TruncRetorna o valor informado truncado,
ou seja, retorna a parte inteira de
um valor, a parte fracionária é des-
cartada. 
2RoundRetorna o valor informado arredon-
dado.
3ArcTanRetorna o valor do ângulo para o
valor da tangente informado.
4CosRetorna o coseno do ângulo infor-
mado.
5Exp 
6FracRetorna a parte fracionário de um
valor informado.
7IntRetorna a parte inteira de um valor informado
8Log 
9Sin 
10Sqr 
11Sqrt 
12Abs 
13Power 
14Random 
4Texto 
5Data/Hora  
6Financeira  
7Estatística  

 

 

 

1.1.2 - Funcionalidade Parâmetros


1.1.2 - Propriedades Formato e Arredondar Valor


 

 

 

Observações:

 

 

1Valor