Het uitvoeren van pijpleidingsvrije URL richt

Laatst bijgewerkt: 7 maart 2025

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar
  • Gebruiker

Leer hoe te om pijpleiding-vrije URL uit te voeren richtin AEM as a Cloud Service om het marketing team toe te laten om de omleidingen te beheren zonder een ontwikkelaar te hoeven.

Er zijn veelvoudige opties om URL te beheren richt in AEM, voor meer informatie, zie opnieuw richt URL.

Het leerprogramma concentreert zich bij het creëren van URL richt zich als zeer belangrijk-waardeparen in een tekstdossier zoals Apache RewriteMapopnieuw en gebruikt AEM as a Cloud Service specifieke configuratie om hen in de module Apache/Dispatcher te laden.

Vereisten

U hebt het volgende nodig om deze zelfstudie te voltooien:

  • Het milieu van AEM as a Cloud Service met versie 18311 of hoger.

  • Het steekproef WKNDproject van Plaatsen moet op het worden opgesteld.

Gebruiksscenario voor zelfstudie

Voor het demodoel, laten we veronderstellen dat het WKND marketing team een nieuwe skicampagne lanceert. Ze willen korte URL's maken voor de ski-avontuurpagina's en deze op hun eigen manier beheren, net zoals ze de inhoud beheren. Zij besloten om de pijpleiding-vrije URL te gebruiken herleidtbenadering om URL te beheren opnieuw richt.

Gebaseerd op de vereisten van het marketing team, zijn het volgende URL omleidingen die moeten worden gecreeerd.

SOURCE URLDoel-URL
/ski/us/en/adventures.html
/ski/northamerica/us/en/adventures/downhill-skiing-wyoming.html
/ski/westkust/us/en/adventures/tahoe-skiing.html
/ski/europe/us/en/adventures/ski-touring-mont-blanc.html

Nu, zie hoe te om deze URL te beheren richt en vereiste eenmalig Dispatcher configuraties in de milieu van AEM as a Cloud Service.

URL-omleidingen beheren

Om URL te beheren zijn er veelvoudige beschikbare opties, onderzoeken hen.

Tekstbestand in DAM

De URL-omleidingen kunnen worden beheerd als sleutelwaardeparen in een tekstbestand en worden geüpload naar het DAM (AEM Digital Asset Management).

De bovenstaande URL-omleidingen kunnen bijvoorbeeld worden opgeslagen in een tekstbestand met de naam skicampaign.txt en worden geüpload naar de map DAM @ /content/dam/wknd/redirects . Na revisie en goedkeuring kan het marketingteam het tekstbestand publiceren.

# Ski Campaign Redirects separated by the TAB character
/ski      /us/en/adventures.html
/ski/northamerica  /us/en/adventures/downhill-skiing-wyoming.html
/ski/westcoast   /us/en/adventures/tahoe-skiing.html
/ski/europe          /us/en/adventures/ski-touring-mont-blanc.html

dossier van de Tekst in DAM

ACS-opdrachten - Kaartbeheer omleiden

ACS Commons - richt de Manager van de Kaartopnieuw om een gebruikersvriendelijke interface om URL te leiden richt.

Bijvoorbeeld, kan het marketing team een nieuwe Redirect genoemde pagina van Kaarten SkiCampaign tot stand brengen en bovengenoemde URL toe leidt opnieuw richt gebruikend geeft Ingangen tabel uit. De URL-omleidingen zijn beschikbaar via /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt .

Redirect de Manager van de Kaart

IMPORTANT
ACS de versie van de Bevelen 6.7.0 of hoger wordt vereist om de Redirect Manager van de Kaart te gebruiken, voor meer informatie, zie de Bevelen ACS - Redirect Manager.

ACS-opdrachten - Omleidingsbeheer

Alternatief, verstrekken de ACS Bevelen - Richt Managerook een gebruikersvriendelijke interface om URL te beheren richt.

Bijvoorbeeld, kan het marketing team een nieuwe configuratie tot stand brengen genoemd /conf/wknd en de bovengenoemde omleidingen toevoegen URL gebruikend de + knoop van de Configuratie van de Omleiding. De URL-omleidingen zijn beschikbaar via /conf/wknd/settings/redirects.txt .

Redirect Manager

IMPORTANT
ACS de versie van de Bevelen 6.10.0 of hoger wordt vereist om de Redirect Manager te gebruiken, voor meer informatie, zie de Bevelen ACS - Redirect Manager.

De Dispatcher configureren

Als u de URL als een RewriteMap wilt laden en deze wilt toepassen op binnenkomende aanvragen, zijn de volgende Dispatcher-configuraties vereist.

Dispatcher-module inschakelen voor flexibele modus

Eerst, verifieer dat de module van Dispatcher voor flexibele wijze wordt toegelaten. De aanwezigheid van USE_SOURCES_DIRECTLY -bestand in de dispatcher/src/opt-in -map geeft aan dat de Dispatcher zich in de flexibele modus bevindt.

URL-omleidingen laden als RewriteMap

Maak vervolgens een nieuw configuratiebestand managed-rewrite-maps.yaml in de map dispatcher/src/opt-in met de volgende structuur.

maps:
- name: <MAPNAME>.map # e.g. skicampaign.map
    path: <ABSOLUTE_PATH_TO_URL_REDIRECTS_FILE> # e.g. /content/dam/wknd/redirects/skicampaign.txt, /etc/acs-commons/redirect-maps/skicampaign/jcr:content.redirectmap.txt, /conf/wknd/settings/redirects.txt
    wait: false # Optional, default is false, when true, the Apache waits for the map to be loaded before starting
    ttl: 300 # Optional, default is 300 seconds, the reload interval for the map

Tijdens de implementatie maakt de Dispatcher het <MAPNAME>.map -bestand in de map /tmp/rewrites .

IMPORTANT
De bestandsnaam (managed-rewrite-maps.yaml) en de locatie (dispatcher/src/opt-in) moeten exact zo zijn als hierboven is vermeld. Beschouw het als een te volgen conventie.