Come descritto nell'elemento padre Ristrutturazione dell’archivio in AEM 6.5 I clienti che eseguono l’aggiornamento a AEM 6.5 devono utilizzare questa pagina per valutare lo sforzo di lavoro associato alle modifiche dell’archivio che possono influenzare tutte le soluzioni. Alcune modifiche richiedono un lavoro durante il processo di aggiornamento di AEM 6.5, mentre altre possono essere differite fino a un aggiornamento futuro.
A partire da AEM 6.4, non esiste una configurazione ContextHub predefinita. Pertanto a livello principale del sito a 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 inserisci il percorso di configurazione ContextHub.
Inoltre, nella configurazione ContextHub, la 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
Modifica sling:resourceType da /libs/granite/contexthub/cloudsettings/components/baseconfiguration a granite/contexthub/cloudsettings/components/baseconfiguration
Ad esempio, la sling:resourceType della configurazione ContextHub deve essere relativa anziché assoluta.
Modelli flusso di lavoro
Posizione precedente
/etc/workflow/models
Nuove posizioni
/libs/settings/workflow/models
/conf/global/settings/workflow/models
/var/workflow/models
Orientamento alla ristrutturazione
Eventuali modelli di flussi di lavoro nuovi o modificati devono essere migrati a /conf/global/workflow/models.
Distribuisci i modelli di flusso di lavoro modificati in un'istanza di sviluppo AEM 6.5 locale, in modo che siano presenti nel percorso precedente.
Modifica il modello di flusso di lavoro utilizzando AEM Workflow Model Editor in AEM > Strumenti > Flusso di lavoro > Modelli.
Durante la migrazione dei modelli di flusso di lavoro modificati forniti da AEM
Con l'Editor modello flusso di lavoro aperto, modifica l'URL dell'indirizzo del browser e sostituisci il segmento del 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
Attiva la modalità Modifica nell'Editor modello flusso di lavoro che copierà la definizione del modello di flusso di lavoro in /conf/global/workflow/models.
Tocca il pulsante Sincronizza per sincronizzare le modifiche al modello del flusso di lavoro runtime in /var/workflow/models.
Esporta entrambi i modelli del flusso di lavoro (/conf/global/workflow/models/<workflow-model>?lang=it) e Runtime Workflow Model (/var/workflow/models/<workflow-model>?lang=it) e integrarla nel progetto AEM.
Ad esempio, esporta:
/config/settings/workflow/models/dam/my_workflow_model e
/var/workflow/models/dam/my_workflow_model
Note
La risoluzione del modello di flusso di lavoro si verifica nel seguente ordine:
/conf/global/settings/workflow/models
/libs/settings/workflow/models
/etc/workflow/models
Pertanto, tutte le personalizzazioni dei modelli di flusso di lavoro forniti da 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 fornito da AEM in /libs/settings/workflow/models.
Istanze flusso di lavoro
Posizione precedente
/etc/workflow/instances
Nuove posizioni
/var/workflow/instances
Orientamento alla ristrutturazione
Per allineare la nuova posizione non è necessaria alcuna azione.
Le istanze del flusso di lavoro storiche possono continuare a risiedere nella posizione precedente in modo sicuro e le nuove istanze del flusso di lavoro verranno create nella nuova posizione.
Note
Qualsiasi riferimento esplicito a un percorso in
custom
Il codice per la posizione precedente deve anche tenere conto 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
Orientamento alla ristrutturazione
È necessario eseguire la migrazione di tutti i moduli di avvio dei flussi di lavoro nuovi o modificati in /conf/global/workflow/launcher/config.
Copia le configurazioni nuove o modificate di Workflow Launcher dalla posizione precedente a nuova posizione (/conf/global).
Note
La risoluzione di Workflow Launcher si verifica nel seguente ordine:
/conf/global/settings/workflow/launcher
/libs/settings/workflow/launcher
/etc/workflow/launcher
Pertanto, tutte le personalizzazioni di Workflow Launcher AEM fornite persistono nella posizione precedente devono essere spostate nella nuova posizione (/conf/global/settings/workflow/launcher se devono essere mantenute, altrimenti saranno sostituite dalla definizione di Workflow Launcher AEM fornita in /libs/settings/workflow/launcher.
Script di flusso di lavoro
Posizione precedente
/etc/workflow/scripts
Nuove posizioni
/libs/workflow/scripts
/apps/workflow/scripts
Orientamento alla ristrutturazione
Eventuali script di flusso di lavoro nuovi o modificati devono essere migrati nella nuova posizione e i modelli di flusso di lavoro di riferimento aggiornati per riflettere la nuova posizione.
Copia gli script di flusso di lavoro nuovi o modificati dalla posizione precedente alla nuova posizione.
/apps/workflow/scripts devono essere mantenuti in SCM.
Aggiorna tutti i riferimenti agli script del flusso di lavoro nella posizione precedente nei modelli di flusso di lavoro per puntare alle nuove posizioni.
Note
AEM 6.4 SP1, quando viene rilasciato, lo rende in modo che questa ristrutturazione possa essere differita fino alla versione 6.5
upgrade
.
Se si esegue l’aggiornamento a AEM 6.4 prima del rilascio di AEM 6.4 SP1, questa ristrutturazione deve essere eseguita come parte del progetto di aggiornamento. Senza farlo, la modifica e il salvataggio dei passaggi del flusso di lavoro che fanno riferimento agli script nella posizione precedente rimuoverà completamente il riferimento allo script del flusso di lavoro dal passaggio del flusso di lavoro, e solo gli script del flusso di lavoro in nuove posizioni saranno disponibili nel menu a discesa di selezione dello script.
Prima dell’aggiornamento futuro
Configurazioni ContextHub
Posizione precedente
/etc/cloudsettings
Nuove posizioni
/libs/settings/cloudsettings
/conf/global/settings/cloudsettings
/conf/<tenant>/settings/cloudsettings
Orientamento alla ristrutturazione
Eventuali 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 le configurazioni ContextHub nuove o modificate dalla posizione precedente alla nuova posizione.
Associa le configurazioni di AEM applicabili alle gerarchie di contenuto AEM.
Gerarchie di pagine AEM Sites tramite AEM Sites > Pagina > Proprietà pagina > Scheda Avanzate > Configurazione cloud.
Disassociare le configurazioni ContextHub legacy migrate dalle gerarchie di contenuto AEM sopra indicate.
Note
N/D
Progettazione Cloud Services classici
Posizione precedente
/etc/designs/cloudservices
Nuove posizioni
/libs/settings/wcm/designs/cloudservices
/apps/settings/wcm/designs/cloudservices
Orientamento alla ristrutturazione
Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.
Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps).
Convertire CSS, JavaScript e risorse statiche nella progettazione in un Libreria client con allowProxy = true.
Aggiorna i riferimenti alla posizione precedente nel
cq
:
designPath
proprietà.
Aggiorna le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
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
Progettazione di dashboard classici
Posizione precedente
/etc/designs/dashboards
Nuove posizioni
/libs/settings/wcm/designs/dashboards
/apps/settings/wcm/designs/dashboards
Orientamento alla ristrutturazione
Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.
Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps?lang=it).
Convertire CSS, JavaScript e risorse statiche nella progettazione in un Libreria client con allowProxy = true.
Aggiorna i riferimenti alla posizione precedente nel
cq
:
designPath
proprietà.
Aggiorna le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
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
Progettazione report classici
Posizione precedente
/etc/designs/reports
Nuove posizioni
/libs/settings/wcm/designs/reports
/apps/settings/wcm/designs/reports
Orientamento alla ristrutturazione
Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.
Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps?lang=it).
Convertire CSS, JavaScript e risorse statiche nella progettazione in un Libreria client con allowProxy = true.
Aggiorna i riferimenti alla posizione precedente nel
cq
:
designPath
proprietà.
Aggiorna le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
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
Progettazioni predefinite
Posizione precedente
/etc/designs/default
Nuove posizioni
/libs/settings/wcm/designs/default
/apps/settings/wcm/designs/default
Orientamento alla ristrutturazione
Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.
Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps?lang=it).
Convertire CSS, JavaScript e risorse statiche nella progettazione in un Libreria client con allowProxy = true.
Aggiorna i riferimenti alla posizione precedente nel
cq
:
designPath
proprietà.
Aggiorna le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
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
Endpoint JavaScript di Adobe DTM
Posizione precedente
/etc/clientlibs/dtm
Nuove posizioni
/var/cq/dtm/clientlibs
Orientamento alla ristrutturazione
Non è richiesta alcuna azione.
La posizione precedente pubblica funge da endpoint proxy per la nuova posizione privata.
Note
N/D
Endpoint Web-Hook DTM Adobe
Posizione precedente
/etc/dtm-hook
Nuove posizioni
/var/cq/dtm/web-hook
Orientamento alla ristrutturazione
Non è richiesta alcuna azione.
La posizione precedente pubblica funge da endpoint proxy per la nuova posizione privata.
Note
N/D
Casella in entrata - Attività
Posizione precedente
/etc/taskmanagement
Nuove posizioni
/var/taskmanagement
Orientamento alla ristrutturazione
Utilizza la Casella in entrata - Elimina attività di manutenzione per rimuovere le attività precedenti dalla posizione precedente, in base alle esigenze.
Note
Non è necessaria alcuna azione per la migrazione delle attività nella nuova posizione.
Le attività presenti nella posizione precedente continuano a essere disponibili e funzionano.
Le nuove attività vengono create nella nuova posizione.
Configurazioni blueprint di Multi-Site Manager
Posizione precedente
/etc/blueprints
Nuove posizioni
/libs/msm
/apps/msm
Orientamento alla ristrutturazione
Copia configurazioni personalizzate da /etc/blueprints a /apps/msm.
Rimuovi /etc/blueprints.
Note
N/D
Configurazioni del gadget per dashboard di progetti AEM
Posizione precedente
/etc/projects/dashboard/gadgets
Nuove posizioni
/libs/cq/core/content/projects/dashboard/gadgets
/apps/cq/core/content/projects/dashboard/gadgets
Orientamento alla ristrutturazione
Tutte le configurazioni del Gadget dashboard di progetti nuovi o modificati devono essere migrate nella nuova posizione (/apps).
Copia le configurazioni del Gadget dashboard di progetti nuovi o modificati dalla posizione precedente nella nuova posizione (/apps).
Non copiare le configurazioni del Gadget dashboard di progetti AEM non modificati, in quanto ora esistono nella nuova posizione (/libs).
Aggiorna i modelli di progetti AEM che fanno riferimento alla posizione precedente per puntare 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à.
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 OSGi Day Communique 5 Tagging su https://serveraddress:serverport/system/console/bundles/com.day.cq.cq-tagging per AEM riconoscere che la nuova posizione contiene contenuto e deve essere utilizzata.
Note
Il riavvio del bundle Day Communique Tagging OSGi registrerà la nuova posizione come radice dei tag solo se la posizione precedente è vuota.
I riferimenti alla posizione precedente continueranno a funzionare dopo la migrazione a nuova posizione per tutte le funzionalità che sfruttano AEM’API TagManager per la risoluzione dei tag.
Qualsiasi codice personalizzato che fa riferimento esplicitamente al percorso /etc/tags deve essere aggiornato a /content/
cq
:tags
, o di preferenza riscritto per sfruttare l’API Java TagManager insieme a questa migrazione.
Eventuali nuovi Cloud Services di traduzione devono essere migrati nella nuova posizione (/apps, /conf/global o /conf/<tenant>).
Esegui la migrazione delle configurazioni esistenti nella posizione precedente alla nuova posizione.
Ricrea manualmente nuove configurazioni di Cloud Services di traduzione tramite l’interfaccia utente di authoring AEM in 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 di AEM applicabili alle gerarchie di contenuto AEM.
Gerarchie di pagine AEM Sites tramite AEM Sites > Pagina > Proprietà pagina > Scheda Avanzate > Configurazione cloud.
AEM gerarchie di frammenti esperienza tramite AEM Frammenti esperienza > Frammento esperienza > Proprietà > Scheda Cloud Services > Configurazione cloud.
AEM gerarchie di cartelle di frammenti esperienza tramite AEM Frammenti esperienza > Cartella > Proprietà > Scheda Cloud Services > Configurazione cloud.
Gerarchie di cartelle AEM Assets tramite AEM Assets > Cartella > Proprietà cartella > Scheda Cloud Services > Configurazione.
AEM progetti tramite Progetti AEM > Progetto > Proprietà progetto > Scheda Avanzate > Configurazione cloud.
Separa i Cloud Services di traduzione legacy migrati dalle gerarchie di contenuto AEM sopra indicate.
Note
La risoluzione dei Cloud Services di traduzione si verifica nel seguente ordine:
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
Orientamento alla ristrutturazione
Qualsiasi definizione nuova o modificata di Lingua di traduzione richiede una migrazione di tutte le definizioni di Lingua di traduzione alla nuova posizione (/apps).
Se sono state apportate aggiunte o modifiche alle definizioni delle lingue di traduzione, copia tutte le definizioni delle lingue di traduzione dalla posizione precedente nella nuova posizione (/apps).
Note
La risoluzione del percorso della lingua di traduzione si verifica nel seguente ordine:
/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 dalle risoluzioni di ordine superiore.
Per tutte le progettazioni gestite in SCM e non scritte in fase di esecuzione tramite le finestre di dialogo di progettazione.
Copia le progettazioni dalla posizione precedente alla nuova posizione (/apps?lang=it).
Convertire CSS, JavaScript e risorse statiche nella progettazione in un Libreria client con allowProxy = true.
Aggiorna i riferimenti alla posizione precedente nel
cq
:
designPath
proprietà.
Aggiorna le pagine che fanno riferimento alla posizione precedente per utilizzare la nuova categoria Libreria client (è necessario aggiornare il codice di implementazione della pagina).
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
Console Web di attivazione della struttura
Posizione precedente
/etc/replication/treeactivation
Nuove posizioni
/libs/replication/treeactivation
Orientamento alla ristrutturazione
Non è richiesta alcuna azione.
Note
La console Web Attivazione albero è ora disponibile tramite Strumenti > Implementazione > Replica > Attiva albero.
Eventuali nuovi Cloud Services del connettore di traduzione fornitore devono essere migrati nella nuova posizione (/apps, /conf/global o /conf/<tenant>).
Esegui la migrazione delle configurazioni esistenti nella posizione precedente alla nuova posizione.
Creare manualmente le nuove configurazioni del connettore di traduzione del fornitore tramite Interfaccia utente AEM authoring in Strumenti > Cloud Services > Cloud Services di traduzione. OPPURE
Copia le nuove configurazioni dei nuovi Cloud Services del connettore di traduzione fornitore dalla posizione precedente alla nuova posizione (/apps, /conf/global o /conf/<tenant>).
Associa le configurazioni di AEM applicabili alle gerarchie di contenuto AEM.
Gerarchie di pagine AEM Sites tramite AEM Sites > Pagina > Proprietà pagina > Scheda Avanzate > Configurazione cloud.
AEM gerarchie di frammenti esperienza tramite AEM Frammenti esperienza > Frammento esperienza > Proprietà > Scheda Cloud Services > Configurazione cloud.
AEM gerarchie di cartelle di frammenti esperienza tramite AEM Frammenti esperienza > Cartella > Proprietà > Scheda Cloud Services > Configurazione cloud.
Gerarchie di cartelle AEM Assets tramite AEM Assets > Cartella > Proprietà cartella > Scheda Cloud Services > Configurazione.
AEM progetti tramite Progetti AEM > Progetto > Proprietà progetto > Scheda Avanzate > Configurazione cloud.
Separa i Cloud Services di traduzione legacy migrati dalle gerarchie di contenuto AEM sopra indicate.
Note
La risoluzione dei Cloud Services di traduzione si verifica nel seguente ordine:
Eventuali modelli e-mail di notifica del flusso di lavoro modificati devono essere migrati nella nuova posizione (/conf/global).
Copia i modelli e-mail di notifica del flusso di lavoro modificati dalla posizione precedente alla nuova posizione.
Rimuovi i modelli e-mail di notifica del flusso di lavoro migrati dalla posizione precedente.
Note
La risoluzione del modello e-mail di notifica del flusso di lavoro si verifica nell’ordine seguente:
/etc/workflow/notification
/conf/global/settings/workflow/notification
/libs/settings/workflow/notification
Pacchetti di flussi di lavoro
Posizione precedente
/etc/workflow/packages
Nuove posizioni
/var/workflow/packages
Orientamento alla ristrutturazione
I pacchetti del flusso di lavoro esistenti nella posizione precedente devono essere migrati nella nuova posizione.
Rimuovi tutti i pacchetti del flusso di lavoro nella posizione precedente a cui non viene fatto riferimento da altri contenuti e che altrimenti non sono necessari.
Sposta tutti i pacchetti del flusso di lavoro nella posizione precedente a cui non viene fatto riferimento da altri contenuti, ma che sono comunque necessari nella nuova posizione.
Lascia tutti i pacchetti del flusso di lavoro a cui fanno riferimento altri contenuti della posizione precedente.
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 lew possono essere gestiti tramite la console Miscadmin dell'interfaccia classica.