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

Come descritto nella pagina padre Ristrutturazione dell’archivio in AEM 6.5, 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

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:

  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.

Note

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.

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:

  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
Note

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

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.

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

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

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

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 pronte all’uso per Screens, Commerce)

Orientamenti per la ristrutturazione

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

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.

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.

  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.

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:

  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
Note

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.

Scaffolding pagine page-scaffolding

Posizione precedente
/etc/scaffolding
Nuove posizioni
/libs/settings/ wcm /tipi-modello/scaffolding/scaffolding/apps/settings/ wcm /tipi-modello/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
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.

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.

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

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

  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
Note

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
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2