Restruturação do repositório de sites no AEM 6.4 sites-repository-restructuring-in-aem

CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Conforme descrito no pai Reestruturação do repositório no AEM 6.4 , os clientes que atualizam para o AEM 6.4 devem usar esta página para avaliar o esforço de trabalho associado às alterações do repositório que afetam a solução da AEM Sites. Algumas alterações exigem esforço de trabalho durante o processo de atualização do AEM 6.4, enquanto outras podem ser adiadas até uma atualização do 6.5.

Com a atualização 6.4

Antes da atualização do 6.5

Com a atualização 6.4 with-upgrade

Segmentos ContextHub contexthub-segments

Localização anterior
/etc/segmentation/contexthub
Novas localizações

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

/conf/<tenant>/settings/wcm/segments

Orientação relativa à reestruturação

Se qualquer segmento novo ou modificado do ContextHub for destinado a ser editado no controle de origem em vez de ser editado no AEM, ele deverá ser migrado para o novo local:

  1. Copie quaisquer segmentos do ContextHub novos ou modificados do local anterior para o novo local adequado (https://experienceleague.adobe.com/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20ou%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=pt-BR)
  2. Atualize referências aos segmentos do ContextHub no local anterior para os segmentos do ContextHub migrados nos novos locais (/apps, /conf/global, /conf/<tenant>).

A consulta do QueryBuilder a seguir localiza todas as referências aos segmentos do ContextHub nos locais anteriores.

\

\

path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%

\

\

Isso pode ser executado via

AEM interface do usuário do QueryBuilder Debugger

. Observe que esta é uma consulta de percurso, portanto, não a execute em relação à produção e assegure-se de ajustar os limites de percurso conforme necessário.

Notas

Os segmentos do ContextHub persistentes no local anterior são exibidos como somente leitura em AEM > Personalização > Públicos-alvo.

Se os segmentos do ContextHub forem editáveis no AEM, eles deverão ser migrados para o novo local (/conf/global ou /conf/<tenant>). Qualquer novo segmento de Segmentos do ContentHub criado em AEM é mantido no novo local (/conf/global ou /conf/<tenant>).

As Propriedades da página do AEM Sites permitem somente o Local anterior (/etc) ou um único novo local (/apps, /conf/global ou /conf/<tenant>) para ser selecionado, portanto, os segmentos do ContextHub devem ser migrados adequadamente.

Qualquer segmento do ContextHub não utilizado AEM sites de referência pode ser removido e não migrado para o Novo local:

  • /etc/segmentation/geometrixx/
  • /etc/segmentation/geometrixx-outdoors

Observação: Se o ClientContext estiver em uso, é recomendável converter para o ContextHub.

Antes da atualização do 6.5 prior-to-upgrade

Bibliotecas de clientes do Adobe Analytics adobe-analytics-client-libraries

Localização anterior
/etc/clientlibs/foundation/sitecatalyst
Novas localizações
/libs/cq/analytics/clientlibs/analytics
Orientação relativa à reestruturação

Qualquer uso personalizado dessas Bibliotecas de clientes deve fazer referência à Biblioteca de clientes por categoria e não por caminho:

  1. Qualquer referência à Biblioteca de clientes por caminho no Local anterior deve ser atualizada para usar Estrutura de referência da Biblioteca do cliente AEM.

  2. Se AEM estrutura de referência da Biblioteca do cliente não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio AEM servlet de Proxy da biblioteca do cliente.

    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/appmeasurement.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/plugins.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/tracking.js
    • /etc.clientlibs/cq/analytics/clientlibs/sitecatalyst/util.js
Notas

A edição dessas bibliotecas de clientes nunca foi suportada.

Para obter as categorias da Biblioteca de clientes , visite cada cq:ClientLIbraryFolder nó por meio do CRXDELite e inspecione a propriedade categories .

  • /libs/cq/analytics/clientlibs/sitecatalyst/appmeasurement
  • /libs/cq/analytics/clientlibs/sitecatalyst/plugins
  • /libs/cq/analytics/clientlibs/sitecatalyst/sitecatalyst
  • /libs/cq/analytics/clientlibs/sitecatalyst/tracking
  • /libs/cq/analytics/clientlibs/sitecatalyst/util

Designs clássicos do Microsoft Word para página da Web classic-microsoft-word-to-web-page-designs

Localização anterior
/etc/designs/wordDesign
Novas localizações

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

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.

  1. Copie os designs do local anterior para o novo local (/apps).
  2. Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
  3. Atualize referências para o Local anterior na propriedade cq:designPath.
  4. 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).
  5. Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da /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/A

Configurações do emulador de dispositivo móvel mobile-device-emulator-configurations

Localização anterior
/etc/mobile
Novas localizações

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Orientação relativa à reestruturação

Qualquer nova configuração do emulador de dispositivo móvel deve ser migrada para o novo local.

  1. Copie quaisquer novas configurações do emulador de dispositivo móvel do local anterior para o novo local (/apps, /conf/global, /conf/<tenant>).
  2. Para quaisquer páginas do AEM Sites que dependam dessas configurações do emulador de dispositivo móvel, atualize o jcr ``:content nó:
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. Para quaisquer Modelos editáveis que dependam dessas configurações do emulador de dispositivo móvel, atualize os Modelos editáveis, apontando a cq : deviceGroups para a Nova Localização.
Notas

A resolução Configurações do emulador de dispositivo móvel ocorre na seguinte ordem:

  1. /conf/<tenant>/settings/mobile
  2. /conf/global/settings/mobile
  3. /apps/settings/mobile
  4. /libs/settings/mobile
  5. /etc/mobile

Configurações do Blueprint do gerenciador de vários sites multi-site-manager-blueprint-configurations

Localização anterior
/etc/blueprints
Novas localizações

/apps/msm (Configurações do Customer Blueprint)

/libs/msm (Configurações do Blueprint prontas para uso no Screens, Commerce)

Orientação relativa à reestruturação

Todas as configurações do Blueprint do Multi-site Manager novas ou modificadas devem ser migradas para o Novo local (/apps).

  1. Copie quaisquer configurações do blueprint do gerenciador de vários sites novas ou modificadas do local anterior para o novo local (/apps).
  2. Remova todas as configurações do Blueprint do gerenciador de vários sites migradas do local anterior.
Notas

Todas as AEM fornecidas Configurações do Blueprint do Gerenciador de Vários Sites existem no Novo Local em /libs.

O conteúdo não faz referência às Configurações azuis do gerenciador de vários sites, portanto, não há referências de conteúdo para ajustar.

Configurações de implementação do gerenciamento de vários sites multi-site-manager-rollout-configurations

Localização anterior
/etc/msm/rolloutConfigs
Novas localizações

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Orientação relativa à reestruturação

Todas as configurações de implementação do gerenciamento de vários sites novas ou modificadas devem ser migradas para o novo local.

  1. Copie quaisquer configurações de implantação do gerenciamento de vários sites, novas ou modificadas, do local anterior para o novo local (/apps).
  2. Atualize qualquer referência nas Páginas AEM para Configurações de implementação do gerenciamento de vários sites no local anterior, para apontar para suas contrapartes nos Novos locais (/libs ou /apps).

Remova as configurações de implantação do gerenciador de vários sites migradas do local anterior.

Notas
A não remoção das Configurações de implementação do gerenciamento de vários sites migradas do Local anterior resulta em opções de implementação duplicadas exibidas para AEM autores.

Modelo de email de notificação de evento da página page-event-notification-e-mail-template

Localização anterior
/etc/notification/email/default/com.day.cq.wcm.core.page
Novas localizações

/libs/settings/notification-templates/com.day.cq.wcm.core.page

/apps/settings/notification-templates/com.day.cq.wcm.core.page

Orientação relativa à reestruturação

Os únicos novos modelos de email de notificação de evento de página compatíveis são oferecer suporte a novas localidades.

A resolução do Modelo de email do evento da página ocorre na seguinte ordem:

  1. /etc/notification/email/default/com.day.cq.wcm.core.page
  2. /apps/settings/notification-templates/com.day.cq.wcm.core.page
  3. /libs/settings/notification-templates/com.day.cq.wcm.core.page
Notas

Qualquer modelo de email de notificação de evento de página novo ou modificado deve ser migrado para o novo local em /apps:

  1. Copie qualquer modelo de email de notificação de evento de página novo ou modificado do local anterior para o novo local (/apps).
  2. Remova qualquer modelo de email de notificação de evento de página migrado do local anterior.

Andaime da página page-scaffolding

Localização anterior
/etc/scaffolding
Novas localizações
/libs/settings/ wcm /template-types/scaffolding/scaffolding/apps/settings/ wcm /template-types/scaffolding/scaffolding
Orientação relativa à reestruturação
O scaffolding criado no Local anterior usa a estrutura herdada Scaffolding e não pode ser migrado para o Novo local. Para alinhar com o novo local, qualquer scaffolding herdado deve ser redesenvolvido usando a estrutura Scaffolding compatível.
Notas
N/A

Grelha responsiva MENOR responsive-grid-less

Localização anterior
/etc/clientlibs/wcm/foundation/grid/grid_base.less
Novas localizações
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Orientação relativa à reestruturação

Qualquer referência ao Local anterior nos arquivos personalizados MENOS deve ser atualizada para ser importada do Novo local.

  • Atualize qualquer arquivo LESS personalizado que faça referência a grid_base.less no Local anterior para fazer referência ao novo local.
Notas
Fazendo referência a um grid_base.less O arquivo resulta no modo Layout do Editor de página e modelo não funcionar, além de uma interrupção do layout da página.

Designs de modelo estático static-template-designs

Localização anterior
/etc/designs/<custom-site>
Novas localizações
/apps/settings/wcm/designs/<custom-site>
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.

  1. Copie os designs do local anterior para o novo local (/apps).
  2. Converta qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
  3. Atualize referências ao Local anterior no cq:designPath propriedade via AEM > Sites > Páginas personalizadas do site > Propriedades da página > Guia Avançado > Campo de design.
  4. 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).
  5. Atualize AEM regras do Dispatcher para permitir a veiculação de bibliotecas de clientes por meio da /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
A abordagem recomendada é criar AEM Sites e Páginas usando Modelos editáveis que usam Conteúdo e políticas de estrutura no lugar de Designs.

Bibliotecas de clientes de integração da Adobe Target adobe-target-integration-client-libraries

Localização anterior
/etc/clientlibs/foundation/target
Novas localizações
/libs/cq/testandtarget/clientlibs/testandtarget
Orientação relativa à reestruturação

Qualquer uso personalizado dessas Bibliotecas de clientes deve fazer referência à Biblioteca de clientes por categoria e não por caminho.

  1. Qualquer referência à Biblioteca de clientes por caminho no Local anterior deve ser atualizada para usar Estrutura de referência da Biblioteca do cliente AEM.
  2. Se AEM estrutura de referência da Biblioteca do cliente não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio AEM servlet de proxy da biblioteca do cliente:
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/testandtarget.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/atjs-integration.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/init.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/mbox.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/parameters.js
  • /etc.clientlibs/cq/testandtarget/clientlibs/testandtarget/util.js
Notas

A edição dessas bibliotecas de clientes nunca foi suportada.

Para obter as categorias da Biblioteca de clientes , visite cada nó cq:ClientLIbraryFolder via CRXDELite e inspecione a propriedade categories :

  • /libs/cq/testandtarget/clientlibs/testandtarget/testandtarget
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs
  • /libs/cq/testandtarget/clientlibs/testandtarget/atjs-integration
  • /libs/cq/testandtarget/clientlibs/testandtarget/init
  • /libs/cq/testandtarget/clientlibs/testandtarget/mbox
  • /libs/cq/testandtarget/clientlibs/testandtarget/parameters
  • /libs/cq/testandtarget/clientlibs/testandtarget/util

Bibliotecas de clientes do WCM Foundation wcm-foundation-client-libraries

Localização anterior
/etc/clientlibs/wcm/foundation
Novas localizações
/libs/wcm/foundation/clientlibs
Orientação relativa à reestruturação

Qualquer uso personalizado dessas Bibliotecas de clientes deve fazer referência à Biblioteca de clientes por categoria e não por caminho.

  1. Qualquer referência à Biblioteca de clientes por caminho no Local anterior deve ser atualizada para usar Estrutura de referência da Biblioteca do cliente AEM.
  2. Se AEM estrutura de referência da Biblioteca do cliente não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio AEM servlet de Proxy da biblioteca do cliente.
  • /etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.css
  • /etc.clientlibs/wcm/foundation/clientlibs/main.js
Notas

A edição dessas bibliotecas de clientes nunca foi suportada.

Para obter as categorias da Biblioteca de clientes , visite cada cq:ClientLIbraryFolder nó via CRXDELite e inspecione a propriedade categories :

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56