Show Menu
SUJETS×

Mappage de ressource

Le mappage de ressource permet de définir des redirections, des URL Vanity et des hôtes virtuels pour AEM.
Par exemple, vous pouvez utiliser ces mappages pour :
  • Prefix all requests with /content so that the internal structure is hidden from the visitors to your website.
  • Define a redirect so that all requests to the /content/en/gateway page of your website are redirected to https://gbiv.com/ .
One possible HTTP mapping prefixes all requests to localhost:4503 with /content . Un mappage de ce type peut être utilisé pour masquer la structure interne vis-à-vis des visiteurs du site web, car il rend :
localhost:4503/content/we-retail/en/products.html
accessible à l’aide de :
localhost:4503/we-retail/en/products.html
as the mapping will automatically add the prefix /content to /we-retail/en/products.html .
Les URL Vanity ne prennent pas en charge les modèles regex.
Voir la documentation Sling et les sections Mappages pour la résolution de ressource et Ressources pour plus d’informations.

Affichage des définitions du mappage

Les mappages forment deux listes que le résolveur de ressources JCR analyse (du haut vers le bas) pour trouver une correspondance.
These lists can be viewed (together with configuration information) under the JCR ResourceResolver option of the Felix console; for example, https://<*host*>:<*port*>/system/console/jcrresolver :
  • Configuration indique la configuration actuelle (telle que définie pour le résolveur de ressource Apache Sling ).
  • Test de configuration. Cela permet de saisir une URL ou un chemin d’accès vers la ressource. Cliquez sur Résoudre ou Mapper pour confirmer la façon dont le système transforme l’entrée.
  • Resolver Map Entries (Entrées de mappage du résolveur) La liste des entrées utilisées par les méthodes ResourceResolver.resolve pour mapper les URL aux ressources.
  • Mapping Map Entries (Entrées de mappage) La liste des entrées utilisées par les méthodes ResourceResolver.map pour mapper les chemins d’accès des ressources aux URL.
Les deux listes affichent différentes entrées, y compris celles définies par défaut par les applications. Cela vise souvent à simplifier les URL pour l’utilisateur.
Les listes associe un modèle , une expression régulière correspondant à la demande, avec un remplacement qui définit la redirection à appliquer.
Par exemple :
Modèle ^[^/]+/[^/]+/welcome$
déclenche :
Remplacement /libs/cq/core/content/welcome.html .
pour rediriger une requête :
https://localhost:4503/welcome ``
vers :
https://localhost:4503/libs/cq/core/content/welcome.html
De nouvelles définitions de mappage sont créées dans le référentiel.
There are many resources available that help explain how to define regular expressions; for example https://www.regular-expressions.info/ .

Création des définitions de mappage dans AEM

Dans une installation d’AEM standard, vous pouvez trouver le dossier :
/etc/map/http
Il s’agit de la structure utilisée lors de la définition des mappages pour le protocole HTTP. Other folders ( sling:Folder ) can be created under /etc/map for any other protocols that you want to map.

Configuration d’une redirection interne vers /content

To create the mapping that prefixes any request to https://localhost:4503/ with /content :
  1. Using CRXDE navigate to /etc/map/http .
  2. Créez un nœud :
    • Type sling:Mapping ce type de nœud est conçu pour de tels mappages, même si son utilisation n’est pas obligatoire.
    • Nom localhost_any
  3. Cliquez sur Tout enregistrer .
  4. Ajoutez les propriétés suivantes à ce nœud :
    • Nom sling:match
      • Type String
      • Valeur localhost.4503/
    • Nom sling:internalRedirect
      • Type String
      • Valeur /content/
  5. Cliquez sur Enregistrer tout .
This will handle a request such as: localhost:4503/geometrixx/en/products.html as if: localhost:4503/content/geometrixx/en/products.html had been requested.
Voir Ressources dans la documentation Sling pour plus d’informations sur les propriétés sling disponibles et leur configuration.
You can use /etc/map.publish to hold the configurations for the publish environment. These must then be replicated, and the new location ( /etc/map.publish ) configured for the Mapping Location of the Apache Sling Resource Resolver of the publish environment.