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 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:

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

Retorna o

valor informado truncado,

numero informado trun-
cado, ou seja, retorna a parte

inteira

in-
teira de


um

valor

numero, a parte

fracionária é des

fra-

cartada

cionária é descartada

2Round
ParâmetroTipos possíveis
1Valor
  • Decimal
Retorna o valor informado arredonarre-
dadodondado.
3ArcTan
ParâmetroTipos possíveis
1Tangente
  • Decimal
Retorna o valor do ângulo para o
valor da tangente informado.
4Cos
ParâmetroTipos possíveis
1Ângulo
  • Decimal
Retorna o coseno do ângulo infor-
mado.
5Exp 
ParâmetroTipos possíveis
1Potência
  • Decimal
Retorna o valor de e elevado a po-
tência informada.
6Frac
ParâmetroTipos possíveis
1Valor
  • Decimal
Retorna a parte fracionário fracionária de um
valor numero informado.
7Int
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna a parte inteira de um

valor

nu-
mero informado.

8Log
ParâmetroTipos possíveis
1Valor
  • Decimal
Retorna o logaritmo do número in-
formado. 
9Sin 
ParâmetroTipos possíveis
1Ângulo
  • Decimal
Retorna o seno do ângulo informa-
do.
10Sqr 
ParâmetroTipos possíveis
1Valor
  • Decimal
Retorna o número informado eleva-
do ao quadrado.
11Sqrt 
ParâmetroTipos possíveis
1Valor
  • Decimal

Retorna a raiz quadrada do nume-
ro informado

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

Retorna o valor absoluto do núme-
ro informado. 

13Power 
14Random 
Image Removed
ParâmetroTipos possíveis
1Valor
  • Decimal
2Potência
  • Decimal
Retorna um valor elevado a potên-
cia informada.
14Random
ParâmetroTipos possíveis
1Máximo
  • Integer
Retorna um valor aleatório.
Image Added
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
 
2Lower
ParâmetroTipos possíveis
1Texto
  • String
 
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
   
 
10PadRight
ParâmetroTipos possíveis
   
 
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
   
 


4Texto 
5Data/Hora  
6Financeira  
7Estatística  

 

 

 

1.1.2 - Funcionalidade Parâmetros


1.1.2 - Propriedades Formato e Arredondar Valor


 

 

 

Observações:

 

...

  • Boolean
  • DateTime
  • Decimal
  • Enum
  • Integer
  • Object
  • String
  • String