Ristrutturazione dell’archivio siti in AEM 6.4 sites-repository-restructuring-in-aem

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

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

Con aggiornamento alla versione 6.4

Prima dell’aggiornamento alla versione 6.5

Con aggiornamento alla versione 6.4 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

Orientamento alla ristrutturazione

Se i segmenti ContextHub nuovi o modificati devono essere modificati nel controllo del codice sorgente anziché essere modificati in AEM, è necessario migrarli nella 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. Aggiorna i riferimenti ai segmenti ContextHub nella posizione precedente ai segmenti ContextHub migrati nelle nuove posizioni (/apps, /conf/global, /conf/<tenant>).

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

\

\

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

\

\

Questo può essere eseguito tramite

Interfaccia utente di Debugger di AEM QueryBuilder

. Tieni presente che si tratta di una query di attraversamento, quindi non eseguirla rispetto alla produzione e assicurati che i limiti di attraversamento vengano regolati in base alle esigenze.

Note

I segmenti ContextHub persistiti nella posizione precedente vengono visualizzati come di sola lettura in AEM > Personalizzazione > Pubblico.

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

Le Proprietà pagina di AEM Sites consentono solo la posizione precedente (/etc) o una singola nuova posizione (/apps, /conf/global o /conf/<tenant>) da selezionare, pertanto i segmenti ContextHub devono essere migrati di conseguenza.

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

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

Nota: Se il ClientContext è in uso, si consiglia di convertire in ContextHub.

Prima dell’aggiornamento alla versione 6.5 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
Orientamento alla 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 in base al percorso nella posizione precedente devono essere aggiornati per utilizzare Framework di riferimento AEM libreria client.

  2. Se AEM framework di riferimento della libreria client non può essere utilizzato, è possibile fare riferimento al percorso assoluto delle librerie client tramite AEM servlet proxy libreria client.

    • /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 nodo tramite CRXDELite ed esamina 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

Orientamento alla ristrutturazione

Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.

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

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

  • Non spostare progetti modificabili dall'autore /etc.
Note
N/D

Configurazioni dell'emulatore del 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

Orientamento alla ristrutturazione

Eventuali nuove configurazioni di emulatore di dispositivi mobili devono essere migrate nella nuova posizione.

  1. Copia le nuove configurazioni dell’emulatore di dispositivi mobili dalla posizione precedente alla nuova posizione (/apps, /conf/global, /conf/<tenant>).
  2. Per le pagine AEM Sites che dipendono da queste configurazioni dell’emulatore del dispositivo mobile, aggiorna la sezione 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, indicando cq : deviceGroups nella nuova posizione.
Note

La risoluzione delle configurazioni dell'emulatore del dispositivo mobile si verifica nel seguente ordine:

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

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

Posizione precedente
/etc/blueprints
Nuove posizioni

/apps/msm (Configurazioni Blueprint cliente)

/libs/msm (Configurazioni di Blueprint pronte per Screens, Commerce)

Orientamento alla ristrutturazione

Eventuali configurazioni di blueprint Manager nuove o modificate devono essere migrate nella nuova posizione (/apps).

  1. Copia le configurazioni di Blueprint Manager nuove o modificate da Posizione precedente a Nuova posizione (/apps).
  2. Rimuovi eventuali configurazioni di blueprint Multi-Site Manager migrate dalla posizione precedente.
Note

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

Il contenuto non fa riferimento alle configurazioni blu di Multi-Site Manager, pertanto non sono presenti riferimenti di 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

Orientamento alla ristrutturazione

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

  1. Copia le configurazioni di rollout di Multi-Site Manager nuove o modificate dalla posizione precedente alla nuova posizione (/apps).
  2. Aggiorna i riferimenti nelle pagine AEM alle configurazioni di rollout di Multi-Site Manager nella posizione precedente, in modo che puntino alle loro controparti nelle nuove posizioni (/libs o /apps).

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

Note
La mancata rimozione delle configurazioni di rollout di Multi-Site Manager migrate dalla posizione precedente determina la visualizzazione di opzioni di rollout duplicate agli autori AEM.

Modello e-mail di 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

Orientamento alla ristrutturazione

I nuovi modelli e-mail di notifica degli eventi di pagina supportati solo supportano le nuove impostazioni internazionali.

La risoluzione del modello di posta elettronica dell’evento pagina si verifica 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

Eventuali modelli e-mail di notifica degli eventi di pagina nuovi o modificati devono essere migrati nel nuovo percorso in /apps:

  1. Copia i modelli e-mail di notifica degli eventi di pagina nuovi o modificati dalla posizione precedente alla nuova posizione (/apps).
  2. Rimuovi i modelli di posta elettronica per le notifiche degli eventi di pagina migrati dal percorso precedente.

Scaffolding delle pagine page-scaffolding

Posizione precedente
/etc/scaffolding
Nuove posizioni
/libs/settings/ wcm /template-types/scaffolding/scaffolding/apps/settings/ wcm /template-types/scaffolding/scaffolding
Orientamento alla ristrutturazione
Lo scaffolding creato nella posizione precedente utilizza il framework Scaffolding legacy e non può essere migrato nella nuova posizione. Per allinearsi alla nuova posizione, qualsiasi Scaffolding legacy deve essere risviluppato utilizzando il framework Scaffolding supportato.
Note
N/D

Griglia reattiva inferiore responsive-grid-less

Posizione precedente
/etc/clientlibs/wcm/foundation/grid/grid_base.less
Nuove posizioni
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Orientamento alla ristrutturazione

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

  • Aggiornare i file LESS personalizzati che fanno riferimento a grid_base.less nella posizione precedente per fare riferimento alla nuova posizione.
Note
Riferimento a un grid_base.less Il file impedisce il funzionamento della modalità Layout dell’Editor pagina e modelli e causa un’interruzione del layout della pagina.

Modelli statici static-template-designs

Posizione precedente
/etc/designs/<custom-site>
Nuove posizioni
/apps/settings/wcm/designs/<custom-site>
Orientamento alla ristrutturazione

Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.

  1. Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps).
  2. Convertire CSS, JavaScript e risorse statiche nella progettazione in un Libreria client con allowProxy = true.
  3. Aggiorna i riferimenti alla posizione precedente nel cq:designPath proprietà tramite AEM > Siti > Pagine del sito personalizzate > Proprietà pagina > Scheda Avanzate > Campo di progettazione.
  4. Aggiorna le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
  5. Aggiorna AEM regole del Dispatcher per consentire il servizio delle librerie client tramite /etc.clientlibs/ servlet proxy.

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

  • Non spostare progetti modificabili dall'autore /etc.
Note
L’approccio consigliato consiste nella creazione di AEM Sites e pagine utilizzando modelli modificabili che utilizzano Contenuto struttura e criteri al posto dei progetti.

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

Posizione precedente
/etc/clientlibs/foundation/target
Nuove posizioni
/libs/cq/testandtarget/clientlibs/testandtarget
Orientamento alla 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 in base al percorso nella posizione precedente devono essere aggiornati per utilizzare Framework di riferimento AEM libreria client.
  2. Se AEM framework di riferimento della libreria client non può essere utilizzato, è possibile fare riferimento al percorso assoluto delle librerie client tramite AEM servlet proxy libreria client:
  • /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:ClientLIbraryFolder tramite CRXDELite ed esamina 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 di WCM Foundation wcm-foundation-client-libraries

Posizione precedente
/etc/clientlibs/wcm/foundation
Nuove posizioni
/libs/wcm/foundation/clientlibs
Orientamento alla 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 in base al percorso nella posizione precedente devono essere aggiornati per utilizzare Framework di riferimento AEM libreria client.
  2. Se AEM framework di riferimento della libreria client non può essere utilizzato, è possibile fare riferimento al percorso assoluto delle librerie client tramite AEM servlet proxy libreria client.
  • /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 nodo via CRXDELite ed esamina la proprietà categories:

  • /libs/wcm/foundation/clientlibs/accessibility
  • /libs/wcm/foundation/clientlibs/main
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56