Repository-Neustrukturierung in AEM 6.5 sites-repository-restructuring-in-aem
Erstellt für:
- Admin
Wie auf der übergeordneten Seite Repository-Neustrukturierung in AEM 6.5 beschrieben, sollte Kundschaft, die auf AEM 6.5 aktualisiert, diese Seite nutzen, um den Arbeitsaufwand im Zusammenhang mit Repository-Neustrukturierungen abzuschätzen, die sich auf AEM Sites auswirken. Einige Änderungen erfordern einen Arbeitsaufwand während des Upgrades auf AEM 6.5, während andere auf eine zukünftige Aktualisierung verschoben werden können.
Mit der Aktualisierung auf 6.5
Vor einem künftigen Upgrade
- Adobe Analytics-Client-Bibliotheken
- Vom klassischen Microsoft Word zu Web-Seiten-Designs
- Konfigurationen für den Mobilgeräte-Emulator
- Blueprint-Konfigurationen für den Multi-Site-Manager
- Rollout-Konfigurationen für den Multi-Site-Manager
- E-Mail-Vorlage für Seitenereignis-Benachrichtigung
- Seiten-Strukturvorlage
- Responsives Raster (LESS)
- Designs für statische Vorlagen
Mit der Aktualisierung auf 6.5 with-upgrade
ContextHub-Segmente contexthub-segments
/etc/segmentation/contexthub
/apps/settings/wcm/segments
/conf/settings/settings/wcm/segments
/conf/<tenant>/settings/wcm/segments
Wenn alle neuen oder modifizierten ContextHub-Segmente in der Quell-Code-Verwaltung und nicht in AEM bearbeitet werden, müssen sie an den neuen Speicherort migriert werden:
- Kopieren Sie alle neuen oder geänderten ContextHub-Segmente vom vorherigen Speicherort an den neuen Speicherort (https://experienceleague.adobe.com/%3Ccode%3Eapps%3C/code%3E,%20%3Ccode%3E/conf/global%3C/code%3E%20oder%20%3Ccode%3E/conf/<tenant>%3C/code%3E?lang=de).
- Aktualisieren Sie die Verweise auf ContextHub-Segmente am vorherigen Speicherort auf die migrierten ContextHub-Segmente an den neuen Speicherorten (
/apps
,/conf/global
,/conf/<tenant>
).
Die folgende Abfrage mit QueryBuilder findet alle Verweise auf ContextHub-Segmente in den vorherigen Speicherorten.
\
\
path=/content property=cq:segments property.operation=like property.value=/etc/segmentation/contexthub/%
\
\
Dies kann über die
Benutzeroberfläche von QueryBuilder Debugger AEM
geschehen. Beachten Sie, dass es sich um eine traversierende Abfrage handelt, führen Sie sie also nicht gegen die Produktion aus und stellen Sie sicher, dass die Traversalgrenzen bei Bedarf angepasst werden.
ContextHub-Segmente, die am vorherigen Speicherort erhalten bleiben, werden unter AEM > Personalisierung > Zielgruppen als schreibgeschützt angezeigt.
Wenn ContextHub-Segmente in AEM bearbeitbar sein sollen, müssen sie an den neuen Speicherort (/conf/global
oder /conf/<tenant>
) migriert werden. Alle neuen ContentHub-Segmente, die in AEM erstellt werden, bleiben am neuen Speicherort (/conf/global
oder /conf/<tenant>
) erhalten.
Die Seiteneigenschaften von AEM Sites erlauben lediglich die Auswahl des vorherigen Speicherorts (/etc
) oder eines einzelnen neuen Speicherorts (/apps
, /conf/global
oder /conf/<tenant>
), daher müssen ContextHub-Segmente entsprechend migriert werden.
Alle nicht verwendeten ContextHub-Segmente von AEM-Referenz-Sites müssen nicht an den neuen Speicherort migriert werden, sondern können entfernt werden:
- /etc/segmentation/geometrixx/
- /etc/segmentation/geometrixx-outdoors
Hinweis: Wenn ClientContext verwendet wird, sollte eine Konvertierung in ContextHub durchgeführt werden.
Vor einem künftigen Upgrade prior-to-upgrade
Adobe Analytics-Client-Bibliotheken adobe-analytics-client-libraries
/etc/clientlibs/foundation/sitecatalyst
/libs/cq/analytics/clientlibs/analytics
Bei einer benutzerdefinierten Verwendung dieser Client-Bibliotheken sollte der Verweis auf die Client-Bibliothek nach Kategorie und nicht nach Pfad erfolgen:
-
Alle Verweise auf die Client-Bibliothek nach Pfad am vorherigen Speicherort sollten aktualisiert werden, sodass sie das Referenzierungssystem für Client-Bibliotheken von AEM verwenden.
-
Sollte das Referenzierungssystem für Client-Bibliotheken von AEM nicht verwendet werden können, kann über das Proxy-Servlet für Client-Bibliotheken von AEM auf den absoluten Pfad der Client-Bibliotheken verwiesen werden.
/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
Die Bearbeitung dieser Client-Bibliotheken wurde zu keinem Zeitpunkt unterstützt.
Um die Kategorien der Client-Bibliothek zu erhalten, rufen Sie jeden Knoten cq:ClientLIbraryFolder
über CRXDELite auf und prüfen Sie die Kategorie-Eigenschaft.
/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
Vom klassischen Microsoft Word zu Web-Seiten-Designs classic-microsoft-word-to-web-page-designs
/etc/designs/wordDesign
/libs/settings/wcm/designs/wordDesign
/apps/settings/wcm/designs/wordDesign
Für alle Designs, die in SCM verwaltet werden und in die nicht zur Laufzeit über Design-Dialogfelder geschrieben wird.
- Kopieren Sie die Designs vom bisherigen Speicherort an den neuen Speicherort (
/apps
). - Wandeln Sie die gesamten CSS-, JavaScript- und statischen Ressourcen im Design in eine Client-Bibliothek mit
allowProxy = true
um. - Aktualisieren Sie Verweise auf den vorherigen Speicherort in der Eigenschaft „cq:designPath“.
- Aktualisieren Sie alle Seiten, die auf den vorherigen Speicherort verweisen, sodass sie die neue Kategorie der Client-Bibliothek verwenden (dies erfordert auf der Seite eine Aktualisierung des Implementierungs-Codes).
- Aktualisieren Sie AEM Dispatcher-Regeln, um die Unterstützung für Client-Bibliotheken über das Proxy-Servlet
/etc.clientlibs/
zuzulassen.
Für alle Designs, die NICHT in SCM verwaltet werden und die über Design-Dialogfelder zur Laufzeit angepasst werden:
- Entfernen Sie keine bearbeitbaren Designs aus
/etc
.
Konfigurationen für den Emulator von Mobilgeräten mobile-device-emulator-configurations
/etc/mobile
/libs/settings/mobile
/apps/settings/mobile
/conf/global/settings/mobile
/conf/<tenant>/settings/mobile
Alle neuen Konfigurationen für den Mobilgeräte-Emulator müssen an den neuen Speicherort migriert werden.
- Kopieren Sie alle neuen Konfigurationen für den Mobilgeräte-Emulator vom vorherigen Speicherort an den neuen Speicherort (
/apps
,/conf/global
,/conf/<tenant>
). - Aktualisieren Sie für alle AEM Sites-Seiten, die von diesen Konfigurationen für den Mobilgeräte-Emulator abhängen, den Knoten
jcr ``:content
der Seite:
[cq:Page]/jcr:content@cq:deviceGroups
= String[ mobile/groups/responsive ] - Aktualisieren Sie die bearbeitbaren Vorlagen für alle bearbeitbaren Vorlagen, die von diesen Konfigurationen für den Mobilgeräte-Emulator abhängen, indem Sie
cq
:deviceGroups
auf den neuen Speicherort verweisen.
Die Auflösung der Konfigurationen für den Mobilgeräte-Emulator geschieht in der folgenden Reihenfolge:
/conf/<tenant>/settings/mobile
/conf/global/settings/mobile
/apps/settings/mobile
/libs/settings/mobile
/etc/mobile
Blueprint-Konfigurationen für den Multi-Site-Manager multi-site-manager-blueprint-configurations
/etc/blueprints
/apps/msm
(Kunden-Blueprint-Konfigurationen)
/libs/msm
(Gebrauchsfertige Blueprint-Konfigurationen für Screens, Commerce)
Alle neuen oder geänderten Blueprint-Konfigurationen für den Multi-Site-Manager müssen an den neuen Speicherort (/apps
) migriert werden.
- Kopieren Sie alle neuen oder modifizierten Blueprint-Konfigurationen für den Multi-Site-Manager vom vorherigen an den neuen Speicherort (
/apps
). - Entfernen Sie alle migrierten Blueprint-Konfigurationen für den Multi-Site-Manager vom vorherigen Speicherort.
Alle von AEM bereitgestellten Blueprint-Konfigurationen für den Multi-Site-Manager sind am neuen Speicherort unter /libs
verfügbar.
Der Inhalt verweist nicht auf die Blueprint-Konfigurationen für den Multi-Site-Manager, sodass keine Inhaltsverweise angepasst werden müssen.
Rollout-Konfigurationen für den Multi-Site-Manager multi-site-manager-rollout-configurations
/etc/msm/rolloutConfigs
/libs/msm/wcm/rolloutconfigs
/apps/msm/wcm/rolloutconfigs
Alle neuen oder modifizierten Rollout-Konfigurationen für den Multi-Site-Manager müssen an den neuen Speicherort migriert werden.
- Kopieren Sie alle neuen oder modifizierten Rollout-Konfigurationen für den Multi-Site-Manager vom vorherigen an den neuen Speicherort (
/apps
). - Aktualisieren Sie alle Verweise auf AEM-Seiten auf Rollout-Konfigurationen für den Multi-Site-Manager am vorherigen Speicherort, um auf ihre Gegenstücke an den neuen Speicherorten zu verweisen (
/libs
oder/apps
).
Entfernen Sie alle migrierten Rollout-Konfigurationen für den Multi-Site-Manager vom vorherigen Speicherort.
E-Mail-Vorlage für die Benachrichtigung über Seitenereignisse page-event-notification-e-mail-template
/etc/notification/email/default/com.day.cq.wcm.core.page
/libs/settings/notification-templates/com.day.cq.wcm.core.page
/apps/settings/notification-templates/com.day.cq.wcm.core.page
Die einzigen unterstützten neuen E-Mail-Vorlagen für die Seitenereignis-Benachrichtigung dienen der Unterstützung neuer Gebietsschemata.
Die Auflösung für die E-Mail-Vorlage für die Seitenereignis-Benachrichtigung geschieht in der folgenden Reihenfolge:
/etc/notification/email/default/com.day.cq.wcm.core.page
/apps/settings/notification-templates/com.day.cq.wcm.core.page
/libs/settings/notification-templates/com.day.cq.wcm.core.page
Alle neuen oder geänderten E-Mail-Vorlagen für die Seitenereignis-Benachrichtigung müssen an den neuen Speicherort unter /apps
migriert werden:
- Kopieren Sie alle neuen oder modifizierten E-Mail-Vorlagen für die Seitenereignis-Benachrichtigung vom vorherigen Speicherort an den neuen Speicherort (
/apps
). - Entfernen Sie alle migrierten E-Mail-Vorlagen für die Seitenereignis-Benachrichtigung vom vorherigen Speicherort.
Seiten-Strukturvorlage page-scaffolding
/etc/scaffolding
wcm
/template-types/scaffolding/scaffolding/apps/settings/ wcm
/template-types/scaffolding/scaffoldingResponsives Raster (LESS) responsive-grid-less
/etc/clientlibs/wcm/foundation/grid/grid_base.less
/libs/wcm/foundation/clientlibs/grid/grid_base.less
Alle Verweise auf den vorherigen Speicherort in benutzerdefinierten LESS-Dateien müssen so aktualisiert werden, dass der Import vom neuen Speicherort erfolgt.
- Aktualisieren Sie alle benutzerdefinierten LESS-Dateien, die auf „grid_base.less“ am vorherigen Speicherort verweisen, so, dass sie auf den neuen Speicherort verweisen.
grid_base.less
Datei führt dazu, dass der Layout-Modus des Seiten- und Vorlageneditors nicht funktioniert und verursacht eine Unterbrechung des Seiten-Layouts.Designs für statische Vorlagen static-template-designs
/etc/designs/<custom-site>
/apps/settings/wcm/designs/<custom-site>
Für alle Designs, die in SCM verwaltet werden und in die nicht zur Laufzeit über Design-Dialogfelder geschrieben wird.
- Kopieren Sie die Designs vom bisherigen Speicherort an den neuen Speicherort (
/apps
). - Wandeln Sie die gesamten CSS-, JavaScript- und statischen Ressourcen im Design in eine Client-Bibliothek mit
allowProxy = true
um. - Aktualisieren Sie die Verweise auf den vorherigen Speicherort in der Eigenschaft
cq:designPath
über AEM > Sites > Seiten für benutzerdefinierte Site > Seiteneigenschaften > Erweitert > Design. - Aktualisieren Sie alle Seiten, die auf den vorherigen Speicherort verweisen, sodass sie die neue Kategorie der Client-Bibliothek verwenden (dies erfordert auf der Seite eine Aktualisierung des Implementierungs-Codes).
- Aktualisieren Sie AEM Dispatcher-Regeln, um die Unterstützung für Client-Bibliotheken über das Proxy-Servlet
/etc.clientlibs/
zuzulassen.
Für alle Designs, die NICHT in SCM verwaltet werden und die über Design-Dialogfelder zur Laufzeit angepasst werden:
- Entfernen Sie keine bearbeitbaren Designs aus
/etc
.
Client-Bibliotheken für die Integration mit Adobe Target adobe-target-integration-client-libraries
/etc/clientlibs/foundation/target
/libs/cq/testandtarget/clientlibs/testandtarget
Bei einer benutzerdefinierten Verwendung dieser Client-Bibliotheken sollte der Verweis auf die Client-Bibliothek nach Kategorie und nicht nach Pfad erfolgen.
- Alle Verweise auf die Client-Bibliothek nach Pfad am vorherigen Speicherort sollten aktualisiert werden, sodass sie das Referenzierungssystem für Client-Bibliotheken von AEM verwenden.
- Sollte das Referenzierungssystem für Client-Bibliotheken von AEM nicht verwendet werden können, kann über das Proxy-Servlet für Client-Bibliotheken von AEM auf den absoluten Pfad der Client-Bibliotheken verwiesen werden:
/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
Die Bearbeitung dieser Client-Bibliotheken wurde zu keinem Zeitpunkt unterstützt.
Um die Kategorien der Client-Bibliothek zu erhalten, rufen Sie jeden Knoten „cq:ClientLIbraryFolder“ über CRXDELite auf und überprüfen Sie die Kategorie-Eigenschaft:
/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
WCM Foundation-Client-Bibliotheken wcm-foundation-client-libraries
/etc/clientlibs/wcm/foundation
/libs/wcm/foundation/clientlibs
Bei einer benutzerdefinierten Verwendung dieser Client-Bibliotheken sollte der Verweis auf die Client-Bibliothek nach Kategorie und nicht nach Pfad erfolgen.
- Alle Verweise auf die Client-Bibliothek nach Pfad am vorherigen Speicherort sollten so aktualisiert werden, dass sie das Referenzierungssystem von AEM für Client-Bibliotheken verwenden.
- Sollte das Referenzierungssystem für Client-Bibliotheken von AEM nicht verwendet werden können, kann über das Proxy-Servlet für Client-Bibliotheken von AEM auf den absoluten Pfad der Client-Bibliotheken verwiesen werden.
/etc.clientlibs/wcm/foundation/clientlibs/accessibility.css
/etc.clientlibs/wcm/foundation/clientlibs/main.css
/etc.clientlibs/wcm/foundation/clientlibs/main.js
Die Bearbeitung dieser Client-Bibliotheken wurde zu keinem Zeitpunkt unterstützt.
Um die Kategorien der Client-Bibliothek zu erhalten, rufen Sie jeden Knoten cq:ClientLIbraryFolder
über CRXDELite auf und prüfen Sie die Kategorie-Eigenschaft.
/libs/wcm/foundation/clientlibs/accessibility
/libs/wcm/foundation/clientlibs/main