1

Fórmula Visual RM

2

Atividade “Para cada Iteração”

Fórmula Visual RM

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

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 = :MESCOMPAND CAST(NROPERIODO AS INTEGER) = :PERIODO AND VALORESFORCADOS = 1

5

Prática 04 – Criando coluna em uma visão

Fórmula Visual RM

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

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

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

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

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

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

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

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

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

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

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

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

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.

Passo Final)

18

Prática 04 – Criando coluna em uma visão

Fórmula Visual RM

19

Prática 04 – Observações

Fórmula Visual RM

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.