Restruturação do repositório de sites no AEM 6.4

Conforme descrito na página principal Reestruturação do Repositório AEM 6.4, os clientes que atualizam para 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

Segmentos ContextHub

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 (/%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 por 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 persistiram 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 apenas que o Local anterior (/etc) ou um único novo local (/apps, /conf/global ou /conf/<tenant>) seja selecionado, portanto, os Segmentos do ContextHub devem ser migrados de acordo.

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

Bibliotecas de clientes do Adobe Analytics

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 AEM estrutura de referência da Biblioteca de clientes.
  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 nó cq:ClientLIbraryFolder 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

Microsoft Word clássico para designs de página da Web

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 uma 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 o serviço de bibliotecas de clientes por meio do servlet proxy /etc.clientlibs/.

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

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 da página jcr :content :
    [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 cq : deviceGroups para o novo local.
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

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

Qualquer configuração do Blueprint do Gerenciador de Vários Sites nova ou modificada deve ser migrada 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 implantação do gerenciador de vários sites

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 quaisquer referências nas Páginas AEM para Configurações de Implantação do Gerenciador de Vários Sites no Local Anterior, para apontar para seus homólogos em 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

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

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

/libs/settings/ wcm /templates-types/scaffolding/scaffolding

/apps/settings/ wcm /templates-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

Grade Responsiva MENOR

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 Fazer referência a um arquivo grid_base.less não existente resulta no funcionamento do Modo de layout da página e do Editor de modelo, além de uma interrupção do layout da página.

Designs de modelo estático

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 uma Biblioteca do cliente com allowProxy = true.
  3. Atualize referências ao Local anterior na propriedade cq:designPath por meio de 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 o fornecimento de Bibliotecas de Clientes por meio do servlet proxy /etc.clientlibs/.

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 Adobe Search and Promote

Localização anterior

/etc/clientlibs/foundation/searchpromote

Novas localizações /libs/cq/searchpromote/clientlibs/searchpromote
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 AEM estrutura de referência da Biblioteca de clientes.
  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/searchpromote/clientlibs/searchpromotei.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/searchpromote/clientlibs/searchpromote

Bibliotecas de clientes da integração do Adobe Target

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 AEM estrutura de referência da Biblioteca de clientes.
  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

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 AEM estrutura de referência da Biblioteca de clientes.
  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 nó cq:ClientLIbraryFolder por meio do CRXDELite e inspecione a propriedade categories :

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main

Nesta página