Configurar um ambiente de desenvolvimento local e um projeto de desenvolvimento inicial

Ao instalar e configurar um ​ Adobe Experience Manager Forms as a ​ Cloud Service , você configura ambientes de desenvolvimento, de preparo e de produção na nuvem. Além disso, também é possível definir e configurar um ambiente de desenvolvimento local.

Você pode usar o ambiente de desenvolvimento local para executar as seguintes ações sem fazer logon no ambiente de desenvolvimento da nuvem:

• Criar formulários e ativos relacionados (temas, modelos, ações enviar personalizadas e muito mais)
• Converter formulários PDF em formulários adaptáveis
• Criar aplicativos para gerar Comunicações do cliente por demanda ou em modos de lote.

Depois que um Formulário adaptável ou ativos relacionados estiverem prontos na instância de desenvolvimento local ou em um aplicativo para gerar [Comunicações do cliente] estiver pronto, você poderá exportar o formulário adaptável ou o aplicativo de comunicações do cliente do ambiente de desenvolvimento local para um ambiente Cloud Service para testes adicionais ou migração para ambientes de produção.

Você também pode desenvolver e testar o código personalizado, como componentes personalizados e preencher o serviço no ambiente de desenvolvimento local. Quando o código personalizado for testado e estiver pronto, você poderá usar o repositório Git do seu ambiente de desenvolvimento de Cloud Service para implantar o código personalizado.

Para configurar um novo ambiente de desenvolvimento local e usá-lo para desenvolver atividades do, execute as seguintes ações na ordem listada:

• Configurar ferramentas de desenvolvimento

• Configurar instâncias locais de Autor e Publicação

• Adicionar arquivo do Forms às instâncias de desenvolvimento locais e configurar usuários

• Configurar ambiente de desenvolvimento local para microsserviços

• Configurar um projeto de desenvolvimento

• Configurar ferramentas locais do Dispatcher

Pré-requisitos

Você precisa do seguinte software para configurar um ambiente de desenvolvimento local. Baixe-os antes de começar a configurar o ambiente de desenvolvimento local:

Baixar a versão mais recente do software da Distribuição de software

Para baixar a versão mais recente do SDK do Adobe Experience Manager as a Cloud Service, o arquivo de recursos do Experience Manager Forms (complemento do AEM Forms), os ativos de referência de formulários ou o Forms Designer no Distribuição de software:

1. Efetue logon no https://experience.adobe.com/#/downloads com o seu Adobe ID

   OBSERVAÇÃO

   Sua organização de Adobe deve ser provisionada para o AEM as a Cloud Service AEM as a Cloud Service baixar o SDK do.

2. Navegue até a AEM as a Cloud Service guia.

3. Classifique por data de publicação em ordem decrescente.

4. Clique no SDK do Adobe Experience Manager as a Cloud Service mais recente, no arquivo de recursos do Experience Manager Forms (complemento do AEM Forms), nos ativos de referência de formulários ou no Forms Designer.

5. Revise e aceite o EULA. Toque no Baixar botão.

Configurar ferramentas de desenvolvimento para Projetos AEM

O projeto do Adobe Experience Manager Forms é uma base de código personalizada. Ele contém código, configurações e conteúdo que são implantados por meio do Cloud Manager para Adobe Experience Manager as a Cloud Service. A variável Arquétipo Maven do projeto AEM O fornece a estrutura de linha de base para o projeto.

Configure as seguintes ferramentas de desenvolvimento para usar no Adobe Experience Manager projeto de desenvolvimento:

• Java™
• Git
• Node.js (npm)
• Maven

Para obter instruções detalhadas sobre como configurar as ferramentas de desenvolvimento mencionadas anteriormente, consulte Configurar ferramentas de desenvolvimento.

Configurar o ambiente de Experience Manager local para desenvolvimento

O SDK do Cloud Service fornece um arquivo QuickStart. Ele executa uma versão local do Experience Manager. Execute as instâncias Autor ou Publicar localmente.

Embora o QuickStart forneça uma experiência de desenvolvimento local, ele não tem todos os recursos disponíveis no Adobe Experience Manager as a Cloud Service. Assim, sempre teste seus recursos e código com Adobe Experience Manager Ambiente de desenvolvimento as a Cloud Service antes de mover os recursos para o estágio ou produção.

Para instalar e configurar o ambiente de Experience Manager local, execute as seguintes etapas:

• Baixar e extrair o Adobe Experience Manager AS A CLOUD SERVICE SDK
• Configurar uma instância de autor
• Configurar uma instância de publicação

Adicionar arquivo do Forms às instâncias locais de Autor e Publicação e configurar usuários específicos do Forms

Execute as seguintes etapas na ordem listada para adicionar o arquivo Forms às instâncias Experience Manager e configurar usuários específicos de formulários:

Instale o arquivo de recursos complementares mais recente do Forms

O arquivo de recursos as a Cloud Service do Adobe Experience Manager Forms fornece ferramentas para criar, estilizar e otimizar o Adaptive Forms no ambiente de desenvolvimento local. Instale o pacote para criar um Formulário adaptável e usar vários outros recursos do AEM Forms. Para instalar o pacote:

1. Baixe e extraia a versão mais recente AEM Forms arquive para seu sistema operacional em Distribuição de software.

2. Navegue até o diretório crx-quickstart/install. Caso a pasta não exista, crie-a.

3. Interrompa a instância do AEM, coloque o AEM Forms arquivo de recursos complementar, aem-forms-addon-<version>.far, na pasta de instalação e reinicie a instância.

Configurar usuários e permissões

Crie usuários como Desenvolvedor de formulários e Profissional de formulários e adicionar esses usuários a grupos de formulários predefinidos para fornecer as permissões necessárias. A tabela abaixo lista todos os tipos de usuários e grupos predefinidos para cada tipo de usuários de formulários:

Configurar o ambiente de desenvolvimento local para o Documento de registro (DoR)

O AEM Forms as a Cloud Services fornece um ambiente de SDK baseado em docker para facilitar o desenvolvimento do Documento de registro e o uso de outros microsserviços. Isso libera você da configuração manual de binários e adaptações específicos da plataforma. Para configurar o ambiente:

1. Instalar e configurar o Docker:

   • (Para Microsoft® Windows) Instalar Desktop Docker. Ele configura Docker Engine e docker-compose na sua máquina.

   • Instalação do (Apple macOS) Desktop Docker para Mac. Ele inclui Docker Engine, cliente Docker CLI, Docker Compose, Docker Content Trust, Kubernetes e Credential Helper.

   • (Para Linux®) Instalar Mecanismo do Docker e Composição do Docker na sua máquina.

   OBSERVAÇÃO

   • Para o Apple macOS lista de permissões, procure pastas contendo instâncias locais do AEM Author.

   • O Docker Desktop para Windows suporta dois back-ends, Hyper-V
     (herdado) e WSL2 (moderno). O compartilhamento de arquivos é automaticamente
     gerenciado pelo Docker ao usar o WSL2 (moderno). Você precisa
     configure explicitamente o compartilhamento de arquivos ao usar o Hyper-V (herdado).

2. Crie uma pasta, digamos o aem-sdk, em paralelo às instâncias de autor e publicação. Por exemplo, C:\aem-sdk.

3. Extraia o aem-forms-addon-<version>.zip\aem-forms-addon-native-<version>.zip arquivo.

   

4. Crie uma variável de ambiente AEM_HOME e aponte para a instalação local do AEM Author. Por exemplo, C:\aem\author.

5. Abra sdk.bat ou sdk.sh para edição. Defina o AEM_HOME para apontar para a instalação local do AEM Author. Por exemplo, C:\aem\author.

6. Abra o prompt de comando e navegue até o aem-forms-addon-native-<version> pasta.

7. Certifique-se de que a instância local do AEM Author esteja ativa e em execução. Execute o seguinte comando para iniciar o SDK:

   • (no Microsoft® Windows) sdk.bat start
   • (no Linux® ou Apple macOS) AEM_HOME=[local AEM Author installation] ./sdk.sh start
   OBSERVAÇÃO

   Se você tiver definido a variável de ambiente no arquivo sdk.sh, especificá-la na linha de comando é opcional. A opção para definir a variável de ambiente na linha de comando é fornecida para executar o comando sem atualizar o script de shell.

   

Agora você pode usar o ambiente de desenvolvimento local para renderizar o Documento de registro. Para testar, carregue um arquivo XDP no seu ambiente e renderize-o. Por exemplo, http://localhost:4502/libs/xfaforms/profiles/default.print.pdf?template=crx:///content/dam/formsanddocuments/cheque-request.xdp converte o arquivo XDP para o documento PDF.

Configurar um projeto de desenvolvimento para o Forms com base no arquétipo de Experience Manager

Use este projeto para criar o Adaptive Forms, implantar atualizações de configuração, sobreposições, criar componentes de Formulário adaptável personalizados, testar e personalizar código no local Experience Manager Forms SDK. Após os testes locais, é possível implantar o projeto em Experience Manager Forms Ambientes as a Cloud Service de produção e não produção. Quando você implanta o projeto, os seguintes ativos do AEM Forms também são implantados:

Para configurar o projeto:

1. Clonar o repositório Git do Cloud Manager na instância de desenvolvimento local: Seu repositório Git do Cloud Manager contém um projeto AEM padrão. Baseia-se no Arquétipo AEM. Clonar o Repositório Git do Cloud Manager usando o Gerenciamento de conta Git por autoatendimento da interface do usuário do Cloud Manager para trazer o projeto para o ambiente de desenvolvimento local. Para obter detalhes sobre o acesso ao repositório, consulte Acessar repositórios.

2. Criar um Experience Manager Forms as a [Cloud Service] projeto: Criar um Experience Manager Forms as a [Cloud Service] projeto com base no mais recente Arquétipo AEM ou posteriormente. O arquétipo ajuda os desenvolvedores a iniciar o desenvolvimento facilmente para AEM Forms as a Cloud Service. Ele também inclui alguns exemplos de temas e modelos para ajudá-lo a começar rapidamente.

   Abra o prompt de comando e execute o comando abaixo para criar uma Experience Manager Forms as a Cloud Service projeto.

   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=mysite -D appId=mysite -D groupId=com.mysite -D includeFormsenrollment="y" -D aemVersion="cloud"
   

   Altere o appTitle, appId, e groupId no comando acima para refletir seu ambiente. Além disso, defina o valor de includeFormsenrollment, includeFormscommunications e includeFormsheadless como y ou n dependendo da sua licença e dos requisitos. Incluir Formsheadless é obrigatório para criar o Forms adaptável com base nos Componentes principais.

   • Use o includeFormsenrollment=y opção para incluir configurações específicas do Forms, temas, modelos, Componentes principais e dependências necessárias para criar o Adaptive Forms. Se você usa o Forms Portal, defina a variável includeExamples=y opção. Ele também adiciona os componentes principais do Forms Portal ao projeto.

   • Use o includeFormscommunications=y opção para incluir os Componentes principais do Forms e as dependências necessárias para incluir a funcionalidade Comunicações do cliente.

3. Implante o projeto no ambiente de desenvolvimento local. Você pode usar o comando a seguir para implantar no ambiente de desenvolvimento local

   mvn -PautoInstallPackage clean install

   Para obter a lista completa de comandos, consulte Criação e instalação

4. Implante o código no seu AEM Forms ambiente as a Cloud Service.

Configurar ferramentas locais do Dispatcher

O Dispatcher é um módulo de servidor Web Apache HTTP que fornece uma camada de segurança e desempenho entre a camada do CDN e AEM Publish. O Dispatcher é parte integral da arquitetura Experience Manager geral e deve fazer parte do ambiente de desenvolvimento local.

Execute as seguintes etapas para configurar o Dispatcher local e, em seguida, adicionar regras específicas do Forms a ele:

Configurar o Dispatcher local

A variável Experience Manager O SDK as a Cloud Service inclui a versão recomendada das Ferramentas do Dispatcher, que facilita a configuração, validação e simulação do Dispatcher localmente. As Ferramentas do Dispatcher são baseadas em Docker e fornecem ferramentas de linha de comando para transcompilar arquivos de configuração do Apache HTTP Web Server e do Dispatcher em um formato compatível e implantá-los no Dispatcher em execução no contêiner Docker.

O armazenamento em cache no Dispatcher permite AEM Forms para preencher previamente o Adaptive Forms em um cliente. Ele melhora a velocidade de renderização de formulários pré-preenchidos.

Para obter instruções detalhadas sobre como configurar o Dispatcher, consulte Configurar ferramentas locais do Dispatcher

Adicionar regras específicas do Forms ao Dispatcher

Execute as seguintes etapas para configurar o cache do Dispatcher para o Experience Manager Forms as a Cloud Service:

1. Abra o projeto AEM e acesse \src\conf.dispatcher.d\available_farms

2. Crie uma cópia do default.farm arquivo. Por exemplo, forms.farm.

3. Abra o recém-criado forms.farm para editar e substituir o seguinte código:

   #/ignoreUrlParams {
   #/0001 { /glob "*" /type "deny" }
   #/0002 { /glob "q" /type "allow" }
   #}
   

   com

   /ignoreUrlParams {
   /0001 { /glob "*" /type "deny" }
   /0002 { /glob "dataRef" /type "allow" }
   }
   

4. Salve e feche o arquivo.

5. Ir para conf.d/enabled_farms e criar um link simbólico para o forms.farm arquivo.

6. Compile e implante o projeto em seu AEM Forms ambiente as a Cloud Service.

Considerações sobre armazenamento em cache

• O armazenamento em cache do Dispatcher permite AEM Forms para preencher previamente o Adaptive Forms em um cliente. Ele melhora a velocidade de renderização de formulários pré-preenchidos.
• O armazenamento em cache de recursos de conteúdo protegido está desativado, por padrão. Para ativar o recurso, você pode executar as instruções fornecidas no Armazenamento em cache de conteúdo protegido artigo
• O Dispatcher pode falhar ao invalidar alguns Forms adaptáveis e Forms adaptáveis relacionados. Para resolver esses problemas, consulte AEM Forms Armazenamento em cache na seção solução de problemas.
• Armazenamento em cache do Adaptive Forms localizado:
  • Usar formato de URL http://host:port/content/forms/af/<afName>.<locale>.html para solicitar uma versão localizada de um Formulário adaptável em vez de http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
  • A opção Local do navegador está desativada, por padrão. Para alterar a configuração do local do navegador,
• Quando você usa o formato de URL http://host:port/content/forms/af/<adaptivefName>.htmle Usar localidade do navegador no gerenciador de configurações estiver desativado, a versão não localizada do Formulário adaptável será fornecida. O idioma não localizado é o idioma usado ao desenvolver o Formulário adaptável. A localidade configurada para seu navegador (localidade do navegador) não é considerada e uma versão não localizada do Formulário adaptável é fornecida.
• Quando você usa o formato de URL http://host:port/content/forms/af/<adaptivefName>.htmle Usar localidade do navegador no gerenciador de configurações estiver ativado, uma versão localizada do Formulário adaptável será fornecida, se disponível. O idioma do Formulário adaptável localizado se baseia no local configurado para seu navegador (local do navegador). Pode levar a [armazenamento em cache somente da primeira instância de um Formulário adaptável]. Para evitar que o problema ocorra na sua instância, consulte somente a primeira instância de um Formulário adaptável é armazenada em cache na seção solução de problemas.

O ambiente de desenvolvimento local está pronto.

Ativar os Componentes principais adaptáveis do Forms no ambiente de desenvolvimento as a Cloud Service e local do AEM Forms

A ativação dos Componentes principais do Adaptive Forms no AEM Forms as a Cloud Service permite que você comece a criar, publicar e fornecer Componentes principais baseados no Adaptive Forms e no Headless Forms, usando as instâncias do Cloud Service da AEM Forms para vários canais. Você precisa do ambiente habilitado dos Componentes principais adaptáveis do Forms para usar o Forms adaptável headless.

Para obter instruções, consulte Ativar os Componentes principais adaptáveis do Forms no ambiente de desenvolvimento as a Cloud Service e local do AEM Forms

Atualizar o ambiente de desenvolvimento local

Atualizar o SDK para uma nova versão requer a substituição de todo o ambiente de desenvolvimento local, resultando na perda de todo o código, configuração e conteúdo nos repositórios locais. Verifique se qualquer código, configuração ou conteúdo que não deve ser destruído foi confirmado com segurança no Git ou exportado das instâncias de Experience Manager locais como Pacotes CRX.

Como evitar perda de conteúdo ao atualizar o SDK

A atualização do SDK está efetivamente criando uma nova instância de Autor e Publicação, incluindo um novo repositório (Configurar projeto do AEM), o que significa que as alterações feitas no repositório de um SDK anterior são perdidas. Para obter estratégias viáveis para ajudar a criar conteúdo persistente entre as atualizações do SDK, consulte Como evitar perda de conteúdo ao atualizar o SDK do AEM

Fazer backup e importar conteúdo específico do Forms para um novo ambiente de SDK

Para fazer backup e mover ativos do SDK existente para um novo ambiente de SDK:

• Crie um backup do conteúdo existente.

• Configure um novo ambiente do SDK.

• Importe o backup para o novo ambiente do SDK.

Criar um backup do conteúdo existente

Faça backup de seu Forms adaptável, modelos, modelo de dados de formulário, tema, configurações e código personalizado. Você pode executar a seguinte ação para criar o backup:

1. Baixar Forms adaptável, temas e PDF forms.

2. Exportar modelos de formulário adaptável.

3. Baixar modelos de dados do formulário

4. Exportar modelos editáveis, configurações de nuvem e modelo de fluxo de trabalho. Para exportar todos os itens mencionados anteriormente do SDK existente, crie um Pacote CRX com os seguintes filtros:

   • /conf/ReferenceEditableTemplates
   • /conf/global/settings/cloudconfigs
   • /conf/global/settings/wcm
   • /var/workflow/models
   • /conf/global/settings/workflow

5. Exporte configurações de email, envie e preencha previamente o código de ações de seu ambiente de desenvolvimento local. Para exportar essas configurações, crie uma cópia das seguintes pastas e arquivos no ambiente de desenvolvimento local:

   • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
   • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
   • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

Importe o backup para o novo ambiente do SDK

Importe o Adaptive Forms, modelos, modelo de dados de formulário, tema, configurações e código personalizado para seu ambiente atualizado. Execute a seguinte ação para importar o backup:

1. Importar Forms adaptável, temas e PDF forms para novos ambientes do SDK.

2. Importar modelos de formulário adaptável para o novo ambiente do SDK.

3. Fazer upload de modelos de dados de formulário para o novo ambiente do SDK.

4. Importar modelos editáveis, configurações de nuvem e modelo de fluxo de trabalho. Para importar todos os itens mencionados anteriormente para o novo ambiente do SDK, importe o pacote CRX que contém esses itens para o novo ambiente do SDK.

5. Importe configurações de email, envie e preencha previamente o código de ações do seu ambiente de desenvolvimento local. Para importar essas configurações, coloque os seguintes arquivos do seu antigo projeto do Arquétipo para o seu novo projeto do Arquétipo:

   • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
   • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
   • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

Seu novo ambiente agora tem formulários e ativos relacionados do ambiente antigo.

Recursos do Business.Adobe.com