Le mappage de ressources permet de définir des redirections, des URL de redirection vers un microsite et des hôtes virtuels pour Adobe Experience Manager (AEM).
Par exemple, vous pouvez utiliser ces mappages pour :
/content
afin que la structure interne soit masquée pour les visiteurs de votre site web ;/content/en/gateway
de votre site Web soient redirigées vers https://gbiv.com/
.Un mappage HTTP possible consiste à préfixer toutes les demandes à localhost:4503
avec le répertoire /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
Pour y accéder à l’aide de :
localhost:4503/we-retail/en/products.html
Comme le mappage ajoute automatiquement le préfixe /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.
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 indique la configuration actuelle (telle que définie pour le résolveur de ressource Apache Sling).
Test de configuration Permet de 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 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 :
https://localhost:4503/welcome
``
Pour :
https://localhost:4503/libs/cq/core/content/welcome.html
De nouvelles définitions de mappage sont créées dans le référentiel.
De nombreuses ressources sont disponibles pour expliquer comment définir des expressions régulières. Par exemple : https://www.regular-expressions.info/.
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.
Pour créer le mappage qui préfixe toute demande de https://localhost:4503/ avec /content
:
À l’aide de CRXDE, accédez à /etc/map/http
.
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
Cliquez sur Enregistrer tout.
Ajoutez les propriétés suivantes à ce nœud :
Nom sling:match
Type String
Valeur localhost.4503/
Nom sling:internalRedirect
Type String[]
Valeur /content/
Cliquez sur Enregistrer tout.
Cela gère une requête telle que :
localhost:4503/geometrixx/en/products.html
comme si :
localhost:4503/content/geometrixx/en/products.html
avait été demandé.
Voir Ressources dans la documentation Sling pour plus d’informations sur les propriétés sling disponibles et leur configuration.
Vous pouvez utiliser /etc/map.publish
pour conserver les configurations dans l’environnement de publication. Ils doivent être répliqués et le nouvel emplacement ( /etc/map.publish
) configuré pour la variable Emplacement du mappage de Apache Sling Resource Resolver de l’environnement de publication.