Ativar os componentes principais adaptáveis do Forms no AEM 6.5 Forms enable-adaptive-forms-core-components
Habilitar os Componentes Principais do Forms Adaptive permite começar a criar, publicar e entregar o Forms Adaptive baseado nos Componentes Principais e o Forms Adaptive Headless do seu ambiente do AEM 6.5 Forms.
Para habilitar os Componentes principais do Adaptive Forms no ambiente do AEM 6.5 Forms, configure e implante um projeto baseado no Arquétipo AEM 41 ou posterior (com as opções de formulários habilitadas) em todas as suas instâncias de Autor e Publicação.
Este artigo fornece instruções detalhadas para configurar e implantar o projeto baseado no AEM Archetype 41 ou posterior no ambiente do AEM 6.5 Forms para ativar os Componentes principais adaptáveis do Forms. Consulte a lista abaixo para ver as versões compatíveis do AEM 6.5 para habilitar os Componentes Principais do Forms:
Pré-requisitos prerequisites
Antes de ativar os Componentes principais do Adaptive Forms em um ambiente Forms do AEM 6.5:
-
Atualize para o AEM 6.5 Forms Service Pack 16 (6.5.16.0) ou posterior.
-
Instale a última versão do Apache Maven.
-
Instale um editor de texto simples. Por exemplo, Microsoft Visual Studio Code.
Criar e implantar o projeto baseado no Arquétipo do AEM mais recente
Para criar um projeto baseado no Arquétipo AEM 41 ou mais tarde e implantá-lo em todas as instâncias de Autor e Publicação:
-
Faça logon no computador, hospedando e executando a instância do Forms do AEM 6.5, como administrador.
-
Abra o prompt de comando ou terminal e execute o seguinte comando para criar um projeto do Arquétipo do AEM (com as opções de formulários ativadas):
- Microsoft Windows
code language-shell 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.23"
- Linux ou Apple macOS
code language-shell 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.23"
Ao executar o comando acima, considere os seguintes pontos:
-
Defina a propriedade
archetypeVersion
como41
ou posterior. Para obter a versão mais recente, consulte a seção de requisitos do sistema na documentação do Arquétipo de Projetos AEM. -
Atualize o comando para refletir os valores específicos do seu ambiente, incluindo
appTitle
,appId
egroupId
. Além disso, defina o valor da propriedadeincludeFormsenrollment
comoy
. Se você usa o Forms Portal, defina a opçãoincludeExamples=y
para incluir os Componentes principais do Forms Portal no seu projeto.
-
(Somente para projetos baseados no Arquétipo versão 41) Depois que o projeto do Arquétipo do AEM for criado, ative temas para o Adaptive Forms baseado em Componentes principais. Para ativar temas:
-
Abra a [Pasta de Projeto do Arquétipo do AEM]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html para edição:
-
Adicione o seguinte código na linha 21:
code language-xml <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>
-
Salvar e fechar o arquivo.
-
-
Atualize o projeto para incluir a versão mais recente dos Componentes principais do Forms:
-
Abra a [Pasta de Projeto do Arquétipo do AEM]/pom.xml para edição.
-
Defina as versões de
core.forms.components.version
ecore.forms.components.af.version
com a versão mais recente dos Componentes Principais do Forms e verifique se ambas têm a mesma versão que os Componentes Principais do Forms mencionados na tabela, e defina a versão decore.wcm.components.version
conforme fornecido nos Componentes Principais do WCM.note warning WARNING - Ao criar um projeto do Arquétipo com versão 45, o
[AEM Archetype Project Folder]/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. Você pode encontrar a última versão no histórico de versões do AEM 6.5 Forms.
note note NOTE - Se você configurar qualquer outra topologia, adicione o envio, o preenchimento prévio e outros URLs ao incluo na lista de permissões na camada do Dispatcher.
- Ao criar um projeto do Arquétipo com versão 45, o
-
Salvar e fechar o arquivo.
-
-
Depois que o projeto do Arquétipo do AEM for criado com sucesso, crie o pacote de implantação para o seu ambiente. Para criar o pacote:
-
Navegue até o diretório raiz do seu projeto do Arquétipo AEM.
-
Execute o seguinte comando para criar o projeto do Arquétipo do AEM para o seu ambiente:
code language-shell mvn clean install
Depois que o Arquétipo do AEM for criado com êxito, um pacote do AEM será gerado. Você pode encontrar o pacote em [Pasta de Projeto do AEM Archetype]\all\target[appid].all-[version].zip
-
-
Use o Gerenciador de Pacotes para implantar o [pacote de Pasta de Projeto do Arquétipo do AEM]\all\target[appid].all-[version].zip em todas as instâncias de Autor e Publicação.
- Caso encontre dificuldades ao acessar a caixa de diálogo de logon em uma instância de publicação, para instalar o pacote por meio do Gerenciador de Pacotes, tente usar a URL:
http://[Publish Server URL]:[PORT]/system/console
para fazer logon. Isso permite que você acesse a página de logon em uma instância do Publish, permitindo que continue com o processo de instalação. - Não exclua ou descarte o projeto do Arquétipo depois de implantá-lo em seu ambiente. O projeto Arquétipo é necessário para adicionar temas personalizados e novos Componentes principais adaptáveis do Forms ao seu ambiente.
Os Componentes principais são ativados para o seu ambiente. Um modelo de Formulário adaptável baseado em Componentes principais em branco e o tema Tela 3.0 são implantados em seu ambiente, permitindo que você crie Componentes principais baseados no Forms adaptável.
Perguntas frequentes
Quais são os componentes principais?
Os Componentes principais são um conjunto de componentes padronizados de Gerenciamento de Conteúdo Online (WCM) para que o AEM acelere o tempo de desenvolvimento e reduza 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