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

Conforme descrito no pai Reestruturação do repositório no AEM 6.5 , os clientes que estiverem 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 para 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. Atualizar 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 via Interface do usuário do depurador AEM QueryBuilder. 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 no AEM > Personalização > Públicos.

Se os segmentos do ContextHub forem editáveis no AEM, eles devem 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 da página do AEM Sites permitem apenas o Local anterior (/etc) ou um único local novo (/apps, /conf/global ou /conf/<tenant>) para serem selecionados, portanto, os Segmentos do ContextHub devem ser migrados de acordo.

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. Todas as referências à Biblioteca do cliente por caminho no Local anterior devem ser atualizadas para uso Estrutura de referência da Biblioteca do cliente AEM.

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

    • /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 cq:ClientLIbraryFolder nó via 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 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. Converter qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente 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 do Dispatcher do AEM para permitir o fornecimento de Bibliotecas de clientes por meio do /etc.clientlibs/ servlet proxy.

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 remova os designs editáveis do /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 o do jcr ``:content nó:
    [cq:Page]/jcr:content@cq: deviceGroups = String[ 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 a 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 do 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 equivalentes 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 e-mail 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 e-mail 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 /template-types/scaffolding/scaffolding

/apps/settings/ wcm /template-types/scaffolding/scaffolding

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
Referência a um não existente grid_base.less O arquivo faz com que o Modo de layout da página e o Editor de modelo não funcionem e causa uma interrupção no 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. Converter qualquer CSS, JavaScript e recursos estáticos no Design em um Biblioteca do cliente com allowProxy = true.
  3. Atualizar referências ao Local anterior na cq:designPath propriedade via AEM > Sites > Páginas do 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 do Dispatcher do AEM para permitir o fornecimento de Bibliotecas de clientes por meio do /etc.clientlibs/ servlet proxy.

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 remova os designs editáveis do /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. Todas as referências à Biblioteca do cliente por caminho no Local anterior devem ser atualizadas para uso Estrutura de referência da Biblioteca do cliente AEM.
  2. Se a estrutura de referência da Biblioteca do cliente AEM não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio do servlet AEM Client Library Proxy:
  • /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. Todas as referências à Biblioteca do cliente por caminho no Local anterior devem ser atualizadas para uso Estrutura de referência da Biblioteca do cliente AEM.
  2. Se a estrutura de referência da Biblioteca do cliente AEM não puder ser usada, o caminho absoluto das Bibliotecas do cliente poderá ser referenciado por meio do servlet AEM Client Library Proxy.
  • /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 cq:ClientLIbraryFolder por meio do CRXDELite e inspecione a propriedade categories:

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