DocumentatieAEM as a Cloud ServiceHandboek

Padtoewijzing voor Edge Delivery Services path-mapping

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Gebruiker

Leer hoe u paginapaden die in de AEM ontwerpinstantie worden gebruikt, kunt toewijzen aan openbare paginapaden die op de website worden gebruikt en bepalen welke inhoud naar Edge Delivery Services wordt gepubliceerd.

Overzicht overview

Als u WYSIWYG-inhoud wilt kunnen schrijven met AEM en publiceren naar Edge Delivery Services, moet u de padtoewijzing van uw project instellen. Deze toewijzing heeft twee doelen.

  • Hiermee wordt een relatie toegewezen en gemaakt tussen paginapaden die worden gebruikt op uw AEM ontwerpinstantie en de openbare paginapaden die worden gebruikt op uw website.
  • Hiermee bepaalt u welke inhoud (pagina's, bladen, elementen, enz.) worden gepubliceerd aan Edge Delivery Services.

De padtoewijzing moet voor elk project afzonderlijk worden geconfigureerd en op basis van de inhoud en URL-structuur van het project. Het wordt gebruikt door AEM tijdens inhoud het publiceren en terwijl het uitgeven van inhoud in de Universele Redacteur.

Configuratie-indeling configuration-format

De indeling van de configuratie voor padtoewijzing bevat twee secties (mappings en includes ) die lijken op het volgende voorbeeld.

{
  "mappings": [
    "/content/aem-boilerplate/:/",
    "/content/aem-boilerplate/configuration:/.helix/config.json"
  ],
  "includes:" [
    "/content/aem-boilerplate/"
  ]
}

toewijzingen mappings

De configuratie mappings bevat een array met interne paden (in de AEM ontwerpinstantie) en externe URL-paden (op de openbare website).

De notatie is <internal paths>:<external path> . Het bestaat doorgaans uit minimaal twee vermeldingen.

  1. De eerste vermelding in het voorbeeld is de padtoewijzing van de websitepagina's.
  2. Het tweede item bepaalt de toewijzing van de .helix/config.json aan de corresponderende spreadsheetpagina in de AEM authoringopslagplaats.

In dit voorbeeld zijn alle pagina's die zijn opgeslagen onder /content/aem-boilerplate/... , rechtstreeks toegankelijk voor het publiek op de site Edge Delivery Services onder https://main--my-site--org.aem.live/.... .

TIP
Alle tabelgegevens die als spreadsheets worden beheerd (bijvoorbeeld metagegevens, omleidingen en taxonomie), worden doorgaans gepubliceerd als .json API-URL's op Edge Delivery Services. Om dit te doen, moeten zij individueel in de kaartconfiguratie worden vermeld.
Gelieve te zien het document Gebruikend Spreadsheets om Gegevens in Tabelvoor meer informatie te beheren.

include includes

De includes -configuratie bepaalt welke inhoudspaden daadwerkelijk worden gerepliceerd naar Edge Delivery Services. Het kan om het even welke serie van wegen ook bevatten en typisch bevat de de hoofdpagina van het hoogste niveau van plaatsen.

Assets dat op pagina's met Edge Delivery Services wordt gebruikt, wordt doorgaans naast de webpagina gepubliceerd. Ze worden automatisch geëxporteerd van de AEM ontwerpinstantie naar Edge Delivery Services.

TIP
Als u een gebruikscase hebt waarin u elementen die rechtstreeks naar Edge Delivery Services worden gepubliceerd (bijvoorbeeld als u afbeeldingen of PDF direct toegankelijk wilt maken via hun URL's buiten een paginacontext), moet u de DAM-paden ook toevoegen aan de sectie includes van de configuratie.
Als een elementenhoofdmap, zoals /content/dam/my-site/documents die een set PDF bevat, via /assets/... openbaar toegankelijk moet zijn, moet een item worden toegevoegd aan de sectie includes van de configuratie.

Hoe te vormen how-to-configure

Uw wegtoewijzingen kunnen op één van twee manieren afhankelijk van de opstelling van uw project worden gevormd.

  1. Als het project voor aem.live wordt gevormd en de configuratiedienstvoor gecentraliseerde configuraties gebruikt, wordt de wegafbeelding voor elke plaats gevormd via deze configuratiedienst.

    • Hier volgt een voorbeeld van een cURL-aanvraag om padtoewijzingen te configureren.
    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/"
    ]
}
}'

  2. Als het project niet de configuratieservice gebruikt, wordt de wegafbeelding gevormd via een paths.json dossier in u de bewaarplaats van GitHub projecten.

In beide gevallen, zodra u uw wegafbeeldingen vormt, kunt u de configuratie controleren via openbaar-toegankelijke configuratie URL https://<branch>--<site>--<org>.aem.page/config.json.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab