Migrar ativos e documentos do AEM Forms

O Utilitário de migração converte os Adaptive Forms assets, cloud settings e Correspondence Management assets do formato usado nas versões anteriores para o formato usado no AEM 6.5 Forms. Quando você executa o utilitário de migração, as seguintes etapas são migradas:

  • Componentes personalizados para formulários adaptáveis
  • Formulários adaptáveis e modelos de gerenciamento de correspondência
  • Configurações da nuvem
  • Gerenciamento de correspondência e ativos de formulários adaptáveis
OBSERVAÇÃO

No caso de atualização fora do local, no caso de ativos de Gerenciamento de correspondência, é possível executar a migração toda vez que importar os ativos. Para a migração do Gerenciamento de correspondência, é necessário ter o Pacote de compatibilidade do Forms instalado.

Abordagem da migração

Você pode atualizar para a versão mais recente do AEM Forms 6.5 do AEM Forms 6.4, 6.3 ou 6.2 ou executar uma nova instalação. Dependendo de você ter atualizado sua instalação anterior ou executado uma nova instalação, é necessário executar um dos seguintes procedimentos:

No caso de atualização no local

Se você tiver realizado uma atualização no local, a instância atualizada já terá os ativos e documentos. No entanto, antes de usar os ativos e documentos, será necessário instalar o Pacote de compatibilidade do AEMFD (inclui o pacote de compatibilidade do Correspondence Management)

Em seguida, é necessário atualizar os ativos e documentos executando o utilitário de Migração.

Em caso de instalação fora do local

Se for uma instalação fora do local (nova), antes de poder usar os ativos e documentos, será necessário instalar o Pacote de compatibilidade do AEMFD (inclui o pacote de Compatibilidade do Correspondence Management).

Em seguida, é necessário importar o pacote de ativos (zip ou cmp) na nova configuração e, em seguida, atualizar os ativos e documentos executando o Migration Utility. O Adobe recomenda criar novos ativos na nova configuração somente após a execução do utilitário de migração.

Devido a alterações relacionadas à compatibilidade com versões anteriores, os locais de algumas pastas no repositório crx são alterados. Exportar e importar dependências manualmente (bibliotecas e ativos personalizados) da configuração anterior para um novo ambiente.

Leia antes de continuar com a migração

Para ativos de Gerenciamento de correspondência:

  • Para os ativos importados da plataforma anterior, uma propriedade é adicionada: fd:version=1.0.
  • Desde o AEM 6.1 Forms, os comentários não estão disponíveis para uso imediato. Os comentários adicionados anteriormente estão disponíveis nos ativos, mas não ficam visíveis na interface automaticamente. É necessário personalizar a propriedade ExtendedProperties na interface do usuário do AEM Forms para tornar os comentários visíveis.
  • Em algumas versões anteriores, como o LiveCycle ES4, o texto foi editado usando o Flex RichTextEditor, mas desde AEM 6.1 Forms, o editor HTML é usado. Devido a essa renderização e aparência das fontes, os tamanhos das fontes e as margens das fontes podem ser diferentes das versões anteriores na interface do usuário Autor. No entanto, as letras têm a mesma aparência ao serem renderizadas.
  • As listas nos módulos de texto são aprimoradas e agora são renderizadas de forma diferente. Pode haver diferenças visuais. Recomendamos que você renderize e veja as letras em que está usando listas em módulos de texto.
  • Como os módulos de conteúdo de imagem são convertidos em ativos do DAM e os layouts e fragmentos são adicionados aos formulários durante a migração, a propriedade Atualizado por para esses módulos muda para administrador.
  • O histórico de versões dos ativos não é migrado e não está disponível após a migração. O histórico de versões subsequente após a migração é mantido.
  • O estado Pronto para publicar está obsoleto desde o AEM 6.1 Forms, portanto, todos os ativos no estado Pronto para publicar são alterados para o estado Modificado.
  • Como a interface do usuário é atualizada no AEM Forms 6.3, as etapas para executar as personalizações também são diferentes. Você precisa refazer a personalização se estiver migrando de uma versão anterior à 6.3.
  • Os fragmentos de layout mudam de /content/apps/cm/layouts/fragmentlayouts/1001 para /content/apps/cm/modules/fragmentlayouts/1001. A referência do Dicionário de dados em ativos exibe o caminho do Dicionário de dados em vez de seu nome.
  • Quaisquer espaços de tabulação usados para alinhamento em módulos de texto precisam ser reajustados. Para obter mais informações, consulte Gerenciamento de correspondência - Uso do espaçamento entre guias para organizar o texto.
  • As configurações do compositor de ativos são alteradas nas configurações de Gerenciamento de correspondência.
  • Os ativos são movidos em pastas com nomes como Texto existente e Lista existente.

Uso do utilitário de migração

Executando o utilitário de migração

Execute o Migration Utility antes de fazer alterações nos ativos ou criar ativos. Recomendamos que você não execute o utilitário após fazer qualquer alteração ou criar ativos. Certifique-se de que a interface do usuário do Correspondence Management ou do Adaptive Forms Assets não esteja aberta enquanto o processo de migração estiver em execução.

Ao executar o Utilitário de migração pela primeira vez, um log é criado com o seguinte caminho e nome: [aem-installation-diretory]\cq-quickstart\logs\aem-forms-migration.log. Esse log continua sendo atualizado com informações de gerenciamento de correspondência e migração do Adaptive Forms, como movimentação de ativos.

OBSERVAÇÃO

Antes de executar o utilitário de migração, certifique-se de ter feito um backup do seu repositório crx.

  1. Em uma sessão do navegador, faça logon AEM instância do autor como Administrador.

  2. Abra o seguinte URL no navegador:

    https://[hostname]:[port]/[context_path]/libs/fd/foundation/gui/content/migration.html

    O navegador exibe quatro opções:

    • Migração de ativos de AEM Forms
    • Migração de componentes personalizados adaptáveis do Forms
    • Migração de modelos adaptáveis do Forms
    • Migração das configurações de nuvem de AEM Forms
  3. Faça o seguinte para executar a migração:

    • Para migrar assets, toque em Migração de ativos do AEM Forms e, na próxima tela, toque em Iniciar migração. Os itens a seguir são migrados:

      • Formulários adaptáveis
      • Fragmentos de documento
      • Temas
      • Cartas
      • Dicionários de dados
    OBSERVAÇÃO

    Durante a migração de ativos, é possível encontrar mensagens de aviso, como "Conflito encontrado para…". Essas mensagens indicam que as regras para alguns componentes em formulários adaptáveis não puderam ser migradas. Por exemplo, se o componente tiver um evento que tenha regras e scripts, se as regras ocorrerem após qualquer script, nenhuma das regras do componente será migrada. No entanto, essas regras podem ser migradas abrindo o editor de regras na criação de formulários adaptáveis.

    Esses componentes podem ser migrados abrindo-os no Editor de regras no editor adaptável do Forms.

    • Para migrar regras e scripts (não é necessário se estiver atualizando da versão 6.3) em componentes personalizados, toque em Migração de componentes personalizados do Adaptive Forms e, na próxima tela, toque em Iniciar migração. Os itens a seguir são migrados: >

    • Regras e scripts criados com o editor de regras (6.1 FP1 e posterior)

    • Scripts criados usando a guia Script na interface do usuário da versão 6.1 e anterior

    • Para migrar modelos (não é necessário se estiver atualizando da versão 6.3 e 6.4), toque em Migração de modelo do Adaptive Forms e, na próxima tela, toque em Iniciar migração. Os itens a seguir são migrados:

    • Modelos antigos - os modelos de formulários adaptáveis criados em /apps usando o AEM 6.1 Forms ou anterior. Isso inclui os scripts que foram definidos nos componentes do modelo.

    • Novos modelos - Modelos de formulários adaptáveis criados usando o editor de modelos em /conf. Isso inclui a migração de regras e scripts criados com o editor de regras.

    • Para migrar componentes personalizados de formulário adaptável, toque em Migração de componentes personalizados do Adaptive Forms e, na página Migração de componentes personalizados, toque em Iniciar migração. Os itens a seguir são migrados:

      • Componentes personalizados criados para o Adaptive Forms
      • Sobreposições de componentes, se houver.
    • Para migrar modelos de formulário adaptáveis, toque em Migração de modelo do Forms adaptável e, na página Migração de componentes personalizados, toque em Iniciar migração. Os itens a seguir são migrados:

      • Modelos de formulário adaptável criados em /apps ou /conf usando AEM Editor de modelo.
    • Migre os serviços de configuração da AEM Forms Cloud para aproveitar o novo paradigma do serviço de nuvem sensível ao contexto, que inclui a interface habilitada para toque (em /conf). Ao migrar os serviços de configuração da AEM Forms Cloud, os serviços em nuvem em /etc são movidos para /conf. Se você não tiver personalizações de serviços de nuvem que dependam dos caminhos herdados (/etc?lang=pt-BR), é recomendável executar o utilitário de migração logo após a atualização para o 6.5 e usar a interface de toque de configuração de nuvem para qualquer trabalho adicional. Se você tiver alguma personalização de serviços em nuvem existente, continue usando a interface clássica na configuração atualizada até que as personalizações sejam atualizadas para se alinharem aos caminhos migrados (/conf?lang=pt-BR) e execute o utilitário de migração.

    Para migrar AEM Forms cloud services, que incluem o seguinte, toque em Migração de configuração da AEM Forms Cloud (a migração de configuração da nuvem é independente do pacote de compatibilidade do AEMFD), toque em Migração de configurações da AEM Forms Cloud e, na página Migração de configuração, toque em Iniciar migração:

    • Serviços em nuvem do Modelo de dados de formulário

      • Caminho de origem: /etc/cloudservices/fdm
      • Caminho de destino: /conf/global/settings/cloudconfigs/fdm
    • Recaptcha

      • Caminho de origem: /etc/cloudservices/recaptcha
      • Caminho de destino: /conf/global/settings/cloudconfigs/recaptcha
    • Adobe Sign

      • Caminho de origem: /etc/cloudservices/echosign
      • Caminho de destino: /conf/global/settings/cloudconfigs/echosign
    • Serviços em nuvem Typekit

      • Caminho de origem: /etc/cloudservices/typekit
      • Caminho de destino: /conf/global/settings/cloudconfigs/typekit

    A janela do navegador exibe o seguinte à medida que o processo de migração ocorre:

    • Quando os ativos são atualizados: Ativos atualizados com êxito.
    • Quando a migração for concluída: Migração de ativos concluída.

    Quando executado, o utilitário de Migração faz o seguinte:

    • Adiciona as tags aos ativos: Adiciona a tag "Gerenciamento de correspondência : Ativos migrados" / "Forms adaptável : Ativos migrados". para os ativos migrados, para que os usuários possam identificar os ativos migrados. Ao executar o utilitário de Migração, todos os ativos existentes no sistema são marcados como Migrado.
    • Gera tags: As categorias e subcategorias presentes no sistema anterior são criadas como tags e, em seguida, essas tags são associadas aos ativos relevantes do Gerenciamento de correspondência no AEM. Por exemplo, uma Categoria (Reivindicações) e uma Subcategoria (Reivindicações) de um modelo de carta são geradas como tags.
  4. Depois que o utilitário de migração terminar de ser executado, continue com as tarefas de manutenção.

Tarefas de casa após executar o utilitário de migração

Depois de executar o utilitário de Migração, siga as seguintes tarefas de manutenção: 🔗

  1. Certifique-se de que a versão XFA dos layouts e dos layouts de fragmento seja a 3.3 ou posterior. Se você estiver usando layouts e layouts de fragmento de uma versão mais antiga, poderá haver problemas na renderização da carta. Para atualizar a versão de um XFA mais antigo para a versão mais recente, execute as seguintes etapas:

    1. Baixe o XFA como um arquivo zip da interface do usuário do Forms.
    2. Extraia o arquivo.
    3. Abra o arquivo XFA no Designer mais recente e salve-o. A versão do XFA é atualizada para a mais recente.
    4. Faça upload do XFA na interface do usuário do Forms.
  2. Publique todos os ativos que foram publicados no sistema anterior antes da migração. O utilitário de migração atualiza os ativos somente na instância do autor e para atualizar os ativos na (s) instância (s) de publicação, é necessário publicar os ativos.

  3. No AEM Forms 6.4 e 6.5, alguns dos direitos dos grupos de usuários de formulários são alterados. Se você quiser que qualquer um dos seus usuários possa fazer upload de XDPs e Adaptive Forms contendo scripts ou usar o editor de código, será necessário adicioná-los ao grupo de usuários avançados de formulários. Da mesma forma, os autores de modelo não podem mais usar o editor de código no Editor de regras. Para que os usuários possam usar o editor de código, adicione-os ao grupo af-template-script-writer. Para obter instruções sobre como adicionar usuários a grupos, consulte Gerenciar usuários e grupos de usuários.

Nesta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now