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 Componentes principais baseados no Forms Adaptive e Forms AEM Adaptive Headless do seu ambiente do 6.5 Forms.
Para habilitar os Componentes principais do Adaptive Forms no ambiente do Forms AEM AEM 6.5, configure e implante um projeto baseado no Arquétipo do 41 ou posterior (com opções de formulários habilitadas) em todas as instâncias do Author e do Publish.
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 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 AEM 6.5 Forms:
-
Atualize para 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 mais recente baseado no Arquétipo AEM
Para criar um projeto com base no Arquétipo AEM 41 ou posterior e implantá-lo em todas as instâncias do Autor e do Publish:
-
Faça logon no computador, hospedando e executando a instância do Forms AEM 6.5, como administrador.
-
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
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.15"
- 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.15"
Ao executar o comando acima, considere os seguintes pontos:
-
Não altere o valor da propriedade
aemVersion
de6.5.15.0
para outra coisa. -
Defina a propriedade
archetypeVersion
como41
ou posterior. Para obter a versão mais recente, consulte a seção requisitos do sistema na documentação do Arquétipo de projeto do 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 Arquétipo AEM for criado, ative temas para o Forms adaptável baseado em Componentes principais. Para ativar temas:
-
Abra a [Pasta de Projeto do Arquétipo 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 do Projeto do Arquétipo 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 Forms do AEM 6.5.
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 AEM for criado com êxito, crie o pacote de implantação para o seu ambiente. Para criar o pacote:
-
Navegue até o diretório raiz do projeto do Arquétipo AEM.
-
Execute o seguinte comando para criar o projeto do Arquétipo AEM para o seu ambiente:
code language-shell 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
-
-
Use o Gerenciador de Pacotes para implantar o pacote [Pasta do Projeto do Arquétipo AEM]\all\target[appid].all-[version].zip em todas as instâncias do Autor e do Publish.
- 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, o que permite prosseguir 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 na Web (WCM) 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