Mappage de ressource resource-mapping

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

Le mappage de ressources permet de définir des redirections, des URL de redirection vers un microsite et des hôtes virtuels pour AEM.

Par exemple, vous pouvez utiliser ces mappages pour :

  • faire précéder toutes les requêtes de /content afin que la structure interne soit masquée pour les visiteurs de votre site web ;
  • définir une redirection afin que toutes les requêtes en direction de la page /content/en/gateway de votre site Web soient redirigées vers https://gbiv.com/.

Un mappage HTTP possible préfixe toutes les requêtes sur localhost:4503 avec /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/geometrixx/en/products.html

accessible à l’aide de :

localhost:4503/geometrixx/en/products.html

car le mappage ajoutera automatiquement le préfixe /content à /geometrixx/en/products.html.

CAUTION
Les URL Vanity ne prennent pas en charge les modèles regex.
NOTE
Voir la documentation Sling et les sections Mappages pour la résolution de ressource et Ressources pour plus d’informations.

Affichage des définitions de mappage viewing-mapping-definitions

Les mappages forment deux listes que le résolveur de ressources JCR évalue (de haut en bas) pour trouver une correspondance.

Ces listes peuvent être visualisées (ainsi que des informations de configuration) sous l’option JCR ResourceResolver de la console Felix ; par exemple, https://<host>:<port>/system/console/jcrresolver :

  • Configuration

    Affiche la configuration actuelle (telle que définie pour la variable Apache Sling Resource Resolver.

  • Test de configuration

    Vous pouvez ainsi saisir une URL ou un chemin d’accès à la ressource. Cliquez sur Resolve (Résoudre) ou Map (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 la ou les applications. Ils visent souvent à simplifier les URL de l’utilisateur.

La paire de listes a Modèle, une expression régulière associée à la requête, avec une Remplacement qui définit la redirection à imposer.

Par exemple :

Modèle ^[^/]+/[^/]+/welcome$

déclenche :

Remplacement /libs/cq/core/content/welcome.html.

pour rediriger une requête :

http://localhost:4503/welcome

vers :

http://localhost:4503/libs/cq/core/content/welcome.html

De nouvelles définitions de mappage sont créées dans le référentiel.

NOTE
Il existe de nombreuses ressources disponibles qui permettent d’expliquer comment définir les expressions régulières ; par exemple, https://www.regular-expressions.info/.

Création de définitions de mappage dans AEM creating-mapping-definitions-in-aem

Dans une installation standard d’AEM, vous trouverez le dossier suivant :

/etc/map/http

Il s’agit de la structure utilisée lors de la définition des mappages pour le protocole HTTP. D’autres dossiers (sling:Folder) peuvent être créés sous /etc/map pour tout autre protocole que vous souhaitez mapper.

Configuration d’une redirection interne vers /content configuring-an-internal-redirect-to-content

Pour créer le mappage qui préfixe toute requête à http://localhost:4503/ avec /content:

  1. À l’aide de CRXDE, accédez à /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 Enregistrer tout.

  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.

Cela permet de gérer une requête telle que :
localhost:4503/geometrixx/en/products.html
comme si :
localhost:4503/content/geometrixx/en/products.html
avait été demandé.

NOTE
Voir Ressources dans la documentation Sling pour plus d’informations sur les propriétés sling disponibles et leur configuration.
NOTE
Vous pouvez utiliser /etc/map.publish pour conserver les configurations dans l’environnement de publication. Elles doivent ensuite être dupliquées, et le nouvel emplacement (/etc/map.publish) configuré pour l’emplacement du mappage du résolveur de ressource Apache Sling de l’environnement de publication.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56