Fragmentos de formulário adaptável adaptive-form-fragments

Versão
Link do artigo
AEM as a Cloud Service
Clique aqui
AEM 6.5
Este artigo

O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principaispara criação de um novo Forms adaptávelou adição de Forms adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

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 da família 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.

Os formulários adaptativos fornecem um mecanismo conveniente para criar formulários segmento curtir um painel ou uma grupo de campos apenas uma vez e reutilizá-los através de formulários adaptáveis. Esses segmentos reutilizáveis e independentes são chamados de Fragmentos de formulário adaptável.

NOTE
Você pode personalizar facilmente suas experiência de fragmento para usuários com a caixa de diálogo Configurar e a caixa de diálogo Design do componente Fragmento de formulário.

Criar um fragmento create-a-fragment

É possível criar um fragmento de formulário adaptável do zero ou salvar um painel em um formulário adaptável existente como fragmento.

Criar fragmento do zero create-fragment-from-scratch

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

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

  3. Especifique título, nome, descrição e tags para o fragmento.

    note note
    NOTE
    Certifique-se de especificar um nome exclusivo para o fragmento. Se existir outro fragmento com o mesmo nome, o fragmento não será criado.
  4. Clique para abrir a Modelo de formulário e na guia Selecionar de selecione um dos seguintes modelos para o fragmento:

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

      note note
      NOTE
      No Forms adaptável baseado em componentes principais, é possível usar um único fragmento de formulário várias vezes em um formulário. Ele oferece suporte a fragmentos de formulário baseados em nenhum e em esquema.
    • Modelo de formulário: especifica criar o fragmento usando um modelo XDP carregado no AEM Forms. Selecione o modelo XDP apropriado como o modelo de formulário para o fragmento.

    Criação de um formulário adaptável usando o modelo de formulário como modelo

    Os subformulários marcados como fragmentos no modelo de formulário selecionado também são exibidos. Você pode selecionar um subformulário para fragmento de formulário adaptável na lista suspensa.

    Selecionar subformulários do modelo de formulário especificado

    Além disso, você pode criar um fragmento de formulário adaptável usando subformulários que não estão marcados como fragmentos no modelo de formulário especificando a expressão SOM para o subformulário na caixa suspensa.

    • Esquema XML: Especifica como criar o fragmento usando um esquema XML carregado no AEM Forms. Você pode fazer upload ou selecionar dentre os esquemas XML disponíveis como o modelo de formulário do fragmento.

    Criar um fragmento de formulário adaptável com base em um esquema XML como modelo

    Você também pode criar um fragmento de formulário adaptável selecionando um complexType presente no esquema selecionado na caixa suspensa.

    Selecione um tipo complexo no modelo de esquema XML especificado

  5. Clique em Criar e clique em Abertura para abrir o fragmento, com um modelo padrão, no modo de edição.

No modo de edição, você pode arrastar e soltar qualquer componente de formulário adaptável do sidekick do AEM no fragmento. Para obter informações sobre componentes de formulários adaptáveis, consulte Introdução à criação de formulários adaptáveis.

Além disso, se você selecionou um esquema XML ou modelo de formulário XDP como o modelo de formulário do fragmento, uma nova guia que exibe a hierarquia do modelo de formulário aparece no localizador de conteúdo. Ela permite 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 XDP ou XSD associado.

Salvar painel como um fragmento save-panel-as-a-fragment

  1. Abra um formulário adaptável que contenha o painel que você deseja salvar como fragmento de formulário adaptável.

  2. Na barra de ferramentas do painel, clique em Salvar como fragmento. A caixa de diálogo Salvar como fragmento é aberta.

    note note
    NOTE
    Se o painel que você está salvando como fragmento contiver painel secundário, o fragmento resultante os incluirá.
  3. Na caixa de diálogo Criação de fragmento, especifique as seguintes informações:

    • Nome: Nome do fragmento. O valor padrão é o nome do elemento do painel. É um campo obrigatório.

      note note
      NOTE
      Certifique-se de especificar um nome exclusivo para o fragmento. Se existir outro fragmento com o mesmo nome, o fragmento não será criado.
    • Título: Título do fragmento. O valor padrão é o título do painel.

    • Descrição: Descrição do fragmento.

    • Tags: marca os metadados do fragmento.

    • Caminho de destino: Caminho do repositório onde o fragmento é salvo. Se você não especificar um caminho, um nó com o mesmo nome do fragmento será criado ao lado do nó que contém o formulário adaptável. O fragmento é salvo neste nó.

    • Modelo de formulário: Dependendo do modelo de formulário para o formulário adaptável, esse campo exibe a variável Esquema XML, Modelo de formulário ou Nenhum. É um campo não editável.

    • Raiz do modelo de fragmento: aparece somente em formulários adaptáveis baseados em XSD. Especifica a raiz do modelo de fragmento. Você pode escolher / ou o tipo complexo XSD no menu suspenso. Você só poderá reutilizar o fragmento em outro formulário adaptável se selecionar o tipo complexo como a raiz do modelo de fragmento.
      Se você escolher / como a raiz do modelo de fragmento, a árvore XSD completa da raiz fica visível na guia modelo de dados de formulário adaptável. Para uma raiz de modelo de fragmento de tipo complexo, somente os descendentes do tipo complexo selecionado ficam visíveis na guia modelo de dados de formulário adaptável. Se você criar um fragmento e escolher um tipo complexo como o Raiz do modelo de fragmento, você pode usá-lo sempre que esse tipo complexo for usado, no mesmo formulário ou em vários formulários.

    • XSD Ref: aparece somente em formulários adaptáveis baseados em XSD. Ela exibe a localização do esquema XML.

    • XDP Ref: aparece somente em formulários adaptáveis baseados em XDP. Ela exibe o local do modelo de formulário XDP.

    save-fragment

    Caixa de diálogo Salvar como fragmento

  4. Clique em OK.

    O painel é salvo na localidade especificada ou padrão no repositório. No formulário adaptável, o painel é substituído por um instantâneo do fragmento. Como mostrado abaixo, o painel Informações gerais e seus painéis secundários, Informações pessoais e Endereço, são salvos como um fragmento.

    Para editar o fragmento, clique em Editar ativo na barra de ferramentas do painel. O fragmento é aberto em uma nova guia ou janela no modo de edição.

    Edição de fragmento

Trabalho com fragmentos working-with-fragments

Configurar a aparência do fragmento configure-fragment-appearance

Qualquer fragmento inserido nos formulários adaptáveis aparece como uma imagem de espaço reservado. O espaço reservado exibe títulos de até dez painéis secundários no fragmento. É possível configurar AEM Forms para mostrar o fragmento completo em vez da imagem de espaço reservado.

Execute as etapas a seguir para poder mostrar fragmentos completos nos formulários:

  1. Vá para AEM página de configuração do console da Web em https:[host]:[porta]/system/console/configMgr.

  2. Search e selecione Formulário adaptável e Configuração do canal da Web de comunicação interativa para abri-lo no modo de edição.

  3. Desativar Ativar espaço reservado no lugar do fragmento para mostrar fragmentos completos em vez da imagem de espaço reservado.

Inserir um fragmento em um formulário adaptável insert-a-fragment-in-an-adaptive-form

Os fragmentos de formulário adaptáveis criados aparecem na guia Fragmentos de formulário adaptáveis do localizador de conteúdo do AEM. Para inserir um fragmento de formulário adaptável em um formulário adaptável:

  1. Abra o formulário adaptável, no modo de edição, no qual deseja inserir um fragmento de formulário adaptável.

  2. Clique em Assets assets-browser na barra lateral. No navegador de ativos, selecione Fragmentos do formulário adaptável no menu suspenso.

    Você também pode optar por exibir todos os fragmentos de formulário adaptáveis ou filtrar com base em seu modelo de formulário - Modelo de formulário, Esquema XML ou Básico.

  3. Arraste e solte um fragmento de formulário adaptável no formulário adaptável.

    note note
    NOTE
    O fragmento de formulário adaptável não está ativado para criação no formulário adaptável. Além disso, não é possível usar um fragmento baseado em XSD em um formulário adaptável baseado em JSON e o oposto.

O fragmento de formulário adaptável é inserido por referência no formulário adaptável e é sincronizado com o fragmento de formulário adaptável independente. Significa que, quando você atualiza o fragmento de formulário adaptável, as alterações são refletidas em todos os formulários adaptáveis em que o fragmento é usado.

Incorporar um fragmento no formulário adaptável embed-a-fragment-in-adaptive-form

Você pode optar por incorporar um fragmento de formulário adaptável em um formulário adaptável clicando em Incorporar ativo: <fragmentName> na barra de ferramentas do painel do fragmento adicionado, conforme mostrado no exemplo de imagem a seguir.

Incorporar um fragmento de formulário no formulário adaptável

NOTE
O fragmento incorporado não está mais vinculado ao fragmento independente. Você pode editar os componentes no fragmento incorporado a partir do formulário adaptável.

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

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

Alterar fragmentos change-fragments

É possível substituir ou alterar um fragmento de formulário adaptável por outro fragmento usando o Selecionar ativo do fragmento na caixa de diálogo Editar componente para um painel de fragmento de formulário adaptável.

Gerar documento de registro para fragmento de formulário adaptável generate-DOR-for-fragments

Documento de registro (DOR) ajuda a manter as informações dos formulários no formato de impressão ou documento. Dessa forma, você poderá rastrear informações sobre seus clientes a qualquer momento posteriormente e também poderá usar o Documento de registro para arquivar formulários e conteúdo juntos no Formato PDF. Saiba como gerar documentos de registro para fragmentos de formulário adaptável.

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 baseado em esquema várias vezes em um Formulário adaptável para salvar dados exclusivamente para cada campo de fragmento 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.

uso de vários fragmentos no formulário adaptável

NOTE
  • Se você usar fragmentos de formulário com base em nenhum várias vezes em um formulário adaptável, ocorre a sincronização de dados entre os campos dos fragmentos. O problema de sincronização de dados não ocorre em fragmentos de formulário baseados em componentes principais, em que você pode usar um fragmento baseado em esquema ou em nenhum várias vezes em um formulário.

Mapeamento automático de fragmentos para associação de dados auto-mapping-of-fragments-for-data-binding

Ao criar um fragmento de formulário adaptável usando um modelo de formulário XFA ou tipo complexo XSD e arrastar e soltar o fragmento em um formulário adaptável, o fragmento XFA ou o tipo complexo XSD é substituído automaticamente pelo fragmento de formulário adaptável correspondente cuja raiz do modelo de fragmento é mapeada para o fragmento XFA ou o Tipo complexo XSD.

É possível alterar o ativo do fragmento e suas associações na caixa de diálogo Editar componente.

NOTE
Você também pode arrastar e soltar um fragmento de formulário adaptável vinculado da biblioteca de fragmentos de formulário adaptável no localizador de conteúdo do AEM e fornecer a referência de vinculação correta na caixa de diálogo Editar componente do painel de fragmentos de formulário adaptável.

Gerenciar fragmentos manage-fragments

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

  1. Acesse https://[hostname]:'port'/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
Abrir
Abre o fragmento de formulário adaptável selecionado no modo de edição.
Propriedades da exibição
Abre o painel Propriedades. No painel Propriedades, é possível visualizar e editar propriedades, gerar uma visualização e fazer upload de uma imagem em miniatura para o fragmento selecionado. Para obter mais informações, consulte Gerenciamento de metadados.
Copiar
Copia o fragmento selecionado. O botão Colar aparece na barra de ferramentas.
Download
Baixa o fragmento selecionado.
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 Visualizar um formulário.
Iniciar revisão/Gerenciar revisão
Permite iniciar e gerenciar uma revisão do fragmento selecionado. Para obter mais informações, consulte Criar e gerenciar revisões.
Criar dicionário
Gera um dicionário para localizar o fragmento selecionado. Para obter mais informações, consulte Localização de formulários adaptáveis.
Publish / Cancelar publicação
Publica/cancela a publicação do fragmento selecionado.
Excluir
Exclui o fragmento selecionado.

Localização do formulário adaptável contendo fragmentos localizing-adaptive-form-containing-fragments

Para localizar um formulário adaptável que contenha fragmentos de formulário adaptáveis, você deve localizar o fragmento e o formulário separadamente. A ideia é localizar um fragmento uma vez e reutilizá-lo em vários formulários adaptáveis.

NOTE
As chaves de localização no fragmento não aparecem no arquivo XLIFF para um formulário adaptável.

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.
  • Em um formulário adaptável baseado em XDP, se você salvar um painel como fragmento que inclui outro fragmento XDP, o fragmento resultante será vinculado automaticamente ao fragmento XDP secundário. Se houver um formulário adaptável baseado em XSD, o fragmento resultante será vinculado à raiz do esquema.
  • Ao criar um fragmento de formulário adaptável, um nó de fragmento é criado, o que é semelhante ao nó guideContainer de um formulário adaptável, no CRXDE Lite.
  • Um fragmento em um formulário adaptável que usa um modelo de dados de formulário diferente não é compatível. Por exemplo, um fragmento baseado em XDP não é compatível em um formulário adaptável baseado em XSD e vice-versa.
  • Os fragmentos de formulário adaptáveis estão disponíveis para uso por meio da guia Fragmentos de formulário adaptáveis no localizador de conteúdo de AEM.
  • 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 dentro de um formulário adaptável. Para editar, edite o fragmento de formulário adaptável independente ou incorpore o fragmento no formulário adaptável.
  • Ao publicar um formulário adaptável, é necessário publicar os fragmentos de formulário adaptável independente inseridos pela referência no formulário adaptável.
  • Quando você republica um fragmento de formulário adaptável atualizado, as alterações refletem nas instâncias publicadas do formulário adaptável em que o fragmento é usado.
  • O formulário adaptável contendo o componente Verificar não é compatível com usuários anônimos. Além disso, não é recomendável usar o componente Verificar em um fragmento de formulário adaptável.
  • (Somente Mac) Para garantir que os fragmentos de formulário funcionalidade funciona perfeitamente em todos os cenários, adicione a seguinte entrada ao arquivo /private/etc/hosts:
    127.0.0.1 <Host machine> Máquina host: a máquina do Apple Mac na qual o AEM Forms é implantado.

Fragmentos de referência reference-fragments

Os fragmentos de formulário adaptáveis de referência que você pode usar para criar seu formulário estão disponíveis. Para obter mais informações, consulte Fragmentos de referência.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2