Fórmula Visual RM.

Apresentação em tema: "Fórmula Visual RM."— Transcrição da apresentação:

1 Fórmula Visual RM

2 Atividade “Para cada Iteração”
Fórmula Visual RM Atividade “Para cada Iteração” Equivalente à estrutura de repetição foreach do C#, é normalmente utilizado para iteração sobre uma coleção de itens. Sua propriedade principal é a “Fonte de dados”; Pode utilizar uma transação por Iteração.

3 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Prática 04: criar Fórmula Visual que resultará em uma nova coluna no cadastro da visão do cadastro de funcionários. A coluna irá indicar se o funcionário possui valores forçados no envelope para a competência e período atuais (do usuário).

4 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 1) Definir a consulta SQL para retornar se um funcionário possui valores forçados no envelope para a competência / Período atuais: SELECT COUNT(VALORESFORCADOS) VALORESFORCADOS FROM PFPERFF(NOLOCK) WHERE CAST(CODCOLIGADA AS INTEGER) = :CODCOLIGADA AND CHAPA = :CHAPA AND ANOCOMP = :ANOCOMP AND MESCOMP = :MESCOMP AND CAST(NROPERIODO AS INTEGER) = :PERIODO AND VALORESFORCADOS = 1

5 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 2) Para se filtrar os dados da consulta SQL, poderemos utilizar as colunas da visão de funcionários: CODCOLIGADA e CHAPA. Mas as colunas MESCOMP , ANOCOMP e NROPERIODO precisam ser recuperados através da atividade de “Leitura de Parâmetros do RM Labore”. Esta será então a primeira atividade da Fórmula Visual.

6 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 3) A atividade “Para cada Iteração” requer uma coleção de itens para ser utilizada, que é configurada através da propriedade Lista de Items. Ao acrescentar essa nova atividade, já sabemos de antemão que essa lista será o DataSet de leitura da visão (o evento associado será o “após ler visão”.

7 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 4) Para setar a lista, será necessário dar um duplo clique com o mouse na coluna da esquerda (conforme imagem abaixo) e setar a propriedade “Rows” da primeira tabela da visão.

8 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 5) Acrescentar uma atividade “sequência” dentro de rmsForEachActivity1. Seu nome é bem sugestivo. Essa atividade delimita uma sequencia de execução para todas as suas atividades filhas. É necessária quando queremos executar mais de uma atividade em sequência.

9 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 6) Acrescentar uma atividade “Consulta SQL” dentro de rmsForEachActivity1. Muita atenção: esta fórmula visual irá executar uma consulta SQL para cada registro da visão. Se o filtro da visão não for muito restritivo, o tempo de carga da mesma poderá aumentar bastante (performance).

10 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 7) Uma vez acrescentada, será necessário configurar a atividade para que a mesma execute a consulta SQL criada anteriormente. Para tal, basta clicar sobre a mesma com o botão direito selecionando em seguida o menu de contexto “Selecionar Consulta SQL”.

11 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 8) Os parâmetros de funcionário deverão ser apontados para a propriedade Fields da atividade rmsForEachActivity. É essa a atividade que cuida de selecionar os registros um a um em um laço de repetição. Para se preencher a propriedade “Fields” com o nome da coluna desejada, deve ser utilizada a tecla “F2”.

12 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 9) Os demais parâmetros deverão ser preenchidos a partir das propriedades da atividade de parâmetros do RMLabore (RMSFopParamsProc). Esses parâmetros serão sempre os mesmos para todos os funcionários dentro da execução da fórmula visual.

13 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 10) Verifique se os parâmetros foram preenchidos corretamente, conforme a ilustração abaixo:

14 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 11) Agora será necessário recuperar o resultado da consulta SQL e gravá-lo em uma nova coluna da visão. Para isso, iremos utilizar uma única atividade: “Expressão”. Essa é a função básica da atividade de expressão: vincular propriedades de uma atividade à outra atividade ou objeto da formula visual.

15 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 11) A atividade de expressão “enxerga” as demais atividades do diagrama. Portanto, podemos recuperar o resultado da consulta digitando: Nome_da_atividade_de_consulta.Nome_daColuna

16 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 11) Agora, precisamos definir onde o valor da expressão calculada será gravado. Sabemos que será calculado um valor para cada registro. Portanto, podemos declarar uma nova coluna na propriedade Fields da atividade “rmsForEachActivity1”

17 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo Final) Basta então associar a fórmula visual criada ao gatilho que desejamos disparar, selecionando também a tela de cadastro para a qual a fórmula visual foi elaborada. A nova coluna deverá então ser exibida ao se acessar a visão de funcionários.

18 Prática 04 – Criando coluna em uma visão
Fórmula Visual RM Prática 04 – Criando coluna em uma visão

19 Fórmula Visual RM Prática 04 – Observações
Até a versão atual do produto, o recurso de fórmulas visuais está vinculado a cadastros, processos e serviços (assinantes), conforme a ilustração ao lado. Observe que todos os gatilhos disponíveis são disparados à partir de uma dessas funcionalidades. Boa parte das dificuldades de utilização podem surgir sobre quais as propriedades de cada atividade deve ser utilizada em cada gatilho.