Criar e usar fragmentos adaptáveis do Forms em um formulário adaptável com base nos Componentes principais adaptive-form-fragments

Versão
Link do artigo
AEM as a Cloud Service (Componentes principais)
Este artigo
AEM as a Cloud Service (Componentes de base)
Clique aqui
AEM 6.5
Clique aqui

Embora cada formulário seja projetado para um propósito específico, há alguns segmentos comuns na maioria dos formulários, como o de fornecer detalhes pessoais, como nome e endereço, detalhes familiares e detalhes de renda. Os desenvolvedores de formulários são necessários para criar esses segmentos comuns sempre que um novo formulário for criado.

O Forms adaptável fornece um mecanismo conveniente para criar segmentos de formulário, como um painel ou um grupo de campos, somente uma vez e reutilizá-los no Forms adaptável. Esses segmentos reutilizáveis e independentes são chamados de fragmentos de formulário adaptável.

Os fragmentos de formulário se integram perfeitamente em vários formulários, simplificando a criação de formulários consistentes e com aparência profissional. Os fragmentos de formulário garantem a reutilização, a padronização e a consistência da marca por meio da funcionalidade "alterar uma vez e refletir em todos os lugares". Experimente maior capacidade de manutenção e eficiência, já que as atualizações feitas em um local são propagadas automaticamente em todos os formulários que utilizam esses fragmentos.

Você pode adicionar um fragmento várias vezes a um documento e usar as propriedades de vinculação de dados de seus componentes para vinculá-lo a diferentes fontes de dados ou esquemas. Por exemplo, você pode usar o mesmo fragmento de endereço para os endereços permanente, para contato e de faturamento, e conectá-lo a diferentes campos de uma fonte de dados ou esquema.

NOTE
Você pode personalizar facilmente a experiência do fragmento para usuários com a Caixa de diálogo de Configuração e Caixa de diálogo de Design do componente de Fragmento de Formulário.

Criar um fragmento de formulário adaptável create-a-fragment

Você pode criar um fragmento de formulário adaptável do zero ou salvar um painel em um formulário adaptável existente como fragmento. Para criar um fragmento de formulário:

  1. Faça logon na instância do AEM Forms em https://[hostname]:[port]/aem/forms.html.

  2. Clique em Criar > Fragmento de formulário adaptável.

    Criar fragmento de formulário adaptável

  3. Especifique título, nome, descrição e tags para o fragmento. Certifique-se de especificar um nome exclusivo para o fragmento. Se outro fragmento existir com o mesmo nome, o fragmento não será criado.

  4. Selecione um modelo de formulário. Você pode criar um fragmento de formulário para Componentes principais com base no Forms adaptável ou Componentes de base com base no Forms adaptável. Para criar fragmento de formulário para formulários baseados em Componentes principais, selecione um modelo baseado em Componentes principais.

    Ao criar fragmento de formulário para formulários baseados em Componentes principais, use a opção Selecionar tema do formulário para selecionar um tema baseado em Componentes principais.

  5. Clique para abrir a guia Modelo de formulário e, no menu suspenso Selecionar de, selecione um dos seguintes modelos para o fragmento:

    Exibe o tipo de modelo na guia Modelo de Formulário

    • Nenhum: especifica criar o fragmento do zero sem usar nenhum modelo de formulário.

      note note
      NOTE
      No Forms adaptável, é possível usar um único fragmento de formulário (com base nos Componentes principais) várias vezes. Ele oferece suporte a fragmentos de formulário baseados em nenhum e em esquema.
    • Esquema: especifica a criação do fragmento usando um esquema XML ou JSON carregado para o AEM Forms. Você pode fazer upload ou selecionar dentre os esquemas XML ou JSON disponíveis como o modelo de formulário do fragmento. Ao selecionar um esquema XML, você também pode criar um fragmento de Formulário adaptável selecionando um complexType presente no esquema selecionado na caixa suspensa Tipo complexo de esquema XML. Ao selecionar um esquema JSON, você também pode criar um fragmento de Formulário adaptável selecionando uma definição de esquema presente no esquema selecionado na caixa suspensa Definições de esquema JSON.

    • Modelo de dados de formulário: especifica a criação do fragmento usando um modelo de dados de formulário (FDM). Você pode criar um fragmento de Formulário adaptável com base em apenas um objeto de modelo de dados em um modelo de dados de formulário (FDM). Expanda a lista suspensa Definições do Modelo de dados de formulário (FDM). Ela lista todos os objetos do modelo de dados no modelo de dados de formulário (FDM) especificado. Selecione um objeto de modelo de dados na lista.

    Modelo de dados de formulário (FDM)

  6. Clique em Criar e em Abrir para abrir o fragmento, com um modelo padrão, no modo de edição. No modo de edição, é possível adicionar qualquer componente de Formulário adaptável ao fragmento.

Depois que o fragmento do Formulário adaptável com base em um esquema ou modelo de dados de formulário (FDM) é criado, o modelo de dados de formulário (FDM) ou os elementos do esquema aparecem na guia Fontes de dados do navegador de conteúdo no editor de Formulário adaptável. Você pode arrastar e soltar elementos do modelo de formulário no fragmento. Os elementos de modelo de formulário adicionados são convertidos em componentes de formulário, ao mesmo tempo em que retêm as propriedades originais do esquema associado.

Adicionar um fragmento a um Formulário adaptável insert-a-fragment-in-an-adaptive-form

Para adicionar um fragmento de formulário adaptável a um formulário adaptável:

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

  2. Adicione o componente Fragmento de formulário adaptável ao formulário.

  3. Abra a caixa de diálogo Configuração do componente Fragmento de formulário adaptável.

  4. Selecione a Referência do fragmento na guia Básico. Todos os fragmentos do Forms adaptável disponíveis para o formulário, dependendo do modelo do formulário, são exibidos.

  5. Selecione um fragmento de formulário adaptável no componente Fragmento de formulário adaptável no formulário adaptável.

    selecione a opção Fragmentos de formulário adaptável

O fragmento de Formulário adaptável é adicionado por referência ao Formulário adaptável e permanece em sincronia com o fragmento de Formulário adaptável independente. Isso implica que quaisquer modificações feitas no fragmento do Formulário adaptável sejam espelhadas em todas as instâncias em que o fragmento é incorporado no Adaptive Forms.

Uso de fragmentos dentro de fragmentos using-fragments-within-fragments

É possível criar fragmentos de formulário adaptável aninhados, o que significa que você pode adicionar um fragmento em outro fragmento e ter uma estrutura de fragmento aninhada.

Uso de um fragmento de formulário várias vezes em um Formulário adaptável using-form-fragment-mutiple-times-in-af

Você pode usar um fragmento de formulário com base em nenhum e em esquema várias vezes em um Formulário adaptável para salvar dados de forma exclusiva para cada campo de fragmentos de formulário. Por exemplo, você pode usar um fragmento de formulário de endereço para coletar detalhes de endereço para endereços permanentes, de comunicação e vivos presentes em um formulário de aplicativo de empréstimo.

usando vários fragmentos no formulário adaptável

Gerenciar fragmentos manage-fragments

É possível executar várias operações em fragmentos de formulário adaptável usando a interface do usuário do AEM Forms.

  1. Acesse https://[hostname]/aem/forms.html.

  2. Clique em Selecionar na barra de ferramentas da interface do usuário do AEM Forms e selecione um Fragmento de formulário adaptável. A barra de ferramentas exibe as seguintes operações que você pode executar no fragmento de Formulário adaptável selecionado.

Operação
Descrição
Editar
Abre o fragmento de formulário adaptável selecionado no modo de edição.
Visualização
Fornece opções para visualizar o fragmento como um HTML ou uma visualização personalizada mesclando dados de um arquivo XML com o fragmento. Para obter mais informações, consulte Visualizando um formulário.
Download
Baixa o fragmento selecionado.
Iniciar revisão/Gerenciar revisão
Permite iniciar e gerenciar uma revisão do fragmento selecionado. Para obter mais informações, consulte Criação e gerenciamento de análises.
Adicionar Dicionário
Gera um dicionário para localizar o fragmento selecionado. Para obter mais informações, consulte Localizando Forms Adaptável.
Publish / Desfazer publicação
Publica/cancela a publicação do fragmento selecionado.
Excluir
Exclui o fragmento selecionado.

Pontos principais a serem lembrados ao trabalhar com fragmentos key-points-to-remember-when-working-with-fragments

  • Certifique-se de que o nome do fragmento seja exclusivo. O fragmento não é criado se houver um fragmento existente com o mesmo nome.
  • Qualquer expressão, script ou estilo em um fragmento de Formulário adaptável independente é retido quando inserido por referência ou incorporado em um Formulário adaptável.
  • Não é possível editar um fragmento de Formulário adaptável, que é inserido por referência, de um Formulário adaptável. Para editar, modifique o fragmento independente do Formulário adaptável.
  • Ao publicar um Formulário adaptável, você precisa publicar os fragmentos independentes do Formulário adaptável inseridos por referência no Formulário adaptável.
  • Ao republicar um fragmento de Formulário adaptável atualizado, as alterações são refletidas nas instâncias publicadas do Formulário adaptável em que o fragmento é usado.
  • O formulário adaptável que contém o componente Verificar não é compatível com usuários anônimos. Além disso, não é recomendado usar o componente Verificar em um fragmento de Formulário adaptável.

Fragmentos de referência reference-fragments

Os fragmentos de formulário adaptável de referência que você pode usar para criar seu formulário estão disponíveis.

Consulte também see-also

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