Fragmentos de formulário adaptáveis

Embora cada formulário seja projetado para uma finalidade específica, há alguns segmentos comuns na maioria das formas, como para fornecer detalhes pessoais, como nome e endereço, detalhes familiares, detalhes de renda e assim por diante. Os desenvolvedores de formulários precisam criar esses segmentos comuns sempre que um novo formulário for criado.

Formulários adaptáveis fornecem um mecanismo conveniente para criar segmentos de formulários, como um painel ou um grupo de campos, somente uma vez e reutilizá-los em formulários adaptáveis. Esses segmentos reutilizáveis e independentes são chamados de fragmentos de formulário adaptáveis.

Criar um fragmento

É 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

1. Efetue login na instância do autor do AEM Forms em https://[nome do host]:[porta]/aem/forms.html.

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

3. Especifique o título, o nome, a descrição e as tags do fragmento.

   OBSERVAÇÃO

   Certifique-se de especificar um nome exclusivo para o fragmento. Se já existir outro fragmento com o mesmo nome, o fragmento não será criado.

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

   • Nenhum: Especifica a criação do fragmento do zero sem usar qualquer modelo de formulário.
   • Modelo de formulário: Especifica a criação do fragmento usando um modelo XDP carregado no AEM Forms. Selecione o modelo XDP apropriado como o modelo de formulário para o fragmento.

   

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

   

   Além disso, é possível 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.

   • SCHEMA XML: Especifica a criação do fragmento usando um schema XML carregado no AEM Forms. É possível carregar ou selecionar entre os schemas XML disponíveis como o modelo de formulário para o fragmento.

   

   Também é possível criar um fragmento de formulário adaptável selecionando um complexType presente no schema selecionado na caixa suspensa.

   

5. Clique em Criar e, em seguida, clique em Abrir 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 AEM para o fragmento. Para obter informações sobre componentes de formulário adaptáveis, consulte Introdução à criação de formulários adaptáveis.

Além disso, se você selecionou um schema XML ou modelo de formulário XDP como o modelo de formulário para o fragmento, uma nova guia exibindo a hierarquia do modelo de formulário será exibida no localizador de conteúdo. Ela permite arrastar e soltar elementos de modelo de formulário no fragmento. Os elementos de modelo de formulário adicionados são convertidos em componentes de formulário enquanto mantêm as propriedades originais do XDP ou XSD associado.

Salvar painel como um fragmento

1. Abra um formulário adaptável que contenha o painel que 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.

   OBSERVAÇÃO

   Se o painel que você está salvando como fragmento contiver o painel filho, o fragmento resultante os incluirá.

3. Na caixa de diálogo Criação de fragmentos, especifique as seguintes informações:

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

     OBSERVAÇÃO

     Certifique-se de especificar um nome exclusivo para o fragmento. Se já 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 do público alvo: Caminho do repositório no qual o fragmento será salvo. Se um caminho não for especificado, 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 o Schema ​​XML, o Modelo de formulário ou Nenhum. É um campo não editável.

   • Raiz do modelo de fragmento: Aparece somente em formulários adaptativos baseados em XSD. Especifica a raiz do modelo de fragmento. Você pode escolher / ou o tipo complexo XSD no menu suspenso. Observe que é possível reutilizar o fragmento em outro formulário adaptável somente se você 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 estará visível na guia do 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 de modelo de dados de formulário adaptável.

   • Ref XSD: Aparece somente em formulários adaptativos baseados em XSD. Ele exibe o local do schema XML.

   • Ref XDP: Aparece somente em formulários adaptativos baseados em XDP. Ele exibe o local do modelo de formulário XDP.

   

   Caixa de diálogo Salvar como fragmento

4. Clique em OK.

   O painel é salvo no local especificado 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 filhos, 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.

   

Trabalhar com fragmentos

Configurar a aparência do fragmento

Qualquer fragmento inserido em formulários adaptáveis aparece como uma imagem de espaço reservado. O espaço reservado exibe títulos de até um máximo de dez painéis filhos no fragmento. Você pode configurar o AEM Forms para mostrar o fragmento completo em vez da imagem de espaço reservado.

Execute as seguintes etapas para mostrar fragmentos completos em formulários:

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

2. Pesquise e clique em Serviço de configuração de formulário adaptável para abri-lo no modo de edição.

3. Desative a caixa de seleção Ativar espaço reservado no lugar da caixa de seleção Fragmento para mostrar fragmentos completos em vez da imagem de espaço reservado.

Inserir um fragmento em um formulário adaptável

Os fragmentos de formulário adaptável criados são exibidos na guia Fragmentos de formulário adaptáveis do localizador de conteú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 na barra lateral. No navegador de ativos, selecione Fragmentos de formulário adaptáveis 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, Schema XML ou Básico.

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

   OBSERVAÇÃO

   O fragmento de formulário adaptável não está habilitado para criação a partir do 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 da maneira oposta.

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 autônomo. Isso significa que, ao atualizar o fragmento do formulário adaptável, as alterações são refletidas em todos os formulários adaptáveis nos quais o fragmento é usado.

Incorporar um fragmento na forma adaptativa

Você pode optar por incorporar um fragmento de formulário adaptável em um formulário adaptável clicando em Incorporar ativo: O botão <fragmentName na barra de ferramentas do painel do fragmento adicionado, como mostrado na seguinte imagem de exemplo.

Uso de fragmentos em fragmentos

É 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

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

Mapeamento automático de fragmentos para vínculo de dados

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

É possível alterar o ativo do fragmento e seus vínculos na caixa de diálogo Editar componente.

Gerenciar fragmentos

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

1. Ir para https://[hostname]:'port'/aem/forms.html.

2. Clique em Selecione 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.

Localização de formulários adaptáveis contendo fragmentos

Para localizar um formulário adaptável que contenha fragmentos de formulário adaptáveis, é necessário 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.

Pontos chave a serem lembrados ao trabalhar com fragmentos

• Verifique se o nome do fragmento é exclusivo. O fragmento não será 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 filho. No caso de um formulário adaptável baseado em XSD, o fragmento resultante será vinculado à raiz do schema.
• Quando você cria um fragmento de formulário adaptável, um nó de fragmento é criado, que é semelhante ao nó guideContainer para 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 é suportado. Por exemplo, um fragmento baseado em XDP não é suportado 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 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 independentes inseridos por referência no formulário adaptável.
• Quando um fragmento de formulário adaptável atualizado é publicado novamente, as alterações são refletidas nas instâncias publicadas do formulário adaptável no qual o fragmento é usado.
• O formulário adaptável que contém o componente Verify não suporta usuários anônimos. Além disso, não é recomendado usar o componente Verify em um fragmento de formulário adaptável.
• (Somente Mac) Para garantir que a funcionalidade de fragmentos de formulário funcione 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 Apple Mac na qual o AEM Forms é implantado.

Fragmentos de referência

Os fragmentos de formulário adaptável de referência que podem ser usados para criar o formulário estão disponíveis. Para obter mais informações, consulte Fragmentos de referência.