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

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

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. Atualize 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 por meio da

Interface do usuário do Depurador QueryBuilder do AEM

. 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.

Os segmentos do ContextHub persistiram na exibição do local anterior como somente leitura em AEM > Personalization > 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>). Quaisquer novos segmentos do ContentHub criados no AEM serão mantidos no novo local (/conf/global ou /conf/<tenant>).

As Propriedades de página do AEM Sites permitem apenas que o Local anterior (/etc) ou um único local novo (/apps, /conf/global ou /conf/<tenant>) seja selecionado, portanto, os Segmentos do ContextHub devem ser migrados adequadamente.

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.

Qualquer uso personalizado dessas bibliotecas de clientes deve fazer referência à biblioteca do cliente por categoria, e não por caminho:

1. Qualquer referência à Biblioteca do cliente por caminho no Local Anterior deve ser atualizada para usar a estrutura de referência da Biblioteca do Cliente 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 por meio do 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

A edição dessas bibliotecas de clientes nunca foi suportada.

Para obter as categorias da Biblioteca do cliente, visite cada nó cq:ClientLIbraryFolder por meio do CRXDELite e inspecione a propriedade de categorias.

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

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

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. Converta qualquer CSS, JavaScript e recursos estáticos no Design em uma Biblioteca de Clientes 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 de Dispatcher do AEM para permitir o fornecimento de Bibliotecas de Clientes por meio do servlet proxy /etc.clientlibs/.

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 mova designs habilitados para o autor de /etc.

N/D

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

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 a da página jcr Nó :content :
   [cq:Page]/jcr:content@cq: deviceGroups = Cadeia de caracteres[ 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 cq : deviceGroups para o novo local.

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

/apps/msm (Configurações do blueprint do cliente)

/libs/msm (Configurações do blueprint prontas para uso para Screens, Commerce)

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.

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.

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

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 homólogos nos Novos Locais (/libs ou /apps).

Remova as Configurações de implantação do gerenciador de vários sites migradas do local anterior.

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.

/libs/settings/notification-templates/com.day.cq.wcm.core.page

/apps/settings/notification-templates/com.day.cq.wcm.core.page

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

Todos os Modelos de Email 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 Email 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.

/libs/settings/ wcm /tipos-modelo/andaime/andaime/apps/settings/ wcm /tipos-modelo/andaime/andaime

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.

N/D

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.

Fazer referência a um arquivo grid_base.less não existente resulta no modo de layout da página e no Editor de modelo não funcionarem e em uma interrupção do layout da página.

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. Converta qualquer CSS, JavaScript e recursos estáticos no Design em uma Biblioteca de Clientes com allowProxy = true.
3. Atualize as referências ao Local Anterior na propriedade cq:designPath por meio de AEM > Sites > Páginas de 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 de Dispatcher do AEM para permitir o fornecimento de Bibliotecas de Clientes por meio do servlet proxy /etc.clientlibs/.

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 mova designs habilitados para o autor de /etc.

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.

Qualquer uso personalizado dessas bibliotecas de clientes deve fazer referência à biblioteca do cliente por categoria, e não por caminho.

1. Qualquer referência à Biblioteca do cliente por caminho no Local Anterior deve ser atualizada para usar a estrutura de referência da Biblioteca do Cliente 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 por meio do servlet Proxy da Biblioteca do cliente 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

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

Qualquer uso personalizado dessas bibliotecas de clientes deve fazer referência à biblioteca do cliente por categoria, e não por caminho.

1. Qualquer referência à Biblioteca do cliente por caminho no Local Anterior deve ser atualizada para usar a estrutura de referência da Biblioteca do Cliente 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 por meio do 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

A edição dessas bibliotecas de clientes nunca foi suportada.

Para obter as categorias da Biblioteca do cliente, visite cada nó cq:ClientLIbraryFolder por meio do CRXDELite e inspecione a propriedade de categorias:

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