Tempo aproximado para leitura: 00:03:00 min
Ocorrência
Como incluir expressão no RM Reports?
Ambiente
Cross Segmentos - TOTVS Backoffice (Linha RM) - RM BI - Todas as versões
Solução
Expressão é um Controle Padrão que permite de maneira eficiente a manipulação de dados.
Para incluir a expressão, realize os seguintes passos:
1. Acesse o módulo desejado e após Gestão | Ferramentas de Análise | RM Reports. Indique um filtro para abrir a visão, em nosso exemplo utilizamos o filtro TODOS, identifique o relatório desejado e dê duplo clique;
2. Após aberto o relatório, é necessário identificar quais dados estão sendo utilizados para a montagem da expressão. Em nosso exemplo, consta vinculado no Detalhe 1 a consulta SQL PFUNC;
2.1. Para identificação da consulta SQL, é necessário acessar Início | Dados | Editar Setença;
3. No lado esquerdo da tela em Controles Padrões identifique o controle Expressão. Selecione o controle e segurando-o, arraste para o corpo do relatório;
4. Após isto, é necessário escolher uma expressão e um formato que encaixe no padrão da expressão escolhida. Para isto, clique na Expressão, após clique na seta, abrirá a Expressão Tarefas.
-
Expressão Tarefas | Expressão: Para configuração da Expressão, é necessário clicar nos três pontinhos, onde abrirá a tela Editor de Expressão, para selecionar a Função e Parâmetros;
Em nosso exemplo, utilizaremos a expressão AddDays(): A expressão AddDays inclui o número especificado de dias no valor do operando Data. Se o número de dias for um número negativo, o número especificado de dias será subtraído do valor de Data.
Ao abrir o Editor de expressão, clique em Funções | Data/Hora | AddDays;
Logo após, é necessário passar parâmetro à expressão selecionada. No exemplo foi utilizado o parâmetro da consulta SQL PFUNC, sendo o campo da base DATA ADMISSAO. Para selecionar o parâmetro final, não é necessário clicar em cada opção, somente passar o mouse sobre elas e quando chegar no parâmetro, selecioná-lo;
Adicionado o parâmetro, acrescente uma virgula e a quantidade de dias, para que a expressão calcule a partir da Data de Admissão. Em nosso exemplo utilizamos ,5 para que a expressão calcule a data de admissão somando 5 dias, se o funcionário foi contratado no dia 15/02/2025, ao gerar o relatório deverá gerar como 20/02/2025. Em seguida clique em OK;
A expressão ficará salva na Expressão Tarefas;
-
Expressão Tarefas | Formato: Para configuração do Formato, é necessário clicar nos três pontinhos, onde abrirá a tela Editor de Formatar Caracter para selecionar a Categoria os Tipos Padrões ou o Personalizado;
Em nosso exemplos iremos utilizar a Categoria DataHora e o Tipos Padrão dd/MM/yyyy. Após seleção, clique em OK;
5. Após adicionar a expressão e o formato, basta salvar o relatório e gerar o mesmo;
5.1. Observe que a data gerada pela expressão, foi exatamente conforme configurado nos passos acima.
Consulta SQL executada sem a Expressão
Relatório gerado com a parametrização da Expressão (data da admissão + 5 dias)
Principais Expressões
Observe abaixo as funções das principais expressões disponíveis.
-
AddMonths(): A expressão AddMonths inclui o número especificado de meses. Se o número de meses for um número negativo, o número especificado de meses será subtraído.
Exemplo: AddMonths(31/10/2014,7) Retorna 31/05/2015;
-
AddYears(): A expressão AddYears inclui o número especificado de anos. Se o número de anos for um número negativo, o número especificado de anos será subtraído.
Exemplo: AddYears(31/10/2014,4) Retorna 31/10/2018;
-
Trim(): A expressão Trim() remove os espaços em branco à esquerda e direita.
Exemplo: Trim(' TOTVS ') Retorna TOTVS;
-
Upper(): A expressão Upper() transforma o texto informado para maiúsculo.
Exemplo: Upper('totvs') Retorna TOTVS
-
Lower(): A expressão Lower() transforma o texto informado para minúsculo.
Exemplo: Lower('TOTVS') Retorna totvs
-
Sqr(): A expressão Sqr() retorna o número informado elevado ao quadrado.
Exemplo: Sqr(3) Retorna 9
-
Sqrt(): A expressão Sqrt() retorna a raiz quadrada do número informado.
Exemplo: Sqrt(3) Retorna 1,7320508075688
-
Replace(): A expressão Replace() substitui as ocorrências de um texto por outro, dentro do texto informado.
Exemplo: Replace('amar','am','trabalh') Retorna trabalhAR
-
Now(): A expressão Now() retorna data e hora do sistema.
Exemplo: Now Retorna 04/07/2014 09:32
-
DayOfWeek(): A expressão DayOfWeek() retorna o dia da semana de uma data.
Exemplo: DayOfWeek(04/07/2014) Retorna Sexta-Feira
-
Length(): A expressão Lenght() retorna tamanho do texto informado.
Exemplo: Length('totvs') Retorna 5
-
Abs(): A expressão Abs() retorna o valor absoluto do valor informado.
Exemplo: Abs(-19) Retorna 19
-
AddHours(): A expressão AddHours() retorna o valor de uma hora somada a um número de horas informado.
Exemplo: AddHours(12:00,2) Retorna 14:00
-
AddMiliSeconds(): A expressão AddMiliSeconds() retorna o valor de um milissegundo somado a um número de milissegundos informado.
Exemplo: AddMilliseconds(12:00:00:10,2) Retorna 12:00:00:12
-
AddMinutes(): A expressão AddMinutes() retorna o valor de um minuto somado a um número de minutos informado.
Exemplo: AddMinutes(18:00,51) Retorna 18:51
-
AddSeconds(): A expressão AddSeconds() retorna o valor de um segundo somado a um número de segundos informado.
Exemplo: AddSeconds(09:00:00,25) Retorna 09:00:25
-
Cos(): A expressão Cos() retorna o cosseno de um ângulo em radianos.
Exemplo: Cos(0.5) Retorna 0,877582561890373
-
Power(): A expressão Power() retorna o número especificado elevado à potência especificada.
Exemplo: Power(10,2) Retorna 100
-
Remove(): A expressão Remove() remove o número especificado de caracteres desta instância, a partir da posição especificada.
Exemplo: Remove('TOTVS',0,2) Retorna TVS
Importante
Sempre que for necessário gerar mais de uma informação para a expressão, conforme exemplo em que são geradas as datas de admissão de cinco chapas, é necessário que a expressão esteja vinculada a um detalhe. Informações no cabeçalho ou rodapé, só serão geradas uma por página.
Saiba mais
Para mais informações acesse:
- Expressão Reports:
- Utilizar o componente Expressão em um Texto Rico.
0 Comentários