Ristrutturazione dell’archivio Sites in AEM 6.5 sites-repository-restructuring-in-aem

Last update: Wed Apr 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Upgrading

Creato per:

Admin

Come descritto sull’elemento padre Ristrutturazione dell’archivio in AEM 6.5 pagina, i clienti che eseguono l’aggiornamento a AEM 6.5 devono utilizzare questa pagina per valutare l’impegno di lavoro associato alle modifiche dell’archivio che influiscono sulla soluzione AEM Sites. Alcune modifiche richiedono un impegno di lavoro durante il processo di aggiornamento AEM 6.5, mentre altre possono essere differite fino a un aggiornamento futuro.

Con aggiornamento 6.5

Segmenti ContextHub

Prima di un aggiornamento futuro

Con aggiornamento 6.5 with-upgrade

Segmenti ContextHub contexthub-segments

Posizione precedente

/etc/segmentation/contexthub

Nuove posizioni

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

Orientamenti per la ristrutturazione

Se alcuni segmenti ContextHub nuovi o modificati vengono modificati nel controllo del codice sorgente anziché essere modificati in AEM, è necessario migrarli alla nuova posizione:

Copia tutti i segmenti ContextHub nuovi o modificati dalla posizione precedente alla nuova posizione appropriata (https://experienceleague.adobe.com/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20o%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=it)
Aggiorna i riferimenti ai segmenti ContextHub nella posizione precedente nei segmenti ContextHub migrati nelle nuove posizioni (/apps, /conf/global, /conf/<tenant>).

La query QueryBuilder seguente individua tutti i riferimenti ai segmenti ContextHub nelle posizioni precedenti.

path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%

Questa operazione può essere eseguita tramite

Interfaccia utente di Debugger di AEM QueryBuilder

. Tieni presente che si tratta di una query di attraversamento, pertanto non eseguirla in produzione e assicurati che i limiti di attraversamento vengano corretti in base alle esigenze.

Note

I segmenti ContextHub persistenti nella posizione precedente vengono visualizzati in sola lettura in AEM > Personalizzazione > Tipi di pubblico.

Se i segmenti ContextHub devono essere modificabili in AEM, è necessario migrarli alla nuova posizione (/conf/global o /conf/<tenant>). Tutti i nuovi segmenti di ContentHub creati in AEM vengono salvati nella nuova posizione (/conf/global o /conf/<tenant>).

Le proprietà della pagina di AEM Sites consentono solo la posizione precedente (/etc) o un'unica nuova posizione (/apps, /conf/global o /conf/<tenant>) per essere selezionato, pertanto è necessario migrare di conseguenza i segmenti ContextHub.

Eventuali segmenti ContextHub inutilizzati dai siti di riferimento AEM possono essere rimossi e non migrati alla nuova posizione:

/etc/segmentation/geometrixx/
/etc/segmentation/geometrixx-outdoors

Nota: se il ClientContext è in uso, si consiglia di convertirlo in ContextHub.

Prima di un aggiornamento futuro prior-to-upgrade

Librerie client di Adobe Analytics adobe-analytics-client-libraries

Posizione precedente

/etc/clientlibs/foundation/sitecatalyst

Nuove posizioni

/libs/cq/analytics/clientlibs/analytics

Orientamenti per la ristrutturazione

Qualsiasi utilizzo personalizzato di queste librerie client deve fare riferimento alla libreria client per categoria e non per percorso:

Eventuali riferimenti alla libreria client per percorso nel percorso precedente devono essere aggiornati per l’utilizzo Framework di riferimento della libreria client AEM.
Se non è possibile utilizzare il framework di riferimento della libreria client AEM, è possibile fare riferimento al percorso assoluto delle librerie client tramite il servlet proxy della libreria client 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

Note

La modifica di queste librerie client non è mai stata supportata.

Per ottenere le categorie della libreria client, visita ciascuna cq:ClientLIbraryFolder tramite CRXDELite e controlla la proprietà 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

Progettazioni classiche da Microsoft Word a pagine Web classic-microsoft-word-to-web-page-designs

Posizione precedente

/etc/designs/wordDesign

Nuove posizioni

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

Orientamenti per la ristrutturazione

Per qualsiasi design gestito in SCM e non scritto in fase di esecuzione tramite le finestre di dialogo per progettazione.

Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps).
Convertire qualsiasi risorsa CSS, JavaScript e statica nella progettazione in una Libreria client con allowProxy = true.
Aggiornare i riferimenti alla posizione precedente nella proprietà cq:designPath.
Aggiorna tutte le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
Aggiorna le regole del Dispatcher AEM per consentire la distribuzione delle librerie client tramite /etc.clientlibs/ servlet proxy

Per tutte le progettazioni che NON sono state gestite in SCM e che sono state modificate in fase di esecuzione tramite le finestre di dialogo di progettazione:

Non spostare i design modificabili da /etc.

Note

N/D

Configurazioni emulatore dispositivo mobile mobile-device-emulator-configurations

Posizione precedente

/etc/mobile

Nuove posizioni

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Orientamenti per la ristrutturazione

Tutte le nuove configurazioni dell’emulatore di dispositivi mobili devono essere migrate alla nuova posizione.

Copia le nuove configurazioni dell’emulatore di dispositivi mobili dalla posizione precedente alla nuova posizione (/apps, /conf/global, /conf/<tenant>).
Per tutte le pagine AEM Sites che dipendono da queste configurazioni dell’emulatore di dispositivi mobili, aggiorna il jcr ``:content nodo:
[cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
Per tutti i modelli modificabili che dipendono da queste configurazioni dell’emulatore di dispositivi mobili, aggiorna i modelli modificabili, puntando il cq : deviceGroups nella nuova posizione.

Note

La risoluzione delle configurazioni dell’emulatore di dispositivi mobili avviene nell’ordine seguente:

/conf/<tenant>/settings/mobile
/conf/global/settings/mobile
/apps/settings/mobile
/libs/settings/mobile
/etc/mobile

Configurazioni blueprint per Multi-Site Manager multi-site-manager-blueprint-configurations

Posizione precedente

/etc/blueprints

Nuove posizioni

/apps/msm (Configurazioni blueprint cliente)

/libs/msm (Configurazioni blueprint predefinite per Screens, Commerce)

Orientamenti per la ristrutturazione

Qualsiasi configurazione blueprint di Multi-Site Manager nuova o modificata deve essere migrata alla nuova posizione (/apps).

Copia tutte le configurazioni blueprint di Multi-Site Manager nuove o modificate dalla posizione precedente alla nuova posizione (/apps).
Rimuovi tutte le configurazioni blueprint di Multi-Site Manager migrate dalla posizione precedente.

Note

Tutte le configurazioni blueprint per Multi-Site Manager fornite dall’AEM esistono nella nuova posizione in /libs.

Il contenuto non fa riferimento alle configurazioni blu di Multi-Site Manager, pertanto non sono presenti riferimenti al contenuto da regolare.

Configurazioni di rollout di Multi-Site Manager multi-site-manager-rollout-configurations

Posizione precedente

/etc/msm/rolloutConfigs

Nuove posizioni

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Orientamenti per la ristrutturazione

Tutte le configurazioni di rollout di Multi-Site Manager nuove o modificate devono essere migrate alla nuova posizione.

Copia tutte le configurazioni di rollout di Multi-Site Manager nuove o modificate dalla posizione precedente alla nuova posizione (/apps).
Aggiornare tutti i riferimenti nelle pagine AEM alle configurazioni di rollout di Multi-Site Manager nella posizione precedente, per puntare alle controparti nelle nuove posizioni (/libs o /apps).

Rimuovi le configurazioni di rollout di Multi-Site Manager migrate dalla posizione precedente.

Note

Se non si rimuovono le configurazioni di rollout di Multi-Site Manager migrate dalla posizione precedente, gli autori AEM visualizzano opzioni di rollout duplicate.

Modello e-mail notifica evento pagina page-event-notification-e-mail-template

Posizione precedente

/etc/notification/email/default/com.day.cq.wcm.core.page

Nuove posizioni

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

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

Orientamenti per la ristrutturazione

Gli unici nuovi modelli di posta elettronica di notifica eventi pagina supportati sono quelli che supportano le nuove impostazioni internazionali.

La risoluzione del modello di posta elettronica eventi pagina viene eseguita nell'ordine seguente:

/etc/notification/email/default/com.day.cq.wcm.core.page
/apps/settings/notification-templates/com.day.cq.wcm.core.page
/libs/settings/notification-templates/com.day.cq.wcm.core.page

Note

Qualsiasi modello di posta elettronica di notifica eventi pagina nuovo o modificato deve essere migrato nella nuova posizione in /apps:

Copiare nella nuova posizione tutti i modelli di messaggio di notifica eventi pagina nuovi o modificati dalla posizione precedente (/apps).
Rimuovere i modelli di posta elettronica di notifica eventi pagina migrati dalla posizione precedente.

Scaffolding pagine page-scaffolding

Posizione precedente

/etc/scaffolding

Nuove posizioni

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

Orientamenti per la ristrutturazione

Lo scaffolding creato nella posizione precedente utilizza il framework di scaffolding legacy e non può essere migrato nella nuova posizione. Per allinearsi alla nuova posizione, qualsiasi scaffolding legacy deve essere risviluppato utilizzando il framework di scaffolding supportato.

Note

N/D

Griglia reattiva MENO responsive-grid-less

Posizione precedente

/etc/clientlibs/wcm/foundation/grid/grid_base.less

Nuove posizioni

/libs/wcm/foundation/clientlibs/grid/grid_base.less

Orientamenti per la ristrutturazione

Eventuali riferimenti alla posizione precedente nei file LESS personalizzati devono essere aggiornati per l’importazione dalla nuova posizione.

Aggiornare tutti i file LESS personalizzati di riferimento che fanno riferimento a grid_base.less nella posizione precedente per fare riferimento alla nuova posizione.

Note

Con riferimento a un non esistente grid_base.less Il file impedisce il funzionamento della modalità Layout dell’Editor pagina e modello e altera il layout della pagina.

Progettazioni modelli statici static-template-designs

Posizione precedente

/etc/designs/<custom-site>

Nuove posizioni

/apps/settings/wcm/designs/<custom-site>

Orientamenti per la ristrutturazione

Per qualsiasi design gestito in SCM e non scritto in fase di esecuzione tramite le finestre di dialogo per progettazione.

Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps).
Convertire qualsiasi risorsa CSS, JavaScript e statica nella progettazione in una Libreria client con allowProxy = true.
Aggiornare i riferimenti alla posizione precedente in cq:designPath proprietà tramite AEM > Sites > Pagine del sito personalizzate > Proprietà pagina > Scheda Avanzate > Campo di progettazione.
Aggiorna tutte le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
Aggiorna le regole del Dispatcher AEM per consentire la distribuzione delle librerie client tramite /etc.clientlibs/ servlet proxy

Per tutte le progettazioni che NON sono state gestite in SCM e che sono state modificate in fase di esecuzione tramite le finestre di dialogo di progettazione:

Non spostare i design modificabili da /etc.

Note

L’approccio consigliato è quello di creare AEM Sites e pagine utilizzando modelli modificabili che utilizzano Contenuto struttura e Criteri al posto di Progettazioni.

Librerie client di integrazione Adobe Target adobe-target-integration-client-libraries

Posizione precedente

/etc/clientlibs/foundation/target

Nuove posizioni

/libs/cq/testandtarget/clientlibs/testandtarget

Orientamenti per la ristrutturazione

Qualsiasi utilizzo personalizzato di queste librerie client deve fare riferimento alla libreria client per categoria e non per percorso.

Eventuali riferimenti alla libreria client per percorso nel percorso precedente devono essere aggiornati per l’utilizzo Framework di riferimento della libreria client AEM.
Se non è possibile utilizzare il framework di riferimento della libreria client AEM, è possibile fare riferimento al percorso assoluto delle librerie client tramite il servlet proxy della libreria client 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

Note

La modifica di queste librerie client non è mai stata supportata.

Per ottenere le categorie della libreria client, visita ogni nodo cq:ClientLIbriaryFolder tramite CRXDELite e controlla la proprietà 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

Librerie client WCM Foundation wcm-foundation-client-libraries

Posizione precedente

/etc/clientlibs/wcm/foundation

Nuove posizioni

/libs/wcm/foundation/clientlibs

Orientamenti per la ristrutturazione

Qualsiasi utilizzo personalizzato di queste librerie client deve fare riferimento alla libreria client per categoria e non per percorso.

Eventuali riferimenti alla libreria client per percorso nel percorso precedente devono essere aggiornati per l’utilizzo Framework di riferimento della libreria client AEM.
Se non è possibile utilizzare il framework di riferimento della libreria client AEM, è possibile fare riferimento al percorso assoluto delle librerie client tramite il servlet proxy della libreria client AEM.

/etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
/etc.clientlibs/wcm/foundation/clientlibs/main.css
/etc.clientlibs/wcm/foundation/clientlibs/main.js

Note

La modifica di queste librerie client non è mai stata supportata.

Per ottenere le categorie della libreria client, visita ciascuna cq:ClientLIbraryFolder tramite CRXDELite ed esamina la proprietà Categories:

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2