Interface do usuário do Editor de regras para o Forms adaptável com base nos Componentes principais

A interface do usuário do Editor de regras para o Forms adaptável com base nos Componentes principais melhora o processo de criação de formulários no Adobe Experience Manager (AEM). Ele permite que usuários empresariais e desenvolvedores implementem comportamento dinâmico e lógica complexa em formulários, escrevendo regras que acionam ações com base em condições predefinidas, entradas de usuário e interações. Este recurso suporta funcionalidades modernas do JavaScript, incluindo recursos ES10, e oferece um editor visual intuitivo que simplifica o processo de escrita de regras.
O Editor de regras é fundamental para simplificar a experiência de preenchimento de formulários, garantindo precisão e eficiência. Ela permite a validação ou a redefinição de painéis e formulários, além da execução de funções personalizadas para calcular valores de objetos de formulário. Com suporte a condições aninhadas e a capacidade de chamar serviços de Modelo de dados de formulário, a interface do usuário do Editor de regras é um componente essencial para criar formulários responsivos, amigáveis e adaptáveis.

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:

  1. Abra um Formulário adaptável no modo de criação.

  2. Selecione o objeto de formulário para o qual deseja gravar uma regra e, na Barra de Ferramentas do Componente, selecione edit-rules . A interface do usuário do editor de regras é exibida.

    criar-regras

    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.

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

    Interface do Editor de Regras

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:

A guia Funções

NOTE
Você pode executar a pesquisa de texto em nomes de objetos e funções e títulos nas guias Objetos e Funções do Forms.

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 um 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, incompletos são inválidos e não são executados. As regras salvas em um objeto de formulário são listadas na próxima vez que você iniciar o editor de regras a partir do mesmo objeto de formulário. Você pode gerenciar as regras existentes nessa visualização. Para obter mais informações, consulte Gerenciar regras.

O botão Cancelar descarta todas as alterações feitas em uma regra e fecha o editor de regras.

Regras de gravação write-rules

Você pode escrever regras usando o editor visual de regras

Primeiro, vamos analisar como escrever regras usando um editor visual.

+++

Usando o editor visual {#using-visual-editor}

Vamos entender como criar uma regra em um editor visual usando o seguinte formulário de exemplo.

Criar-regra-exemplo

A seção Requisitos de Empréstimo no formulário de solicitação de empréstimo de exemplo exige que os candidatos especifiquem seu estado civil, salário e, se forem casados, o salário de seus cônjuges. 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:

  1. 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 edit-rules . Em seguida, selecione Criar para iniciar o editor de regras.

    write-rules-visual-editor-1

    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.

  2. Selecione o menu suspenso Selecionar estado e selecione é igual a. O campo Inserir uma cadeia de caracteres é exibido.

    write-rules-visual-editor-2

  3. No campo Inserir uma Cadeia de Caracteres na regra, selecione Casado no menu suspenso.

    write-rules-visual-editor-4

    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.

  4. Na instrução Then, selecione Mostrar no menu suspenso Selecionar Ação.

    write-rules-visual-editor-5

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

    write-rules-visual-editor-6

    Em seguida, defina a ação a ser executada se essa condição for False.

  6. Clique em Adicionar outra Seção para adicionar outra condição ao campo Salário do Cônjuge, caso selecione Estado Civil como solteiro.

    quando-mais

  7. Na instrução Else, selecione Ocultar no menu suspenso Selecionar Ação.
    quando-mais

  8. 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.
    quando-mais

    A regra é exibida da seguinte maneira no editor de regras.

    write-rules-visual-editor-7

  9. Selecione Concluído para salvar a regra.

note note
NOTE
Como alternativa, você pode escrever uma regra Mostrar no campo Salário do Cônjuge, em vez de regras Quando no campo Estado Civil, para implementar o mesmo comportamento.

write-rules-visual-editor-9

  1. 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 para empréstimo.

    No modo de criação, selecione o campo Qualificação para empréstimo e selecione edit-rules . Em seguida, selecione Criar para iniciar o editor de regras.

  2. Selecione a regra Definir Valor de no menu suspenso de regras.

    write-rules-visual-editor-10

  3. Selecione Selecionar Opção e selecione Expressão Matemática. Um campo para escrever expressão matemática é aberto.

    write-rules-visual-editor-11

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

    write-rules-visual-editor-12

  5. Em seguida, selecione na área destacada ao redor do campo de expressão e selecione Estender expressão.

    write-rules-visual-editor-13

    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.

    write-rules-visual-editor-14

    note note
    NOTE
    Você pode criar expressões complexas usando componentes, funções, expressões matemáticas e valores de propriedade no campo Selecionar opção.

    Em seguida, crie uma condição, que quando retorna True, a expressão é executada.

  6. Selecione Adicionar Condição para adicionar uma instrução When.

    write-rules-visual-editor-15

    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. write-rules-visual-editor-16

  7. Selecione Concluído. Ele salva a regra.

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

    write-rules-visual-editor-17

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.

write-rules-visual-editor-18

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.

write-rules-visual-editor-19

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 edit-rules1 . É possível exibir o título e uma pré-visualização do resumo da regra. Além disso, a interface do permite expandir e exibir o resumo completo da regra, alterar a ordem das regras, editar regras e excluir regras.

Regras de lista

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 expand-rule-content para expandi-lo.

  • 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 da parte superior, 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 sort-rules ou arrastando-a e soltando-a na ordem desejada na lista.

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

Desabilitar regra

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:

  1. Selecione o objeto de formulário do qual deseja copiar uma regra e, na barra de ferramentas do componente, selecione editar regra . A interface do usuário do editor de regras é exibida com o objeto de formulário selecionado e as regras existentes são exibidas.

    copiar regra

    Para obter informações sobre como gerenciar regras existentes, consulte Gerenciar regras.

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

    copyrule2

  3. 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.
  4. Selecione Concluído para salvar a regra.

Próxima etapa

Para entender os vários tipos de operadores e eventos no editor de regras de um Formulário adaptável, consulte o artigo Tipos de Operadores e Eventos Disponíveis no Editor de Regras de um Formulário adaptável.

Consulte também

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab