Pfadzuordnung für Edge Delivery Services path-mapping
Erfahren Sie, wie Sie in der AEM-Autoreninstanz verwendete Seitenpfade öffentlichen Seitenpfaden zuordnen, die auf der Website verwendet werden, und steuern, welcher Inhalt in Edge Delivery Services veröffentlicht wird.
Übersicht overview
Um WYSIWYG-Inhalte mithilfe von AEM erstellen und in Edge Delivery Services veröffentlichen zu können, müssen Sie die Pfadzuordnung Ihres Projekts einrichten. Diese Zuordnung hat zwei Zwecke.
- Sie ordnet Seitenpfade, die in Ihrer AEM-Autoreninstanz verwendet werden, zu und erstellt eine Beziehung zu den öffentlichen Seitenpfaden, die auf Ihrer Website verwendet werden.
- Sie steuert, welche Inhalte (Seiten, Blätter, Assets usw.) werden in Edge Delivery Services veröffentlicht.
Die Pfadzuordnung muss für jedes Projekt einzeln und entsprechend dem Inhalt und der URL-Struktur des Projekts konfiguriert werden. Sie wird von AEM während der Veröffentlichung von Inhalten und während der Bearbeitung von Inhalten im universellen Editor verwendet.
Konfigurationsformat configuration-format
Das Format der Pfadzuordnungskonfiguration enthält zwei Abschnitte (mappings
und includes
), die dem folgenden Beispiel ähneln.
{
"mappings": [
"/content/aem-boilerplate/:/",
"/content/aem-boilerplate/configuration:/.helix/config.json"
],
"includes:" [
"/content/aem-boilerplate/"
]
}
Zuordnungen mappings
Die Konfiguration mappings
enthält eine Reihe von internen Pfaden (in der AEM-Autoreninstanz) und externen URL-Pfaden (auf der öffentlichen Website).
Das Format ist <internal paths>:<external path>
. Sie besteht normalerweise aus mindestens zwei Einträgen.
- Der erste Eintrag aus dem Beispiel ist die Pfadzuordnung der Website-Seiten.
- Der zweite Eintrag steuert die Zuordnung von
.helix/config.json
zur entsprechenden Tabellenseite im AEM Authoring-Repository.
In diesem Beispiel sind alle unter /content/aem-boilerplate/...
gespeicherten Seiten auf der Edge Delivery Services-Site direkt unter https://main--my-site--org.aem.live/....
öffentlich zugänglich.
.json
API-URLs auf Edge Delivery Services veröffentlicht. Dazu müssen sie einzeln in der Zuordnungskonfiguration aufgeführt sein.include includes
Die includes
-Konfiguration steuert, welche Inhaltspfade tatsächlich auf Edge Delivery Services repliziert werden. Es kann auch ein beliebiges Array von Pfaden enthalten und enthält normalerweise die Stammseite der Sites auf oberster Ebene.
Auf Edge Delivery Services-Seiten verwendete Assets werden normalerweise neben der Webseite veröffentlicht. Sie werden automatisch aus der AEM-Autoreninstanz in Edge Delivery Services exportiert.
includes
"der Konfiguration hinzufügen./content/dam/my-site/documents
, der einen Satz PDF enthält, über /assets/...
öffentlich zugänglich sein soll, muss ein Eintrag zum Abschnitt includes
der Konfiguration hinzugefügt werden.Anleitung zum Konfigurieren how-to-configure
Ihre Pfadzuordnungen können je nach Einrichtung Ihres Projekts auf zwei Arten konfiguriert werden.
-
Wenn das Projekt für
aem.live
konfiguriert ist und den Konfigurationsdienst für zentralisierte Konfigurationen verwendet, wird die Pfadzuordnung für jede Site über diesen Konfigurationsdienst konfiguriert.- Im Folgenden finden Sie eine Beispiel-cURL-Anfrage zum Konfigurieren von Pfadzuordnungen.
code language-text curl --request POST \ --url https://admin.hlx.page/config/{org}/sites/{site}/public.json \ --header 'Content-Type: application/json' \ --header 'x-auth-token: ......' \ --data '{ "paths": { "mappings": [ "/content/aem-boilerplate/:/", "/content/aem-boilerplate/configuration:/.helix/config.json" ], "includes": [ "/content/aem-boilerplate/" ] } }'
-
Wenn das Projekt den Konfigurationsdienst nicht verwendet, wird die Pfadzuordnung über eine
paths.json
-Datei in Ihren Projekten GitHub-Repository konfiguriert.- Ein Beispiel finden Sie unter
https://github.com/adobe-rnd/aem-boilerplate-xwalk/blob/main/paths.json
.
- Ein Beispiel finden Sie unter
In beiden Fällen können Sie die Konfiguration nach der Konfiguration der Pfadzuordnungen über die öffentlich zugängliche Konfigurations-URL https://<branch>--<site>--<org>.aem.page/config.json
überprüfen.