Linha RM

Atalhos

Páginas filhas
  • RPT00021.1 - Expressão (Geral)

Índice:

       

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.

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°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)

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°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.

Funcionalidade Funções

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

  • 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)



  • 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)

  • 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)

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

  • String Upper(String Texto)
2 Lower
N° Parâmetro Tipos possíveis
1 Texto
  • String

Transforma o texto informado em minusculo.

 Assinaturas Possíveis:

  • String Lower(String Texto)
3 Length
N° Parâmetro Tipos possíveis
1 Texto
  • String

Retorna o tamanho do texto informado.

Assinaturas Possíveis:

  • Integer Length(String Texto)
4 Trim
N° Parâmetro Tipos possíveis
1 Texto
  • String

Retira os espaços em branco do inicio e fim do texto informado.

Assinaturas Possíveis:

  • String Trim(String Texto)
5 TrimEnd
N° Parâmetro Tipos possíveis
1 Texto
  • String

Retira os espaços em branco do fim do texto informado.

Assinaturas Possíveis:

  • String TrimEnd(String Texto)
6 TrimStart
N° Parâmetro Tipos possíveis
1 Texto
  • String

Retira os espaços em branco do inicio do texto informado.

Assinaturas Possíveis:

  • String TrimStart(String Texto)
7 IndexOf
N° Parâmetro Tipos possíveis
1 Texto1
  • String
2 Texto2
  • String
3 Posição
  • Integer
4 Inicio
  • Integer
5 Fim
  • Integer

Retorna a primeira posição do texto 2 dentro do texto 1.

Assinaturas Possíveis:

  • Integer IndexOf(String Texto1, String Texto2)
  • Integer IndexOf(String Texto1, String Texto2, Integer Posição)
  • Integer IndexOf(String Texto1, String Texto2, Integer Inicio, Integer Fim)
  • Integer IndexOf(String Texto1, String Texto2, Integer Posição)
  • Integer IndexOf(String Texto1, String Texto2, Integer Inicio, Integer Fim)
8 LastIndexOf
N° Parâmetro Tipos possíveis
1 Texto1
  • String
2 Texto2
  • String

Retorna a ultima posição do texto 2 dentro do texto 1.

Assinaturas Possíveis:

  • Integer LastIndexOf(String Texto1, String Texto2)
9 PadLeft
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Tamanho
  • Integer
3 Caractere
  • String

Alinha o texto informado a esquerda de acordo com o tamanho informado.

Assinaturas Possíveis:

  • String PadLeft(String Texto, Integer Tamanho)
  • String PadLeft(String Texto, Integer Tamanho, String Caractere)
10 PadRight
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Tamanho
  • Integer
3 Caractere
  • String

Alinha o texto informado a direita de acordo com o tamanho informado.

Assinaturas Possíveis:

  • String PadRight(String Texto, Integer Tamanho)
  • String PadRight(String Texto, Integer Tamanho, String Caractere)
11 Remove
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Posição
  • Integer
3 Tamanho
  • Integer

Remove os caracteres do texto informado a partir da posição informada.

Assinaturas Possíveis:

  • String Remove(String Texto, Integer Posição)
  • String Remove(String Texto, Integer Posição, IntegerTamanho)
12 SubString
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Posição
  • Integer
3 Tamanho
  • Integer

Retorna o sub-texto do texto informado a partir da posição informada.

Assinaturas Possíveis:

  • String SubString(String Texto, Integer Posição)
  • String SubString(String Texto, Integer Posição, Integer Tamanho)
13 Replace
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Procurar
  • String
3 NovoValor
  • String

Substitui a ocorrência de um texto por outro, dentro do texto informado.

Assinaturas Possíveis:

  • String Replace(String Texto, String Procurar, String NovoValor)
14 ReplaceAll
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Procurar
  • String
3 NovoValor
  • String

Substitui todas as ocorrências de um texto por outro, dentro do texto informado.

Assinaturas Possíveis:

  • String ReplaceAll(String Texto, StringProcurar, String NovoValor)
15 StringBetween
N° Parâmetro Tipos possíveis
1 Texto
  • String
2 Procurar
  • String
3 Inicio
  • Integer
4 Final
  • Integer

Retorna o texto que está após o valor informado.

Assinaturas Possíveis:

  • String StringBetween(String Texto, String Procurar)
  • String StringBetween(String Texto, Integer Inicio, Integer Final)
16 Format
N° Parâmetro Tipos possíveis
1 Valor
  • Decimal
  • Integer
  • DateTime
  • String
2 Máscara
  • String

Aplica a máscara de formatação em um objeto.

Assinaturas Possíveis:

  • String Format(Decimal Valor)
  • String Format(Integer Valor)
  • String Format(DateTime Valor)
  • String Format(String Valor)
17 Split
N° Parâmetro Tipos possíveis
1 Valor
  • String
2 Separador
  • String
3 Delimitador
  • String
4 Índice
  • Integer

Quebra um texto separado pelo separador informado e retorna um item do índice.

Assinaturas Possíveis:

  • String Split(String Valor, String Separador, Integer Indice)
  • String Split(String Valor, String Separador, String Delimitador, Integer Indice)
18 Join
N° Parâmetro Tipos possíveis
1 Separador
  • String
2 Texto1
  • String
3 Texto2
  • String

Faz a união de dois valores usando o separador informado.

Assinaturas Possíveis:

  • String Join(String Separador, String Texto1, String Texto2)


  • Comandos de Data/Hora;
  • Retorna data e hora de hoje, retorna dia da semana entre outros...

Funções Disponíveis:

N° Nome Parâmetros Descrição
1 Today

Nenhum

Data do Sistema

Assinaturas Possíveis:

  • DateTime Today()
2 Now

Nenhum

Data/Hora do Sistema

Assinaturas Possíveis:

  • DateTime Now()
3 Day
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna o dia da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Day(DateTime Data)
4 Month
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna o mês da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Month(DateTime Data)
5 Year
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna o ano da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Year(DateTime Data)
6 Hour
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna a hora da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Hour(DateTime Data)
7 Minute
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna os minutos da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Minute(DateTime Data)
8 Second
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna os segundos da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Second(DateTime Data)
9 Millisecond
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna os milissegundos da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Millisecond(DateTime Data)
10 DayOfWeek
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna o dia da semana da Data/Hora informada.

Assinaturas Possíveis:

  • Integer DayOfWeek(DateTime Data)
11 DayOfYear
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime

Retorna o dia do ano da Data/Hora informada.

Assinaturas Possíveis:

  • Integer DayOfYear(DateTime Data)
12 DaysBetween
Nº Parâmetro Tipos possíveis
1 DataInicial
  • DateTime
2 DataFinal
  • DateTime

Retorna o número de dias entre as duas datas informadas.

Assinaturas Possíveis:

  • Integer DaysBetween(DateTime DataInicial, DateTime DataFinal)
13 MonthsBetween
Nº Parâmetro Tipos possíveis
1 DataInicial
  • DateTime
2 DataFinal
  • DateTime

Retorna o número de meses entre as duas datas informadas.

Assinaturas Possíveis:

  • Integer DaysBetween(DateTime DataInicial, DateTime DataFinal)
14 AddDays
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Decimal

Adiciona o número de dias especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddDays(DateTime Data, Decimal Valor)
15 AddMonths
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Integer

Adiciona o número de meses especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddMonths(DateTime Data, Integer Valor)
16 AddYears
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Integer

Adiciona o número de anos especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddYears(DateTime Data, Integer Valor)
17 AddHours
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Decimal

Adiciona o número de horas especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddHours(DateTime Data, Decimal Valor)
18 AddMinutes
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Decimal

Adiciona o número de minutos especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddMinutes(DateTime Data, Decimal Valor)
19 AddSeconds
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Decimal

Adiciona o número de segundos especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddSeconds(DateTime Data, Decimal Valor)
20 AddMilliseconds
Nº Parâmetro Tipos possíveis
1 Data
  • DateTime
2 Valor
  • Decimal

Adiciona o número de milisegundos especificados na data informada.

Assinaturas Possíveis:

  • DateTime AddMilliseconds(DateTime Data, Decimal Valor)


  • Comandos Financeiros;
  • Retorna Períodos de uma Anuidade, bem como valores futuros e juros incidentes sobre a mesma.
  • Retorna Taxa de Retorno, VPL e Tempo de Payback de Lançamentos, entre outros...

Funções Disponíveis:

N° Nome Parâmetros Descrição
1 FV
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Períodos
  • Decimal
3 Pagamento
  • Decimal
4 ValorPresente
  • Decimal
5 ModoDePagamento
  • Integer

Retorna o valor futuro de uma anuidade com pagamentos periódicos fixos.

Assinaturas Possíveis:

  • Decimal FV(Decimal Taxa, Decimal Periodos, Decimal Pagamento, Decimal ValorPresente, Integer ModoDePagamento)
2 IPmt
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Período
  • Decimal
3 Períodos
  • Decimal
4 ValorPresente
  • Decimal
5 ValorFuturo
  • Decimal
6 ModoDePagamento
  • Integer

Retorna os juros pagos em uma anuidade com pagamentos periódicos fixos.

Assinaturas Possíveis:

  • Decimal IPmt(Decimal Taxa, Decimal Periodo, Decimal Periodos, Decimal ValorPresente, Decimal ValorFuturo, Integer ModoDePagamento)
3 NPer
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Pagamento
  • Decimal
3 ValorPresente
  • Decimal
4 ValorFuturo
  • Decimal
5 ModoDePagamento
  • Integer

Retorna o número de períodos de uma anuidade com pagamentos periódicos fixos.

Assinaturas Possíveis:

  • Decimal NPer(Decimal Taxa, Decimal Pagamento, Decimal ValorPresente, Decimal ValorFuturo, Integer ModoDePagamento)
4 Pmt
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Periodos
  • Decimal
3 ValorPresente
  • Decimal
4 ValorFuturo
  • Decimal
5 ModoDePagamento
  • Integer

Retorna o valor do pagamento por período de uma anuidade com pagamentos periódicos fixos.

Assinaturas Possíveis:

  • Decimal Pmt(Decimal Taxa, Decimal Periodos, Decimal ValorPresente, Decimal ValorFuturo, Integer ModoDePagamento)
5 PPmt
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Periodo
  • Decimal
3 Periodos
  • Decimal
4 ValorPresente
  • Decimal
5 ValorFuturo
  • Decimal
6 ModoDePagamento
  • Integer

Retorna o valor do pagamento principal de uma anuidade com pagamentos periódicos fixos.

Assinaturas Possíveis:

  • Decimal PPmt(Decimal Taxa, Decimal Periodo, Decimal Periodos, Decimal ValorPresente, Decimal ValorFuturo, Integer ModoDePagamento)
6 PV
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Periodos
  • Decimal
3 Pagamento
  • Decimal
4 ValorFuturo
  • Decimal
5 ModoDePagamento
  • Integer

Retorna o valor presente de uma anuidade com pagamentos periódicos fixos a ser paga no futuro.

Assinaturas Possíveis:

  • Decimal PV(Decimal Taxa, Decimal Periodos, Decimal Pagamento, Decimal ValorFuturo, Integer ModoDePagamento)
7 Rate
Nº Parâmetro Tipos possíveis
1 Periodos
  • Decimal
2 Pagamento
  • Decimal
3 ValorPresente
  • Decimal
4 ValorFuturo
  • Decimal
5 ModoDePagamento
  • Integer

Retorna a taxa de juros de uma anuidade com pagamentos periódicos fixos.

Assinaturas Possíveis:

  • Decimal Rate(Decimal Periodos, Decimal Pagamento, Decimal ValorPresente, Decimal ValorFuturo, Integer ModoDePagamento)
8 ConvertRate
Nº Parâmetro Tipos possíveis
1 Taxa
  • Decimal
2 Origem
  • Integer
3 Destino
  • Integer

Retorna a taxa de juros anual convertida para mensal.

Assinaturas Possíveis:

  • Decimal ConvertRate(Decimal Taxa, Integer Origem, Integer Destino)
  • Decimal ConvertRate(Decimal Taxa)
9 IRR
Nº Parâmetro Tipos possíveis
1 Tabela
  • Object
2 Periodo
  • String
3 Valor
  • String
4 TaxaValorFuturo
  • Decimal

Retorna a taxa interna de retorno para uma série de lançamentos.

Assinaturas Possíveis:

  • Decimal IRR(Object Tabela, String Periodo, String Valor, Decimal
    TaxaValorFuturo)
10 MIRR
Nº Parâmetro Tipos possíveis
1 Tabela
  • Object
2 Período
  • String
3 Valor
  • String
4 TaxaDesconto
  • Decimal
5 TaxaInvestimento
  • Decimal

Retorna a taxa interna de retorno modificada para uma série de lançamentos.

Assinaturas Possíveis:

  • Decimal MIRR(Object Tabela, String Periodo, String Valor, Decimal
    TaxaDesconto, Decimal TaxaInvestimento)
11 NPV
Nº Parâmetro Tipos possíveis
1 Tabela
  • Object
2 Periodo
  • String
3 Valor
  • String
4 TaxaDesconto
  • Decimal

Retorna o VPL para uma série de lançamentos.

Assinaturas Possíveis:

  • Decimal NPV(Object Tabela, String Periodo, String Valor, Decimal
    TaxaDesconto)
12 Payback
Nº Parâmetro Tipos possíveis
1 Tabela
  • Object
2 Periodo
  • String
3 Valor
  • String
4 TaxaDesconto
  • Decimal

Calcula o tempo de payback para uma série de lançamentos.

Assinaturas Possíveis:

  • Decimal Payback(Object Tabela, String Periodo, String Valor, Decimal
    TaxaDesconto)
  • Comandos Estatísticos;
  • A partir de uma lista de objetos os comandos estatísticos retornam a quantidade de itens, a soma, a média, o mínimo e o máximo, entre outras operações com listas.

Funções Disponíveis:

N° Nome Parâmetros Descrição
1 Sum
Nº Parâmetro Tipos possíveis
1 Lista
  • Object
2 Campo
  • String

Soma os valores de uma lista.

Assinaturas Possíveis:

  • Decimal Sum(Object Lista, String Campo)
2 Min
Nº Parâmetro Tipos possíveis
1 Lista
  • Object
2 Campo
  • String

Retorna o menor valor de um campo da lista.

Assinaturas Possíveis:

  • Decimal Min(Object Lista, String Campo)
3 Max
Nº Parâmetro Tipos possíveis
1 Lista
  • Object
2 Campo
  • String

Retorna o maior valor de um campo da lista.

Assinaturas Possíveis:

  • Decimal Max(Object Lista, String Campo)
4 Select
Nº Parâmetro Tipos possíveis
1 Lista
  • Object
2 Filtro
  • String
3 Campos
  • String
4 Valores
  • String

Retorna um subconjunto filtrado dos dados de uma lista.

Assinaturas Possíveis:

  • Object Select(Object Lista, String Filtro)
  • Object Select(Object Lista, String Campos, String Valores)
5 Lookup
Nº Parâmetro Tipos possíveis
1 Lista
  • Object
2 ColunaResultado
  • String
3 ColunaValor
  • String
4 Valor
  • Object
5 Linha
  • Integer

Retorna o valor de uma coluna da lista baseado no valor de outra.

Assinaturas Possíveis:

  • Object Lookup(Object Lista, String ColunaResultado, String ColunaValor, Object Valor)
  • Object Lookup(Object Lista, String ColunaResultado, Integer Linha)
6 isEmpty
Nº Parâmetro Tipos possíveis
1 Lista
  • Object

Retorna se a lista está vazia.

Assinaturas Possíveis:

  • Boolean isEmpty(Object Lista)


Os tipos de parâmetros possíveis não devem ser colocados entre os parênteses. Informe apenas o valor desejado conforme o exemplo:


Funcionalidade Parâmetros

Os parâmetros disponíveis são:

N°NomeDescriçãoImagem
1Base

Os parâmetros Base (Campos da Base), poderão ser:

  • Campos da base (Separados pelo nome da Tabela do banco)
  • Campos de consultas SQL (Separados pelo nome da consulta SQL)


2Relatório

Os parâmetros Relatório (Campos do Relatório), poderão ser:

  • Os variados controles disponíveis na caixa de ferramentas do Relatório.
  • Parâmetros do Relatório

Propriedades Formato e Arredondar Valor

Como Utilizar a Expressão em um Relatório.

PASSO 1 - Verifique se o detalhe, onde a expressão será adicionada, contém um membro de dados.


OBSERVACAO

O membro de dados pode ser tanto uma tabela do banco como uma consulta SQL.

Se uma expressão é adicionada em um detalhe cujo membro de dados não foi definido, o valor da expressão poderá aparecer zerado.


PASSO 2 - Arraste o componente expressão para dentro do relatório:


PASSO 3 - Preencha as propriedades da Expressão:


PASSO 3 - A) Escreve a expressão utilizando toda a funcionalidade explicada acima. (OBRIGATORIO)


PASSO 3 - B) Escolha a formatação para o resultado da expressão. (FACULTATIVO)


PASSO 3 - C) Escolha se quer que o resultado seja arredondado ou não. (FACULTATIVO)



OBSERVACAO

Caso queira configurar mais propriedades do componente Expressão aperte F4 para que o menu Grade de Propriedades seja apresentado.

Formatação de Dados - XLSX

É possível formatar os dados de uma expressão para a exportação de relatórios nos formatos "XSLX" e "XLS", utilizando o parâmetro "XLSX Formato String" no RM Reports:

Exemplos:

Abaixo está demonstrado um exemplo de formatação com unidades de milhar e decimais, utilizando a máscara 0,000.00:

  • Quando o campo "XLSX Formato String" NÃO é preenchido: 

Ao realizar a geração de um relatório, onde contem uma expressão, perceba que o relatório gerado apresenta a unidade de milhar

  • Quando realizado a exportação do relatório para um arquivo "XSLX" e "XLS", perceba que o campo perde a formatação ao abrir

  • Quando o campo "XSLX" e "XLS" é preenchido CORRETAMENTE:
    • Na grade de propriedades da expressão, Aba "Dados", perceba que existe um campo com o nome "XLSX Formato String". Para impedir que a formatação da expressão não seja perdida ao exportar para XLSX/XLS, iremos adicionar a máscara citada no campo:

  • Agora, ao gerar o relatório e exportar para para um arquivo "XSLX" e "XLS", perceba que o formato não foi perdido, é o mesmo de quando o relatório foi gerado.

Considerações Importantes acerca da Formatação de Dados - XLSX

A formatação de dados segue o padrão utilizado nativamente pelo Microsoft Excel. Dessa forma, para alcançar o resultado desejado, deve se atentar à máscara tal qual o Excel utiliza.

Decimais e Milhares

É importante frisar que a ferramenta de exportação para XLSX/XLS determina que a vírgula/comma ( , ) deve ser utilizada para separar unidades de milhar e o ponto/period ( . ) deve ser utilizado para separar unidades decimais, o que pode ocasionar resultados indesejados caso não seja seguido a risca:


Dado (Deve seguir o formato padrão, com vírgula para separar decimais):


Formatação do campo (Seguindo as determinações corretas):

Resultado:


Abaixo estão as principais máscaras, no padrão do Excel. Para mais informações, consulte a documentação do Microsoft Excel: Criar um formato de número personalizado

  • 0
  • 0.00
  • 0,000.00
  • #,##0
  • #,##0.00
  • 0%
  • 0.00%
  • 0.00E+00
  • ##0.0E+0
  • # ?/?
  • # ??/??
  • m/d/yyyy
  • d-mmm-yy
  • d-mmm
  • mmm-yy
  • h:mm AM/PM
  • h:mm:ss AM/PM
  • h:mm
  • h:mm:ss
  • m/d/yyyy h:mm
  • mm:ss
  • mm:ss.0

Exceções Mais Comuns

Algumas exceções são bastante comuns de ocorrer, quando se executa um relatório contendo expressões, são elas:

N°NomeDescriçãoSolução
1Operador MultiplicaçãoO operador Mult é incompatível com o tipo String.

A solução é simples:

  • Basta envolver o campo com a função Decimal();

Exemplo:

  • DE: Relatório.Text1
  • PARA: Decimal(Relatório.Text1)

Caso haja a possibilidade do campo ser nulo ou branco, utilizar o operador condicional If
para retornar um valor numérico.

Exemplo:

  • DE: Decimal(Relatório.Text1)
  • PARA: Decimal(If(Relatório.Text1 = '', '0', Relatório.Text))
2Operador DivisãoO operador Div é incompatível com o tipo String.
3Operador SomaO operador Plus é incompatível com o tipo String.
4Operador SubtraçãoO operador Minus é incompatível com o tipo String.

...





Produto: Framework

Versão: 12.01.XX

Processo: Expressão (Geral)

Status: Finalizado

Data: 10/10/2017

Autores:

Erlon Cesar Lima De Freitas

Flavio Henrique Pereira Campelo

Gustavo Naves De Castro

Philippe Fernandes Lima Gonçalves

SARAH ROLAND CAMPOS LISBOA

Wesley Avelino De Carvalho

  • Sem rótulos