DocumentaçãoAEM 6.5Guia do usuário

Criação de um modelo de formulário adaptável personalizado creating-a-custom-adaptive-form-template

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
NOTE
O AEM Forms introduziu os modelos dinâmicos. Você pode usar o editor de modelos do AEM Sites para criar ou editar modelos dinâmicos. Os modelos mencionados no artigo abaixo são modelos estáticos. Eles não estão disponíveis em uma instalação padrão. Instalar pacote de Compatibilidade para obter esses modelos em seu ambiente.

Pré-requisitos prerequisites

Modelo de formulário adaptável adaptive-form-template

Um modelo de formulário adaptável é um modelo de página AEM especializado, com determinadas propriedades e estrutura de conteúdo usada para criar o formulário adaptável. O modelo tem layouts, estilos e estrutura básica de conteúdo inicial pré-configurados.

Depois de criar um formulário, as alterações na estrutura do conteúdo do modelo original não serão refletidas no formulário.

Modelos de formulário adaptável padrão default-adaptive-form-templates

O AEM QuickStart fornece os seguintes modelos de formulário adaptáveis:

  • Modelo de pesquisa: permite criar um formulário adaptável de página única usando o Layout responsivo que tem várias colunas configuradas. O layout é ajustado automaticamente com base nas dimensões das várias telas nas quais você deseja exibir o formulário.
  • Modelo de inscrição simples: permite criar um formulário adaptável em várias etapas usando um layout de assistente. Nesse layout, você pode especificar uma expressão de conclusão de etapa para cada etapa, que é validada antes de o assistente prosseguir para a próxima etapa.
  • Modelo de inscrição com guias: permite criar um formulário adaptável com várias guias usando um layout de guias à esquerda, onde você pode visitar as guias em qualquer ordem aleatória.
  • Modelo de inscrição avançado: permite criar um formulário com várias guias e um assistente. Ele usa um layout de guias à esquerda que permite visitar guias em qualquer ordem. Ele usa os serviços de design da Adobe Document Cloud para assinatura e verificação.
  • Modelo em branco: permite criar um formulário sem qualquer cabeçalho, rodapé e conteúdo inicial. Você pode adicionar componentes como caixas de texto, botões e imagens. O modelo em branco permite criar um formulário que você pode incorporar nas páginas do site AEM.

Esses modelos têm a propriedade sling:resourceType definida como o componente de página correspondente. O componente Página renderiza a página CQ, contendo o contêiner de formulário adaptável, que por sua vez renderiza o formulário adaptável.

A tabela a seguir enumera a associação entre os modelos e o componente de página:

Modelo
Componente de Página
/libs/fd/af/templates/surveyTemplate
/libs/fd/af/components/page/survey
/libs/fd/af/templates/simpleEnrollmentTemplate
/libs/fd/af/components/page/base
/libs/fd/af/templates/tabbedEnrollmentTemplate
/libs/fd/af/components/page/tabbedenrollment
/libs/fd/afaddon/templates/advancedEnrollmentTemplate
/libs/fd/afaddon/components/page/advanced/enrollment

Criação de um modelo de formulário adaptável usando o editor de modelos creating-an-adaptive-form-template-using-template-editor

Você pode especificar a estrutura e o conteúdo inicial de um formulário adaptável usando o Editor de modelos. Por exemplo, você deseja que todos os autores de formulário tenham poucas caixas de texto, botões de navegação e um botão de envio em um formulário de inscrição. Você pode criar um modelo que os autores podem usar para criar um formulário consistente com outros formulários de inscrição. O Editor de modelo AEM permite:

  • Adicionar componentes de cabeçalho e rodapé de um formulário na camada da estrutura
  • Forneça o conteúdo inicial para o formulário.
  • Especifique um tema.
  • Especifique ações como enviar, redefinir e navegar.

Para obter mais informações, consulte Editor de modelos.

Criação de um modelo de formulário adaptável a partir do CRXDE creating-an-adaptive-form-template-from-crxde

Em vez de usar os modelos disponíveis, você pode criar um modelo e usá-lo para criar formulários adaptáveis. Os modelos personalizados são baseados em vários componentes de página que fazem referência a contêineres de formulário adaptável e elementos de página, como cabeçalho e rodapé.

Você pode criar esses componentes usando o componente de página base para seu site. Como alternativa, é possível estender o componente de página do formulário adaptável que os modelos prontos para uso usam.

Execute as seguintes etapas para criar um modelo personalizado, como simpleEnrollmentTemplate.

  1. Navegue até o CRXDE Lite na instância de criação.

  2. No diretório /apps, crie a estrutura de pastas para o aplicativo. Por exemplo, se o nome do aplicativo for mycompany, crie uma pasta com esse nome. Normalmente, a pasta do aplicativo contém componentes, configuração, modelos, src e diretórios de instalação. Para este exemplo, crie as pastas de componentes, configuração e modelos.

  3. Navegue até a pasta /libs/fd/af/templates.

  4. Copie o nó simpleEnrollmentTemplate.

  5. Navegue até a pasta /apps/mycompany/templates. Clique com o botão direito do mouse e selecione Colar.

  6. Se necessário, renomeie o nó do modelo copiado. Por exemplo, renomeie-o como enrollment-template.

  7. Navegue até o local /apps/mycompany/templates/enrollment-template.

  8. Modifique as propriedades jcr:title e jcr:description do nó jcr:content para distinguir o modelo do modelo copiado.

  9. O nó jcr:content do modelo modificado contém os componentes guideContainer e guideformtitle. guideContainer é o contêiner que contém o formulário adaptável. O componente guideformtitle exibe o nome, a descrição do aplicativo etc.

    Em vez de guideformtitle, inclua um componente personalizado ou o componente parsys. Por exemplo, remova guideformtitle e adicione um componente personalizado ou o nó de componente parsys. Verifique se a propriedade sling:resourceType do componente faz referência ao componente e se a mesma propriedade está definida no arquivo de página component.jsp.

  10. Navegue até o local /apps/mycompany/templates/enrollment-template/jcr:content.

  11. Abra a guia Propriedades e altere o valor da propriedade cq:designPath para /etc/designs/mycompany.

  12. Agora crie um nó /etc/designs/mycompany para o tipo cq:Page.

Criar um componente de página de formulário adaptável create-an-adaptive-form-page-component

O modelo personalizado tem o mesmo estilo do modelo padrão, pois o modelo faz referência ao componente de página /libs/fd/af/components/page/base. Você pode encontrar a referência do componente como a propriedade sling:resourceType definida no nó /apps/mycompany/templates/enrollment-template/jcr:content. Como a base é um componente principal do produto, não modifique esse componente.

  1. Navegue até o nó /apps/mycompany/templates/enrollment-template/jcr:content e modifique o valor da propriedade sling:resourceType para /apps/mycompany/components/page/enrollmentpage

  2. Copie o nó /libs/fd/af/components/page/base para a pasta /apps/mycompany/components/page.

  3. Renomeie o componente copiado para enrollmentpage.

  4. (Somente se você já tiver uma contentpage) Execute as seguintes etapas (a-d), se você tiver um componente contentpage existente para o seu site. Se você não tiver um componente contentpage existente para o seu site, poderá deixar a propriedade resourceSuperType para apontar para a página base pronta para uso.

    1. Para o nó enrollmentpage, defina o valor da propriedade sling:resourceSuperType como mycompany/components/page/contentpage. O componente contentpage é o componente da página base do site. Outros componentes da página podem estendê-la. Remover arquivos de script em enrollmentpage, exceto head.jsp, content.jsp e library.jsp. O componente sling:resourceSuperType, que é contentpage neste caso, inclui todos esses scripts. Os cabeçalhos, incluindo a barra de navegação e o rodapé, são herdados do componente contentpage.

    2. Abra o arquivo head.jsp.

      O arquivo JSP contém a linha <cq.include script="library.jsp"/>.

      O arquivo library.jsp contém a biblioteca do cliente guide.theme.simpleEnrollment, que contém o estilo do formulário adaptável.

      O componente de página enrollmentpage tem um arquivo head.jsp exclusivo que substitui o arquivo head.jsp do componente contentpage.

    3. Incluir todos os scripts no arquivo head.jsp do componente contentpage no arquivo head.jsp do componente enrollmentpage.

    4. No script content.jsp, é possível adicionar conteúdo de página adicional ou referências a outros componentes incluídos quando uma página é renderizada. Por exemplo, se você adicionar o componente personalizado applicationformheader, certifique-se de adicionar a seguinte referência ao componente no arquivo JSP:

      <cq:include path="applicationformheader" resourceType="mycompany/components/applicationformheader"/>

      Da mesma forma, se você adicionar um componente parsys na estrutura do nó do modelo, inclua também o componente personalizado.

Criação de uma biblioteca de cliente de formulários adaptável creating-an-adaptive-form-client-library

O arquivo head.jsp do componente enrollmentpage para o novo modelo inclui uma biblioteca cliente guide.theme.simpleEnrollment. O template padrão também usa essa biblioteca do cliente. Altere o estilo no novo modelo usando um destes métodos:

  • Defina um tema personalizado e substitua o tema padrão guide.theme.simpleEnrollment pelo tema personalizado.
  • Defina uma nova biblioteca do cliente em /etc/designs/mycompany. Inclua a biblioteca do cliente após a entrada de tema padrão na página jsp. Incluir todos os estilos substituídos e arquivos Java Script adicionais nesta biblioteca do cliente.
NOTE
O tema se refere a uma biblioteca do cliente incluída no componente Página usado para renderizar um formulário adaptável. A biblioteca do cliente rege principalmente a aparência de um formulário adaptável.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2