Tempo aproximado para leitura: 00:03:00 min

Ocorrência

Expressão no RM Reports

Ambiente
Cross Segmentos - TOTVS Backoffice (Linha RM) - RM BI - Todas as versões

Solução

Expressão é um objeto que permite de maneira eficiente a manipulação de dados.

Trabalhando com expressões

1°) Para inserir uma expressão ao relatório, acesse a guia/menus Gestão | Ferramentas de Análise | RM Reports.

2°) Carregada a visão, selecione o relatório que irá conter expressões.

3°) Selecionado o relatório, é necessário editar sua estrutura. Para realizar a edição de estrutura do relatório, clique em Processos, em seguida, Editar Estrutura. Depois de carregada a visão, clique na funcionalidade Expressão localizada no canto esquerdo e adicione ao relatório.

4°) Adicionado ao relatório, clique em Expressão Tarefas.

5°) Devemos escolher uma expressão e um formato que encaixe no padrão da expressão escolhida.

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.

Para deixar mais claro a objetividade desta expressão, clique no menu Dados | Adicionar Fonte de Dados, em seguida pesquise pela tabela PFUNC, no campo Pesquisar na coluna Tabela da Base.

Adicione a tabela Funcionários. Clique em Totvs Folha de Pagamento | Funcionários em seguida, Adicionar | OK.

Adicionado a tabela iremos utilizá-la na expressão. Clique novamente em Expressão Tarefas | Expressão.

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. Clique em Parâmetros | Base  | PFUNC  | DATAADMISSAO . 

Adicionado, acrescente após a virgula uma quantidade de dias, para que a expressão calcule a partir da Data de Admissão. Em seguida clique em OK.

Após clicado, observe que foi acrescentado ao relatório a expressão conforme foi configurada.

Adicionada ao relatório, adicione um formato para a expressão. Clique novamente em Expressão Tarefas | Formato |.

Ao abrir o Editor de Formatar Caracter, clique em Categoria | DataHora | Tipos Padrão | Escolha o formato desejado e clique em OK. 

Após adicionar um formato à expressão, basta salvar o relatório e gerar o mesmo. Observe que a data gerada pela expressão, foi exatamente conforme configurado nos passos acima.

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

Saiba mais

O passo-a-passo com os prints do exemplo acima encontra-se no link Expressão Reports