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

/apps/settings/wcm/segments

/conf/settings/settings/wcm/segments

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

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

1. Copia 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)
2. Aggiornare i riferimenti ai segmenti ContextHub nella posizione precedente ai 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 QueryBuilder Debugger di AEM

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

I segmenti ContextHub persistenti nella posizione precedente vengono visualizzati in sola lettura in AEM > Personalization > Audiences.

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

Le proprietà di pagina di AEM Sites consentono di selezionare solo la posizione precedente (/etc) o una singola nuova posizione (/apps, /conf/global o /conf/<tenant>), pertanto è necessario eseguire la migrazione dei segmenti ContextHub di conseguenza.

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.

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

1. Eventuali riferimenti alla libreria client per percorso nel percorso precedente devono essere aggiornati per utilizzare il framework di riferimento della libreria client AEM.

2. Se non è possibile utilizzare il framework di riferimento della libreria client dell’AEM, è possibile fare riferimento al percorso assoluto delle librerie client tramite il servlet proxy della libreria client dell’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

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

Per ottenere le categorie della libreria client, visitare ogni nodo cq:ClientLIbraryFolder tramite CRXDELite e controllare la proprietà delle categorie.

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

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

1. Copiare le progettazioni dal percorso precedente al nuovo percorso (/apps).
2. Convertire le risorse CSS, JavaScript e statiche nella progettazione in una Libreria client con allowProxy = true.
3. Aggiornare i riferimenti alla posizione precedente nella proprietà cq:designPath.
4. 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).
5. Aggiornare le regole Dispatcher AEM per consentire la distribuzione di librerie client tramite il servlet proxy /etc.clientlibs/.

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 design modificabili da /etc.

N/D

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

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

1. Copiare le nuove configurazioni dell'emulatore di dispositivi mobili dal percorso precedente al nuovo percorso (/apps, /conf/global, /conf/<tenant>).
2. Per tutte le pagine AEM Sites che dipendono da queste configurazioni dell'emulatore di dispositivi mobili, aggiorna il della pagina jcr ``:content nodo:
   [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/groups/responsive ]
3. Per tutti i modelli modificabili che dipendono da queste configurazioni dell'emulatore di dispositivi mobili, aggiorna i modelli modificabili, puntando su cq : deviceGroups nel nuovo percorso.

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

1. /conf/<tenant>/settings/mobile
2. /conf/global/settings/mobile
3. /apps/settings/mobile
4. /libs/settings/mobile
5. /etc/mobile

/apps/msm (Configurazioni blueprint cliente)

/libs/msm (Configurazioni blueprint pronte all’uso per Screens, Commerce)

Qualsiasi configurazione blueprint di Multi-Site Manager nuova o modificata deve essere migrata al nuovo percorso (/apps).

1. Copiare le configurazioni blueprint di Multi-Site Manager nuove o modificate dal percorso precedente al nuovo percorso (/apps).
2. Rimuovi tutte le configurazioni blueprint di Multi-Site Manager migrate dalla posizione precedente.

Tutte le configurazioni blueprint per Multi-Site Manager fornite dall'AEM sono presenti 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.

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

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

1. Copiare le configurazioni di rollout di Multi-Site Manager nuove o modificate dal percorso precedente al nuovo percorso (/apps).
2. Aggiornare tutti i riferimenti nelle pagine AEM alle configurazioni di rollout di Multi-Site Manager nel percorso precedente, in modo che puntino alle relative controparti nei nuovi percorsi (/libs o /apps).

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

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

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

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

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:

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

Qualsiasi modello di posta elettronica di notifica eventi pagina nuovo o modificato deve essere migrato nel nuovo percorso in /apps:

1. Copiare i modelli di posta elettronica per le notifiche di eventi pagina nuovi o modificati dal percorso precedente al nuovo percorso (/apps).
2. Rimuovere i modelli di posta elettronica di notifica eventi pagina migrati dalla posizione precedente.

/libs/settings/ wcm /tipi-modello/scaffolding/scaffolding/apps/settings/ wcm /tipi-modello/scaffolding/scaffolding

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.

N/D

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.

Il riferimento a un file grid_base.less non esistente comporta il mancato funzionamento della modalità Layout dell'Editor pagina e modello e l'interruzione del layout della pagina.

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

1. Copiare le progettazioni dal percorso precedente al nuovo percorso (/apps).
2. Convertire le risorse CSS, JavaScript e statiche nella progettazione in una Libreria client con allowProxy = true.
3. Aggiornare i riferimenti alla posizione precedente nella proprietà cq:designPath tramite AEM > Siti > Pagine del sito personalizzate > Proprietà pagina > Scheda Avanzate > Campo di progettazione.
4. 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).
5. Aggiornare le regole Dispatcher AEM per consentire la distribuzione di librerie client tramite il servlet proxy /etc.clientlibs/.

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 design modificabili da /etc.

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

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

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

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

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

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

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

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

Per ottenere le categorie della libreria client, visitare ogni nodo cq:ClientLIbraryFolder tramite CRXDELite e controllare la proprietà delle categorie:

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