Reestruturação do repositório Sites no AEM 6.4

Conforme descrito na página principal Reestruturação do repositório AEM 6.4 , os clientes que atualizam para a AEM 6.4 devem usar esta página para avaliar o esforço de trabalho associado às alterações no repositório que afetam a AEM Sites Solution. 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 atualização 6.4

Antes da atualização do 6.5

Com atualização 6.4

Segmentos ContextHub

Localização anterior /etc/segmentation/contexthub
Novos locais

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

Orientação relativa à reestruturação

Se algum 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. Copiar quaisquer segmentos do ContextHub novos ou modificados do local anterior para o novo local apropriado (/%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 as referências aos segmentos do ContextHub no local anterior para os segmentos do ContextHub migrados nos novos locais (/apps, /conf/global, /conf/<tenant>).

O seguinte query do QueryBuilder localiza todas as referências a 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áriodo QueryBuilder Debugger. Observe que este é um query que atravessa, portanto, não o execute na produção e verifique se os limites transversais estão ajustados conforme necessário.

Notas

Os segmentos do ContextHub persistiram até o local anterior serem exibidos como somente leitura em AEM > Personalização > Audiência.

Se os segmentos do ContextHub forem editáveis no AEM, eles deverão ser migrados para o novo local (/conf/global ou /conf/<tenant>). Todos os novos segmentos do ContentHub criados em AEM são persistentes para o 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.

Todos os segmentos do ContextHub não utilizados dos sites de referência 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 em ContextHub.

Antes da atualização do 6.5

Bibliotecas do cliente Adobe Analytics

Localização anterior

/etc/clientlibs/foundation/sitecatalyst

Novos locais /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. Quaisquer referências à Biblioteca de clientes por caminho no Local anterior devem ser atualizadas para usar AEM estruturade referência da Biblioteca de clientes.
  2. Se AEM estrutura de referência da Biblioteca de clientes não puder ser usada, o caminho absoluto das Bibliotecas de clientes poderá ser referenciado pelo servlet AEM Proxy da Biblioteca de clientes.
    • /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 destas 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 categoria.

  • /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

Localização anterior /etc/designs/wordDesign
Novos locais

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

Orientação relativa à reestruturação

Para qualquer design gerenciado no SCM e não gravado em tempo de execução por meio das 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 as referências ao Local anterior na propriedade cq:designPath.
  4. Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria da Biblioteca do cliente (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 do Cliente por meio do servlet /etc.clientlibs/ proxy.

Para qualquer design que NÃO seja gerenciado no SCM e tempo de execução modificado por meio das Caixas de diálogo de design:

  • Não remova os Designs que podem ser criados para autores de /etc.
Notas N/A

Configurações do emulador de dispositivo móvel

Localização anterior

/etc/mobile

Novos locais

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Orientação relativa à reestruturação Todas as novas configurações do emulador de dispositivos móveis devem ser migradas 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 qualquer página do AEM Sites que dependa dessas configurações do emulador de dispositivos móveis, atualize o nó da página jcr :content :
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
  3. Para qualquer Modelo editável que dependa 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 das 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 de Blueprint do Multi-site Manager

Localização anterior /etc/blueprints
Novos locais

/apps/msm (Configurações de Blueprint do cliente)

/libs/msm (Configurações do out of the Box Blueprint para Screens, Comércio)

Orientação relativa à reestruturação

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

  1. Copie quaisquer Configurações 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 Multi-site Manager migradas do Local anterior.
Notas

Todas as AEM fornecidas Configurações de Blueprint do Multi-site Manager existem no novo local em /libs.

O conteúdo não faz referência às Configurações azuis do Multi-site Manager, portanto, não há referências de conteúdo para ajustar.

Configurações de implantação do Multi-site Manager

Localização anterior

/etc/msm/rolloutConfigs

Novos locais

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Orientação relativa à reestruturação

Quaisquer Configurações de implantação do Multi-site Manager novas ou modificadas devem ser migradas para o novo local.

  1. Copie quaisquer Configurações de implantação do Multi-site Manager novas ou modificadas do Local anterior para o novo local (/apps).
  2. Atualize quaisquer referências em Páginas AEM para Configurações de implantação do Multi-site Manager no Local anterior, para apontar para os seus homólogos em Novos locais (/libs ou /apps).

Remova as Configurações de implantação do Multi-site Manager migradas do Local anterior.

Notas Falha ao remover as Configurações de implantação do Multi-site Manager migradas do Local anterior resulta em opções de implantação do duplicado exibidas para autores AEM.

Modelo de e-mail de notificação de Evento de página

Localização 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ção relativa à reestruturação

Os únicos modelos de e-mail de notificação de Evento de página suportados são para suportar novas localidades.

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

Todos os modelos de e-mail de notificação de Evento 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 Evento 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 Evento de página migrados do local anterior.

Andaime da página

Localização anterior /etc/scaffolding
Novos locais

/libs/settings/ wcm /template-types/scaffolding/scaffolding

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

Orientação relativa à reestruturação Os andaimes criados no Local anterior usam a estrutura de andaimes herdada e não podem ser migrados para o novo local. Para alinhar com o novo local, qualquer Andaime herdado deve ser redesenvolvido usando a estrutura Scaffolding suportada.
Notas N/A

Grade responsiva MENOS

Localização anterior /etc/clientlibs/wcm/foundation/grid/grid_base.less
Novos locais /libs/wcm/foundation/clientlibs/grid/grid_base.less
Orientação relativa à reestruturação

Todas as referências ao Local anterior em arquivos MENOS personalizados devem ser atualizadas para serem importadas do Novo local.

  • Atualize quaisquer arquivos LESS personalizados que façam referência a grid_base.less no Local anterior para fazer referência ao novo local.
Notas A referência a um grid_base.less arquivo não existente resulta no Modo de layout da página e no Editor de modelos que não estão funcionando, além de uma interrupção no layout da página.

Modelos estáticos de modelos

Localização anterior /etc/designs/<custom-site>
Novos locais /apps/settings/wcm/designs/<custom-site>
Orientação relativa à reestruturação

Para qualquer design gerenciado no SCM e não gravado em tempo de execução por meio das 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 as referências ao Local anterior na cq:designPath propriedade por meio de AEM > Sites > Páginas personalizadas do site > Propriedades da página > Guia Avançado > Campode design.
  4. Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria da Biblioteca do cliente (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 do Cliente por meio do servlet /etc.clientlibs/ proxy.

Para qualquer design que NÃO seja gerenciado no SCM e tempo de execução modificado por meio das Caixas de diálogo de design:

  • Não remova os Designs que podem ser criados para autores de /etc.
Notas A abordagem recomendada é criar AEM Sites e páginas usando modelos editáveis que usam Conteúdo da estrutura e políticas em vez de Designs.

Bibliotecas do cliente de integração do Adobe Search and Promote

Localização anterior

/etc/clientlibs/foundation/searchpromote

Novos locais /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. Quaisquer referências à Biblioteca de clientes por caminho no Local anterior devem ser atualizadas para usar AEM estruturade 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 pelo servlet AEM Proxy da Biblioteca do cliente:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
Notas

A edição destas 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 categoria:

  • /libs/cq/searchpromote/clientlibs/searchpromote

Bibliotecas do cliente de integração da Adobe Target

Localização anterior

/etc/clientlibs/foundation/target

Novos locais /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. Quaisquer referências à Biblioteca de clientes por caminho no Local anterior devem ser atualizadas para usar AEM estruturade 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 pelo servlet AEM 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 destas 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 categoria:

  • /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

Novos locais /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. Quaisquer referências à Biblioteca de clientes por caminho no Local anterior devem ser atualizadas para usar AEM estruturade referência da Biblioteca de clientes.
  2. Se AEM estrutura de referência da Biblioteca de clientes não puder ser usada, o caminho absoluto das Bibliotecas de clientes poderá ser referenciado pelo servlet AEM Proxy da Biblioteca de clientes.
  • /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 destas 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 categoria:

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

Nesta página