Introdução ao Editor de regras para o Formulário adaptável com base nos Componentes principais
Em um Formulário adaptável baseado em Componentes principais, o recurso do editor de regras permite que usuários empresariais e desenvolvedores gravem regras para objetos de Formulário adaptável. Essas regras definem as ações a serem acionadas nos objetos de formulário com base nas condições predefinidas, entradas do usuário e ações do usuário no formulário. Esse recurso ajuda a simplificar ainda mais a experiência de preenchimento de formulário, garantindo precisão e velocidade.
O editor de regras fornece uma interface de usuário intuitiva e simplificada para escrever regras. Ele oferece um editor visual que atende a todos os usuários, permitindo que eles criem e gerenciem regras sem precisar de extenso conhecimento técnico. Essa abordagem visual facilita a compreensão e a implementação da lógica desejada em seus formulários.
Algumas das ações principais que você pode executar em objetos do Formulário adaptável usando regras são:
- Mostrar ou ocultar um objeto
- Habilitar ou desabilitar um objeto
- Definir um valor para um objeto
- Validar o valor de um objeto
- Executar funções para calcular o valor de um objeto
- Chamar um serviço de modelo de dados de formulário (FDM) e executar uma operação
- Definir a propriedade de um objeto
Os usuários adicionados ao grupo forms-power-users
podem criar scripts e editar os existentes. Os usuários do grupo forms-users podem usar os scripts, mas não podem criá-los ou editá-los.
Consulte o artigo Diferença entre o Editor de Regras do Foundation e o Editor de Regras do Componente Principal para obter uma comparação detalhada.
Noções básicas sobre uma regra understanding-a-rule
Uma regra é uma combinação de ações e condições. No editor de regras, as ações incluem atividades como ocultar, mostrar, habilitar, desabilitar ou calcular o valor de um objeto em um formulário. As condições são expressões booleanas que são avaliadas executando verificações e operações no estado, valor ou propriedade de um objeto de formulário. As ações são executadas com base no valor ( True
ou False
) retornado pela avaliação de uma condição.
O editor de regras fornece um conjunto de tipos de regras predefinidos, como Quando, Mostrar, Ocultar, Ativar, Desativar, Definir valor de e Validar, para ajudá-lo a escrever regras. Cada tipo de regra permite definir condições e ações em uma regra. O documento explica detalhadamente cada tipo de regra.
Uma regra normalmente segue uma das seguintes construções:
Condition-Action Nesta construção, uma regra primeiro define uma condição seguida por uma ação a ser acionada. A construção é comparável à instrução if-then em linguagens de programação.
No editor de regras, o tipo de regra When impõe a construção de condição-ação.
Condição-ação Nesta construção, uma regra primeiro define uma ação a ser acionada seguida por condições para avaliação. Outra variação dessa construção é ação-condição-ação alternativa, que também define uma ação alternativa a ser acionada se a condição retornar Falso.
Os tipos de regra Mostrar, Ocultar, Ativar, Desativar, Definir valor de e Validar no editor de regras impõem a construção de regra de condição de ação. Por padrão, a ação alternativa para Mostrar é Ocultar, e para Habilitar é Desabilitar e o oposto. Não é possível alterar a ação alternativa padrão.
Para obter mais informações sobre tipos de regras disponíveis no editor de regras, consulte Tipos de regras disponíveis no editor de regras.
Diretrizes para a escolha de uma construção de regra guidelines-for-choosing-a-rule-construct
Embora seja possível obter a maioria dos casos de uso usando qualquer construção de regra, veja a seguir algumas diretrizes para escolher uma construção em vez de outra. Para obter mais informações sobre as regras disponíveis no editor de regras, consulte Tipos de regras disponíveis no editor de regras.
-
Uma regra prática comum ao criar uma regra é pensar nela no contexto do objeto no qual você está escrevendo uma regra. Considere que deseja ocultar ou mostrar o campo B com base no valor especificado por um usuário no campo A. Nesse caso, você está avaliando uma condição no campo A e, com base no valor retornado, aciona uma ação no campo B.
Portanto, se estiver gravando uma regra no campo B (o objeto no qual você está avaliando uma condição), use a construção de condição-ação ou o tipo de regra When. Da mesma forma, use a construção action-condition ou o tipo de regra Mostrar ou Ocultar no campo A.
-
Às vezes, você deve executar várias ações com base em uma condição. Nesses casos, é recomendável usar a construção condição-ação. Nesta construção, você pode avaliar uma condição uma vez e especificar várias instruções de ação.
Por exemplo, para ocultar os campos B, C e D com base na condição que verifica o valor especificado por um usuário no campo A, grave uma regra com construção de condição-ação ou Quando tipo de regra no campo A e especifique ações para controlar a visibilidade dos campos B, C e D. Caso contrário, você precisará de três regras separadas nos campos B, C e D, em que cada regra verifica a condição e mostra ou oculta o respectivo campo. Neste exemplo, é mais eficiente escrever o tipo de regra Quando em um objeto do que o tipo de regra Mostrar ou Ocultar em três objetos.
-
Para acionar uma ação com base em várias condições, é recomendável usar uma construção action-condition. Por exemplo, para mostrar e ocultar o campo A avaliando as condições nos campos B, C e D, use o tipo de regra Mostrar ou Ocultar no campo A.
-
Use a construção de condição-ação ou condição de ação se a regra contiver uma ação para uma condição.
-
Se uma regra verificar uma condição e executar uma ação imediatamente ao fornecer um valor em um campo ou ao sair de um campo, é recomendável gravar uma regra com uma construção de condição-ação ou o tipo de regra Quando no campo em que a condição é avaliada.
-
A condição na regra Quando é avaliada quando um usuário altera o valor do objeto no qual a regra Quando é aplicada. No entanto, se você quiser que a ação seja acionada quando o valor for alterado no lado do servidor, como para preencher previamente o valor, é recomendável gravar uma regra When que aciona a ação quando o campo é inicializado.
-
Ao escrever regras para objetos de menus suspensos, botões de opção ou caixas de seleção, as opções ou os valores desses objetos de formulário no formulário são preenchidos previamente no editor de regras.
Para entender como usar a interface de usuário para gravar e gerenciar regras em um Editor de regras, consulte o artigo Interface de usuário do Editor de regras para o Forms adaptável com base nos Componentes principais.
Consulte também
- Introdução ao Editor de regras para o Forms adaptável com base nos Componentes principais
- Tipos de operadores e eventos no editor de regras de um Formulário adaptável com base nos Componentes principais
- Interface do usuário do Editor de regras para o Forms adaptável com base nos Componentes principais
- Casos de uso diferentes do Editor de regras para um formulário adaptável baseado em componentes principais
- Diferença em várias edições do editor de regras
- Introdução às funções personalizadas para o Forms adaptável com base nos Componentes principais
- Criar uma função personalizada para um formulário adaptável com base nos Componentes principais
- Exemplos de desenvolvimento e uso de função personalizada