Ativar os componentes principais adaptáveis do Forms no AEM 6.5 Forms

Aplicável a: ✔ Componentes Principais Do Formulário Adaptável ❎ Componentes De Base Do Formulário Adaptável.

Habilitar os Componentes principais adaptáveis do Forms permite que você comece a criar, publicar e fornecer Forms adaptável baseado em componentes principais e Forms adaptável headless do seu ambiente AEM 6.5 Forms.

Para ativar os Componentes principais do Adaptive Forms no ambiente AEM 6.5 Forms, configure e implante um Arquétipo AEM 41 ou posterior projeto baseado em (com as opções de formulários ativadas) em todas as instâncias do Autor e de Publicação.

Este artigo fornece instruções detalhadas para configurar e implantar o Arquétipo AEM 41 ou posterior com base em seu ambiente AEM 6.5 Forms para ativar os Componentes principais adaptáveis do Forms. Consulte a lista abaixo para obter AEM 6.5 versões compatíveis para ativar os Componentes principais do Forms:

Pré-requisitos

Antes de ativar os Componentes principais do Adaptive Forms em um ambiente AEM 6.5 Forms:

• Atualizar para AEM 6.5 Forms Service Pack 16 (6.5.16.0) ou posterior.

• Instale a versão mais recente do Apache Maven.

• Instale um editor de texto simples. Por exemplo, Microsoft Visual Studio Code.

Criar e implantar o projeto mais recente baseado no Arquétipo AEM

Para criar um Arquétipo AEM 41 ou posteriormente projeto baseado em e implantá-lo em todas as suas instâncias de Autor e Publicação:

1. Faça logon no computador, hospedando e executando a instância do Forms AEM 6.5, como administrador.

2. Abra o prompt de comando ou terminal e execute o seguinte comando para criar um projeto do Arquétipo AEM (com as opções de formulários ativadas):

   • Microsoft Windows

      mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate ^
      -D archetypeGroupId=com.adobe.aem ^
      -D archetypeArtifactId=aem-project-archetype ^
      -D archetypeVersion=41 ^
      -D appTitle="My Form" ^
      -D appId="myform" ^
      -D groupId="com.myform" ^
      -D includeFormsenrollment="y" ^
      -D aemVersion="6.5.15"
   

   • Linux ou Apple macOS

      mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \
      -D archetypeGroupId=com.adobe.aem \
      -D archetypeArtifactId=aem-project-archetype \
      -D archetypeVersion=41 \
      -D appTitle="My Form" \
      -D appId="myform" \
      -D groupId="com.myform" \
      -D includeFormsenrollment="y" \
      -D aemVersion="6.5.15"
   

   Ao executar o comando acima, considere os seguintes pontos:

   • Não altere o valor de aemVersion propriedade de 6.5.15.0 a qualquer outra coisa.

   • Defina o archetypeVersion propriedade para 41 ou posteriormente. Para obter a versão mais recente, consulte a seção requisitos de sistema em Arquétipo de projeto AEM documentação.

   • Atualize o comando para refletir os valores específicos do seu ambiente, incluindo o appTitle, appId, e groupId. Além disso, defina o valor do includeFormsenrollment propriedade para y. Se você usa o Forms Portal, defina a variável includeExamples=y opção para incluir os Componentes principais do Forms Portal no projeto.

3. (Somente para projetos baseados no Arquétipo versão 41) Depois que o projeto Arquétipo AEM for criado, ative temas para o Forms adaptável baseado em Componentes principais. Para ativar temas:

   1. Abra o [Pasta de projeto do arquétipo AEM]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html para edição:

   2. Adicione o seguinte código na linha 21:

      <sly data-sly-use.clientlib="core/wcm/components/commons/v1/templates/clientlib.html"
      data-sly-use.formstructparser="com.adobe.cq.forms.core.components.models.form.FormStructureParser"
      data-sly-test.themeClientLibRef="${formstructparser.themeClientLibRefFromFormContainer}">
      <sly data-sly-test="${themeClientLibRef}" data-sly-call="${clientlib.css @ categories=themeClientLibRef}"/>
      </sly>
      

      

   3. Salvar e fechar o arquivo.

4. Atualize o projeto para incluir a versão mais recente dos Componentes principais do Forms:

   1. Abra o [Pasta de projeto do arquétipo AEM]/pom.xml para edição.

   2. Definir versão de core.forms.components.version e core.forms.components.af.version para Componentes principais mais recentes do Forms e garantir que ambas tenham a mesma versão que Componentes principais do Forms mencionado na tabela e defina a versão de core.wcm.components.version conforme indicado na Componentes principais do WCM.

      AVISO

      • Ao criar um projeto do Arquétipo com o version 45, o [Pasta de projeto do arquétipo AEM]/pom.xml define inicialmente a versão dos componentes principais de formulários como 1.1.28. Antes de criar ou implantar o projeto Arquétipo, atualize a versão dos componentes principais de formulários para 1.1.26.
      OBSERVAÇÃO

      • Se você configurar qualquer outra topologia, adicione o envio, o preenchimento prévio e outros URLs ao arquivo de inclui na lista de permissões na camada do Dispatcher.

   3. Salvar e fechar o arquivo.

5. Depois que o projeto do Arquétipo AEM for criado com êxito, crie o pacote de implantação para o seu ambiente. Para criar o pacote:

   1. Navegue até o diretório raiz do projeto do Arquétipo AEM.

   2. Execute o seguinte comando para criar o projeto do Arquétipo AEM para o seu ambiente:

      mvn clean install
      

      

   Depois que o projeto do Arquétipo AEM é criado com êxito, um pacote AEM é gerado. Você pode encontrar o pacote em [Pasta de projeto do arquétipo AEM]\all\target[appid].all-[version].zip

6. Use o Gerenciador de pacotes para implantar o [Pasta de projeto do arquétipo AEM]\all\target[appid].all-[version]pacote .zip em todas as instâncias Autor e Publicar.

Os Componentes principais são ativados para o seu ambiente. Um modelo de Formulário adaptável e um tema da Tela 3.0 em branco dos Componentes principais são implantados em seu ambiente, permitindo criar Componentes principais com base no Forms adaptável.

Perguntas frequentes

Quais são os componentes principais?

A variável Componentes principais são um conjunto de componentes padronizados de Gerenciamento de Conteúdo na Web (WCM, na sigla em inglês) para o AEM a fim de acelerar o tempo de desenvolvimento e reduzir o custo de manutenção de seus sites.

Quais são os recursos adicionados à habilitação dos componentes principais?

Quando os Componentes principais do Forms adaptável estiverem ativados para seu ambiente, um modelo de Formulário adaptável baseado em Componentes principais em branco e o tema do Canvas 3.0 serão adicionados ao seu ambiente. Depois de ativar os Componentes principais adaptáveis do Forms no seu ambiente, você pode:

• Crie Componentes principais com base no Forms adaptável.
• Crie Componentes principais com base em modelos de formulário adaptável.
• Crie temas personalizados para os Componentes principais com base em modelos de Formulário adaptável.
• Servir representações JSON do Formulário adaptável com base no Componente principal para canais como dispositivos móveis, Web, aplicativos nativos e serviços que exigem a representação headless de um formulário.

O que vem a seguir

• Criar um formulário adaptável baseado nos Componentes principais
• Criar ou adicionar um formulário adaptável a uma página do AEM Sites ou a um fragmento de experiência
• Criar temas para Forms adaptável com base em Componentes principais
• Criar um modelo para os Componentes principais com base no Forms adaptável