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 potrebbero influire su tutte le soluzioni. 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.
A partire da AEM 6.4, non è presente alcuna configurazione ContextHub predefinita. Pertanto a livello di directory principale del sito cq:contextHubPathproperty deve essere impostato per indicare quale configurazione deve essere utilizzata.
Passa alla directory principale del sito.
Apri le proprietà della pagina principale e seleziona la scheda Personalizzazione.
Nel campo Percorso Contexthub immetti il percorso di configurazione ContextHub.
Inoltre, nella configurazione ContextHub, il sling:resourceType deve essere aggiornato per essere relativo e non assoluto.
Apri le proprietà del nodo di configurazione ContextHub in CRX DE Lite, ad esempio /apps/settings/cloudsettings/legacy/contexthub
Cambia sling:resourceType da /libs/granite/contexthub/cloudsettings/components/baseconfiguration a granite/contexthub/cloudsettings/components/baseconfiguration
Cioè il sling:resourceType della configurazione ContextHub deve essere relativo anziché assoluto.
Modelli flusso di lavoro
Posizione precedente
/etc/workflow/models
Nuove posizioni
/libs/settings/workflow/models
/conf/global/settings/workflow/models
/var/workflow/models
Orientamenti per la ristrutturazione
Qualsiasi modello di flusso di lavoro nuovo o modificato deve essere migrato a /conf/global/workflow/models.
Distribuire i modelli di flusso di lavoro modificati in un'istanza di sviluppo AEM 6.5 locale, in modo che esistano nel percorso precedente.
Modifica il modello di flusso di lavoro utilizzando l’Editor modello flusso di lavoro AEM in AEM > Strumenti > Flusso di lavoro > Modelli.
Durante la migrazione dei modelli di flusso di lavoro AEM modificati
Con l’Editor modello flusso di lavoro aperto, modifica l’URL dell’indirizzo del browser e sostituisci il segmento di percorso /libs/settings/workflow/models con /etc/workflow/models.
Ad esempio, modifica: http://localhost:4502/editor.html/libs/settings/workflow/models/dam/update_asset.html a http://localhost:4502/editor.html/etc/workflow/models/dam/update_asset.html
Abilita la modalità Modifica nell’Editor modello flusso di lavoro, che copierà la definizione del modello flusso di lavoro in /conf/global/workflow/models.
Tocca il pulsante Sync per sincronizzare le modifiche apportate al modello di flusso di lavoro di runtime in /var/workflow/models.
Esporta entrambi i modelli di flusso di lavoro (/conf/global/workflow/models/<workflow-model>?lang=it) e modello di flusso di lavoro di runtime (/var/workflow/models/<workflow-model>?lang=it) e integrarla nel progetto AEM.
Ad esempio, esportare:
/conf/global/settings/workflow/models/dam/my_workflow_model e
/var/workflow/models/dam/my_workflow_model
Note
La risoluzione del modello di flusso di lavoro viene eseguita nell'ordine seguente:
/conf/global/settings/workflow/models
/libs/settings/workflow/models
/etc/workflow/models
Pertanto, tutte le personalizzazioni dei modelli di flusso di lavoro forniti dall’AEM che persistono nella posizione Precedente devono essere spostate in /conf/global/settings/workflow/models se devono essere mantenute, altrimenti saranno sostituite dalla definizione del modello di flusso di lavoro fornita dall’AEM in /libs/settings/workflow/models.
Istanze flusso di lavoro
Posizione precedente
/etc/workflow/instances
Nuove posizioni
/var/workflow/instances
Orientamenti per la ristrutturazione
Non è richiesta alcuna azione per l’allineamento con la nuova posizione.
Le istanze storiche dei flussi di lavoro possono continuare a risiedere nella posizione precedente senza problemi e verranno create nuove istanze dei flussi di lavoro nella nuova posizione.
Note
Qualsiasi riferimento esplicito al percorso in
custom
Il codice della Posizione precedente deve tenere conto anche della Nuova Posizione. Si consiglia di eseguire il refactoring di questo codice per utilizzare le API del flusso di lavoro AEM.
Moduli di avvio per flusso di lavoro
Posizione precedente
/etc/workflow/launcher/config
Nuove posizioni
/libs/settings/workflow/launcher/config
/conf/global/settings/workflow/launcher/config
Orientamenti per la ristrutturazione
Qualsiasi modulo di avvio del flusso di lavoro nuovo o modificato deve essere migrato a /conf/global/workflow/launcher/config.
Copia le configurazioni nuove o modificate dell'Utilità di avvio flusso di lavoro dal percorso precedente al nuovo percorso (/conf/global).
Note
La risoluzione dell'utilità di avvio del flusso di lavoro viene eseguita nell'ordine seguente:
/conf/global/settings/workflow/launcher
/libs/settings/workflow/launcher
/etc/workflow/launcher
Pertanto, tutte le personalizzazioni di Workflow Launcher fornite dall’AEM e persistenti nella posizione precedente devono essere spostate nella nuova posizione (/conf/global/settings/workflow/launcher se devono essere mantenuti, altrimenti saranno sostituiti dalla definizione Workflow Launcher fornita dall’AEM in /libs/settings/workflow/launcher.
Script flusso di lavoro
Posizione precedente
/etc/workflow/scripts
Nuove posizioni
/libs/workflow/scripts
/apps/workflow/scripts
Orientamenti per la ristrutturazione
Qualsiasi script di flusso di lavoro nuovo o modificato deve essere migrato alla nuova posizione e i modelli di flusso di lavoro di riferimento devono essere aggiornati per riflettere la nuova posizione.
Copiare gli script di flusso di lavoro nuovi o modificati dalla posizione precedente alla nuova posizione.
/apps/workflow/scripts devono essere mantenute nell’SCM.
Aggiornare eventuali riferimenti agli script del flusso di lavoro nella posizione precedente in Modelli flusso di lavoro per puntare alle nuove posizioni.
Note
L'AEM 6.4 SP1, quando sarà pubblicato, consente di posticipare la ristrutturazione al 6.5
upgrade
.
Se si effettua l’aggiornamento al AEM 6.4 prima del rilascio del AEM 6.4 SP1, tale ristrutturazione dovrebbe essere effettuata nell’ambito del progetto di aggiornamento. In caso contrario, la modifica e il salvataggio dei passaggi del flusso di lavoro che fanno riferimento a script nel percorso precedente rimuoveranno completamente il riferimento allo script del flusso di lavoro dal passaggio del flusso di lavoro e solo gli script del flusso di lavoro nei nuovi percorsi saranno disponibili nel menu a discesa per la selezione degli script.
Prima di un aggiornamento futuro
Configurazioni ContextHub
Posizione precedente
/etc/cloudsettings
Nuove posizioni
/libs/settings/cloudsettings
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Orientamenti per la ristrutturazione
Tutte le configurazioni ContextHub nuove o modificate devono essere migrate nella nuova posizione e le pagine AEM Sites di riferimento devono essere aggiornate per riflettere la nuova posizione.
Copia tutte le configurazioni ContextHub nuove o modificate dalla posizione precedente alla nuova posizione.
Associa le configurazioni AEM applicabili alle gerarchie di contenuti AEM.
Gerarchie di pagine AEM Sites tramite AEM Sites > Pagina > Proprietà pagina > Scheda Avanzate > Configurazione cloud.
Dissocia tutte le configurazioni ContextHub legacy migrate dalle gerarchie di contenuti AEM sopra indicate.
Note
N/D
Progettazioni Cloud Services classiche
Posizione precedente
/etc/designs/cloudservices
Nuove posizioni
/libs/settings/wcm/designs/cloudservices
/apps/settings/wcm/designs/cloudservices
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à.
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 sono state modificate in fase di esecuzione tramite le finestre di dialogo per progettazione.
Non spostare i design modificabili da /etc.
Note
N/D
Progettazioni dashboard classiche
Posizione precedente
/etc/designs/dashboards
Nuove posizioni
/libs/settings/wcm/designs/dashboards
/apps/settings/wcm/designs/dashboards
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?lang=it).
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à.
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 sono state modificate in fase di esecuzione tramite le finestre di dialogo per progettazione.
Non spostare i design modificabili da /etc.
Note
N/D
Progettazioni report classici
Posizione precedente
/etc/designs/reports
Nuove posizioni
/libs/settings/wcm/designs/reports
/apps/settings/wcm/designs/reports
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?lang=it).
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à.
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 sono state modificate in fase di esecuzione tramite le finestre di dialogo per progettazione.
Non spostare i design modificabili da /etc.
Note
N/D
Progettazioni predefinite
Posizione precedente
/etc/designs/default
Nuove posizioni
/libs/settings/wcm/designs/default
/apps/settings/wcm/designs/default
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?lang=it).
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à.
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 sono state modificate in fase di esecuzione tramite le finestre di dialogo per progettazione.
Non spostare i design modificabili da /etc.
Note
N/D
Endpoint JavaScript di Adobe DTM
Posizione precedente
/etc/clientlibs/dtm
Nuove posizioni
/var/cq/dtm/clientlibs
Orientamenti per la ristrutturazione
Non è richiesta alcuna azione.
La posizione precedente pubblica funge da endpoint proxy per la nuova posizione privata.
Note
N/D
Adobe di endpoint per web hook DTM
Posizione precedente
/etc/dtm-hook
Nuove posizioni
/var/cq/dtm/web-hook
Orientamenti per la ristrutturazione
Non è richiesta alcuna azione.
La posizione precedente pubblica funge da endpoint proxy per la nuova posizione privata.
Note
N/D
Attività casella in entrata
Posizione precedente
/etc/taskmanagement
Nuove posizioni
/var/taskmanagement
Orientamenti per la ristrutturazione
Utilizza il Casella in entrata - Attività di manutenzione rimozione per rimuovere le attività precedenti dalla posizione precedente in base alle esigenze.
Note
Non è richiesta alcuna azione per eseguire la migrazione delle attività nella nuova posizione.
Le attività presenti nel percorso precedente continuano a essere disponibili e a funzionare.
Le nuove attività vengono create nella nuova posizione.
Configurazioni blueprint per Multi-Site Manager
Posizione precedente
/etc/blueprints
Nuove posizioni
/libs/msm
/apps/msm
Orientamenti per la ristrutturazione
Copia configurazioni personalizzate da /etc/blueprints a /apps/msm.
Rimuovi /etc/blueprints.
Note
N/D
Configurazioni gadget dashboard progetti AEM
Posizione precedente
/etc/projects/dashboard/gadgets
Nuove posizioni
/libs/cq/core/content/projects/dashboard/gadgets
/apps/cq/core/content/projects/dashboard/gadgets
Orientamenti per la ristrutturazione
Qualsiasi configurazione di gadget per dashboard progetti AEM nuova o modificata deve essere migrata nella nuova posizione (/apps).
Copiare nella nuova posizione le configurazioni del gadget per il dashboard dei progetti AEM nuove o modificate dalla posizione precedente (/apps).
Non copiare le configurazioni del gadget del dashboard dei progetti AEM non modificate in quanto sono ora presenti nella nuova posizione (/libs).
Aggiornare eventuali modelli di progetti AEM che fanno riferimento alla Posizione precedente in modo che puntino alla nuova posizione appropriata.
Note
Se viene applicato il pacchetto di compatibilità AEM 6.4, sarà necessario eseguire le attività di allineamento dell’archivio al momento della rimozione del pacchetto di compatibilità.
È necessario eseguire la migrazione di tutti i modelli di posta elettronica per le notifiche di replica nuovi o modificati nella nuova posizione (/apps)
Copiare nel nuovo percorso i modelli di posta elettronica per le notifiche di replica nuovi o modificati dal percorso precedente (/apps).
Rimuovere eventuali modelli di posta elettronica di notifica replica migrati dal percorso precedente.
Note
Gli unici nuovi modelli di posta elettronica per le notifiche di replica supportati sono quelli che supportano le nuove impostazioni internazionali.
La risoluzione del modello di posta elettronica per le notifiche di replica viene eseguita nell'ordine seguente:
Tutti i tag devono essere migrati in /content/cq:tags.
Copia tutti i tag dalla posizione precedente alla nuova posizione.
Rimuovi tutti i tag dalla posizione precedente.
Tramite la console web AEM, riavvia il bundle Day Communique 5 Tagging OSGi all’indirizzo https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging affinché l’AEM riconosca che la Nuova sede contiene contenuti e deve essere utilizzata.
Note
Il riavvio del bundle OSGi di assegnazione tag Day Communique registrerà la nuova posizione come radice del tag solo se la posizione precedente è vuota.
I riferimenti alla posizione precedente continueranno a funzionare dopo la migrazione alla nuova posizione per tutte le funzionalità che sfruttano l’API TagManager dell’AEM per la risoluzione dei tag.
Qualsiasi codice personalizzato che fa riferimento esplicitamente al percorso /etc/tags deve essere aggiornato a /content/
cq
:tags
, o preferibilmente riscritto per sfruttare l’API Java di TagManager, insieme a questa migrazione.
Qualsiasi nuovo Cloud Services di traduzione deve essere migrato nella nuova posizione (/apps, /conf/global o /conf/<tenant>).
Migra le configurazioni esistenti nella posizione precedente alla nuova posizione.
Ricreare manualmente le nuove configurazioni dei Cloud Services di traduzione tramite l’interfaccia utente di creazione dell’AEM all’indirizzo Strumenti > Cloud Services > Cloud Services di traduzione. OPPURE
Copia le nuove configurazioni dei Cloud Services di traduzione dalla posizione precedente alla nuova posizione (/apps, /conf/global o /conf/<tenant>).
Associa le configurazioni AEM applicabili alle gerarchie di contenuti AEM.
Gerarchie di pagine AEM Sites tramite AEM Sites > Pagina > Proprietà pagina > Scheda Avanzate > Configurazione cloud.
Gerarchie di frammenti esperienza AEM tramite Frammenti esperienza AEM > Frammento esperienza > Proprietà > Scheda Cloud Services > Configurazione cloud.
Gerarchie di cartelle di frammenti esperienza AEM tramite Frammenti esperienza AEM > Cartella > Proprietà > Scheda Cloud Services > Configurazione cloud.
Gerarchie di cartelle di AEM Assets tramite AEM Assets > Cartella > Proprietà cartella > Scheda Cloud Services > Configurazione.
Progetti AEM tramite Progetti AEM > Progetto > Proprietà progetto > Scheda Avanzate > Configurazione cloud.
Dissocia eventuali Cloud Services di traduzione legacy migrati dalle gerarchie di contenuto AEM sopra indicate.
Note
La risoluzione dei Cloud Services di traduzione viene eseguita nell'ordine seguente:
I Cloud Services di traduzione migrati devono essere compatibili con AEM 6.4.
Lingue di traduzione
Posizione precedente
/etc/translation/supportedLanguages
Nuove posizioni
/libs/settings/translation/supportedLanguages
/apps/settings/translation/supportedLanguages
Orientamenti per la ristrutturazione
Qualsiasi definizione nuova o modificata di Lingua di traduzione richiede la migrazione di tutte le definizioni di Lingua di traduzione nella nuova posizione (/apps).
Se sono state apportate aggiunte o modifiche alle definizioni della lingua di traduzione, copia tutte le definizioni della lingua di traduzione dalla posizione precedente alla nuova posizione (/apps).
Note
La risoluzione del percorso della lingua di traduzione viene eseguita nell'ordine seguente:
/etc/translation/supportedLanguages
/apps/settings/translation/supportedLanguage
/libs/settings/translation/supportedLanguages
Questa risoluzione non supporta una sovrapposizione di unione, il che significa che il percorso risolto deve contenere tutte le lingue supportate e non erediterà le lingue supportate da risoluzioni di ordine superiore.
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?lang=it).
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à.
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 sono state modificate in fase di esecuzione tramite le finestre di dialogo per progettazione.
Non spostare i design modificabili da /etc.
Note
N/D
Console Web di attivazione struttura
Posizione precedente
/etc/replication/treeactivation
Nuove posizioni
/libs/replication/treeactivation
Orientamenti per la ristrutturazione
Non è richiesta alcuna azione.
Note
La console Web di Attivazione struttura è ora disponibile tramite Strumenti > Implementazione > Replica > Attiva struttura.
Cloud Services di connettori di traduzione fornitore
Qualsiasi nuovo Cloud Services di connettori di traduzione fornitore deve essere migrato nella nuova posizione (/apps, /conf/global o /conf/<tenant>).
Migra le configurazioni esistenti nella posizione precedente alla nuova posizione.
Creazione manuale di nuove configurazioni dei Cloud Services di connettori di traduzione fornitore tramite Interfaccia utente di creazione AEM in Strumenti > Cloud Services > Cloud Services di traduzione. OPPURE
Copia le nuove configurazioni dei Cloud Services del connettore di traduzione fornitore dalla posizione precedente alla nuova posizione (/apps, /conf/global o /conf/<tenant>).
Associa le configurazioni AEM applicabili alle gerarchie di contenuti AEM.
Gerarchie di pagine AEM Sites tramite AEM Sites > Pagina > Proprietà pagina > Scheda Avanzate > Configurazione cloud.
Gerarchie di frammenti esperienza AEM tramite Frammenti esperienza AEM > Frammento esperienza > Proprietà > Scheda Cloud Services > Configurazione cloud.
Gerarchie di cartelle di frammenti esperienza AEM tramite Frammenti esperienza AEM > Cartella > Proprietà > Scheda Cloud Services > Configurazione cloud.
Gerarchie di cartelle di AEM Assets tramite AEM Assets > Cartella > Proprietà cartella > Scheda Cloud Services > Configurazione.
Progetti AEM tramite Progetti AEM > Progetto > Proprietà progetto > Scheda Avanzate > Configurazione cloud.
Dissocia eventuali Cloud Services di traduzione legacy migrati dalle gerarchie di contenuto AEM sopra indicate.
Note
La risoluzione dei Cloud Services di traduzione viene eseguita nell'ordine seguente:
È necessario eseguire la migrazione di tutti i modelli e-mail di notifica del flusso di lavoro modificati alla nuova posizione (/conf/global).
Copiare nella nuova posizione tutti i modelli di e-mail di notifica del flusso di lavoro modificati dalla posizione precedente.
Rimuovi i modelli e-mail di notifica flusso di lavoro migrati dalla posizione precedente.
Note
La risoluzione del modello e-mail di notifica flusso di lavoro viene eseguita nell'ordine seguente:
/etc/workflow/notification
/conf/global/settings/workflow/notification
/libs/settings/workflow/notification
Pacchetti flusso di lavoro
Posizione precedente
/etc/workflow/packages
Nuove posizioni
/var/workflow/packages
Orientamenti per la ristrutturazione
I pacchetti di flusso di lavoro esistenti nella posizione precedente devono essere migrati nella nuova posizione.
Rimuovi eventuali pacchetti flusso di lavoro nella posizione precedente che non sono referenziati da altri contenuti e che non sono altrimenti necessari.
Sposta tutti i pacchetti flusso di lavoro nella posizione precedente che non sono referenziati da altri contenuti ma che sono comunque necessari nella nuova posizione.
Lascia nella posizione precedente tutti i pacchetti del flusso di lavoro a cui fanno riferimento altri contenuti.
Note
I pacchetti del flusso di lavoro creati tramite la console Miscadmin dell’interfaccia classica vengono mantenuti nella posizione precedente, mentre tutti gli altri vengono mantenuti nella nuova posizione.
I pacchetti del flusso di lavoro memorizzati nelle posizioni precedenti o precedenti possono essere gestiti tramite la console Gestione errori dell’interfaccia classica.