Show Menu
TÓPICOS×

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

Conforme descrito na página principal Reestruturação do repositório no AEM 6.5 , os clientes que atualizam 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 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 da atualização futura

Com atualização 6.5

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 Query Builder 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 futura

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