| 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)
|
|
Card |
---|
| - 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 | | 2 | Campo | |
| 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 | | 2 | Campo | |
| 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 | | 2 | Campo | |
| 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 | | 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)
| 5 | 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)
| 6 | isEmpty | Nº | Parâmetro | Tipos possíveis |
---|
1 | Lista | |
| 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 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
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
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° | 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. |
... |