Ristrutturazione dell'archivio siti in AEM 6.4

Come descritto nella pagina Ristrutturazione del repository principale di AEM 6.4, i clienti che effettuano l'aggiornamento a AEM 6.4 devono utilizzare questa pagina per valutare lo sforzo di lavoro associato alle modifiche del repository che hanno un impatto sulla soluzione AEM Sites. Alcune modifiche richiedono sforzi di lavoro durante il processo di aggiornamento di AEM 6.4, mentre altre possono essere posticipate fino a un aggiornamento di 6.5.

Con aggiornamento 6.4

Aggiornamento precedente a 6.5

Con aggiornamento 6.4

Segmenti ContextHub

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 i segmenti ContextHub nuovi o modificati devono essere modificati nel controllo del codice sorgente anziché essere modificati in AEM, devono essere migrati nella nuova posizione:

  1. Copiare eventuali segmenti ContextHub nuovi o modificati dalla posizione precedente alla nuova posizione appropriata (/%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 AEM interfaccia utente del debugger di QueryBuilder. Notate che si tratta di una query di attraversamento, quindi non eseguitela rispetto alla produzione e accertatevi che i limiti di attraversamento vengano regolati in base alle esigenze.

Note

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

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

Proprietà pagina AEM Sites consentono solo di selezionare la posizione precedente (/etc) o una singola nuova posizione (/apps, /conf/global o /conf/<tenant>), 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 eseguire la conversione in ContextHub.

Aggiornamento precedente a 6.5

librerie client Adobe Analytics

Posizione precedente

/etc/clientlibs/foundation/sitecatalyst

Nuove posizioni /libs/cq/analytics/clientlibs/analytics
Orientamenti per la ristrutturazione

L'uso 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 nella posizione precedente devono essere aggiornati per utilizzare il framework di riferimento della libreria client AEM.
  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 Libreria client, visitare ciascun nodo cq:ClientLIbraryFolder tramite CRXDELite ed esaminare la proprietà category.

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

Progettazione classiche di pagine da Microsoft Word a Web

Posizione precedente /etc/designs/wordDesign
Nuove posizioni

/libs/settings/wcm/designs/wordDesign

/apps/settings/wcm/designs/wordDesign

Orientamenti per la ristrutturazione

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

  1. Copiate le progettazioni dalla posizione precedente alla nuova posizione (/apps).
  2. Convertite eventuali risorse CSS, JavaScript e statiche nella progettazione in una libreria client con allowProxy = true.
  3. Aggiorna i riferimenti alla posizione precedente nella proprietà cq:designPath.
  4. Aggiorna tutte le pagine che fanno riferimento al percorso precedente per utilizzare la nuova categoria Libreria client (per questo è necessario aggiornare il codice di implementazione Pagina).
  5. Aggiorna AEM regole del dispatcher per consentire la trasmissione delle librerie client tramite il servlet proxy /etc.clientlibs/.

Per qualsiasi progettazione NON gestita in SCM e modificata in fase di esecuzione tramite le finestre di dialogo Progettazione:

  • Non spostare Designer modificabili da /etc.
Note N/D

Configurazioni emulatore dispositivo mobile

Posizione precedente

/etc/mobile

Nuove posizioni

/libs/settings/mobile

/apps/settings/mobile

/conf/global/settings/mobile

/conf/<tenant>/settings/mobile

Orientamenti per la ristrutturazione Qualsiasi nuova configurazione dell'emulatore di dispositivi mobili deve essere migrata nella nuova posizione.
  1. Copiate le nuove configurazioni dell'emulatore di dispositivi mobili dal percorso precedente alla nuova posizione (/apps, /conf/global, /conf/<tenant>).
  2. Per tutte pagine AEM Sites che dipendono da queste configurazioni dell'emulatore di dispositivi mobili, aggiorna la pagina jcr :content nodo:
    [cq:Page]/jcr:content@cq: deviceGroups = String[ mobile/group/reattivo ]
  3. Per tutti i modelli modificabili che dipendono da queste configurazioni dell'emulatore di dispositivi mobili, aggiorna i modelli modificabili, indicando la cq : deviceGroups nella nuova posizione.
Note

La risoluzione delle configurazioni dell'emulatore del dispositivo mobile si verifica 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 Manager multisito

Posizione precedente /etc/blueprints
Nuove posizioni

/apps/msm (configurazioni Blueprint cliente)

/libs/msm (configurazioni di Blueprint Box per schermi, Commerce)

Orientamenti per la ristrutturazione

Eventuali nuove configurazioni di Blueprint Manager multisito o modificate devono essere trasferite nella nuova posizione (/apps).

  1. Copiate le configurazioni Blueprint Manager multisito o modificate dalla posizione precedente alla nuova posizione (/apps).
  2. Rimuovere tutte le configurazioni di blueprint Manager multisito migrate dalla posizione precedente.
Note

Tutte le configurazioni di Blueprint Manager multisito AEM sono disponibili nella nuova posizione in /libs.

Il contenuto non fa riferimento alle configurazioni Blue Manager multisito, pertanto non sono presenti riferimenti di contenuto da regolare.

Configurazioni di rollout di più siti Manager

Posizione precedente

/etc/msm/rolloutConfigs

Nuove posizioni

/libs/msm/wcm/rolloutconfigs

/apps/msm/wcm/rolloutconfigs

Orientamenti per la ristrutturazione

Tutte le configurazioni di rollout manager multisito nuove o modificate devono essere trasferite nella nuova posizione.

  1. Copiate le configurazioni di rollout manager multisito nuove o modificate dalla posizione precedente alla nuova posizione (/apps).
  2. Aggiornate i riferimenti AEM pagine alle configurazioni di rollout Manager multisito nella posizione precedente, per indicare le controparti nelle nuove posizioni (/libs o /apps).

Rimuovere le configurazioni di rollout Manager multisito migrate dalla posizione precedente.

Note La mancata rimozione delle configurazioni di rollout Manager multisito migrate dalla posizione precedente determina la visualizzazione di opzioni di rollout duplicate per gli autori AEM.

Modello e-mail notifica evento pagina

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

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

La risoluzione del modello e-mail evento pagina si verifica nel seguente ordine:

  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 evento pagina nuovi o modificati devono essere migrati nella nuova posizione in /apps:

  1. Copiate i modelli e-mail di notifica evento pagina nuovi o modificati dal percorso precedente al nuovo percorso (/apps).
  2. Rimuovete eventuali modelli e-mail di notifica eventi pagina migrati dal percorso precedente.

Scaffolding pagina

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 in Posizione precedente utilizza il framework Scaffolding legacy e non può essere migrato nella Nuova posizione. Per allineare con la nuova posizione, qualsiasi Scaffolding legacy deve essere risviluppato utilizzando il framework Scaffolding supportato.
Note N/D

Griglia reattiva

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 essere importati dalla nuova posizione.

  • Aggiorna tutti i file LESS personalizzati che fanno riferimento a grid_base.less nella Posizione precedente per fare riferimento alla nuova posizione.
Note Facendo riferimento a un file grid_base.less non esistente, la modalità di layout dell'Editor pagina e modelli non funziona e si verifica un'interruzione del layout di pagina.

Progettazione modelli statici

Posizione precedente /etc/designs/<custom-site>
Nuove posizioni /apps/settings/wcm/designs/<custom-site>
Orientamenti per la ristrutturazione

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

  1. Copiate le progettazioni dalla posizione precedente alla nuova posizione (/apps).
  2. Convertite eventuali 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 al percorso precedente per utilizzare la nuova categoria Libreria client (per questo è necessario aggiornare il codice di implementazione Pagina).
  5. Aggiorna AEM regole del dispatcher per consentire la trasmissione delle librerie client tramite il servlet proxy /etc.clientlibs/.

Per qualsiasi progettazione NON gestita in SCM e modificata in fase di esecuzione tramite le finestre di dialogo Progettazione:

  • Non spostare Designer modificabili da /etc.
Note L'approccio consigliato consiste nel creare AEM Sites e pagine utilizzando Modelli modificabili che utilizzano Struttura, Contenuto e Criteri al posto di Designer.

librerie client di ricerca e integrazione Promote

Posizione precedente

/etc/clientlibs/foundation/searchpromote

Nuove posizioni /libs/cq/searchpromote/clientlibs/searchpromote
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 nella posizione precedente devono essere aggiornati per utilizzare il framework di riferimento della libreria client AEM.
  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/searchpromote/clientlibs/searchpromotei.js
Note

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

Per ottenere le categorie Libreria client, visitare ogni nodo cq:ClientLIbraryFolder tramite CRXDELite ed esaminare la proprietà category:

  • /libs/cq/searchpromote/clientlibs/searchpromote

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 nella posizione precedente devono essere aggiornati per utilizzare il framework di riferimento della libreria client AEM.
  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 Libreria client, visitare ogni nodo cq:ClientLIbraryFolder tramite CRXDELite ed esaminare la proprietà category:

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

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 nella posizione precedente devono essere aggiornati per utilizzare il framework di riferimento della libreria client AEM.
  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 Libreria client, visitare ciascun nodo cq:ClientLIbraryFolder tramite CRXDELite ed esaminare la proprietà category:

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

In questa pagina