...

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

Assinaturas Possíveis:

If(Boolean Teste, DateTime Verdadeiro, DateTime Falso)
If(Boolean Teste, Decimal Verdadeiro, Decimal Falso)
If(Boolean Teste, Enum Verdadeiro, Enum Falso)
If(Boolean Teste, Integer Verdadeiro, Integer Falso)
If(Boolean Teste, Object Verdadeiro, Object Falso)
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 Valor)
Boolean(DateTime Valor)
Boolean(Decimal Valor)
Boolean(Enum Valor)
Boolean(Integer Valor)
Boolean(Object Valor)
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(Boolean Valor)
DateTime(DateTime Valor)
DateTime(Decimal Valor)
DateTime(Enum Valor)
DateTime(Integer Valor)
DateTime(Object Valor)
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(Boolean Valor)
Decimal(DateTime Valor)
Decimal(Decimal Valor)
Decimal(Enum Valor)
Decimal(Integer Valor)
Decimal(Object Valor)
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(Boolean Valor)
Enum(DateTime Valor)
Enum(Decimal Valor)
Enum(Enum Valor)
Enum(Integer Valor)
Enum(Object Valor)
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(Boolean Valor)
Integer(DateTime Valor)
Integer(Decimal Valor)
Integer(Enum Valor)
Integer(Integer Valor)
Integer(Object Valor)
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(Boolean Valor)
Object(DateTime Valor)
Object(Decimal Valor)
Object(Enum Valor)
Object(Integer Valor)
Object(Object Valor)
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(Boolean Valor)
String(DateTime Valor)
String(Decimal Valor)
String(Enum Valor)
String(Integer Valor)
String(Object Valor)
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 trun-
cadotruncado, ou seja, retorna a parte in-
teira inteira de um numero, a parte fra-
cionária fracionária é descartada.

Assinaturas Possíveis:

Trunc(Decimal Valor)

2

Round

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

Retorna o valor informado

arre-
dondado.

arredondado.

Assinaturas Possíveis:

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:

ArcTan(Decimal Tangente)

4

Cos

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

Retorna o

coseno

cosseno do ângulo

infor-
mado.

informado.

Assinaturas Possíveis:

Cos(Decimal Ângulo)

5

Exp

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

Retorna o valor de e elevado a

po-
tência

potência informada.

Assinaturas Possíveis:

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:

Frac(Decimal Valor)

7

Int

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

Retorna a parte inteira de um nu-
mero numero informado.

Assinaturas Possíveis:

Int(Decimal Valor)

8

Log

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

Retorna o logaritmo do número

in-
formado

informado.

Assinaturas Possíveis:

Log(Decimal Valor)

9

Sin

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

Retorna o seno do ângulo

informa-
do.

informado.

Assinaturas Possíveis:

Sin(Decimal Ângulo)

10

Sqr

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

Retorna o número informado

eleva-
do

elevado ao quadrado.

Assinaturas Possíveis:

Sqr(Decimal Valor)

11

Sqrt

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

Retorna a raiz quadrada do nume-
ro informadonumero informado

Assinaturas Possíveis:

Sqrt(Decimal Valor)

12

Abs

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

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

Assinaturas Possíveis:

Abs(Decimal Valor)

13

Power

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

Retorna um valor elevado a

potên-
cia

potência informada.

Assinaturas Possíveis:

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:

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

2

Lower

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

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 10

Nova versão 11

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 10

Nova versão 11

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