Show Menu
TÓPICOS×

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

Conforme descrito na página principal 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 no repositório que afetam a solução 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 AEM 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 (/ apps , /conf/global ou /conf/<tenant> )
  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> ).
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 do API do Construtor de Query AEM QueryBuilder. Observe que esta é uma consulta transversal, portanto, não a 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 > Públicos .
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 no 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 do AEM podem ser removidos e não migrados para o novo local:
  • /etc/segmentation/geometrixx/
  • /etc/segmentation/geometrixx-outdoors
Observação: Se ClientContext estiver em uso, é recomendável converter em ContextHub.

Antes da atualização do 6.5

Bibliotecas de clientes do 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 a estrutura de referência da Biblioteca de clientes 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 pelo 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 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 category.
  • /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 Biblioteca do cliente (isso requer a atualização do código de implementação da Página).
  5. Atualize as regras do AEM 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 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 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 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 duplicadas exibidas aos autores do AEM.

Modelo de email 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 compatível.
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
Quaisquer referências ao Local anterior em arquivos MENOS personalizados devem ser atualizadas para importar 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 funcionam, 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 > Campo de design.
  4. Atualize quaisquer Páginas que façam referência ao Local anterior para usar a nova categoria Biblioteca do cliente (isso requer a atualização do código de implementação da Página).
  5. Atualize as regras do AEM 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 sites e páginas do AEM usando modelos editáveis que usam conteúdo de 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 a estrutura de referência da Biblioteca de clientes do AEM.
  2. Se a estrutura de referência da Biblioteca de clientes do AEM não puder ser usada, o caminho absoluto das Bibliotecas de clientes poderá ser referenciado pelo servlet Proxy da biblioteca de clientes do AEM:
  • /etc.clientlibs/cq/searchpromote/clientlibs/searchpromotei.js
Notas
A edição destas 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 de categorias:
  • /libs/cq/searchpromote/clientlibs/searchpromote

Bibliotecas do cliente de integração do 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 a estrutura de referência da Biblioteca de clientes do AEM.
  2. Se a estrutura de referência da Biblioteca de clientes do AEM não puder ser usada, o caminho absoluto das Bibliotecas de clientes poderá ser referenciado pelo servlet Proxy da biblioteca de clientes 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 destas 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 de categorias:
  • /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 a estrutura de referência da Biblioteca de clientes 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 pelo 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 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 de categorias:
  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main