Adicionar regras a um formulário adaptável dos Componentes principais adaptive-forms-rule-editor
Este artigo contém os recursos mais recentes do Editor de regras dos Componentes principais do Forms adaptável:
- Suporte para implementar condições aninhadas com a funcionalidade When-then-else
- Validar ou redefinir painéis e formulários, incluindo campos
- Suporte para recursos modernos do JavaScript, como funções de esquerda e seta (suporte para ES10), em funções personalizadas.
O recurso Editor de regras facilita os usuários e desenvolvedores de negócios de formulários a escrever regras em 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. Isso 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. O editor de regras oferece um editor visual para todos os usuários. Algumas das ações principais que você executa em objetos de 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 os scripts e editar os existentes. Os usuários no forms-users group podem usar os scripts, mas não podem criá-los ou editá-los.
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 a if-then statement nas 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 regras Mostrar, Ocultar, Habilitar, Desabilitar, Definir Valor de e Validar no Editor de Regras impõem a construção da regra action-condition. 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 você deseja ocultar ou mostrar um 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 você estiver gravando uma regra no campo B (o objeto no qual você está avaliando uma condição), use a construção
condition-actionou o tipo de regraWhen. Da mesma forma, use a construçãoaction-conditionou o tipo de regraShow or Hideno 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
condition-action. 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 Mostrar ou Ocultar em três objetos.
-
Para acionar uma ação com base em várias condições, é recomendável usar a construção action-condition. Por exemplo, para mostrar e ocultar o campo A avaliando as condições nos campos B, C e D, use Mostrar ou Ocultar tipo de regra 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 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.
Tipos de operadores e eventos disponíveis no editor de regras available-operator-types-and-events-in-rule-editor
O editor de regras fornece os seguintes operadores lógicos e eventos com os quais você pode criar regras.
- É Igual A
- Não É Igual A
- Começa com
- Termina com
- Contém
- Não contém
- Está Vazio
- Não Está Vazio
- Selecionado: Retorna verdadeiro quando o usuário seleciona uma opção específica para uma caixa de seleção, lista suspensa ou um botão de opção.
- Inicializado (evento): Retorna verdadeiro quando um objeto de formulário é renderizado no navegador.
- Está Alterado (evento): Retorna verdadeiro quando o usuário altera o valor inserido ou a opção selecionada para um objeto de formulário.
Tipos de regras disponíveis no editor de regras available-rule-types-in-rule-editor
O editor de regras fornece um conjunto de tipos de regras predefinidos que você pode usar para escrever regras. Vamos analisar cada tipo de regra detalhadamente. Para obter mais informações sobre como gravar regras no editor de regras, consulte Regras de gravação.
Quando whenruletype
O tipo de regra When segue a construção de regra ação-condição-ação-alternativa, ou, às vezes, apenas a construção ação-condição. Nesse tipo de regra, primeiro especifique uma condição para avaliação seguida por uma ação para acionar se a condição for atendida ( True). Ao usar o tipo de regra When, você pode usar vários operadores AND e OR para criar expressões aninhadas.
Usando o tipo de regra Quando, é possível avaliar uma condição em um objeto de formulário e executar ações em um ou mais objetos.
Em palavras simples, uma regra When típica é estruturada da seguinte maneira:
When on Object A:
(Condition 1 AND Condition 2 OR Condition 3) is TRUE;
Then, do the following:
Action 2 on Object B;ANDAction 3 on Object C;
Else, do the following:
Action 2 on Object C;
_
Quando você tem um componente de vários valores, como botões de opção ou lista, ao criar uma regra para esse componente, as opções são automaticamente recuperadas e disponibilizadas para o criador da regra. Não é necessário digitar os valores da opção novamente.
Por exemplo, uma lista tem quatro opções: Vermelho, Azul, Verde e Amarelo. Ao criar a regra, as opções (botões de opção) são recuperadas automaticamente e disponibilizadas ao criador da regra da seguinte maneira:
Ao escrever uma regra Quando, é possível acionar a ação Limpar valor de. A ação Clear Value Of limpa o valor do objeto especificado. Ter Clear Value of como uma opção na instrução When permite criar condições complexas com vários campos. Você pode adicionar a instrução Else para adicionar outras condições.
Vários campos permitidos em Quando allowed-multiple-fields
Na condição When, você tem a opção de adicionar outros campos além do campo ao qual a regra é aplicada.
Por exemplo, usando o tipo de regra Quando, é possível avaliar uma condição em diferentes objetos de formulário e executar a ação:
When:
(Object A Condition 1)
AND/OR
(Object B Condtion 2)
Then, do the following:
Action 1 on Object A
_
Considerações ao usar Vários campos permitidos no recurso de condição Quando
- Verifique se o componente principal e a versão da especificação estão definidos com a versão mais recente para usar esse recurso no editor de regras.
- Se as regras forem aplicadas a campos diferentes na condição When, a regra será acionada mesmo se apenas um desses campos for alterado.
Se os vários campos permitidos no recurso Quando condição encontrarem problemas, siga as etapas de solução de problemas como:
- Abra o formulário no modo de edição.
- Abra o Navegador de conteúdo e selecione o componente Contêiner do Guia do seu Formulário adaptável.
- Clique no ícone de propriedades do Guia Contêiner
- Clique em Concluído e salve a caixa de diálogo novamente.
Ocultar oculta o objeto especificado.
Mostrar Mostra o objeto especificado.
Habilitar Habilita o objeto especificado.
Desabilitar Desabilita o objeto especificado.
Chamar serviço Chama um serviço configurado em um modelo de dados de formulário (FDM). Quando você escolhe a operação Chamar Serviço, um campo é exibido. Ao tocar no campo, ele exibe todos os serviços configurados em todos os modelos de dados de formulário (FDM) na instância Experience Manager. Ao escolher um serviço de modelo de dados de formulário, mais campos são exibidos onde você pode mapear objetos de formulário com parâmetros de entrada e saída para o serviço especificado. Consulte o exemplo de regra para chamar serviços do Modelo de dados de formulário (FDM).
Além do serviço de modelo de dados de formulário, você pode especificar um URL WSDL direto para chamar um serviço Web. No entanto, um serviço de modelo de dados de formulário tem muitos benefícios e a abordagem recomendada para chamar um serviço.
Para obter mais informações sobre como configurar serviços no modelo de dados de formulário (FDM), consulte Experience Manager Forms Integração de Dados.
Defina o valor de Computes e defina o valor do objeto especificado. Você pode definir o valor do objeto como uma string, o valor de outro objeto, o valor calculado usando a expressão matemática ou a função, o valor de uma propriedade de um objeto ou o valor de saída de um serviço de Modelo de Dados de Formulário configurado. Quando você escolhe a opção de serviço Web, ela exibe todos os serviços configurados em todos os modelos de dados de formulário (FDM) na sua instância Experience Manager. Ao escolher um serviço de modelo de dados de formulário, mais campos são exibidos onde você pode mapear objetos de formulário com parâmetros de entrada e saída para o serviço especificado.
Para obter mais informações sobre como configurar serviços no modelo de dados de formulário (FDM), consulte Experience Manager Forms Integração de Dados.
O tipo de regra Definir Propriedade permite que você defina o valor de uma propriedade do objeto especificado com base em uma ação de condição. Você pode definir a propriedade como uma das seguintes opções:
- visível (Booleano)
- label.value (String)
- label.visible (Booleano)
- descrição (String)
- ativado (Booleano)
- readOnly (Booleano)
- obrigatório (booleano)
- screenReaderText (Cadeia de caracteres)
- válido (Booleano)
- errorMessage (String)
- padrão (Número, String, Data)
- enumNames (Cadeia de caracteres[])
- chartType (String)
Por exemplo, permite definir regras para mostrar a caixa de texto quando um botão é clicado. Você pode usar uma função personalizada, um objeto de formulário, uma propriedade de objeto ou uma saída de serviço para definir uma regra.
Para definir uma regra com base em uma função personalizada, selecione Saída da Função na lista suspensa e arraste e solte uma função personalizada na guia Funções. Se a ação da condição for atendida, a caixa de entrada de texto ficará visível.
Para definir uma regra baseada em um objeto de formulário, selecione Objeto de formulário na lista suspensa e arraste e solte um objeto de formulário da guia Objetos de formulário. Se a ação de condição for atendida, a caixa de entrada de texto ficará visível no Formulário adaptável.
Uma regra Definir propriedade com base em uma propriedade de objeto permite tornar a caixa de entrada de texto visível em um Formulário adaptável com base em outra propriedade de objeto incluída no Formulário adaptável.
A figura a seguir representa um exemplo de ativação dinâmica da caixa de seleção com base na ocultação ou exibição da caixa de texto em um Formulário adaptável:
Limpar Valor de Limpa o valor do objeto especificado.
Definir Foco Define o foco no objeto especificado.
Enviar Formulário Envia o formulário.
Redefinir Redefine o formulário ou o objeto especificado.
Validar Valida o formulário ou o objeto especificado.
Adicionar instância Adiciona uma instância do painel ou linha de tabela repetível especificado.
Remover instância Remove uma instância do painel ou linha de tabela repetível especificado.
Saída de Função Define uma regra baseada em funções predefinidas ou funções personalizadas.
Navegar até Navega até outro Forms Adaptive, outros ativos, como imagens ou fragmentos de documentos, ou uma URL externa.
Evento de expedição aciona as ações ou comportamentos específicos com base em condições ou eventos predefinidos.
Definir valor de set-value-of
O tipo de regra Definir Valor de permite que você defina o valor de um objeto de formulário, dependendo se a condição especificada é atendida ou não. O valor pode ser definido como um valor de outro objeto, uma sequência literal, um valor derivado de uma expressão matemática ou de uma função, um valor de uma propriedade de outro objeto ou a saída de um serviço de modelo de dados de formulário. Da mesma forma, você pode verificar uma condição em um componente, string, propriedade ou valores derivados de uma função ou expressão matemática.
O tipo de regra Definir Valor de não está disponível para todos os objetos de formulário, como painéis e botões da barra de ferramentas. Uma regra padrão Definir valor de tem a seguinte estrutura:
Defina o valor do Objeto A como:
(cadeia de caracteres ABC) OU
(propriedade de objeto X do Objeto C) OU
(valor de uma função) OR
(valor de uma expressão matemática) OR
(valor de saída de um serviço de modelo de dados);
Quando (opcional):
(Condição 1 E Condição 2 E Condição 3) é VERDADEIRA;
O exemplo a seguir seleciona o valor de Question2 como True e define o valor de Result como correct.
Exemplo de Definir Valor regra usando o serviço de modelo de dados de formulário.
Programa show
Usando o tipo de regra Mostrar, você pode escrever uma regra para mostrar ou ocultar um objeto de formulário com base no fato de uma condição ser atendida ou não. O tipo de regra Mostrar também aciona a ação Ocultar caso a condição não seja atendida ou retorne False.
Uma regra típica de exibição está estruturada da seguinte maneira:
Show Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Hide Object A;
Ocultar hide
Semelhante ao tipo de regra Mostrar, você pode usar o tipo de regra Ocultar para mostrar ou ocultar um objeto de formulário com base no fato de uma condição ser atendida ou não. O tipo de regra Ocultar também aciona a ação Mostrar caso a condição não seja atendida ou retorne False.
Uma regra típica de Ocultar está estruturada da seguinte maneira:
Hide Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Show Object A;
Habilitar enable
O tipo de regra Habilitar permite habilitar ou desabilitar um objeto de formulário com base no fato de uma condição ser atendida ou não. O tipo de regra Habilitar também aciona a ação Desabilitar caso a condição não seja atendida ou retorne False.
Uma regra Enable típica é estruturada da seguinte maneira:
Enable Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Disable Object A;
Desabilitar disable
Semelhante ao tipo de regra Habilitar, o tipo de regra Desabilitar permite habilitar ou desabilitar um objeto de formulário com base no fato de uma condição ser atendida ou não. O tipo de regra Desativar também aciona a ação Ativar caso a condição não seja atendida ou retorne False.
Uma regra típica de Desativação está estruturada da seguinte maneira:
Disable Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Enable Object A;
Validar validate
O tipo de regra Validar valida o valor em um campo usando uma expressão. Por exemplo, você pode escrever uma expressão para verificar se a caixa de texto para especificar o nome não contém caracteres especiais ou números.
Uma regra Validate típica é estruturada da seguinte maneira:
Validate Object A;
Using:
(Expression 1 AND Expression 2 AND Expression 3) is TRUE;
Noções básicas sobre a interface do usuário do editor de regras understanding-the-rule-editor-user-interface
O Editor de regras fornece uma interface de usuário abrangente, mas simples, para gravar e gerenciar regras. É possível iniciar a interface do usuário do editor de regras em um Formulário adaptável no modo de criação.
Para iniciar a interface do usuário do editor de regras:
-
Abra um Formulário adaptável no modo de criação.
-
Selecione o objeto de formulário para o qual deseja gravar uma regra e, na Barra de Ferramentas do Componente, selecione
Todas as regras existentes nos objetos de formulário selecionados são listadas nessa exibição. Para obter informações sobre como gerenciar regras existentes, consulte Gerenciar regras.
-
Selecione Criar para escrever uma nova regra. O editor visual da interface do usuário do editor de regras é aberto por padrão quando você inicia o editor de regras pela primeira vez.
Vamos analisar cada componente da interface do editor de regras em detalhes.
A. Exibição de componente-regra a-component-rule-display
Exibe o título do objeto de Formulário adaptável pelo qual você iniciou o editor de regras e o tipo de regra selecionado no momento. No exemplo acima, o editor de regras é iniciado de um objeto de Formulário adaptável chamado Pergunta 1, e o tipo de regra selecionado é Quando.
B. Funções e objetos de formulário b-form-objects-and-functions-br
O painel à esquerda na interface do usuário do editor de regras inclui duas guias: Objetos do Forms e Funções.
A guia Objetos de formulário mostra uma exibição hierárquica de todos os objetos contidos no formulário adaptável. Ele exibe o título e o tipo dos objetos. Ao escrever uma regra, você pode arrastar e soltar objetos de formulário no editor de regras. Ao criar ou editar uma regra ao arrastar e soltar um objeto ou função em um espaço reservado, o espaço reservado automaticamente assume o tipo de valor apropriado.
Os objetos de formulário que têm uma ou mais regras válidas aplicadas são marcados com um ponto verde. Se alguma das regras aplicadas a um objeto de formulário for inválida, o objeto de formulário será marcado com um ponto amarelo.
A guia Funções inclui um conjunto de funções incorporadas, como Soma de, Mín de, Máx de, Média de, Número de e Validar formulário. Você pode usar essas funções para calcular valores em painéis e linhas de tabela repetíveis e usá-los em declarações de ação e condição ao escrever regras. Entretanto, você também pode criar funções personalizadas.
Algumas das listas de funções são exibidas na figura:
Na árvore esquerda dos objetos de formulário, você pode selecionar os objetos de formulário para exibir as regras aplicadas a cada um dos objetos. Você não só pode navegar pelas regras dos vários objetos de formulário, como também pode copiar e colar regras entre os objetos de formulário. Para obter mais informações, consulte Copiar-colar regras.
C. Alternância entre objetos e funções de formulário c-form-objects-and-functions-toggle-br
O botão de alternância, quando tocado, alterna o painel de funções e objetos de formulário.
D. Editor visual de regras visual-rule-editor
Editor visual de regras é a área no modo editor visual da interface do usuário do editor de regras em que você escreve regras. Ele permite selecionar um tipo de regra e definir adequadamente condições e ações. Ao definir condições e ações em uma regra, você pode arrastar e soltar objetos e funções de formulário do painel Objetos de formulário e Funções.
Para obter mais informações sobre como usar o editor visual de regras, consulte Regras de gravação.
E. Botões Concluído e Cancelar done-and-cancel-buttons
O botão Concluído é usado para salvar uma regra. Você pode salvar uma regra incompleta. No entanto, estão incompletos inválido e não são executados. As regras salvas em um objeto de formulário são listadas quando você iniciar o regra editor na próxima vez do mesmo objeto de formulário. Você pode gerenciar regras existentes nesse visualização. Para obter mais informações, consulte Gerenciar regras.
A Cancelar botão descarta as alterações feitas em uma regra e fecha a regra editor.
Regras de gravação write-rules
É possível criar regras usando o visual regra editor
Primeiro, vamos analisar como escrever regras usando o editor visual.
Uso do editor visual using-visual-editor
Vamos entender como criar uma regra no editor visual usando o seguinte formulário de exemplo.
A seção Requisitos de empréstimo no formulário de aplicativo de empréstimo por exemplo exige que os requerentes especifiquem seu estado civil, salário e, se casados, o salário de seu cônjuge. Com base nas entradas do usuário, a regra calcula o valor de qualificação de empréstimo e é exibida no campo Elegibilidade do empréstimo. Aplique as seguintes regras para implementar o cenário:
- O campo Salário do Cônjuge é exibido somente quando o Estado Civil é Casado.
- O valor de qualificação de empréstimo é de 50% do salário total.
Para gravar regras, execute as seguintes etapas:
-
Primeiro, escreva a regra para controlar a visibilidade do campo Salário do Cônjuge com base na opção que o usuário seleciona para o botão de opção Estado Civil.
Abra o formulário de solicitação de empréstimo no modo de criação. Selecione o componente Estado civil e selecione
Ao iniciar o editor de regras, a regra Quando é selecionada por padrão. Além disso, o objeto de formulário (nesse caso, Estado civil) de onde você iniciou o editor de regras é especificado na instrução When.
Embora não seja possível alterar ou modificar o objeto selecionado, você poderá usar o menu suspenso de regras, como mostrado abaixo, para selecionar outro tipo de regra. Se quiser criar uma regra em outro objeto, selecione Cancelar para sair do editor de regras e iniciá-lo novamente a partir do objeto de formulário desejado.
-
Selecione o menu suspenso Selecionar estado e selecione é igual a. O campo Inserir uma cadeia de caracteres é exibido.
-
No campo Inserir uma Cadeia de Caracteres na regra, selecione Casado no menu suspenso.
Você definiu a condição como
When Marital Status is equal to Married. Em seguida, defina a ação a ser executada se essa condição for True. -
Na instrução Then, selecione Mostrar no menu suspenso Selecionar Ação.
-
Arraste e solte o campo Salário do Cônjuge da guia Objetos de Formulário no campo Soltar objeto ou selecionar aqui. Como alternativa, selecione o campo Soltar objeto ou selecione aqui e selecione o campo Salário do Cônjuge no menu pop-up, que lista todos os objetos de formulário no formulário.
Em seguida, defina a ação a ser executada se essa condição for False.
-
Clique em Adicionar outra Seção para adicionar outra condição ao campo Salário do Cônjuge, caso selecione Estado Civil como solteiro.
-
Na instrução Else, selecione Ocultar no menu suspenso Selecionar Ação.
-
Arraste e solte o campo Salário do Cônjuge da guia Objetos de Formulário no campo Soltar objeto ou selecionar aqui. Como alternativa, selecione o campo Soltar objeto ou selecione aqui e selecione o campo Salário do Cônjuge no menu pop-up, que lista todos os objetos de formulário no formulário.
A regra é exibida da seguinte maneira no editor de regras.
-
Selecione Concluído para salvar a regra.
-
Em seguida, escreva uma regra para calcular o valor de qualificação de empréstimo, que é 50% do salário total, e exiba-o no campo Elegibilidade do empréstimo. Para obter este resultado, crie Definir valor de regras no campo Qualificação de empréstimo.
No modo de criação, selecione o campo Qualificação para empréstimo e selecione
-
Selecione a regra Definir Valor de no menu suspenso de regras.
-
Selecione Selecionar Opção e selecione Expressão Matemática. Um campo para escrever expressão matemática é aberto.
-
No campo de expressão:
-
Selecione ou arraste e solte da guia Objeto do Forms o campo Salário no primeiro campo Soltar objeto ou selecione aqui.
-
Selecione Plus no campo Selecionar Operador.
-
Selecione ou arraste e solte na guia Objeto do Forms o campo Salário do Cônjuge no outro objeto Solte ou selecione aqui.
-
-
Em seguida, selecione na área destacada ao redor do campo de expressão e selecione Estender expressão.
No campo de expressão estendida, selecione dividido por no campo Selecionar Operador e Número no campo Selecionar Opção. Em seguida, especifique 2 no campo de número.
note note NOTE É possível criar expressões complexas usando componentes, funções, expressões matemáticas e valores propriedade do campo Selecionar opção. Próximo, crie uma condição que, quando retornar True, a expressão for executada.
-
Selecione Adicionar condição para adicionar uma declaração Quando.
Na instrução When:
-
Selecione ou arraste e solte na guia Objeto do Forms o campo Estado civil no primeiro campo Soltar objeto ou selecione aqui.
-
Selecione é igual a no campo Selecionar Operador.
-
Selecione a string no outro objeto Soltar ou selecione aqui e especifique Casado no campo Inserir uma string.
A regra finalmente aparece da seguinte maneira no editor de regras.
-
-
Selecione Concluído. Ele salva a regra.
-
Repita as etapas 7 a 14 para definir outra regra para calcular a elegibilidade do empréstimo se o estado civil for Simples. A regra é exibida da seguinte maneira no editor de regras.
Como alternativa, você pode usar a regra Definir Valor de para calcular a elegibilidade do empréstimo na regra Quando criada para mostrar/ocultar o campo Salário do Cônjuge. A regra combinada resultante quando o estado civil é Simples é exibida da seguinte maneira no editor de regras.
Você pode escrever uma regra combinada para controlar a visibilidade do campo Salário do Cônjuge e calcular a elegibilidade para empréstimo quando o estado civil é Casado usando a condição Outro.
Funções personalizadas no editor de regras custom-functions
Além das funções prontas para uso como Soma de que estão listadas em Saída de Funções, você também pode usar funções personalizadas no editor de regras. O editor de regras é compatível com a sintaxe do JavaScript ECMAScript 2019 para scripts e funções personalizadas. Para obter instruções sobre como criar funções personalizadas, consulte o artigo Funções personalizadas no Adaptive Forms
Gerenciar regras manage-rules
Todas as regras existentes em um objeto de formulário são listadas ao selecionar o objeto e selecionar
Você pode executar as seguintes ações nas regras:
-
Expandir/Recolher: a coluna Conteúdo da lista de regras exibe o conteúdo da regra. Se o conteúdo inteiro da regra não estiver visível no modo de exibição padrão, selecione
-
Reordenar: qualquer nova regra criada é empilhada na parte inferior da lista de regras. As regras são executadas de cima para baixo. A regra na parte superior é executada primeiro, seguida por outras regras do mesmo tipo. Por exemplo, se você tiver as regras When, Show, Enable e When na primeira, segunda, terceira e quarta posições acima, respectivamente, a regra When na parte superior será executada primeiro, seguida pela regra When na quarta posição. Em seguida, as regras Show e Enable são executadas.
Você pode alterar a ordem de uma regra tocando em
-
Editar: para editar uma regra, marque a caixa de seleção ao lado do título da regra. São exibidas opções para editar e excluir a regra. Selecione Editar para abrir a regra selecionada no editor de regras .
-
Excluir: para excluir uma regra, selecione a regra e selecione Excluir.
-
Habilitar/Desabilitar: quando é necessário suspender temporariamente o uso de uma regra, você pode selecionar uma ou mais regras e selecionar Desabilitar na barra de ferramentas Ações para desabilitá-las. Se uma regra estiver desativada, ela não será executada no tempo de execução. Para habilitar uma regra que esteja desabilitada, você pode selecioná-la e selecionar Habilitar na barra de ferramentas de ações. A coluna de status da regra exibe se a regra está ativada ou desativada.
Copiar e colar regras copy-paste-rules
É possível copiar e colar uma regra de um campo para outros campos semelhantes para economizar tempo.
Para copiar e colar regras, faça o seguinte:
-
Selecione o objeto de formulário do qual deseja copiar uma regra e, na barra de ferramentas do componente, selecione
Para obter informações sobre como gerenciar regras existentes, consulte Gerenciar regras.
-
Marque a caixa de seleção ao lado do título da regra. As opções para gerenciar a regra são exibidas. Selecione Copiar.
-
Selecione outro objeto de formulário no qual você deseja colar a regra e selecione Colar. Além disso, você pode editar a regra para alterá-la.
note note NOTE Você só poderá colar uma regra em outro objeto de formulário se esse objeto der suporte ao evento da regra copiada. Por exemplo, um botão oferece suporte ao evento click. É possível colar uma regra com um evento de clique em um botão, mas não em uma caixa de seleção. -
Selecione Concluído para salvar a regra.
Expressões aninhadas nestedexpressions
O editor de regras permite usar vários operadores AND e OR para criar regras aninhadas. Você pode misturar vários operadores AND e OR em regras.
Veja a seguir um exemplo de uma regra aninhada que exibe uma mensagem ao usuário sobre a elegibilidade para a custódia de uma criança quando as condições necessárias são atendidas.
Também é possível arrastar e soltar condições em uma regra para editá-la. Selecione e passe o mouse sobre o identificador (
Condições de expressão de data dateexpression
A editor de regras permite usar comparações de datas para criar condições.
A seguir, uma condição de exemplo que exibe um objeto de texto estático se a hipoteca da casa já for tomada, o que o usuário significa preenchendo o campo de data.
Quando a data da hipoteca da propriedade como preenchida pela usuário estiver no passado, o Formulário Adaptável exibirá uma nota sobre o cálculo de renda. A regra a seguir compara a data preenchida pela usuário com a data atual e se a data preenchida pelo usuário for anterior à data atual, o formulário exibe a mensagem de texto (chamada Renda).
Quando a data de preenchimento for anterior à data atual, o formulário exibirá a mensagem de texto (Receita) como a seguir:
Condições de comparação de número number-comparison-conditions
O editor de regras permite criar condições que comparam dois números.
A seguir, uma condição de exemplo que exibe um objeto de texto estático se o número de meses em que um solicitante está hospedado no endereço atual for menor que 36.
Quando o usuário indica que está morando no endereço residencial atual por menos de 36 meses, o formulário exibe uma notificação de que mais prova de residência pode ser solicitada.
Exemplo de regras example
Invocar serviço de modelo de dados de formulário invoke
Considere um serviço Web GetInterestRates que obtém o valor do empréstimo, a estabilidade e a pontuação de crédito do candidato como entrada e retorna um plano de empréstimo incluindo o valor da IME e a taxa de juros. Você cria um Modelo de dados de formulário (FDM) usando o serviço Web como uma fonte de dados. Você adiciona objetos de modelo de dados e um serviço get ao modelo de formulário. O serviço aparece na guia Serviços do modelo de dados de formulário (FDM). Em seguida, crie um Formulário adaptável que inclua campos de objetos de modelo de dados para capturar as entradas do usuário para valor do empréstimo, estabilidade e pontuação de crédito. Adicione um botão que aciona o serviço Web para buscar detalhes do plano. A saída é preenchida nos campos apropriados.
A regra a seguir mostra como configurar a ação Chamar serviço para realizar o cenário de exemplo.
Acionamento de várias ações usando a regra Quando triggering-multiple-actions-using-the-when-rule
Em um formulário de solicitação de empréstimo, você deseja registrar se o candidato ao empréstimo é um cliente existente ou não. Com base nas informações fornecidas pelo usuário, o campo ID do cliente deve mostrar ou ocultar. Além disso, é possível definir o foco no campo ID do cliente se o usuário for um cliente existente. O formulário de pedido de empréstimo tem os seguintes componentes:
-
Um botão de opção, Você já é cliente do Geometrixx?, que fornece as opções Sim e Não. O valor de Sim é 0 e Não é 1.
-
Geometrixx Um campo de texto, ID do cliente, para especificar a ID do cliente.
Quando você escreve uma regra Quando no botão de opção para implementar esse comportamento, a regra é exibida da seguinte maneira no editor visual de regras.
Regra no editor visual
Na regra de exemplo, a instrução na seção When é a condição, que quando retorna True, executa as ações especificadas na seção Then.
Uso de uma saída de função em uma regra using-a-function-output-in-a-rule
Em um formulário de ordem de compra, você tem a tabela a seguir, na qual os usuários preenchem seus pedidos. Nesta tabela:
- A primeira linha pode ser repetida, para que os usuários possam solicitar vários produtos e especificar quantidades diferentes. Seu nome de elemento é
Row1. - O título da célula na coluna Quantidade do Produto da linha repetível é Quantidade. O nome do elemento desta célula é
productquantity. - A segunda linha da tabela não pode ser repetida e o título da célula na coluna Quantidade do Produto nesta linha é Quantidade Total.
A. Linha1 B. Quantidade C. Quantidade Total
Agora, você deseja adicionar quantidades especificadas na coluna Quantidade do Produto para todos os produtos e exibir a soma na célula Quantidade Total. Você pode obter essa soma gravando uma regra Definir Valor de na célula Quantidade total, como mostrado abaixo.
Regra no editor visual
Validação de um valor de campo usando expressão validating-a-field-value-using-expression
No form ordem de compra explicado no exemplo anterior, você deseja impedir que o usuário faça pedidos de mais de uma quantidade de qualquer produto com preço superior a 10000. Para fazer essa validação, você pode gravar uma regra Validate como mostrado abaixo.
Regra no editor visual