...

Produto:

TOTVS Reports

Versões:

12.1.XX

Ocorrência:

Ambiente:

Passo a passo

Índice

exclude	Expressã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:

N°	Nome	Versão	Descrição
1	Expressão	12.1.x	Define a expressão que será validada e executada pelo "motor" do relatório, afim de apresentar um valor.
2	Formato	12.1.x	Formata o valor final gerado pelo componente expressão.
3	Arredondar Valor	12.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:

N°	Nome	Versão	Descrição
1	Funções	12.1.x	Dispõe de diversas funções, que varia de Lógicas a Estatísticas, para facilitar a construção de uma expressão.
2	Parâmetros	12.1.x	Dispõ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:

N°

Nome

Descrição

1

Lógico

Comandos lógicos;
Apresentação de resultado conforme condições.

Funções Disponíveis:

N°

Nome

Parâmetros

Descrição

1

If

N°	Parâmetro	Tipos possíveis
1	Teste	Boolean
2	Verdadeiro	DateTime Decimal Enum Integer Object String
3	Falso	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)

2

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

N°

Nome

Parâmetros

Descrição

1

Boolean

N°	Parâmetro	Tipos possíveis
1	Valor	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)

2

DateTime

N°	Parâmetro	Tipos possíveis
1	Valor	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)

3

Decimal

N°	Parâmetro	Tipos possíveis
1	Valor	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)

4

Enum

N°	Parâmetro	Tipos possíveis
1	Valor	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)

5

Integer

N°	Parâmetro	Tipos possíveis
1	Valor	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)

6

Object

N°	Parâmetro	Tipos possíveis
1	Valor	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)

7

String

N°	Parâmetro	Tipos possíveis
1	Valor	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)

3

Matemática

Comandos matemáticos;
Permite arredondamentos, truncamentos, calculo com ângulos, etc...

Funções Disponíveis:

Nº

Nome

Parâmetro

Descrição

1

Trunc

N°	Parâmetro	Tipos possíveis
1	Valor	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)

2

Round

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna o valor informado arredondado.

Assinaturas Possíveis:

Integer Round(Decimal Valor)

3

ArcTan

N°	Parâmetro	Tipos possíveis
1	Tangente	Decimal

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

Assinaturas Possíveis:

Decimal ArcTan(Decimal Tangente)

4

Cos

N°	Parâmetro	Tipos possíveis
1	Ângulo	Decimal

Retorna o cosseno do ângulo informado.

Assinaturas Possíveis:

Decimal Cos(Decimal Ângulo)

5

Exp

N°	Parâmetro	Tipos possíveis
1	Potência	Decimal

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

Assinaturas Possíveis:

Decimal Exp(Decimal Potência)

6

Frac

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna a parte fracionária de um numero informado.

Assinaturas Possíveis:

Decimal Frac(Decimal Valor)

7

Int

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna a parte inteira de um numero informado.

Assinaturas Possíveis:

Decimal Int(Decimal Valor)

8

Log

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna o logaritmo do número informado.

Assinaturas Possíveis:

Decimal Log(Decimal Valor)

9

Sin

N°	Parâmetro	Tipos possíveis
1	Ângulo	Decimal

Retorna o seno do ângulo informado.

Assinaturas Possíveis:

Decimal Sin(Decimal Ângulo)

10

Sqr

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna o número informado elevado ao quadrado.

Assinaturas Possíveis:

Decimal Sqr(Decimal Valor)

11

Sqrt

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna a raiz quadrada do numero informado

Assinaturas Possíveis:

Decimal Sqrt(Decimal Valor)

12

Abs

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal

Retorna o valor absoluto do número informado.

Assinaturas Possíveis:

Decimal Abs(Decimal Valor)

13

Power

N°	Parâmetro	Tipos possíveis
1	Valor	Decimal
2	Potência	Decimal

Retorna um valor elevado a potência informada.

Assinaturas Possíveis:

Decimal Power(Decimal Valor, Decimal Potência)

14

Random

N°	Parâmetro	Tipos possíveis
1	Máximo	Integer

Retorna um valor aleatório.

Assinaturas Possíveis:

Decimal Random()
Decimal Random(Integer Máximo)

4

Texto

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:

N°

Nome

Parâmetros

Descrição

1

Upper

N°	Parâmetro	Tipos possíveis
1	Texto	String

Transforma o texto informado em maiúsculo.

Assinaturas Possíveis:

Upper(String Texto)

2

Lower

N°	Parâmetro	Tipos possíveis
1	Texto	String

Transforma o texto informado em minusculo.

Assinaturas Possíveis:

Lower(String Texto)

3

Length

N°	Parâmetro	Tipos possíveis
1	Texto	String

4

Trim

N°	Parâmetro	Tipos possíveis
1	Texto	String

5

TrimEnd

N°	Parâmetro	Tipos possíveis
1	Texto	String

6

TrimStart

N°	Parâmetro	Tipos possíveis
1	Texto	String

7

IndexOf

N°	Parâmetro	Tipos possíveis
1	Texto1	String
2	Texto2	String
3	Posição	Integer
4	Inicio	Integer
5	Fim	Integer

8

LastIndexOf

N°	Parâmetro	Tipos possíveis
1	Texto1	String
2	Texto2	String

9

PadLeft

N°	Parâmetro	Tipos possíveis
1	Texto	String
2	Tamanho	Integer
3	Caractere	String

10

PadRight

N°	Parâmetro	Tipos possíveis
1	Texto	String
2	Tamanho	Integer
3	Caractere	String

11

Remove

N°	Parâmetro	Tipos possíveis

12

SubString

N°	Parâmetro	Tipos possíveis

13

Replace

N°	Parâmetro	Tipos possíveis

14

ReplaceAll

N°	Parâmetro	Tipos possíveis

15

StringBetween

N°	Parâmetro	Tipos possíveis

16

Format

N°	Parâmetro	Tipos possíveis

17

Split

N°	Parâmetro	Tipos possíveis

18

Join

N°	Parâmetro	Tipos possíveis

5

Data/Hora

6

Financeira

7

Estatística

1.1.2 - Funcionalidade Parâmetros

1.1.2 - Propriedades Formato e Arredondar Valor

Para melhor compreender a propriedade Formato, veja Formatação (Passo a Passo).
Para melhor compreender a propriedade Arredondar Valor, veja Propriedade Arredondar Valor.

Observações:

...

Atalhos

Páginas filhas

Versões comparadas

Versão antiga 11

Nova versão 12

Chave

1 - Expressão (Entendendo as Propriedades)

1.1 - Propriedades Presentes na Smart Tag

1.1.1 - Propriedade Expressão

1.1.2 - Funcionalidade Funções

1.1.2 - Funcionalidade Parâmetros

1.1.2 - Propriedades Formato e Arredondar Valor

Atalhos

Páginas filhas

Histórico da Página

Versões comparadas

Versão antiga 11

Nova versão 12

Chave

1 - Expressão (Entendendo as Propriedades)

1.1 - Propriedades Presentes na Smart Tag

1.1.1 - Propriedade Expressão

1.1.2 - Funcionalidade Funções

1.1.2 - Funcionalidade Parâmetros

1.1.2 - Propriedades Formato e Arredondar Valor