Frmula Visual RM 1 Frmula Visual RM Atividade

Fórmula Visual RM 1

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. 2

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). 3

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 4

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. 5

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 Data. Set de leitura da visão (o evento associado será o “após ler visão”. 6

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. 7

Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 5) Acrescentar uma atividade “sequência” dentro de rms. For. Each. Activity 1. 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. 8

Fórmula Visual RM Prática 04 – Criando coluna em uma visão Passo 6) Acrescentar uma atividade “Consulta SQL” dentro de rms. For. Each. Activity 1. 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). 9

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”. 10

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 rms. For. Each. Activity. É 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 “F 2”. 11

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 (RMSFop. Params. Proc). Esses parâmetros serão sempre os mesmos para todos os funcionários dentro da execução da fórmula visual. 12

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: 13

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. 14

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_da. Coluna 15

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 “rms. For. Each. Activity 1” 16

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. 17

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

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. 19