Í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.
![](/download/attachments/270909667/image2017-1-6%2010%3A33%3A2.png?version=1&modificationDate=1483709660000&api=v2)
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) |
Propriedade Expressão
Ao clicar no botão [...] do lado direito da caixa de texto, vinculados a propriedade Expressão, uma tela será apresentada:
![](/download/attachments/270909667/image2017-1-6%2011%3A2%3A13.png?version=1&modificationDate=1483711410000&api=v2)
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. |
Funcionalidade Funções
As funções disponíveis são:
N° | Nome | Descrição | Imagem |
1 Informações |
---|
|
Deck of Cards |
---|
| Card |
---|
| Image Added
- Comandos lógicos;
- Apresentação de resultado conforme condições.
Funções Disponíveis: Âncora |
---|
| operadorcondicionalif |
---|
| operadorcondicionalif |
---|
|
N° | Nome | Parâmetros | Descrição |
---|
1 | If | N° | Parâmetro | Tipos possíveis |
---|
1 | Teste | | 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)
|
|
|
|
Image Removed2 | 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: 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)
|
|
|
|
Image Removed3 | Image Added
- 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 | |
| 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 | |
| Retorna o valor informado arredondado. Assinaturas Possíveis: - Integer Round(Decimal Valor)
| 3 | ArcTan | N° | Parâmetro | Tipos possíveis |
---|
1 | Tangente | |
| 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 | |
| Retorna o cosseno do ângulo informado. Assinaturas Possíveis: - Decimal Cos(Decimal Ângulo)
| 5 | Exp | N° | Parâmetro | Tipos possíveis |
---|
1 | Potência | |
| 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 | |
| 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 | |
| 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 | |
| Retorna o logaritmo do número informado. Assinaturas Possíveis: - Decimal Log(Decimal Valor)
| 9 | Sin | N° | Parâmetro | Tipos possíveis |
---|
1 | Ângulo | |
| Retorna o seno do ângulo informado. Assinaturas Possíveis: - Decimal Sin(Decimal Ângulo)
| 10 | Sqr | N° | Parâmetro | Tipos possíveis |
---|
1 | Valor | |
| 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 | |
| Retorna a raiz quadrada do numero informado Assinaturas Possíveis: - Decimal Sqrt(Decimal Valor)
| 12 | Abs | N° | Parâmetro | Tipos possíveis |
---|
1 | Valor | |
| 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 | | 2 | Potência | |
| 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 | |
| Retorna um valor aleatório. Assinaturas Possíveis: - Decimal Random()
- Decimal Random(Integer Máximo)
|
|
|
|
Image Removed4 | 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: N° | Nome | Parâmetros | Descrição |
---|
1 | Upper | N° | Parâmetro | Tipos possíveis |
---|
1 | Texto | |
| Transforma o texto informado em maiúsculo. Assinaturas Possíveis: - String Upper(String Texto)
| 2 | Lower | N° | Parâmetro | Tipos possíveis |
---|
1 | Texto | |
| Transforma o texto informado em minusculo. Assinaturas Possíveis: - String Lower(String Texto)
| 3 | Length | N° | Parâmetro | Tipos possíveis |
---|
1 | Texto | |
| Retorna o tamanho do texto informado. Assinaturas Possíveis: - Integer Length(String Texto)
| 4 | Trim | N° | Parâmetro | Tipos possíveis |
---|
1 | Texto | |
| 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 | |
| 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 | |
| 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 | | 2 | Texto2 | | 3 | Posição | | 4 | Inicio | | 5 | Fim | |
| 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 | | 2 | Texto2 | |
| 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 | | 2 | Tamanho | | 3 | Caractere | |
| 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 | | 2 | Tamanho | | 3 | Caractere | |
| 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 | | 2 | Posição | | 3 | Tamanho | |
| 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 | | 2 | Posição | | 3 | Tamanho | |
| 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 | | 2 | Procurar | | 3 | NovoValor | |
| 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 | | 2 | Procurar | | 3 | NovoValor | |
| 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 | | 2 | Procurar | | 3 | Inicio | | 4 | Final | |
| 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 | |
| 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 | | 2 | Separador | | 3 | Delimitador | | 4 | Índice | |
| 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 | | 2 | Texto1 | | 3 | Texto2 | |
| Faz a união de dois valores usando o separador informado. Assinaturas Possíveis: - String Join(String Separador, String Texto1, String Texto2)
|
|
|
|
Image Removed5 | Image Added
- 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: | 2 | Now | Nenhum | Data/Hora do Sistema Assinaturas Possíveis: | 3 | Day | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| Retorna o dia da Data/Hora informada. Assinaturas Possíveis: - Integer Day(DateTime Data)
| 4 | Month | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| 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 | |
| Retorna o ano da Data/Hora informada. Assinaturas Possíveis: - Integer Year(DateTime Data)
| 6 | Hour | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| Retorna a hora da Data/Hora informada. Assinaturas Possíveis: - Integer Hour(DateTime Data)
| 7 | Minute | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| Retorna os minutos da Data/Hora informada. Assinaturas Possíveis: - Integer Minute(DateTime Data)
| 8 | Second | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| Retorna os segundos da Data/Hora informada. Assinaturas Possíveis: - Integer Second(DateTime Data)
| 9 | Millisecond | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| Retorna os milissegundos da Data/Hora informada. Assinaturas Possíveis: - Integer Millisecond(DateTime Data)
| 10 | DayOfWeek | Nº | Parâmetro | Tipos possíveis |
---|
1 | Data | |
| 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 | |
| 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 | | 2 | DataFinal | |
| 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 | | 2 | DataFinal | |
| 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 | | 2 | Valor | |
| 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 | | 2 | Valor | |
| 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 | | 2 | Valor | |
| 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 | | 2 | Valor | |
| 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 | | 2 | Valor | |
| 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 | | 2 | Valor | |
| 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 | | 2 | Valor | |
| Adiciona o número de milisegundos especificados na data informada. Assinaturas Possíveis: - DateTime AddMilliseconds(DateTime Data, Decimal Valor)
|
|
|
|
Image Removed6 | 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: N° | Nome | Parâmetros | Descrição |
---|
1 | FV | Nº | Parâmetro | Tipos possíveis |
---|
1 | Taxa | | 2 | Períodos | | 3 | Pagamento | | 4 | ValorPresente | | 5 | ModoDePagamento | |
| 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 | | 2 | Período | | 3 | Períodos | | 4 | ValorPresente | | 5 | ValorFuturo | | 6 | ModoDePagamento | |
| 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 | | 2 | Pagamento | | 3 | ValorPresente | | 4 | ValorFuturo | | 5 | ModoDePagamento | |
| 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 | | 2 | Periodos | | 3 | ValorPresente | | 4 | ValorFuturo | | 5 | ModoDePagamento | |
| 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 | | 2 | Periodo | | 3 | Periodos | | 4 | ValorPresente | | 5 | ValorFuturo | | 6 | ModoDePagamento | |
| 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 | | 2 | Periodos | | 3 | Pagamento | | 4 | ValorFuturo | | 5 | ModoDePagamento | |
| 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 | | 2 | Pagamento | | 3 | ValorPresente | | 4 | ValorFuturo | | 5 | ModoDePagamento | |
| 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 | | 2 | Origem | | 3 | Destino | |
| 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 | | 2 | Periodo | | 3 | Valor | | 4 | TaxaValorFuturo | |
| 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 | | 2 | Período | | 3 | Valor | | 4 | TaxaDesconto | | 5 | TaxaInvestimento | |
| 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 | | 2 | Periodo | | 3 | Valor | | 4 | TaxaDesconto | |
| 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 | | 2 | Periodo | | 3 | Valor | | 4 | TaxaDesconto | |
| 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)
|
|
|
|
Image Removed7Estatística | - 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 |
|
|
|
CountSum | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | |
|
|
|
|
Conta o número de itens de um | Soma os valores de uma lista. Assinaturas Possíveis: |
|
|
|
Count)SumMin | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | | 2 | Campo | |
|
|
|
|
Soma os valores de uma Retorna o menor valor de um campo da lista. Assinaturas Possíveis: |
|
|
|
Sum- Min(Object Lista, String Campo)
| 3 |
|
|
|
AvgMax | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | | 2 | Campo | |
|
|
|
|
Faz uma média dos valores de uma Retorna o maior valor de um campo da lista. Assinaturas Possíveis: |
|
|
|
Avg- Max(Object Lista, String Campo)
| 4 |
|
|
|
MinSelect | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | | 2 |
|
|
|
|
Campo o menor valor de um campo da um subconjunto filtrado dos dados de uma lista. Assinaturas Possíveis: |
|
|
|
Decimal Min- Object Select(Object Lista, String
|
|
|
|
Campo)5 | Max | - Filtro)
- Object Select(Object Lista, String Campos, String Valores)
| 5 | Lookup | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | | 2 |
|
|
|
|
| ColunaResultado | | 3 | ColunaValor |
|
|
|
|
Campo maior um campo uma coluna da lista baseado no valor de outra. Assinaturas Possíveis: |
|
|
|
- Object Lookup(Object Lista, String ColunaResultado, String ColunaValor, Object Valor)
- Object Lookup
|
|
|
|
Decimal Max Campo- ColunaResultado, Integer Linha)
| 6 |
|
|
|
SelectisEmpty | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | |
|
|
|
|
2 | Filtro | |
3 | Campos | |
4 | Valores | |
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)
| 7 | Lookup | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | | 2 | ColunaResultado | | 3 | ColunaValor | | 4 | Valor | | 5 | Linha | |
| 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)
|
8 | isEmpty | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | |
| Retorna se a lista está vazia. Assinaturas Possíveis: - Boolean isEmpty(Object Lista)
|
Funcionalidade Parâmetros
Os parâmetros disponíveis são:
N° | Nome | Descrição | Imagem |
---|
1 | Base | 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)
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:
N° | Nome | Descrição | Imagem |
---|
1 | Base | 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 |
2 | Relató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 |
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 |
---|
|
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 |
---|
|
Caso queira configurar mais propriedades do componente Expressão aperte F4 para que o menu Grade de Propriedades seja apresentado. Image Added
|
É 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
Image 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
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 |
---|
|
É 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): 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
Image Removed | 2 | Relató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 Removed |
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 Removed
Informações |
---|
|
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 Removed
PASSO 3 - Preencha as propriedades da Expressão:
Image Removed
PASSO 3 - A) Escreve a expressão utilizando toda a funcionalidade explicada acima. (OBRIGATORIO)
Image Removed
PASSO 3 - B) Escolha a formatação para o resultado da expressão. (FACULTATIVO)
Image Removed
PASSO 3 - C) Escolha se quer que o resultado seja arredondado ou não. (FACULTATIVO)
Image Removed Informações |
---|
|
Caso queira configurar mais propriedades do componente Expressão aperte F4 para que o menu Grade de Propriedades seja apresentado.
Image RemovedExceçõ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° | Nome | Descrição | Solução |
---|
1 | Operador Multiplicação | O 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))
|
2 | Operador Divisão | O operador Div é incompatível com o tipo String. |
3 | Operador Soma | O operador Plus é incompatível com o tipo String. |
4 | Operador Subtração | O operador Minus é incompatível com o tipo String. |
... |