Versões comparadas

Chave

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

...

Produto:

TOTVS Reports

Versões:

12.1.XX

Ocorrência:

 

Ambiente:

 

Passo a passo

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

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 resultado definido como verdadeiro, ou pode ser apresentado um resultado definido como falso. 

Assinaturas Possíveis:

  • DateTime If(Boolean Teste, DateTime Verdadeiro, DateTime Falso)
  • Decimal If(Boolean Teste, Decimal Verdadeiro, Decimal Falso)
  • Enum If(Boolean Teste, Enum Verdadeiro, Enum Falso)
  • Integer If(Boolean Teste, Integer Verdadeiro, Integer Falso)
  • Object If(Boolean Teste, Object Verdadeiro, Object Falso)
  • String If(Boolean Teste, String Verdadeiro, String 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.

Assinaturas Possíveis:

  • Boolean Boolean(Boolean Valor)
  • Boolean Boolean(DateTime Valor)
  • Boolean Boolean(Decimal Valor)
  • Boolean Boolean(Enum Valor)
  • Boolean Boolean(Integer Valor)
  • Boolean Boolean(Object Valor)
  • Boolean Boolean(String Valor)
2DateTime
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String

Converte um objeto em um valor Data/Hora.

Assinaturas Possíveis:

  • DateTime DateTime(Boolean Valor)
  • DateTime DateTime(DateTime Valor)
  • DateTime DateTime(Decimal Valor)
  • DateTime DateTime(Enum Valor)
  • DateTime DateTime(Integer Valor)
  • DateTime DateTime(Object Valor)
  • DateTime DateTime(String Valor)
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).

Assinaturas Possíveis:

  • Decimal Decimal(Boolean Valor)
  • Decimal Decimal(DateTime Valor)
  • Decimal Decimal(Decimal Valor)
  • Decimal Decimal(Enum Valor)
  • Decimal Decimal(Integer Valor)
  • Decimal Decimal(Object Valor)
  • Decimal Decimal(String Valor)
4Enum
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String

Converte um objeto em um valor Enumerado .

Assinaturas Possíveis:

  • Enum Enum(Boolean Valor)
  • Enum Enum(DateTime Valor)
  • Enum Enum(Decimal Valor)
  • Enum Enum(Enum Valor)
  • Enum Enum(Integer Valor)
  • Enum Enum(Object Valor)
  • Enum Enum(String Valor)
5Integer
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String

Converte um objeto em um valor inteiro. 

Assinaturas Possíveis:

  • Integer Integer(Boolean Valor)
  • Integer Integer(DateTime Valor)
  • Integer Integer(Decimal Valor)
  • Integer Integer(Enum Valor)
  • Integer Integer(Integer Valor)
  • Integer Integer(Object Valor)
  • Integer Integer(String Valor)
6Object
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String

Converte qualquer outro tipo em um objeto. 

Assinaturas Possíveis:

  • Object Object(Boolean Valor)
  • Object Object(DateTime Valor)
  • Object Object(Decimal Valor)
  • Object Object(Enum Valor)
  • Object Object(Integer Valor)
  • Object Object(Object Valor)
  • Object Object(String Valor)
7String
ParâmetroTipos possíveis
1Valor
  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String

Converte um objeto em um valor alfanumérico .

Assinaturas Possíveis:

  • String String(Boolean Valor)
  • String String(DateTime Valor)
  • String String(Decimal Valor)
  • String String(Enum Valor)
  • String String(Integer Valor)
  • String String(Object Valor)
  • String String(String Valor)
3Matemática
  • Comandos matemáticos;
  • Permite arredondamentos, truncamentos, calculo com ângulos, etc... 

Funções Disponíveis:

NomeParâmetroDescrição
1Trunc
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna o numero informado truncado, ou seja, retorna a parte inteira de um numero, a parte fracionária é descartada. 

Assinaturas Possíveis:

  • Integer Trunc(Decimal Valor)
2Round
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna o valor informado arredondado.

Assinaturas Possíveis:

  • Integer Round(Decimal Valor)
3ArcTan
ParâmetroTipos possíveis
1Tangente
  • Decimal

Retorna o valor do ângulo para o valor da tangente informado.

Assinaturas Possíveis:

  • Decimal ArcTan(Decimal Tangente)
4Cos
ParâmetroTipos possíveis
1Ângulo
  • Decimal

Retorna o cosseno do ângulo informado.

Assinaturas Possíveis:

  • Decimal Cos(Decimal Ângulo)
5Exp
ParâmetroTipos possíveis
1Potência
  • Decimal

Retorna o valor de e elevado a potência informada.

Assinaturas Possíveis:

  • Decimal Exp(Decimal Potência)
6Frac
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna a parte fracionária de um numero informado.

Assinaturas Possíveis:

  • Decimal Frac(Decimal Valor)
7Int
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna a parte inteira de um numero informado.

Assinaturas Possíveis:

  • Decimal Int(Decimal Valor)
8Log
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna o logaritmo do número informado. 

Assinaturas Possíveis:

  • Decimal Log(Decimal Valor)
9Sin
ParâmetroTipos possíveis
1Ângulo
  • Decimal

Retorna o seno do ângulo informado.

Assinaturas Possíveis:

  • Decimal Sin(Decimal Ângulo)
10Sqr
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna o número informado elevado ao quadrado.

Assinaturas Possíveis:

  • Decimal Sqr(Decimal Valor)
11Sqrt
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna a raiz quadrada do numero informado

Assinaturas Possíveis:

  • Decimal Sqrt(Decimal Valor)
12Abs
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna o valor absoluto do número informado. 

Assinaturas Possíveis:

  • Decimal Abs(Decimal Valor)
13Power
ParâmetroTipos possíveis
1Valor
  • Decimal
2Potência
  • Decimal

Retorna um valor elevado a potência informada.

Assinaturas Possíveis:

  • Decimal Power(Decimal Valor, Decimal Potência)
14Random
ParâmetroTipos possíveis
1Máximo
  • Integer

Retorna um valor aleatório.

Assinaturas Possíveis:

  • Decimal Random()
  • Decimal Random(Integer Máximo)
4Texto
  • Comandos de Texto;
  • Permite transformar os caracteres de uma cadeia de caracteres em maiúsculo, minusculo;
  • Permite remover os espaços em branco tanto na frente quanto atrás da cadeia de caracteres;
  • Permite remover caracteres da cadeia de caracteres, etc...

Funções Disponíveis:

NomeParâmetrosDescrição
1Upper
ParâmetroTipos possíveis
1Texto
  • String
 

Transforma o texto informado em maiúsculo.

Assinaturas Possíveis:

  • Upper(String Texto)
2Lower
ParâmetroTipos possíveis
1Texto
  • String

Transforma o texto informado em minusculo.

 

Assinaturas Possíveis:

 

  • Lower(String Texto)


3Length
ParâmetroTipos possíveis
1Texto
  • String
 
4Trim
ParâmetroTipos possíveis
1Texto
  • String
 
5TrimEnd
ParâmetroTipos possíveis
1Texto
  • String
 
6TrimStart
ParâmetroTipos possíveis
1Texto
  • String
 
7IndexOf
ParâmetroTipos possíveis
1Texto1
  • String
2Texto2
  • String
3Posição
  • Integer
4Inicio
  • Integer
5Fim
  • Integer
 
8LastIndexOf
ParâmetroTipos possíveis
1Texto1
  • String
2Texto2
  • String
 
9PadLeft
ParâmetroTipos possíveis
1Texto
  • String
2Tamanho
  • Integer
3Caractere
  • String
 
10PadRight
ParâmetroTipos possíveis
1Texto
  • String
2Tamanho
  • Integer
3Caractere
  • String
 
11Remove
ParâmetroTipos possíveis
   
 
12SubString
ParâmetroTipos possíveis
   
 
13Replace
ParâmetroTipos possíveis
   
 
14ReplaceAll
ParâmetroTipos possíveis
   
 
15StringBetween
ParâmetroTipos possíveis
   
 
16Format
ParâmetroTipos possíveis
   
 
17Split
ParâmetroTipos possíveis
   
 
18Join
ParâmetroTipos possíveis
   
 


5Data/Hora  
6Financeira  
7Estatística  

 

 

 

1.1.2 - Funcionalidade Parâmetros


1.1.2 - Propriedades Formato e Arredondar Valor


 

 

 

Observações:

 

...