Conforme descrito no pai Reestruturação do repositório no AEM 6.5 , os clientes que atualizam para o AEM 6.5 devem usar essa página para avaliar o esforço de trabalho associado às alterações do repositório que possivelmente afetarão todas as soluções. Algumas alterações exigem esforço de trabalho durante o processo de atualização do AEM 6.5, enquanto outras podem ser adiadas até uma atualização futura.
A partir AEM 6.4, não há configuração padrão do ContextHub. Portanto, no nível raiz do site a cq:contextHubPathproperty deve ser definida para indicar qual configuração deve ser usada.
Navegue até a raiz do site.
Abra as propriedades da página raiz e selecione a guia Personalization .
No campo Caminho do Contexthub , digite seu próprio caminho de configuração do ContextHub.
Além disso, na configuração do ContextHub, a variável sling:resourceType precisa ser atualizado para ser relativo e não absoluto.
Abra as propriedades do nó de configuração do ContextHub no CRX DE Lite, por exemplo /apps/settings/cloudsettings/legacy/contexthub
Alterar sling:resourceType from /libs/granite/contexthub/cloudsettings/components/baseconfiguration para granite/contexthub/cloudsettings/components/baseconfiguration
Ou seja, o sling:resourceType da configuração do ContextHub deve ser relativa em vez de absoluta.
Modelos do fluxo de trabalho
Localização anterior
/etc/workflow/models
Novas localizações
/libs/settings/workflow/models
/conf/global/settings/workflow/models
/var/workflow/models
Orientação relativa à reestruturação
Qualquer modelo de fluxo de trabalho novo ou modificado deve ser migrado para /conf/global/workflow/models.
Implante os Modelos de fluxo de trabalho modificados em uma instância de desenvolvimento do AEM local 6.5, de modo que eles existam no local Anterior.
Edite o modelo de fluxo de trabalho usando AEM Editor de modelo de fluxo de trabalho em AEM > Ferramentas > Fluxo de trabalho > Modelos.
Ao migrar modelos de fluxo de trabalho modificados fornecidos pelo AEM
Com o Editor de modelo de fluxo de trabalho aberto, modifique o URL de endereço do navegador e substitua o segmento de caminho /libs/settings/workflow/models por /etc/workflow/models.
Por exemplo, altere: http://localhost:4502/editor.html/libs/settings/workflow/models/dam/update_asset.html para http://localhost:4502/editor.html/etc/workflow/models/dam/update_asset.html
Ative o modo Editar no Editor de modelo de fluxo de trabalho, que copiará a definição do modelo de fluxo de trabalho para /conf/global/workflow/models.
Toque no botão Sincronizar para sincronizar as alterações no Modelo de fluxo de trabalho em Tempo de execução em /var/workflow/models.
Exportar ambos os modelos de fluxo de trabalho (/conf/global/workflow/models/<workflow-model>?lang=pt-BR) e Modelo de fluxo de trabalho em tempo de execução (/var/workflow/models/<workflow-model>?lang=pt-BR) e integrar o projeto AEM.
Por exemplo, exportar:
/config/settings/workflow/models/dam/my_workflow_model e
/var/workflow/models/dam/my_workflow_model
Notas
A resolução do Modelo de Fluxo de Trabalho ocorre na seguinte ordem:
/conf/global/settings/workflow/models
/libs/settings/workflow/models
/etc/workflow/models
Assim, qualquer personalização de Modelos de Fluxo de Trabalho fornecidos AEM persistida no local Anterior deve ser movida para /conf/global/settings/workflow/models se quiserem ser retidos, caso contrário, serão substituídas pela definição de Modelo de Fluxo de Trabalho fornecida pelo AEM em /libs/settings/workflow/models.
Instâncias do fluxo de trabalho
Localização anterior
/etc/workflow/instances
Novas localizações
/var/workflow/instances
Orientação relativa à reestruturação
Nenhuma ação é necessária para alinhar com a Nova Localização.
As Instâncias de Fluxo de Trabalho Históricas podem continuar residindo com segurança no Local Anterior, e novas Instâncias de Fluxo de Trabalho serão criadas no Novo Local.
Notas
Quaisquer referências de caminho explícitas em
custom
o código para a Localização anterior também deve levar em conta a Nova localização. É recomendável que esse código seja refatorado para usar as APIs do fluxo de trabalho do AEM.
Inicializadores do fluxo de trabalho
Localização anterior
/etc/workflow/launcher/config
Novas localizações
/libs/settings/workflow/launcher/config
/conf/global/settings/workflow/launcher/config
Orientação relativa à reestruturação
Todos os Iniciadores de Fluxo de Trabalho novos ou modificados devem ser migrados para /conf/global/workflow/launcher/config.
Copie quaisquer configurações novas ou modificadas do Iniciador do fluxo de trabalho do Local anterior para o novo local (/conf/global).
Notas
A resolução do Iniciador de Fluxo de Trabalho ocorre na seguinte ordem:
/conf/global/settings/workflow/launcher
/libs/settings/workflow/launcher
/etc/workflow/launcher
Assim, qualquer personalização do Workflow Launcher fornecido AEM persistiu no local Anterior deve ser movida para o Novo local (/conf/global/settings/workflow/launcher se forem retidos, caso contrário, serão substituídos pela definição do Iniciador de fluxo de trabalho fornecida pela AEM em /libs/settings/workflow/launcher.
Scripts de fluxo de trabalho
Localização anterior
/etc/workflow/scripts
Novas localizações
/libs/workflow/scripts
/apps/workflow/scripts
Orientação relativa à reestruturação
Quaisquer scripts de fluxo de trabalho novos ou modificados devem ser migrados para o novo local e os Modelos de fluxo de trabalho de referência atualizados para refletir o novo local.
Copie quaisquer scripts de fluxo de trabalho novos ou modificados do local anterior para o novo local.
/apps/workflow/scripts deve ser mantido no SCM.
Atualize qualquer referência aos scripts de fluxo de trabalho no local anterior em modelos de fluxo de trabalho para apontar para os novos locais.
Notas
AEM 6.4 SP1, quando é liberada, faz com que essa reestruturação possa ser adiada para 6.5
upgrade
.
Se estiver atualizando para o AEM 6.4 antes do lançamento do AEM 6.4 SP1, essa reestruturação deverá ser executada como parte do projeto de atualização. Sem isso, editar e salvar as Etapas do fluxo de trabalho que fazem referência aos scripts no Local anterior removerá a referência do Script de fluxo de trabalho da Etapa do fluxo de trabalho totalmente, e somente os scripts de fluxo de trabalho em novos locais estarão disponíveis na lista suspensa de seleção de script.
Antes da atualização futura
Configurações do ContextHub
Localização anterior
/etc/cloudsettings
Novas localizações
/libs/settings/cloudsettings
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Orientação relativa à reestruturação
Todas as configurações do ContextHub novas ou modificadas devem ser migradas para o novo local e as páginas do AEM Sites de referência devem ser atualizadas para refletir o novo local.
Copie quaisquer configurações do ContextHub novas ou modificadas do local anterior para o novo local.
Associe as configurações de AEM aplicáveis às hierarquias de conteúdo AEM.
Hierarquias de página do AEM Sites por meio do AEM Sites > Página > Propriedades da página > Guia Avançado > Configuração da nuvem.
Desassocie qualquer configuração herdada do ContextHub migrada das hierarquias de conteúdo AEM mencionadas anteriormente.
Notas
N/A
Designs Cloud Services clássicos
Localização anterior
/etc/designs/cloudservices
Novas localizações
/libs/settings/wcm/designs/cloudservices
/apps/settings/wcm/designs/cloudservices
Orientação relativa à reestruturação
Para quaisquer Designs gerenciados no SCM e não gravados em tempo de execução por meio de Caixas de Diálogo de Design.
Copie os designs do local anterior para o novo local (/apps).
Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
Atualize referências ao Local anterior no
cq
:
designPath
propriedade.
Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria Biblioteca de clientes (isso requer a atualização do código de implementação da Página).
Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da pasta /etc.clientlibs/.. servlet proxy.
Para qualquer Designs que NÃO seja gerenciado no SCM e tempo de execução modificado por meio de Caixas de Diálogo de Design.
Não mova os Designs que podem ser do autor para fora de /etc.
Notas
N/D
Designs de painéis clássicos
Localização anterior
/etc/designs/dashboards
Novas localizações
/libs/settings/wcm/designs/dashboards
/apps/settings/wcm/designs/dashboards
Orientação relativa à reestruturação
Para quaisquer Designs gerenciados no SCM e não gravados em tempo de execução por meio de Caixas de Diálogo de Design.
Copie os designs do local anterior para o novo local (/apps?lang=pt-BR).
Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
Atualize referências ao Local anterior no
cq
:
designPath
propriedade.
Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria Biblioteca de clientes (isso requer a atualização do código de implementação da Página).
Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da pasta /etc.clientlibs/.. servlet proxy.
Para qualquer Designs que NÃO seja gerenciado no SCM e tempo de execução modificado por meio de Caixas de Diálogo de Design.
Não mova os Designs que podem ser do autor para fora de /etc.
Notas
N/D
Designs de relatórios clássicos
Localização anterior
/etc/designs/reports
Novas localizações
/libs/settings/wcm/designs/reports
/apps/settings/wcm/designs/reports
Orientação relativa à reestruturação
Para quaisquer Designs gerenciados no SCM e não gravados em tempo de execução por meio de Caixas de Diálogo de Design.
Copie os designs do local anterior para o novo local (/apps?lang=pt-BR).
Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
Atualize referências ao Local anterior no
cq
:
designPath
propriedade.
Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria Biblioteca de clientes (isso requer a atualização do código de implementação da Página).
Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da pasta /etc.clientlibs/.. servlet proxy.
Para qualquer Designs que NÃO seja gerenciado no SCM e tempo de execução modificado por meio de Caixas de Diálogo de Design.
Não mova os Designs que podem ser do autor para fora de /etc.
Notas
N/D
Designs padrão
Localização anterior
/etc/designs/default
Novas localizações
/libs/settings/wcm/designs/default
/apps/settings/wcm/designs/default
Orientação relativa à reestruturação
Para quaisquer Designs gerenciados no SCM e não gravados em tempo de execução por meio de Caixas de Diálogo de Design.
Copie os designs do local anterior para o novo local (/apps?lang=pt-BR).
Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
Atualize referências ao Local anterior no
cq
:
designPath
propriedade.
Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria Biblioteca de clientes (isso requer a atualização do código de implementação da Página).
Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da pasta /etc.clientlibs/.. servlet proxy.
Para qualquer Designs que NÃO seja gerenciado no SCM e tempo de execução modificado por meio de Caixas de Diálogo de Design.
Não mova os Designs que podem ser do autor para fora de /etc.
Notas
N/D
Endpoint de JavaScript do Adobe DTM
Localização anterior
/etc/clientlibs/dtm
Novas localizações
/var/cq/dtm/clientlibs
Orientação relativa à reestruturação
Nenhuma ação necessária.
A localização anterior pública atua como um ponto de extremidade proxy para a nova localização privada.
Notas
N/D
Endpoint de gancho da Web do Adobe DTM
Localização anterior
/etc/dtm-hook
Novas localizações
/var/cq/dtm/web-hook
Orientação relativa à reestruturação
Nenhuma ação necessária.
A localização anterior pública atua como um ponto de extremidade proxy para a nova localização privada.
Notas
N/D
Tarefas da caixa de entrada
Localização anterior
/etc/taskmanagement
Novas localizações
/var/taskmanagement
Orientação relativa à reestruturação
Use o Tarefa de manutenção da limpeza da caixa de entrada para remover tarefas antigas do local anterior, conforme necessário.
Notas
Nenhuma ação é necessária para migrar Tarefas para o novo local.
As tarefas presentes no Local anterior continuam disponíveis e funcionam.
Novas Tarefas são criadas no Novo Local.
Configurações do Blueprint do gerenciador de vários sites
Localização anterior
/etc/blueprints
Novas localizações
/libs/msm
/apps/msm
Orientação relativa à reestruturação
Copiar configurações personalizadas de /etc/blueprints para /apps/msm.
Remover /etc/blueprints.
Notas
N/D
Configurações do Gadget do Painel de Projetos AEM
Localização anterior
/etc/projects/dashboard/gadgets
Novas localizações
/libs/cq/core/content/projects/dashboard/gadgets
/apps/cq/core/content/projects/dashboard/gadgets
Orientação relativa à reestruturação
Qualquer configuração de gadget do painel Projetos nova ou modificada AEM deve ser migrada para o novo local (/apps).
Copie qualquer configuração de gadget do painel AEM Projetos nova ou modificada do local anterior para o novo local (/apps).
Não copie configurações de Gadget do Painel de Projetos não modificadas, pois elas agora existem no novo local (/libs).
Atualize qualquer modelo de Projetos AEM que referencie a Localização anterior para apontar para a nova localização apropriada.
Notas
Se o pacote de compatibilidade do AEM 6.4 for aplicado, será necessário executar as atividades de alinhamento do repositório no momento da remoção do pacote de compatibilidade.
Modelo de Correio Eletrônico de Notificação de Replicação
Todas as tags devem ser migradas para /content/cq:tags.
Copie todas as tags do local anterior para o novo local.
Remova todas as tags do local anterior.
Por meio do Console da Web AEM, reinicie o pacote OSGi de Marcação do Day Communique 5 em https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging para AEM reconhecer que a Nova Localização contém conteúdo e deve ser usada.
Notas
Reiniciar o pacote OSGi de Marcação de comunidade do dia registrará somente o Novo local como a raiz da tag se o Local anterior estiver vazio.
As referências ao local anterior continuarão a funcionar após a migração para o novo local de todas as funcionalidades que usam AEM API do TagManager para resolução de tags.
Qualquer código personalizado que faça referência explícita ao caminho /etc/tags deve ser atualizado para /content/
cq
:tags
ou, preferencialmente, reescrita para aproveitar a API Java do TagManager, em conjunto com essa migração.
Qualquer novo Cloud Services de Tradução deve ser migrado para o novo local (/apps, /conf/global ou /conf/<tenant>).
Migre as configurações existentes no local anterior para o novo local.
Recrie manualmente as novas configurações de Cloud Services de tradução por meio da interface do usuário de criação de AEM em Ferramentas > Cloud Services > Cloud Services de tradução. OU
Copie quaisquer novas configurações de Cloud Services de Tradução do local anterior para o novo local (/apps, /conf/global ou /conf/<tenant>).
Associe as configurações de AEM aplicáveis às hierarquias de conteúdo AEM.
Hierarquias de página do AEM Sites via AEM Sites > Página > Propriedades da página > Guia Avançado > Configuração da nuvem.
AEM hierarquias do Fragmento de experiência por meio de AEM Fragmentos de experiência > Fragmento de experiência > Propriedades > Guia Cloud Services > Configuração da nuvem.
AEM hierarquias da pasta do fragmento de experiência por meio de AEM Fragmentos de experiência > Pasta > Propriedades > Guia Cloud Services > Configuração da nuvem.
Hierarquias de pastas do AEM Assets via AEM Assets > Pasta > Propriedades da pasta > Guia Cloud Services > Configuração.
Projetos AEM via AEM Projetos > Projeto > Propriedades do projeto > Guia Avançado > Configuração na nuvem.
Desassocie qualquer Cloud Services de Tradução herdada migrada das hierarquias de conteúdo AEM acima.
Notas
A resolução de Cloud Services de tradução ocorre na seguinte ordem:
Os Cloud Services de tradução migrados devem ser compatíveis com o AEM 6.4.
Idiomas de tradução
Localização anterior
/etc/translation/supportedLanguages
Novas localizações
/libs/settings/translation/supportedLanguages
/apps/settings/translation/supportedLanguages
Orientação relativa à reestruturação
Qualquer definição nova ou modificada de Idioma de tradução requer a migração de todas as definições de Idioma de tradução para o novo local (/apps).
Se alguma adição ou modificação tiver sido feita às definições de Idioma de Tradução, copie todas as definições de Idioma de Tradução do local anterior para o novo local (/apps).
Notas
A resolução do caminho Idioma de Tradução ocorre na seguinte ordem:
/etc/translation/supportedLanguages
/apps/settings/translation/supportedLanguage
/libs/settings/translation/supportedLanguages
Esta resolução não suporta uma sobreposição de mesclagem, o que significa que o caminho resolvido deve conter todos os Idiomas Suportados e não herdará os Idiomas Suportados das resoluções de ordem superior.
Para quaisquer Designs gerenciados no SCM e não gravados em tempo de execução por meio de Caixas de Diálogo de Design.
Copie os designs do local anterior para o novo local (/apps?lang=pt-BR).
Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
Atualize referências ao Local anterior no
cq
:
designPath
propriedade.
Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria Biblioteca de clientes (isso requer a atualização do código de implementação da Página).
Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da pasta /etc.clientlibs/.. servlet proxy.
Para qualquer Designs que NÃO seja gerenciado no SCM e tempo de execução modificado por meio de Caixas de Diálogo de Design.
Não mova os Designs que podem ser do autor para fora de /etc.
Notas
N/D
Console da Web de Ativação em Árvore
Localização anterior
/etc/replication/treeactivation
Novas localizações
/libs/replication/treeactivation
Orientação relativa à reestruturação
Nenhuma ação necessária.
Notas
O Console da Web de Ativação em Árvore agora está disponível por meio do Ferramentas > Implantação > Replicação > Ativar árvore.
Cloud Services do conector de tradução do fornecedor
Qualquer novo Cloud Services do Conector de tradução do fornecedor deve ser migrado para o novo local (/apps, /conf/global ou /conf/<tenant>).
Migre as configurações existentes no Local anterior para o Novo local.
Crie manualmente as novas configurações do Cloud Services do Conector de tradução do fornecedor por meio do AEM da interface de criação em Ferramentas > Cloud Services > Cloud Services de tradução. OU
Copie quaisquer novas configurações de Cloud Services do Conector de tradução do fornecedor do local anterior para o novo local (/apps, /conf/global ou /conf/<tenant>).
Associe as configurações de AEM aplicáveis às hierarquias de conteúdo AEM.
Hierarquias de página do AEM Sites via AEM Sites > Página > Propriedades da página > Guia Avançado > Configuração da nuvem.
AEM hierarquias do Fragmento de experiência por meio de AEM Fragmentos de experiência > Fragmento de experiência > Propriedades > Guia Cloud Services > Configuração da nuvem.
AEM hierarquias da pasta do fragmento de experiência por meio de AEM Fragmentos de experiência > Pasta > Propriedades > Guia Cloud Services > Configuração da nuvem.
Hierarquias de pastas do AEM Assets via AEM Assets > Pasta > Propriedades da pasta > Guia Cloud Services > Configuração.
Projetos AEM via AEM Projetos > Projeto > Propriedades do projeto > Guia Avançado > Configuração na nuvem.
Desassocie qualquer Cloud Services de Tradução herdada migrada das hierarquias de conteúdo AEM acima.
Notas
A resolução de Cloud Services de tradução ocorre na seguinte ordem:
Modelos de email de notificação de fluxo de trabalho
Localização anterior
/etc/workflow/notification
Novas localizações
/libs/settings/workflow/notification
/conf/global/settings/workflow/notification
Orientação relativa à reestruturação
Qualquer modelo de email de notificação de fluxo de trabalho modificado deve ser migrado para o novo local (/conf/global).
Copie todos os Modelos de email de notificação de fluxo de trabalho modificados do local anterior para o novo local.
Remova Modelos de email de notificação de fluxo de trabalho migrados do local anterior.
Notas
A resolução do Modelo de email de notificação de fluxo de trabalho ocorre na seguinte ordem:
/etc/workflow/notification
/conf/global/settings/workflow/notification
/libs/settings/workflow/notification
Pacotes de fluxo de trabalho
Localização anterior
/etc/workflow/packages
Novas localizações
/var/workflow/packages
Orientação relativa à reestruturação
Os pacotes de fluxo de trabalho existentes no local anterior devem ser migrados para o novo local.
Remova todos os pacotes de fluxo de trabalho no local anterior que não estejam referenciados por outro conteúdo e que, de outra forma, não sejam necessários.
Mova todos os pacotes de fluxo de trabalho no local anterior que não sejam referenciados por outro conteúdo, mas que, de outra forma, sejam necessários no novo local.
Deixe quaisquer Pacotes de fluxo de trabalho referenciados por outro conteúdo no local anterior.
Notas
Os pacotes de fluxo de trabalho criados por meio do console Miscadmin da interface clássica são mantidos no local anterior, enquanto todos os outros são mantidos no novo local.
Os pacotes de fluxo de trabalho armazenados nos locais anteriores ou inferiores podem ser gerenciados por meio do console Miscadmin da interface clássica.