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

Conforme descrito na página pai Reestruturação do repositório no AEM 6.5, os clientes que estão atualizando para o AEM 6.5 devem usar esta página para avaliar o esforço de trabalho associado às alterações no 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.5, enquanto outras podem ser adiadas até uma atualização futura.

Com Atualização 6.5

Antes de uma atualização futura

Com atualização para 6.5 with-upgrade

Segmentos ContextHub contexthub-segments

Local anterior
/etc/segmentation/contexthub
Novos locais

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

Orientações em matéria de reestruturação

Se algum segmento novo ou modificado do ContextHub for editado no controle do código-fonte em vez de ser editado no AEM, ele deverá ser migrado para o novo local:

  1. Copie todos os Segmentos do ContextHub novos ou modificados do local anterior para o novo local apropriado (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 a 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 por meio da

Interface do usuário do Depurador QueryBuilder do AEM

. Observe que esta é uma consulta de percurso, portanto, não a execute em relação à produção e garanta limites de percurso ajustados conforme necessário.

Notas

Os segmentos do ContextHub persistiram na exibição do local anterior como somente leitura em AEM > Personalization > 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>). Quaisquer novos segmentos do ContentHub criados no AEM serão mantidos no novo local (/conf/global ou /conf/<tenant>).

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

Todos os segmentos do ContextHub não utilizados dos sites de referência do AEM podem ser removidos e não migrados 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 de uma atualização futura prior-to-upgrade

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

Local anterior
/etc/clientlibs/foundation/sitecatalyst
Novos locais
/libs/cq/analytics/clientlibs/analytics
Orientações em matéria de reestruturação

Qualquer uso personalizado dessas bibliotecas de clientes deve fazer referência à biblioteca do cliente por categoria, e não por caminho:

  1. Qualquer referência à Biblioteca do cliente por caminho no Local Anterior deve ser atualizada para usar a estrutura de referência da Biblioteca do Cliente do AEM.

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

    • /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 do cliente, visite cada nó cq:ClientLIbraryFolder por meio do CRXDELite e inspecione a propriedade de categorias.

  • /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 de Word para Página da Web do Microsoft classic-microsoft-word-to-web-page-designs

Local anterior
/etc/designs/wordDesign
Novos locais

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

Orientações em matéria de reestruturação

Para qualquer design gerenciado em SCM e não gravado no 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 uma Biblioteca de Clientes com allowProxy = true.
  3. Atualize as 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 cliente (isso requer a atualização do código de implementação da Página).
  5. Atualize as regras de Dispatcher do AEM para permitir o fornecimento de Bibliotecas de Clientes por meio do servlet proxy /etc.clientlibs/.

Para qualquer design que NÃO seja gerenciado no SCM e modificado em tempo de execução via caixas de diálogo de design:

  • Não mova designs habilitados para o autor de /etc.
Notas
N/D

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

Local anterior
/etc/mobile
Novos locais

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Orientações em matéria de reestruturação

Quaisquer novas configurações do emulador de dispositivo móvel devem ser migradas para o novo local.

  1. Copie todas as 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 a da página jcr :content :
    [cq:Page]/jcr:content@cq: deviceGroups = Cadeia de caracteres[ móvel/grupos/responsivo ]
  3. Para todos os Modelos editáveis que dependem dessas Configurações do emulador de dispositivo móvel, atualize os Modelos editáveis, apontando para cq : deviceGroups para o novo local.
Notas

A resolução Configurações do emulador do 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

Local anterior
/etc/blueprints
Novos locais

/apps/msm (Configurações do blueprint do cliente)

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

Orientações em matéria de reestruturação

Quaisquer configurações de blueprint do gerenciador de vários sites novas ou modificadas devem ser migradas para o Novo local (/apps).

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

Todas as Configurações de Blueprint do Gerenciador de Vários Sites fornecidas pelo AEM 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 a serem ajustadas.

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

Local anterior
/etc/msm/rolloutConfigs
Novos locais

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Orientações em matéria de reestruturação

Quaisquer configurações de implementação de gerenciador de vários sites novas ou modificadas devem ser migradas para o novo local.

  1. Copie todas as Configurações de Implantação do Gerenciador de Vários Sites novas ou modificadas do Local Anterior para o novo local (/apps).
  2. Atualize todas as referências nas Páginas AEM para as Configurações de Implantação do Gerenciador de Vários Sites no Local Anterior, para apontar para seus homólogos nos Novos Locais (/libs ou /apps).

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

Notas
Falha ao remover as configurações de implantação do gerenciador de vários sites migradas do local anterior resulta na exibição de opções de implantação duplicadas para autores de AEM.

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

Local anterior
/etc/notification/email/default/com.day.cq.wcm.core.page
Novos locais

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

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

Orientações em matéria de reestruturação

Os únicos novos Modelos de e-mail de notificação de eventos de página compatíveis são os novos locais.

A resolução do Modelo de e-mail de evento de 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

Todos os Modelos de Email de Notificação de Eventos de Página novos ou modificados devem ser migrados para o novo local em /apps:

  1. Copie todos os Modelos de Email de Notificação de Eventos de Página novos ou modificados do Local Anterior para o novo local (/apps).
  2. Remova todos os modelos de e-mail de notificação de eventos de página migrados do local anterior.

Scaffolding da página page-scaffolding

Local anterior
/etc/scaffolding
Novos locais
/libs/settings/ wcm /tipos-modelo/andaime/andaime/apps/settings/ wcm /tipos-modelo/andaime/andaime
Orientações em matéria de reestruturação
O scaffolding criado no Local anterior usa a estrutura de scaffolding herdada e não pode ser migrado para o Novo local. Para alinhar com o novo local, qualquer andaime herdado deve ser recriado usando a estrutura de andaime compatível.
Notas
N/D

Grade responsiva LESS responsive-grid-less

Local anterior
/etc/clientlibs/wcm/foundation/grid/grid_base.less
Novos locais
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Orientações em matéria de reestruturação

Qualquer referência ao Local anterior em arquivos LESS personalizados deve ser atualizada para importar 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
Fazer referência a um arquivo grid_base.less não existente resulta no modo de layout da página e no Editor de modelo não funcionarem e em uma interrupção do layout da página.

Designs de modelos estáticos static-template-designs

Local anterior
/etc/designs/<custom-site>
Novos locais
/apps/settings/wcm/designs/<custom-site>
Orientações em matéria de reestruturação

Para qualquer design gerenciado em SCM e não gravado no 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 uma Biblioteca de Clientes com allowProxy = true.
  3. Atualize as referências ao Local Anterior na propriedade cq:designPath por meio de AEM > Sites > Páginas de Site Personalizadas > 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 cliente (isso requer a atualização do código de implementação da Página).
  5. Atualize as regras de Dispatcher do AEM para permitir o fornecimento de Bibliotecas de Clientes por meio do servlet proxy /etc.clientlibs/.

Para qualquer design que NÃO seja gerenciado no SCM e modificado em tempo de execução via caixas de diálogo de design:

  • Não mova designs habilitados para o autor 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 do Adobe Target adobe-target-integration-client-libraries

Local anterior
/etc/clientlibs/foundation/target
Novos locais
/libs/cq/testandtarget/clientlibs/testandtarget
Orientações em matéria de reestruturação

Qualquer uso personalizado dessas bibliotecas de clientes deve fazer referência à biblioteca do cliente por categoria, e não por caminho.

  1. Qualquer referência à Biblioteca do cliente por caminho no Local Anterior deve ser atualizada para usar a estrutura de referência da Biblioteca do Cliente do AEM.
  2. Se a estrutura de referência da Biblioteca do cliente do AEM não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio do servlet Proxy da Biblioteca do cliente do AEM:
  • /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 do cliente, 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

Local anterior
/etc/clientlibs/wcm/foundation
Novos locais
/libs/wcm/foundation/clientlibs
Orientações em matéria de reestruturação

Qualquer uso personalizado dessas bibliotecas de clientes deve fazer referência à biblioteca do cliente por categoria, e não por caminho.

  1. Qualquer referência à Biblioteca do cliente por caminho no Local Anterior deve ser atualizada para usar a estrutura de referência da Biblioteca do Cliente do AEM.
  2. Se a estrutura de referência da Biblioteca do cliente do AEM não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio do servlet Proxy da Biblioteca do cliente do AEM.
  • /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 do cliente, visite cada nó cq:ClientLIbraryFolder por meio do CRXDELite e inspecione a propriedade de categorias:

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2