v.5.60 - Regra de formulário

A guia de “Regras de formulário” é utilizada para administrar e padronizar as regras de comportamento que o formulário irá executar nos processos utilizados na Plataforma Lecom.. Essas regras de formulário são eventos criados para auxiliar no tratamento dos dados de uma atividade de processo.

Para acessar a guia Regra de formulário você deverá estar no ambiente de edição de processo no Studio e seguir os passos abaixo:

1. Selecione o processo que deseja editar para administrar a Regra de formulário:

Open

2. Após selecionar o processo, clique em Editar:

Open

3. Após o carregamento da nova tela, clique então em Regras de Formulário.

4. Ao posicionar o cursor sobre a guia Regra de formulário será exibido a seguinte mensagem “Crie e configure as regras de formulário necessárias para o funcionamento de cada atividade do seu processo.”

5. Você terá acesso ao painel das Regras de Formulário, na modalidade Consultas:

Nesse painel estão listadas todas as regras indexadas ao modelo/processo que está sendo editado.

6. Além disso, nesse momento, você pode visualizar as seguintes funcionalidades:

• Barra de pesquisa

• Filtros

• Painel de resultados obtidos

• Modo de visualização: visualização em tabela ou visualização em card

• Quantidade de regras exibidas: de 1 até 4 regras

• Nova Regra

Veja na imagem abaixo a disposição dessas funcionalidades:

CADASTRO DE NOVA REGRA

Nessa tela é possível cadastrar uma nova regra. Lembre-se que as regras cadastradas poderão ser utilizadas em múltiplas atividades.

1. Para cadastrar uma nova regra, clique no botão “+ Nova Regra”, localizado na área de “Regras de Formulário” a direita da tela.

2. Será aberto um formulário para cadastrar as regras, conforme imagem abaixo:

3. No campo “Título” você deverá informar o nome da nova regra; no campo “Descrição” você deverá descrever qual a função dessa nova regra.

4. Ao clicar na caixa “Vincular atividades”, aparecerá as seguintes opções: “Todas as atividades” e as atividades incluídas no processo. Nesse momento, você já pode vincular a nova regra diretamente a uma ou mais atividades existentes, podendo, inclusive, vincular a “Todas as atividades”.

5. A partir disso, são feitas as determinações condicionais, para que as regras de formulário exerçam ações nos processos/atividades. Em “Quando acontecer os eventos” você deverá selecionar o evento que disparará a regra de formulário, clicando na seta:

6. Ao clicar na seta será aberta uma relação, na qual você poderá escolher entre botão ou campo. As opções de campo são:

• A API JS uma regra alterar o valor do campo

• Clicar em gráfico

• O campo perde o foco

• O campo recebe o foco

• O campo é clicado

Observe a imagem abaixo:

7. Após selecionar o evento, será aberto uma caixa ao lado, para você selecionar o elemento. Para cada evento, há uma relação de elementos específicos. Observe o exemplo abaixo:

8. É possível acrescentar quantos eventos forem necessários, ativar ou desativar cada um deles, ordená-los (para mover basta posicionar o cursor no ícone com três tracinhos e arrastar para a posição desejada) e também excluir, de acordo com a necessidade do processo/atividades.

9. Em “E as condições forem atendidas” deve ser preenchido com as condicionais para que uma ação ocorra, ou não. Para isso, clique em “+ Adicionar bloco”.

10. Nesse momento, é possível criar blocos condicionais. Você deverá selecionar o elemento e o operador. Para cada elemento, aparecerá uma relação específica de operador. Observe o exemplo abaixo:

11. Caso você adicione mais blocos, esses podem ser unidos por “e” ou “ou”, facilitando o desenvolvimento das condicionais.

12. Além disso, o bloco pode ser “negativo”, para isso clique no botão de exclamação “!” no canto esquerdo do bloco. Você também poderá Excluir uma condição, Adicionar condição interna e Mover a condição para ordená-la. Observe a imagem abaixo:

13. O item “Execute as ações” é o lugar onde você apontará as ações a serem executadas nos formulários, após as condicionais serem verificadas. Clique na seta para exibir a lista de ações:

14. As ações podem ser por:

• Agrupador

• Botão

• Campo

• Formulário

• Grid

15. Ao escolher a ação, uma nova caixa poderá se abrir e você poderá selecionar o elemento. Para cada ação, que necessite de um elemento, aparecerá uma relação específica. Caso seja necessário, uma terceira caixa poderá ser aberta. Nesse caso, insira a informação solicitada. Observe o exemplo abaixo:

16. As ações também podem ser adicionadas, excluídas, ordenadas, ativadas ou desativadas, de acordo com a necessidade do processo/atividade.

17. No item “Senão, execute as ações” você também apontará as ações a serem executadas nos formulários, após as condicionais serem verificadas. Basta clicar na opção “Adicionar +” para selecionar a ação desejada.

18. Em seguida será aberta uma caixa para que você possa selecionar a ação desejada.

19. Dependendo da ação desejada, poderá ser aberta mais duas caixas, uma para selecionar o elemento e ainda outra para informar o valor.

20. Senão, execute as ações também podem ser adicionadas, excluídas, ordenadas, ativadas ou desativadas, de acordo com a necessidade do processo/atividade.

21. Por fim, para salvar as alterações, basta clicar no botão “Salvar” no final do formulário. Observe também que há um botão para ativar ou inativar  regra de formulário.

22. Após Salvar a Regra de formulário, você poderá visualizar as particularidades cadastradas para cada regra de formulário: “Título”, “Descrição”, “Atividades”, “Detalhes” e se a regra está “Ativa” ou “Inativa”.

23. O Título e a Descrição nomeiam e descrevem brevemente a regra, as Atividades apresentam os vínculos aos quais a regra se aplica. Já em “Detalhes” é possível verificar maiores informações sobre a regra de formulário, como as ações executadas através das condições solicitadas ao ocorrerem eventos. Como “quando acontecer os eventos”, “e as condições forem atendidas”, “execute as ações” e “senão, execute as ações”. Basta clicar nas setas:

24. Também é possível Editar, Duplicar, Sinalizar e Excluir cada regra. Basta clicar nos três pontos localizados no canto superior direito da regra para essas opções ficarem disponíveis.

25. Para realizar alterações, clique no botão Editar. Você poderá realizar alterações em todos os campos da regra de tela.

26. Neste momento você também pode localizar o botão “Duplicar”, para gerar uma nova regra idêntica a essa.

27. O botão “Sinalizar”, permite uma identificação visual que auxilia na filtragem de regras específicas. Ao selecionar essa opção a regra de formulário ficará com ícone de bandeira amarela.

28. E, por fim, o botão “Excluir”, que deleta a regra de formulário selecionada.

Aqui também é possível realizar Ações em lote com as regras de formulário. Abaixo, demonstraremos como fazê-las.

29. Basta indicar na guia de seleção no canto superior esquerdo de cada regra, ou procurar condições específicas ao lado da barra de pesquisa. As condições preexistentes são “Todos”, “Nenhum”, “Sinalizados”, “Ativos” e “Inativos”.

30. Após selecionadas, é possível abrir ou fechar os detalhes dessas regras; ativar ou desativar; sinalizar ou desmarcar sinalização e, por fim, excluir as regras.

Os mecanismos de busca também estão presentes nesta tela.

31. Na barra de pesquisa você encontrar uma caixa de texto para buscar as suas regras de formulário. Importante: As buscas acontecem pelo “Título” e pela “Descrição” da regra.

32. Ao lado da barra de pesquisa é possível filtrar para refinar a busca através das Atividades, das Tags, dos Eventos, dos Elementos, dos Vínculos e das Ações, além de afinar a pesquisa com a busca das regras que estão Ativas ou Inativas, Sinalizadas ou não.

33. Outro atributo importante é a possibilidade de Gerenciar regras por atividade, que pode ser acessado clicando no link com mesmo nome.

34. Nesse momento, é possível alterar a ordem das regras de formulário, encadeando-as conforme a necessidade do processo/atividade, individualmente. Para ordená-las é muito simples: basta clicar e arrastar o item pelos traços à esquerda da regra.

35. Aqui você tem à disposição um botão para Ativar e Desativar a regra, além de poder Editar, Duplicar ou Excluir cada regra, pensando na funcionalidade do processo/atividade, a partir do item Ações.

36. É possível também deixar a tela cheia, basta clicar no ícone demonstrado abaixo: