Versões comparadas

Chave

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

Expressão (Geral)

 

...

Produto:

...

TOTVS Reports

...

Versões:

...

12.1.XX

...

Ocorrência:

...

 

...

Ambiente:

...

 

...

Índice:


       

...

Índice
exclude

...

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

 

Image Modified

...

 

O componente expressão tem várias propriedades, e o entendimento das mesmas é necessário para uma correta configuração do componente.

 

1.1.2 - Propriedades Formato e Arredondar Valor

 

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)

Propriedade Expressão


Ao clicar no botão [...] do lado direito da caixa de texto, vinculados a propriedade Expressão, uma tela será apresentada:

Image Added

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.

Funcionalidade Funções


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

Informações
iconfalse
Deck of Cards
idI
Card
labelLógico

Image Added

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

Funções Disponíveis:

Âncora
operadorcondicionalif
operadorcondicionalif

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)



Card
labelConversão

Image Added

  • 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)
Card
labelMatemática

Image Added

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

Image Added

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

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

Transforma o texto informado em minusculo.

 Assinaturas Possíveis:

  • String Lower(String Texto)


3Length
ParâmetroTipos possíveis
1Texto
  • String

Retorna o tamanho do texto informado.

Assinaturas Possíveis:

  • Integer Length(String Texto)
4Trim
ParâmetroTipos possíveis
1Texto
  • String

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

Assinaturas Possíveis:

  • String Trim(String Texto)
5TrimEnd
ParâmetroTipos possíveis
1Texto
  • String

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

Assinaturas Possíveis:

  • String TrimEnd(String Texto)
6TrimStart
ParâmetroTipos possíveis
1Texto
  • String

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

Assinaturas Possíveis:

  • String TrimStart(String Texto)


7IndexOf
ParâmetroTipos possíveis
1Texto1
  • String
2Texto2
  • String
3Posição
  • Integer
4Inicio
  • Integer
5Fim
  • 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)
8LastIndexOf
ParâmetroTipos possíveis
1Texto1
  • String
2Texto2
  • String

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

Assinaturas Possíveis:

  • Integer LastIndexOf(String Texto1, String Texto2)
9PadLeft
ParâmetroTipos possíveis
1Texto
  • String
2Tamanho
  • Integer
3Caractere
  • 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)

10PadRight
ParâmetroTipos possíveis
1Texto
  • String
2Tamanho
  • Integer
3Caractere
  • 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)


11Remove
ParâmetroTipos possíveis
1Texto
  • String
2Posição
  • Integer
3Tamanho
  • 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)
12SubString
ParâmetroTipos possíveis
1Texto
  • String
2Posição
  • Integer
3Tamanho
  • 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)
13Replace
ParâmetroTipos possíveis
1Texto
  • String
2Procurar
  • String
3NovoValor
  • 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)
14ReplaceAll
ParâmetroTipos possíveis
1Texto
  • String
2Procurar
  • String
3NovoValor
  • 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)
15StringBetween
ParâmetroTipos possíveis
1Texto
  • String
2Procurar
  • String
3Inicio
  • Integer
4Final
  • 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)
16Format
ParâmetroTipos possíveis
1Valor
  • Decimal
  • Integer
  • DateTime
  • String
2Má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)
17Split
ParâmetroTipos possíveis
1Valor
  • String
2Separador
  • String
3Delimitador
  • 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)
18Join
ParâmetroTipos possíveis
1Separador
  • String
2Texto1
  • String
3Texto2
  • String

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

Assinaturas Possíveis:

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


Card
labelData/Hora

Image Added

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

Funções Disponíveis:

NomeParâmetrosDescrição
1Today

Nenhum

Data do Sistema

Assinaturas Possíveis:

  • DateTime Today()
2Now

Nenhum

Data/Hora do Sistema

Assinaturas Possíveis:

  • DateTime Now()
3Day
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna o dia da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Day(DateTime Data)
4Month
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna o mês da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Month(DateTime Data)


5Year
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna o ano da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Year(DateTime Data)


6Hour
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna a hora da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Hour(DateTime Data)
7Minute
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna os minutos da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Minute(DateTime Data)
8Second
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna os segundos da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Second(DateTime Data)
9Millisecond
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna os milissegundos da Data/Hora informada.

Assinaturas Possíveis:

  • Integer Millisecond(DateTime Data)
10DayOfWeek
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna o dia da semana da Data/Hora informada.

Assinaturas Possíveis:

  • Integer DayOfWeek(DateTime Data)
11DayOfYear
ParâmetroTipos possíveis
1Data
  • DateTime

Retorna o dia do ano da Data/Hora informada.

Assinaturas Possíveis:

  • Integer DayOfYear(DateTime Data)
12DaysBetween
ParâmetroTipos possíveis
1DataInicial
  • DateTime
2DataFinal
  • DateTime

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

Assinaturas Possíveis:

  • Integer DaysBetween(DateTime DataInicial, DateTime DataFinal)
13MonthsBetween
ParâmetroTipos possíveis
1DataInicial
  • DateTime
2DataFinal
  • DateTime

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

Assinaturas Possíveis:

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

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

Assinaturas Possíveis:

  • DateTime AddDays(DateTime Data, Decimal Valor)
15AddMonths
ParâmetroTipos possíveis
1Data
  • DateTime
2Valor
  • Integer

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

Assinaturas Possíveis:

  • DateTime AddMonths(DateTime Data, Integer Valor)
16AddYears
ParâmetroTipos possíveis
1Data
  • DateTime
2Valor
  • Integer

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

Assinaturas Possíveis:

  • DateTime AddYears(DateTime Data, Integer Valor)
17AddHours
ParâmetroTipos possíveis
1Data
  • DateTime
2Valor
  • Decimal

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

Assinaturas Possíveis:

  • DateTime AddHours(DateTime Data, Decimal Valor)
18AddMinutes
ParâmetroTipos possíveis
1Data
  • DateTime
2Valor
  • Decimal

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

Assinaturas Possíveis:

  • DateTime AddMinutes(DateTime Data, Decimal Valor)
19AddSeconds
ParâmetroTipos possíveis
1Data
  • DateTime
2Valor
  • Decimal

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

Assinaturas Possíveis:

  • DateTime AddSeconds(DateTime Data, Decimal Valor)
20AddMilliseconds
ParâmetroTipos possíveis
1Data
  • DateTime
2Valor
  • Decimal

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

Assinaturas Possíveis:

  • DateTime AddMilliseconds(DateTime Data, Decimal Valor)


Card
labelFinanceira

Image Added

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

NomeParâmetrosDescrição
1FV
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Períodos
  • Decimal
3Pagamento
  • Decimal
4ValorPresente
  • Decimal
5ModoDePagamento
  • 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)
2IPmt
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Período
  • Decimal
3Períodos
  • Decimal
4ValorPresente
  • Decimal
5ValorFuturo
  • Decimal
6ModoDePagamento
  • 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)
3NPer
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Pagamento
  • Decimal
3ValorPresente
  • Decimal
4ValorFuturo
  • Decimal
5ModoDePagamento
  • 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)
4Pmt
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Periodos
  • Decimal
3ValorPresente
  • Decimal
4ValorFuturo
  • Decimal
5ModoDePagamento
  • 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)
5PPmt
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Periodo
  • Decimal
3Periodos
  • Decimal
4ValorPresente
  • Decimal
5ValorFuturo
  • Decimal
6ModoDePagamento
  • 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)
6PV
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Periodos
  • Decimal
3Pagamento
  • Decimal
4ValorFuturo
  • Decimal
5ModoDePagamento
  • 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)
7Rate
ParâmetroTipos possíveis
1Periodos
  • Decimal
2Pagamento
  • Decimal
3ValorPresente
  • Decimal
4ValorFuturo
  • Decimal
5ModoDePagamento
  • 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)
8ConvertRate
ParâmetroTipos possíveis
1Taxa
  • Decimal
2Origem
  • Integer
3Destino
  • 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)
9IRR
ParâmetroTipos possíveis
1Tabela
  • Object
2Periodo
  • String
3Valor
  • String
4TaxaValorFuturo
  • 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)

10MIRR
ParâmetroTipos possíveis
1Tabela
  • Object
2Período
  • String
3Valor
  • String
4TaxaDesconto
  • Decimal
5TaxaInvestimento
  • 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)
11NPV
ParâmetroTipos possíveis
1Tabela
  • Object
2Periodo
  • String
3Valor
  • String
4TaxaDesconto
  • Decimal

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

Assinaturas Possíveis:

  • Decimal NPV(Object Tabela, String Periodo, String Valor, Decimal
    TaxaDesconto)
12Payback
ParâmetroTipos possíveis
1Tabela
  • Object
2Periodo
  • String
3Valor
  • String
4TaxaDesconto
  • 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)
Card
labelLigação de dados
  • 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:

NomeParâmetrosDescrição
1Sum
ParâmetroTipos possíveis
1Lista
  • Object
2Campo
  • String

Soma os valores de uma lista.

Assinaturas Possíveis:

  • Decimal Sum(Object Lista, String Campo)
2Min
ParâmetroTipos possíveis
1Lista
  • Object
2Campo
  • String

Retorna o menor valor de um campo da lista.

Assinaturas Possíveis:

  • Decimal Min(Object Lista, String Campo)
3Max
ParâmetroTipos possíveis
1Lista
  • Object
2Campo
  • String

Retorna o maior valor de um campo da lista.

Assinaturas Possíveis:

  • Decimal Max(Object Lista, String Campo)
4Select
ParâmetroTipos possíveis
1Lista
  • Object
2Filtro
  • String
3Campos
  • String
4Valores
  • 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)
5Lookup
ParâmetroTipos possíveis
1Lista
  • Object
2ColunaResultado
  • String
3ColunaValor
  • String
4Valor
  • Object
5Linha
  • 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)
6isEmpty
ParâmetroTipos possíveis
1Lista
  • Object

Retorna se a lista está vazia.

Assinaturas Possíveis:

  • Boolean isEmpty(Object Lista)


Dica

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

Image Added



Funcionalidade Parâmetros

Os parâmetros disponíveis são:

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)


Image Added
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
Image Added

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.

Image Added


Informações
titleOBSERVACAO

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:

Image Added


PASSO 3 - Preencha as propriedades da Expressão:

Image Added


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

Image Added


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

Image Added


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

Image Added

Informações
titleOBSERVACAO

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

Image Added

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 milharImage Added

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

Image Added

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

Image Added

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

Image Added

Image Added

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.

Aviso
titleDecimais e Milhares

É importante frisar que a ferramenta de exportação para XLSX/XLS determina que a vírgula/comma 

...

Observações:

( , ) 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):

Image Added


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

Image Added

Resultado:

Image Added


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:

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.

...





Informações
iconfalse
Informações
iconfalse

Produto: Framework

Informações
iconfalse

Versão: 12.01.XX

Informações
iconfalse

Processo: Expressão (Geral)

Informações
iconfalse
Informações
iconfalse

Status: Finalizado

Informações
iconfalse

Data: 10/10/2017

Informações
iconfalse

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

...