Vous consultez actuellement l'aide de la version:

Ce document répond aux questions suivantes :

  • Architecture du portail AEM
  • Administration et configuration d’AEM en tant que portail
  • Utilisation d’AEM en tant que portail
  • Installation, configuration et affichage du contenu d’AEM dans un portlet (serveur web, par exemple)

Architecture du portail AEM

L’architecture du portail AEM comporte des définitions des portails et des portlets.

Qu’est-ce qu’un portail ?

Un portail est une application web qui permet la personnalisation, la connexion unique et l’intégration du contenu provenant de sources différentes et héberge la couche de présentation des systèmes d’information.

Dans AEM, vous pouvez exécuter des portlets compatibles avec la spécification JSR-286. Le composant Portlet permet également d’incorporer un portlet dans la page. Voir Administration du portlet de contenu AEM.

Qu’est-ce qu’un portlet ?

Les portlets sont des composants web déployés dans un conteneur, qui proposent du contenu dynamique. L’interface du portlet est regroupée et déployée sous forme de fichier WAR dans un conteneur de portlet. Si vous exécutez AEM en tant que portail, vous avez besoin du fichier WAR du portlet pour exécuter le portlet.

Pour configurer le contenu d’AEM de sorte qu’il s’affiche sur un portail, voir Installation, configuration et utilisation d’AEM dans un portlet.

AEM Portal Director

Attention :

AEM Portal Director est obsolète depuis la version AEM 6.4. Voir Fonctionnalités obsolètes et supprimées.

Administration du portlet de contenu AEM

Le portlet de contenu AEM permet d’afficher du contenu AEM sur un portail. Le portlet est disponible à l’adresse /crx-quickstart/opt/portal et peut être personnalisé de différentes façons. Par exemple, vous pouvez personnaliser la gestion SSO/de l’authentification en déployant votre propre service d’authentification générant les informations d’authentification nécessaires pour qu’AEM remplace le comportement par défaut. Les modules externes utilisent une API définie, qui permet d’ajouter votre propre fonctionnalité en créant le module externe contre les API. Le module externe peut être déployé dans le portlet exécuté. Pour qu’il fonctionne correctement, une instance de création et de publication AEM doit être configurée avec le chemin d’accès au contenu à afficher au démarrage.

Certaines des configurations sont modifiables par le biais des préférences de portlet et d’autres par le biais des configurations de service OSGI. Vous pouvez modifier ces configurations à l’aide des fichiers config ou de la console web OSGi.

Préférences de portlet

Les préférences de porlet peuvent être configurées lors du déploiement sur le serveur du portail ou en modifiant le fichier WEB-INF/portlet.xml avant de déployer l’application web du portlet. Le fichier portlet.xml se présente, par défaut, comme suit :

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd /opt/SUNWps/dtd/portlet.xsd"
             version="1.0">
   <portlet>
      <portlet-name>RSSWeatherPortlet</portlet-name>
      <portlet-class>org.jboss.portlet.weather.WeatherPortlet</portlet-class>
      <init-param>
         <name>default_zipcode</name>
         <value>05673</value>
      </init-param>
      <init-param>
         <name>RSS_XSL</name>
         <value>/WEB-INF/Rss.xsl</value>
      </init-param>
      <init-param>
         <name>base_url</name>
         <value>http://xml.weather.yahoo.com/forecastrss?p=</value>
      </init-param>
      <expiration-cache>180</expiration-cache>
      <supports>
         <mime-type>text/html</mime-type>
         <portlet-mode>VIEW</portlet-mode>
         <portlet-mode>EDIT</portlet-mode>
      </supports>
      <portlet-info>
         <title>Weather Portlet</title>
      </portlet-info>
      <portlet-preferences>
         <preference>
            <name>expires</name>
            <value>180</value>
         </preference>
         <preference>
            <name>RssXml</name>
            <value>http://xml.weather.yahoo.com/forecastrss?p=33145</value>
            <read-only>false</read-only>
         </preference>
      </portlet-preferences>
   </portlet>
</portlet-app>

Le portlet peut être configuré avec les préférences suivantes :

startPath

Il s’agit du chemin d’accès de début du portlet : il définit le contenu affiché initialement.

Important : si le portlet est configuré de manière à se connecter aux instances de création et de publication AEM exécutées sur un chemin d’accès contextuel autre que /, vous devez forcer CQUrlInfo dans la configuration HTML du Gestionnaire de bibliothèques de ces instances AEM (via Felix Webconsole, par exemple) ou la modification ne fonctionnera pas et la boîte de dialogue Préférence ne s’affichera pas.

htmlSelector Sélecteur ajouté à chaque adresse URL. Par défaut, il s’agit d’un portlet afin que toutes les demandes de pages HTML qui utilisent des adresses URL qui se terminent par .portlet.html. Cela permet d’utiliser des scripts personnalisés dans AEM pour le rendu du portlet.
addCssToPortalHeader

Par défaut, les fichiers CSS d’AEM que contient la page HTML sont inclus dans le portlet. La désactivation de cette option exclut les fichiers CSS par défaut.

Si cette option est activée, les fichiers CSS sont ajoutés dans les balises <head> de la page HTML ou incorporés dans la page HTML en fonction du comportement du portail.

includeToolbar Par défaut, une barre d’outils est rendue dans le portlet de contenu pour la fonctionnalité de gestion. Si vous désactivez cette option, aucune barre d’outils n’est rendue.
urlParameterNames

Liste des autres noms de paramètre URL susceptibles de contenir la nouvelle adresse URL du contenu à afficher pour le portlet. La liste est traitée de haut en bas. Le premier paramètre contenant une valeur est utilisé. Si le système ne trouve aucune adresse URL, le paramètre d’URL par défaut est utilisé. L’adresse URL fournie est utilisée en l’état, sans autre modification.

Ce paramètre concerne chaque portlet déployé. Il sert également à configurer globalement certains paramètres des adresses URL dans la configuration d’OSGi pour le « Day Portal Director Portlet Bridge ».

preferenceDialog Chemin d’accès à la boîte de dialogue Préférences dans AEM. Si cette préférence n’est pas renseignée, la boîte de dialogue Préférences intégrée est utilisée. La valeur par défaut est /libs/portal/content/prefs.html.
initialRedirect Par défaut, le portlet exécute une redirection JavaScript de toute la page du portail lors du premier appel. Cela permet de prendre en charge le scénario de glisser-déposer des serveurs de portail modernes. En production, cette redirection est rarement nécessaire et peut donc être désactivée en définissant la préférence sur false.

Console web OSGi

Si le serveur est exécuté sur localhost, port 8080, et que l’application web du portlet AEM est montée dans le contexte de l’application web cqportlet, l’adresse URL de la console web est http://localhost:8080/cqportlet/cqbridge/system/console. Le nom d’utilisateur et le mot de passe par défaut sont admin.

Ouvrez l’onglet Configurations et sélectionnez Configuration du serveur CQ de Portal Directory. Vous spécifiez l’adresse URL de base de l’instance de création et de publication. Cette procédure est décrite dans la section Configuration du portlet.

Remarque :

La console web OSGi n’est destinée qu’à la modification des configurations en phase de développement (ou de test). Veillez à bloquer les demandes de la console pour les systèmes de production.

Fourniture de fonctionnalités

Pour prendre en charge les déploiements automatisés et la mise en service des configurations, le portlet de contenu AEM comporte une prise en charge des configurations intégrée, qui tente de lire les configurations au chemin d’accès aux classes indiqué à l’application du portlet.

Au démarrage, la propriété système com.day.cq.po rtet.config est lue pour détecter l’environnement actif. En règle générale, la valeur de cette propriété est du type dev, prod, test et ainsi de suite. Si aucun environnement n’est défini, aucune configuration n’est lue.

Si un environnement est défini, le système cherche un fichier config dans le chemin d’accès aux classes sous com/day/cq/portlet/{env}.config, où env est remplacé par la valeur actuelle pour l’environnement. Ce fichier doit répertorier tous les fichiers de configuration pour cet environnement. Ces fichiers sont recherchés par rapport à l’emplacement du fichier .config. Par exemple, si le fichier contient une ligne my.service.xml, ce fichier est lu à partir du chemin d’accès aux classes sous com/day/cq/portlet/my.service.config. Le nom du fichier comprend l’ID de persistance du service, suivi de .config. Dans l’exemple précédent, l’ID de persistance est my.service. Le format du fichier de configuration est le format utilisé par le programme d’installation OSGi Apache Sling.

Cela signifie qu’un fichier .config correspondant doit être ajouté pour chaque environnement. Une configuration qui doit être appliquée à tous les environnements doit être indiquée dans tous ces fichiers. Si un seul environnement est concerné, elle est simplement indiquée dans ce fichier. Ce mécanisme permet de s’assurer d’un contrôle total sur la configuration lue dans un environnement déterminé.

Il est possible d’utiliser une autre propriété système pour détecter l’environnement. Spécifiez la propriété système com.day.cq.po rtet.configproperty contenant le nom de la propriété système à utiliser à la place de com.day.cq.portet.config.

Mise en cache et annulation de la mise en cache

Le portlet, dans sa configuration par défaut, met en cache les réponses qu’il reçoit d’AEM WCM dans un cache spécifique à l’utilisateur. Les caches doivent être annulés si des modifications sont apportées au contenu de l’instance de publication. À cet effet, un agent de réplication doit être configuré dans l’instance de création AEM WCM. Le cache peut également être vidé manuellement. Cette section décrit ces deux procédures.

Le portlet peut être configuré avec son propre cache, de sorte que le contenu dans le portlet s’affiche sans avoir à accéder à AEM. Le portail est disponible sous forme de contenu dans le répertoire /libs/portal/director. Pour accéder au contenu, démarrez une instance AEM et téléchargez le fichier de cet emplacement à l’aide de CRXDE Lite ou Webdav.

Vous pouvez déployer ce lot lors de l’exécution ou l’ajouter à l’application web du portlet sous WEB-INF/lib/resources/bundles avant le déploiement.

Une fois le cache déployé, le portlet met en cache le contenu de l’instance de publication. Le cache du portlet peut être annulé en vidant le Dispatcher d’AEM. Pour configurer le portlet de manière à utiliser son propre cache :

  1. Configurez un agent de réplication dans l’instance de création qui cible le serveur du portail. 
  2. Si le serveur du portail est exécuté sur localhost, port 8080, et que l’application web du portlet AEM est montée dans le contexte cqportlet, l’adresse URL pour vider le cache de la console web est http://localhost:8080/cqportlet/cqbridge/cqpcache?Path=$(path). Utilisez la méthode GET.
    Remarque : au lieu d’utiliser un paramètre de demande, vous pouvez envoyer un en-tête HTTP appelé Path.

Vidage du cache par un agent de réplication

Comme l’annulation normale de Dispatcher, un agent de réplication peut être configuré de manière à cibler le cache du portlet AEM du portail. Une fois que vous avez configuré l’agent de réplication, chaque activation d’une page normale vide le cache du portail.

Si vous gérez plusieurs nœuds du portail exécutant le portlet AEM, vous devez créer un agent de chaque nœud, comme indiqué dans cette procédure.

Pour configurer un agent de réplication pour le portail :

  1. Connectez-vous à l’instance de création.

  2. Sur l’onglet Sites web, cliquez sur l’onglet Outils.

  3. Cliquez sur Nouvelle page dans le menu Nouveau de l’agent de réplication.

    screen_shot_2012-02-15at40647pm
  4. Dans Modèle, sélectionnez Agent de réplication et entrez un nom pour l’agent. Cliquez sur Créer.

    screen_shot_2012-02-15at40817pm
  5. Double-cliquez sur l’agent de réplication que vous venez de créer. Le système indique qu’il n’est pas valide, car il n’a pas encore été configuré.

    screen_shot_2012-02-15at41001pm
  6. Cliquez sur Modifier.

  7. Sur l’onglet Paramètres, cochez la case Activé, sélectionnez le type de sérialisation Vider Dispatcher, puis saisissez un délai avant une nouvelle tentative (60 000, par exemple).

    screen_shot_2012-02-15at42101pm
  8. Cliquez sur l’onglet Transfert.

  9. Dans le champ URI, saisissez L’URI de vidage du portlet. L’URI est au format suivant :

    http://<wps-host>:<port>/<wps-context>/<cq5-portlet-context>/cqbridge/cqpcache
    screen_shot_2012-02-15at42322pm
  10. Cliquez sur l’onglet Étendu.

    screen_shot_2012-02-15at42515pm
  11. Dans la boîte de dialogue Méthode HTTP, saisissez GET.

  12. Dans le champ En-têtes HTTP, cliquez sur + pour ajouter une nouvelle entrée, puis saisissez Chemin d’accès : {path}.

  13. Si nécessaire, cliquez sur l’onglet Proxy et saisissez les informations du serveur proxy dans l’agent.

  14. Pour enregistrer les modifications, cliquez sur OK.

  15. Pour tester la connexion, cliquez sur le lien Tester la connexion. Un message du journal s’affiche et indique si le test de réplication a réussi. Par exemple :

    screen_shot_2012-02-15at42639pm

Vidage manuel du cache du portlet

Vous pouvez vider manuellement le cache du portlet en accédant à l’adresse URL configurée pour l’agent de réplication. Pour le format de l’adresse URL, voir Vidage du cache. De plus, l’adresse URL doit être étendue avec un paramètre URL Path=<chemin d’accès> pour indiquer les éléments à vider.

Par exemple :

http://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=* vide le cache entier. http://10.0.20.99:10040/wps/PA_CQ5_Portlet/cqbridge/cqpcache?Path=/content/mypage/xyz vide /content/mypage/xyz dans le cache.

Sécurité du portail

Le portail est le mécanisme d’authentification principal. Vous pouvez vous connecter à AEM avec un utilisateur technique, un utilisateur du portail, un groupe et ainsi de suite. Le portlet n’a pas accès au mot de passe de l’utilisateur du portail. Par conséquent, si le portlet ne connaît pas toutes les informations d’identification pour connecter correctement un utilisateur, une solution de connexion unique doit être utilisée. Dans ce cas, le portlet AEM transfère toutes les informations nécessaires à AEM, qui les transfère à son tour au référentiel AEM sous-jacent. Ce comportement est enfichable et peut être personnalisé.

Authentification lors de la publication

Cette section décrit les modes d’authentification disponibles que le portlet peut utiliser pour communiquer avec les instances AEM WCM sous-jacentes.

Par défaut, aucune information de l’utilisateur n’est envoyée à l’instance de publication d’AEM. Le contenu s’affiche toujours en tant qu’utilisateur anonyme. Si des informations spécifiques à l’utilisateur sont fournies par AEM ou si l’utilisateur doit s’authentifier pour la publication, cette option doit être activée.

Accès à la configuration de l’authentification du portlet

Les options de configuration de l’authentification utilisées par le portlet dans des instances AEM WCM sont disponibles dans la console web (configuration OSGi).

Remarque :

Lorsque vous utilisez AEM, plusieurs méthodes permettent de gérer les paramètres de configuration pour les services OSGi (nœuds de la console ou du référentiel).

Pour plus d’informations, voir Configuration d’OSGi.

Pour accéder à la configuration de l’authentification du portlet :

  1. Accès à la console web à l’adresse URL suivante :

    http://localhost:8080/cqportlet/cqbridge/system/console

    Par exemple, dans sa configuration par défaut :

    http://wps-host:10040/wps/PA_CQ5_Portlet/cqbridge/system/console

  2. Connectez-vous à la console web. Les informations d’identification par défaut sont admin/admin.

  3. Dans la console, sélectionnez Configuration.

  4. Dans le menu Configuration, sélectionnez un service particulier à configurer. Les services sont fournis par le portlet dans la structure OSGi.

    Nom du service Description
    Day Portal Director Authenticator Configurer le mode d’authentification utilisé pour les instances AEM WCM. En fonction du mode sélectionné, vous pouvez spécifier un utilisateur technique ou le nom du cookie de connexion unique. De plus, il est possible d’activer l’authentification pour les instances de publication d’AEM WCM.
    Day Portal Director File Cache Configurer les paramètres déterminant la façon dont le portlet met en cache les réponses qu’il reçoit des instances AEM WCM.
    Day Portal Director HTTP Client Service Configurer la façon dont le portlet se connecte aux instances AEM WCM sous-jacentes via HTTP. Vous pouvez, par exemple, spécifier un serveur proxy.
    Day Portal Director Locale Handler Configurer les paramètres régionaux pris en charge par le portlet. Les demandes au niveau des instances AEM WCM dépendent des paramètres régionaux de l’utilisateur. Par exemple, si la langue de l’utilisateur est l’allemand, la demande sera /content/geometrixx/de/...
    Day Portal Director Privilege Manager Indiquer si le portlet doit tester l’onglet Sites web en fonction de l’utilisateur actuellement connecté.
    Day Portal Director Toolbar Renderer Personnaliser le rendu de la barre d’outils du portlet.
  5. Vous pouvez également configurer la console web et le service de journalisation. Par exemple, vous pouvez modifier les informations d’identification de l’administrateur pour la console web en cliquant sur le lien Console de gestion OSGi Apache Felix.

Mode Utilisateur technique

Dans le mode par défaut, toutes les demandes émises par le portlet pour l’instance de création AEM WCM sont authentifiées à l’aide du même utilisateur technique, indépendamment de l’utilisateur actuel du portail. Le mode Utilisateur technique est activé par défaut. Vous activez/désactivez ce mode dans l’écran de configuration approprié dans la console de gestion OSGi :

L’utilisateur technique spécifié doit exister sur l’instance de création AEM WCM et sur l’instance de publication si l’option S’authentifier lors de la publication est activée. Veillez à attribuer à l’utilisateur des autorisations suffisantes pour la tâche de création.

Connexion unique (SSO)

Le portlet prend en charge la connexion unique avec la version commerciale d’AEM. Le service d’authentification peut être configuré de manière à utiliser la connexion unique et transmettre à AEM l’utilisateur actuel du portail au format De base sous forme de cookie appelé « cqpsso ». AEM doit être configuré de manière à utiliser le gestionnaire d’authentification SSO pour le chemin d’accès /. Le nom du cookie doit lui aussi être configuré ici.

Le fichier crx-quickstart/repository/repository.xml du référentiel d’AEM doit être configuré en conséquence :

<LoginModule class="com.day.crx.security.authentication.CRXLoginModule">
  ...
  <param name="trust_credentials_attribute" value="TrustedInfo"/>
  <param name="anonymous_principal" value="anonymous"/>
</LoginModule>

Mode Authentification SSO

Le portlet peut s’authentifier pour AEM WCM à l’aide du schéma de connexion unique (SSO). Dans ce mode, l’utilisateur actuellement connecté au portail est transféré à AEM WCM sous forme de cookie de connexion unique. Si le mode SSO est utilisé, tous les utilisateurs du portail ayant accès au portlet AEM doivent être connus au niveau des instances AEM WCM sous-jacentes, le plus souvent sous forme d’AEM WCM connecté au LDAP ou en ayant créé manuellement les utilisateurs à l’avance. De plus, avant d’activer la connexion unique dans le portlet, l’instance de création AEM WCM sous-jacente (et l’instance de publication si l’option S’authentifier lors de la publication est activée) doit être configurée pour accepter les demandes basées sur l’authentification unique.

Pour configurer le portlet de manière à utiliser le mode d’authentification SSO, exécutez cette procédure (décrite en détail dans les sections suivantes) :

  • Activer le référentiel d’AEM WCM pour accepter les informations d’identification de confiance.
  • Activer l’authentification SSO dans AEM WCM.
  • Activer l’authentification SSO dans le portlet AEM.

Activation du référentiel d’AEM WCM pour accepter les informations d’identification approuvées

Avant de pouvoir activer la connexion unique pour AEM WCM, le référentiel sous-jacent doit être configuré de manière à accepter les informations d’identification approuvées fournies par AEM WCM. À cet effet, configurez le fichier repository.xml d’AEM.

  1. Dans le système de fichiers dans lequel AEM WCM est installé, ouvrez le fichier suivant :

    //crx-quickstart/repository/repository.xml

  2. Dans le fichier XML, cherchez l’entrée de LoginModule et ajoutez trust_credentials_attribute à sa configuration :

    <LoginModule class="com.day.crx.security.authentication.CRXLoginModule">
      ...
      <param name="trust_credentials_attribute" value="TrustedInfo"/>
      <param name="anonymous_principal" value="anonymous"/>
    </LoginModule>
  3. Redémarrez AEM WCM pour que les modifications soient appliquées.

Activation de l’authentification SSO dans AEM WCM

Pour activer la connexion unique dans AEM WCM, accédez à l’entrée de configuration appropriée dans la Console de gestion web Apache Felix (OSGi) d’AEM WCM :

  1. Accédez à la console par le biais de son URI à l’adresse http://<hôte-AEM>:<port>/system/console.

  2. Dans le menu Configuration, sélectionnez Gestionnaire d’authentification SSO. Dans cet exemple, le gestionnaire de connexion unique accepte des demandes de connexion unique de tous les chemins d’accès en fonction du cookie fourni par le portlet AEM. Votre configuration peut varier.

    Chemin d’accès / Active le gestionnaire de connexion unique pour toutes les demandes
    Nom des cookies cqpsso Nom du cookie fourni par le portlet, configuré sur la console OSGi du portlet.
  3. Cliquez sur Enregistrer pour activer la connexion unique. La connexion unique est maintenant le schéma d’authentification principal.

Pour chaque demande que reçoit AEM WCM, l’authentification SSO est tentée en premier. En cas d’échec, un système de secours du schéma d’authentification de base habituel est exécuté. En tant que telles, les connexions normales à AEM WCM sans connexion unique restent possibles.

Activation de l’authentification SSO dans un portlet AEM

Pour que cette instance AEM WCM sous-jacente accepte des requêtes de connexion unique, le mode d’autorisation du portlet doit être défini non plus sur Technique, mais sur Connexion unique.

Pour activer l’authentification SSO dans un portlet AEM :

  1. Accédez à la console par le biais de son URI à l’adresse http://<hôte-AEM>:<port>/system/console.

  2. Dans le menu Configuration, sélectionnez Day Portal Director Authenticator dans la liste des configurations disponibles.

  3. Dans ce mode, sélectionnez Connexion unique. Conservez les valeurs par défaut des autres paramètres.

    chlimage_1
  4. Cliquez sur Enregistrer pour permettre la connexion unique pour le portlet.

    À des fins de test, accédez au portlet avec l’administrateur de votre portail après avoir créé le même utilisateur dans AEM WCM avec des autorisations d’administrateur.

Après avoir exécuté cette procédure, les demandes sont authentifiées à l’aide d’une connexion unique. Un fragment de code type de la communication HTTP révèle la présence des en-têtes ci-dessous, spécifiques à SSO set au portlet :

C-12-#001898 -> [GET /mynet/en/_jcr_content/par/textimage/image.img.png HTTP/1.1 ]
C-12-#001963 -> [cq5:locale: en ]
C-12-#001979 -> [cq5:used-locale: en ]
C-12-#002000 -> [cq5:locales: en,en_US ]
C-12-#002023 -> [cqp:user: wpadmin ]
C-12-#002042 -> [cqp:portal: IBM WebSphere Portal/6.1 ]
C-12-#002080 -> [cqp:windowid: 7_CGAH47L000CE302V2KFNOG0084 ]
C-12-#002124 -> [cqp:windowstate: normal ]
C-12-#002149 -> [cqp:portletmode: view ]
C-12-#002172 -> [User-Agent: Jakarta Commons-HttpClient/3.1 ]
C-12-#002216 -> [Host: 10.0.0.68:4502 ]
C-12-#002238 -> [Cookie: $Version=0; cqpsso=Basic+d3BhZG1pbg%3D%3D ]
C-12-#002289 -> [ ]

Activation de l’authentification par code personnel

Si vous n’utilisez pas les fonctionnalités de modification en ligne par défaut du portlet de contenu AEM, mais que vous souhaitez que la création et l’administration fassent partie du portlet en dehors du portail directement dans l’instance de création AEM, vous devez activer l’authentification par code personnel. Vous devez également modifier la configuration des boutons de gestion.

Pour afficher la page d’administration du site web ou modifier une page du portlet, le portlet de contenu AEM utilise la nouvelle authentification par code personnel. Par défaut, l’authentification par code personnel est désactivée, donc les modifications ci-dessous apportées à la configuration doivent être effectuées dans AEM :

  1. Activez l’authentification approuvée dans AEM en ajoutant les informations approuvées au fichier repository.xml :

    <LoginModule class="com.day.crx.security.authentication.CRXLoginModule">
      ...
      <param name="trust_credentials_attribute" value="TrustedInfo"/>
    </LoginModule>
  2. Dans la console de configuration OSGi, située par défaut à l’adresse http://localhost:4502/system/console/configMgr, sélectionnez Gestionnaire d’authentification par code personnel CQ dans le menu déroulant.

  3. Modifiez le paramètre Chemin d’accès racine de l’adresse URL afin qu’il ne contienne que la valeur unique /.

Autorisations

Certaines fonctions du portlet sont protégées par des autorisations. L’utilisateur actuel doit disposer de cette autorisation pour pouvoir accéder à cette fonction. Les autorisations ci-dessous sont prédéfinies :

  • « toolbar » : il s’agit de l’autorisation générale en affichage/utilisation de la barre d’outils dans le portlet.
  • « prefs » : si l’utilisateur dispose de cette autorisation, il peut afficher/modifier les préférences du portlet.
  • « cq-author:edit » : avec cette autorisation, l’utilisateur peut appeler l’affichage de modification du contenu.
  • « cq-author:preview » : avec cette autorisation, l’utilisateur peut afficher l’aperçu.
  • « cq-author:siteadmin » : avec cette autorisation, l’utilisateur peut ouvrir l’administration du site dans AEM.

La meilleure approche pour gérer les autorisations consiste à utiliser les rôles du portail et d’affecter des rôles à ces droits. Cette opération peut être effectuée par le biais d’une configuration OSGi. La configuration « Day Portal Director Privilege Manager » peut être configurée avec un ensemble de rôles pour chaque autorisation. Si l’utilisateur possède l’un des rôles, il dispose de l’autorisation correspondante.

De plus, il est possible de définir cet accès en fonction des rôles pour chaque instance de portlet. La boîte de dialogue Préférences du portlet contient un champ de saisie pour chacune des autorisations ci-dessus. Pour chaque autorisation, il est possible de configurer une liste des rôles de portlet, séparés par des virgules. Si une valeur est configurée, elle remplace la configuration globale du service « Day Portal Director Privilege Manager », et il peut être nécessaire d’ajouter les mêmes rôles que dans ce paramètre global, car les rôles ne sont pas fusionnés. Si aucune valeur n’est spécifiée, la configuration globale est utilisée.

Personnalisation de l’application du portlet AEM

L’application du portlet AEM indiquée lance un conteneur OSGi dans l’application web comme le fait AEM. Cette architecture permet d’utiliser tous les avantages d’OSGi :

  • Facilité de mise à jour et d’extension
  • Fourniture de mises à jour dynamiques dans le portlet sans intervention du serveur du portail
  • Facilité de personnalisation du portlet

Boutons de la barre d’outils

La barre d’outils et ses boutons peuvent être configurés et personnalisés. Vous pouvez ajouter vos propres boutons à la barre d’outils ou définir les boutons affichés dans les différents modes. Chaque bouton correspond à un service OSGi configurable par le biais d’une configuration OSGi.

La console web OSGi répertorie toutes les configurations de bouton sur l’onglet Configuration. Pour chaque bouton, vous pouvez choisir le mode dans lequel ce bouton s’affiche. Cela permet de désactiver un bouton en supprimant tous les modes, par exemple.

Par défaut, le portlet de contenu AEM utilise la fonctionnalité de modification en ligne. Cependant, si vous préférez passer à l’instance de création AEM pour la modification, activez Bouton SiteAdmin et Bouton ContentFinder, mais désactivez Bouton Modifier. Dans ce cas, veillez à configurer correctement l’authentification par code personnel dans AEM.

La disposition de la barre d’outils du portlet peut être personnalisée en installant un lot par le biais de la console web Felix du portlet, qui contient du code CSS/HTML personnalisé à un emplacement prédéfini.

Structure des lots

Voici un exemple de structure de lots :

$ jar tvf target/toolbarlayout-0.0.1-SNAPSHOT.jar | awk '{print $8}'
META-INF/
META-INF/MANIFEST.MF
/com/day/cq/portlet/toolbar/layout/
/com/day/cq/portlet/toolbar/layout/author.gif
/com/day/cq/portlet/toolbar/layout/back.gif
/com/day/cq/portlet/toolbar/layout/button.html
/com/day/cq/portlet/toolbar/layout/edit.gif
/com/day/cq/portlet/toolbar/layout/manage.html
/com/day/cq/portlet/toolbar/layout/publish.html
/com/day/cq/portlet/toolbar/layout/refresh.gif
/com/day/cq/portlet/toolbar/layout/siteadmin.gif
/com/day/cq/portlet/toolbar/layout/toolbar.css

Le dossier META-INF contient le fichier MANIFEST.MF nécessaire à OSGi afin de l’identifier comme lot. Il se présente de la manière suivante :

Manifest-Version: 1.0
Built-By: djaeggi
Created-By: Apache Maven Bundle Plugin
Import-Package: com.day.cq.portlet.toolbar.layout
Bnd-LastModified: 1234178347159
Export-Package: com.day.cq.portlet.toolbar.layout
Bundle-Version: 0.0.1.SNAPSHOT
Bundle-Name: Company CQ5 Portal Director Portlet Toolbar Layout
Bundle-Description: This bundle provides a custom layout for the CQ5 P
 ortal Director Portlet Toolbar.
Build-Jdk: 1.5.0_16
Bundle-ManifestVersion: 2
Bundle-SymbolicName: com.day.cq.portlet.company.toolbarlayout
Tool: Bnd-0.0.255

La présence du répertoire HTML/CSS/images dans le dossier /com/day/cq/portlet/toolbar/layout est déterminée par le portlet et ne peut pas être modifiée. De même, les en-têtes Import-Package et Export-Package du fichier MANIFEST.MF doivent être appelés eux aussi dans le dossier /com/day/cq/portlet/toolbar/layout. Bundle-SymbolicName doit être un nom de module complet unique.

Vous pouvez le créer à l’aide d’un outil comme maven ou manuellement, comme un fichier JAR avec l’en-tête approprié défini, comme indiqué dans cette section.

Affichages de la barre d’outils du portlet

La barre d’outils du portlet comporte deux états d’affichage. Chaque affichage et les boutons associés peuvent être personnalisés avec un fichier HTML correspondant.

Affichage Publication

L’affichage Publication ne comporte qu’un seul bouton, qui permet d’afficher/de masquer la barre d’outils dans l’affichage Gestion. L’affichage Publication est représenté par le fichier publish.html dans le lot précédent. Dans le code HTML, vous pouvez utiliser les espaces réservés ci-dessous, que le portlet remplace par le contenu approprié lors du rendu :

Espaces réservés de l’affichage Publication

Espace réservé  String Description 
{buttonManage} Un espace réservé est remplacé par le bouton Gérer, qui permet d’afficher/de masquer l’état du portlet dans l’état de la gestion.

Affichage Gestion

L’affichage Gestion comporte quatre boutons : Modifier, onglet Sites web, Actualiser et Précédent. L’affichage Gestion est représenté par le fichier manage.html dans le lot précédent. Dans le code HTML, vous pouvez utiliser les espaces réservés ci-dessous, que le portlet remplace par le contenu approprié lors du rendu :

Espaces réservés de l’affichage Gestion

Chaîne de l’espace réservé Description
{buttonEdit} L’espace réservé est remplacé par le bouton Modifier, qui affiche une nouvelle fenêtre contenant la page active en mode d’édition dans AEM.
{buttonWebsites tab} Espace réservé, remplacé par un bouton qui affiche l’onglet Sites web d’AEM WCM.
{buttonRefresh} Actualise l’affichage actif.
{buttonBack} Remet le portlet en mode de publication.

Boutons

Les boutons, indépendamment de l’affichage dans lequel ils figurent, utilisent le même code HTML commun, défini dans le fichier button.html.

Dans le code HTML, vous pouvez utiliser les espaces réservés ci-dessous, que le portlet remplace par le contenu approprié lors du rendu :

Boutons des affichages Gestion et Publication

Chaîne de l’espace réservé  Description 
{name} Nom du bouton, par exemple, Créer, Précédent, Actualiser, etc.
{id} ID CSS du bouton.
{url} Adresse URL de la cible du bouton.
{text} Étiquette du bouton.
{onclick} Fonction onclick JavaScript (contient {url}).

Exemple de fichier button.html :

<div class="cqp_button">

 <a href="#" onclick="{onclick}">

 <img src="/wps/PA_CQ5_Portlet/cqbridge/static/{id}.gif" alt="{text}" 
title="{text}"/>

 </a>
</div>

Installation d’une mise en page personnalisée

Pour installer une mise en page personnalisée, accédez à la section Lots de la console web OSGI du portlet et chargez le lot.

Modules

Si vous devez charger ou créer des modules pour votre installation, voir la section Gestionnaire de modules dans la documentation d’AEM pour obtenir des instructions détaillées.

Gestion des liens

Tous les liens sont réécrits afin de fonctionner dans le contexte du portail. Par défaut, ce sont les liens avec des paramètres de rendu qui sont utilisés. Le service Portal Director HTML Rewriter peut être configuré de manière à utiliser des liens d’action à la place.

Vous pouvez également définir d’autres paramètres de demande qui peuvent faire l’objet d’une requête pour le chemin d’accès au contenu à afficher. Cette fonction est utile, par exemple, s’il y a un lien de l’extérieur vers du contenu spécifique.

De plus, le service Portal Director HTML Rewriter peut être configuré avec une liste d’exclusions définies par des expressions régulières pour la réécriture des liens. Par exemple, s’il y a des liens relatifs vers des systèmes externes, vous devez les ajouter à cette liste d’exclusions.

Localisation

Le portlet de contenu AEM possède une fonctionnalité de localisation intégrée, qui permet de s’assurer que le contenu d’AEM est dans la langue appropriée.

Cette opération s’effectue en deux étapes :

  1. Le service Portal Directory Locale Detector détecte les paramètres régionaux du portail en extrayant le paramètre des paramètres régionaux du portail. Ce service doit être configuré avec la liste des langues disponibles dans AEM.
  2. Le service Portal Director Locale Handler gère la localisation de la demande actuelle. Il utilise le chemin d’accès au contenu demandé, par exemple, /content/geometrixx/en/company.html et conformément à la configuration, il remplace les paramètres régionaux en par les paramètres régionaux de l’utilisateur.

Le service Portal Director Locale Handler peut être configuré avec les chemins d’accès pour vérifier les informations des paramètres régionaux, qui incluent généralement tout ce qui se trouve sous /content et avec la position des informations des paramètres régionaux dans le chemin d’accès. Par défaut, le gestionnaire des paramètres régionaux suit la recommandation de structurer les sites multilingues dans AEM.

Si votre site ne comporte pas de règle absolue pour gérer les informations des paramètres régionaux avec le chemin d’accès, il est possible de remplacer le gestionnaire des paramètres régionaux par votre propre mise en œuvre.

Services OSGi facultatifs

Des services OSGi facultatifs peuvent être mis en œuvre pour personnaliser différentes parties du portlet. Chaque service correspond à une interface Java. Cette interface peut être mise en œuvre et déployée par le biais d’un lot dans le portlet.

RequestTracker Le suivi des demandes reçoit une notification chaque fois que le contenu s’affiche dans le portlet. Cela vous permet de conserver une trace des appels du portlet.
InvocationContextListener Programme d’écoute appelé au début et à la fin de chaque demande adressée au portlet. Ce programme d’écoute peut être utilisé pour modifier ou ajouter des informations pour la demande actuelle.
ErrorHandler Gestionnaire d’erreur personnalisé pour les erreurs lors de la phase de rendu.
HttpProcessor Ce service peut être utilisé pour ajouter des informations pour chaque appel HTTP transmis à AEM.
PortletAction Ajoutez votre propre action au portlet : cette action peut être appelée par le biais d’un lien d’action de portlet.
PortletDecoratorService Ce service peut être utilisé pour décorer le contenu du portlet.
ResourceProvider Ajoutez votre propre fournisseur de ressource afin de fournir au client une ressource par le biais d’un lien de ressource de portlet.
TextMapper Permet de post-traiter des fichiers HTML, CSS et JavaScript.
ToolbarButton Ajoutez votre propre bouton à la barre d’outils.
UrlMapper Ajoutez un service afin d’appliquer une correspondancepersonnalisée ou une réécriture personnalisée des adresses URL.
UserInfoProvider Ajoutez vos propres informations sur l’utilisateur. Ce service peut être utilisé pour obtenir des informations du portail dans le portlet.

Remplacement des services par défaut

Les services ci-dessous possèdent une mise en œuvre par défaut dans le portlet de contenu (grâce à une interface Java correspondante). Pour la personnalisation, un lot contenant la nouvelle mise en œuvre du service doit être déployé dans l’application du portlet.

En mettant en œuvre ce service, veillez à définir la propriété service.ranking du service sur une valeur positive. La mise en œuvre par défaut utilise le classement 0, et le portlet utilise le service avec le classement le plus élevé.

Nom Description Comportement par défaut
Authentificateur Fournit les informations d’authentification à AEM. Utilise un utilisateur technique configurable pour la création et la publication. Ou le protocole SSO peut être utilisé.
HTMLRewriter Réécrit les liens, les images, etc. Réécrit les liens AEM en liens de portail ; peut être étendu par un UrlMapper et un TextMapper
HttpClientService Gère toutes les connexions HTTP Mise en œuvre standard
LocaleHandler Gère les informations de paramètres régionaux. Réécrit un lien dans le contenu en prenant les paramètres régionaux en compte.
LocaleDetector Détecte les paramètres régionaux de l’utilisateur. Utilise les paramètres régionaux fournis par le portail.
PrivilegeManager Vérifie les droits d’utilisateur Vérifie l’accès à instance de création si l’utilisateur a l’autorisation de modifier le contenu
ToolbarRenderer Effectue le rendu de la barre d’outils. Ajoute une fonctionnalité à la barre d’outils

Événements de portlet

L’API de portlet (JSR-286) spécifie les événements de portlet. Le portlet de contenu AEM comporte une passerelle intégrée, répartissant les événements pour le portlet AEM sous forme d’événements OSGi : la gestion des événements de portlet devient enfichable.

Si vous voulez gérer des événements spécifiques, déclarez-les comme événements de réception dans le descripteur de déploiement (ou configurez-le par le biais de votre serveur de portail) et mettez un service OSGi en œuvre en déclarant l’interface EventHandler (voir la spécification OSGi EventAdmin).

Chaque fois qu’un événement de portlet se produit, un événement OSGi spécifique est envoyé pour appeler le gestionnaire. Le gestionnaire extrait toutes les informations contextuelles et peut mettre à jour le statut du portlet en conséquence ou envoyer de nouveaux événements. Essentiellement, dans la méthode handle, toutes les fonctionnalités de la phase d’événement de portlet peuvent être utilisées.

Utilisation d’AEM en tant que portail

Utilisez le composant Portlet pour ajouter des fenêtres de portlet à des pages AEM. Les bibliothèques partagées que vous installez sur le serveur d’applications permettent au composant Portlet de détecter les applications de portlet déployées.

Pour utiliser AEM comme portail, procédez comme suit :

  1. Installez le composant Portlet et les bibliothèques partagées.
  2. Ajoutez le composant Portlet au Sidekick.
  3. Configurez et déployez l’application web qui contient les portlets à afficher dans le composant Portail.
  4. Ajoutez le composant Portlet à une page, puis sélectionnez le portlet à afficher.

Remarque :

Vous ne pouvez utiliser le composant Portlet que lorsque AEM est déployé comme application web. (Voir Installation d’AEM avec un serveur d’applications.)

Installation du composant Portlet

Le fichier JAR d’AEM Quickstart contient les fichiers du composant Portlet. Pour obtenir les fichiers (cq-portlet-components.zip), vous pouvez exécuter Quickstart ou extrayez le contenu. 

  1. Exécutez ou extrayez le contenu du fichier JAR de Quickstart et recherchez le fichier cq-portlet-components.zip en conséquence :
    • Exécutez Quickstart : crx-quickstart/opt/portal
    • Extrayez le contenu de Quickstart : static/opt/portal
  2. Ouvrez le Gestionnaire de modules de l’instance de création CQ5 déployée sur le serveur d’applications. (http://appserverhost:port/cq5author/crx/packmgr)
  3. Utilisez le Gestionnaire de modules pour charger et installer le module cq-portlets-components.zip.

    Le module installe cq-portlet-director-sharedlibs-x.x.x.jar dans le dossier /libs/portal/director dans le référentiel.

  4. Copiez cq-portlet-director-sharedlibs-x.x.x.jar sur votre disque dur. Vous pouvez utiliser n’importe quel moyen pour obtenir le fichier, par exemple, FileVault ou un client WebDAV.
  5. Déplacez le fichier cq-portlet-director-sharedlibs.x.x.x.jar vers le dossier de la bibliothèque partagée de votre serveur d’applications afin que les classes soient disponibles pour les applications de portlet déployées.

 

Ajout du composant Portlet au Sidekick

Ajoutez le composant Portlet au système de paragraphes afin qu’il soit disponible pour les auteurs. 

  1. Dans le Sidekick, cliquez sur l’icône en forme de règle pour accéder au mode Conception.
  2. À côté du titre Conception du par au-dessus du premier paragraphe, cliquez sur Modifier.
  3. Dans la catégorie de composants Général, cochez la case en regard du composant Portlet et cliquez sur OK.
chlimage_1

Configuration et déploiement des applications Portlet

Déployez les portlets dans le conteneur web du serveur d’applications afin qu’ils soient disponibles dans le composant Portail. Avant de déployer l’application de portlet, vous devez configurer l’application afin qu’elle charge le servlet du conteneur de portail d’AEM. Cette configuration permet au composant Portlet d’accéder aux portlets.

  1. Extrayez le contenu du fichier WAR de l’application du portlet.

    Conseil : la commande jar xf nomapp.war extrait les fichiers.

  2. Ouvrez le fichier web.xml dans un éditeur de texte.

  3. Ajoutez la configuration de servlet ci-dessous dans l’élément web-app :

    <servlet>
            <servlet-name>slingportal</servlet-name>
            <servlet-class>org.apache.sling.portal.container.api.ContainerServlet</servlet-class>
            <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
            <servlet-name>slingportal</servlet-name>
            <url-pattern>/SlingPortletInvoker</url-pattern>
    </servlet-mapping>
  4. Enregistrez le fichier web.xml et recompressez le fichier WAR.

    Conseil : la commande jar cvf nomapp.war * ajoute le contenu du répertoire actif au fichier nomapp.war.

  5. Déployez l’application de portlet sur le serveur d’applications. Pour plus d’informations, reportez-vous à la documentation de votre serveur d’applications.

Ajout de portlets à votre page AEM

Utilisez le composant Portail pour ajouter une fenêtre du portlet à votre page web. Spécifiez le portlet à afficher à l’aide des propriétés du composant.

  1. Dans la page web, faites glisser le composant Portlet dans le groupe Général du Sidekick dans la page.

    Remarque :

    Une fois que vous avez fait glisser le composant dans la page, rechargez la page pour vous assurer de son bon fonctionnement.

  2. Double-cliquez sur le composant pour ouvrir les propriétés du portlet.

  3. Dans le menu déroulant Entité du portlet, sélectionnez le portlet dans la liste.

  4. Cochez ou désélectionnez la case Masquer la barre de titre selon si vous souhaitez afficher la barre de titre du portlet.

  5. Dans le champ Fenêtre du portlet, saisissez un ID de fenêtre du portlet unique, si vous le souhaitez.

    Remarque :

    Si vous envisagez d’utiliser plusieurs fois le même portlet dans la même page, attribuez à chaque portlet un ID de fenêtre différent.

  6. Cliquez sur OK. Le portlet s’affiche dans la page AEM.

    chlimage_1

Installation, configuration et utilisation d’AEM dans un portlet

Pour accéder au contenu fourni par AEM WCM, le serveur du portail peut disposer d’AEM Portal Director Portlet. À cet effet, installez, configurez et ajoutez le portlet à la page du portail en suivant la procédure décrite dans cette section.

Par défaut, le portlet se connecte à l’instance de publication sur localhost 4503 et l’instance de création sur locahost 4502. Ces valeurs peuvent être modifiées lors du déploiement du portlet. Portal Director est disponible sous forme de contenu dans le référentiel, sous /libs/portal/directory. Avant de l’utiliser, vous devez télécharger le fichier WAR de l’application.

Téléchargement du fichier WAR

  1. À l’aide de WebDAV ou CRXDE Lite, accédez à /libs/portal/director.

  2. Téléchargez cq-portlet-webapp.war.

Remarque :

Ces procédures utilisent le portail WebSphere à titre d’exemple même si elles sont aussi génériques que possible. N’oubliez pas que les procédures varient pour les autres portails web. Même si la procédure est identique, pour l’essentiel, pour tous les portails web, vous devez adapter les étapes à votre portail web spécifique.

Installation du portlet

Pour installer le portlet :

  1. Connectez-vous au portail avec des autorisations d’administrateur.

  2. Accédez à la partie Gestion du portlet de votre portail web.

  3. Cliquez sur Installer et accédez à l’application du portlet AEM (cq-portlet-webapp.war) téléchargée et saisissez d’autres informations importantes sur le portlet.

    Pour obtenir des informations essentielles sur le portlet, vous pouvez accepter les valeurs par défaut ou modifier les valeurs. Si vous acceptez les valeurs par défaut, le portlet est disponible à l’adresse suivante : http://<hôte-wps>:<port>/wps/PA_CQ5_Portlet. La console d’administration OSGi fournie par le portlet est disponible à l’emplacement http://<hôte-wps->:<port>/wps/ PA_CQ5_Portlet/cqbridge/system/console (la paire nom d’utilisateur/mot de passe est admin/admin).

  4. Assurez-vous que l’application de portlet démarre automatiquement en sélectionnant cette option ou en cochant la case, puis enregistrez vos modifications. Un message indiquant que l’installation a été effectuée correctement s’affiche.

Configuration du portlet

Une fois que vous avez installé le portlet, vous devez le configurer afin qu’il connaisse les adresses URL des instances AEM sous-jacentes (création et publication). Vous pouvez également configurer d’autres options.

Pour configurer le portlet :

  1. Dans la fenêtre d’administration du portail du serveur d’applications, accédez à la gestion du portlet, qui répertorie tous les portlets, et sélectionnez le portlet AEM Portal Director.

  2. Configurez le portlet, au besoin. Par exemple, vous pouvez avoir besoin de modifier l’adresse URL pour les instances de création et de publication et l’adresse URL du chemin d’accès de début. Les configurations par défaut sont décrites dans la section Préférences de portlet.

    Remarque :

    Si le portlet est configuré de manière à se connecter aux instances de création et de publication d’AEM exécutées sur un chemin d’accès contextuel autre que /, vous devez forcer CQUrlInfo dans la configuration HTML du Gestionnaire de bibliothèques de ces instances AEM (via Felix Webconsole, par exemple) ou la modification ne fonctionnera pas et la boîte de dialogue Préférence ne s’affichera pas.

  3. Enregistrez les modifications apportées à la configuration sur le serveur d’applications.

  4. Accédez à la console d’administration OSGi pour le portlet. L’emplacement par défaut est http://<hôte-wps>:<port>/wps/PA_CQ5_Portlet/cqbridge/system/console/configMgr. La paire nom d’utilisateur/mot de passe est par défaut admin/admin.

  5. Sélectionnez la configuration Day Portal Director CQ Server Configuration et modifiez les valeurs suivantes :

    • Adresse URL de base de création : adresse URL de base de l’instance de création AEM.
    • Adresse URL de base de publication : adresse URL de base de l’instance de publication AEM.
    • Création utilisée comme publication : l’instance de création est-elle utilisée comme instance de publication
      (pour le développement) ?
    chlimage_1
  6. Cliquez sur Enregistrer. Vous pouvez maintenant ajouter le portlet aux pages du portail et utiliser le portail.

URL de contenu

Lorsque le contenu est demandé à partir d’AEM, le portlet utilise le mode d’affichage actuel (publication ou création) et le chemin d’accès actuel pour assembler une adresse URL complète. Avec les valeurs par défaut, la première adresse URL est http://localhost:4503/content/geometrixx/en.portlet.html. La valeur de la propriété htmlSelector est ajoutée automatiquement à l’adresse URL avant l’extension.

Si le portlet passe en mode Aide et que appendHelpViewModeAsSelector est sélectionné, le sélecteur help est lui aussi ajouté, par exemple, http://localhost:4503/content/geometrixx/en.portlet.html.help. Si la fenêtre du portlet est agrandie et que appendMaxWindowStateAsSelector est sélectionné, le sélecteur est lui aussi ajouté, par exemple, http://localhost:4503/content/geometrixx/en.portlet.max.help.

Les sélecteurs peuvent être évalués dans AEM, et un autre modèle peut être utilisé pour différents sélecteurs.

Utilisation d’une correspondance d’adresses URL de contenu dans AEM

Généralement, le chemin d’accès de début pointe directement vers le contenu dans AEM. Cependant, si vous voulez conserver les chemins d’accès de début dans AEM plutôt que dans les préférences de portlet, vous pouvez faire pointer le chemin d’accès de début vers une correspondance de contenu dans AEM, comme /var/portlets. Dans ce cas, un script exécuté dans AEM peut utiliser les informations envoyées à partir du portlet pour déterminer l’adresse URL qui est l’adresse URL de début. Il doit exécuter une redirection vers l’adresse URL appropriée.

Ajout du portlet à la page Portail

Pour ajouter le portlet à la page Portal :

  1. Assurez-vous que vous êtes dans la fenêtre administration du serveur d’applications et accédez à l’emplacement de gestion des pages. (Par exemple, dans WebSphere 6,1, cliquez sur Gérer les pages.)

  2. Sélectionnez le nom dans le portlet, puis sélectionnez une page existante ou créez-en une.

  3. Modifiez la mise en page de la page.

  4. Sélectionnez le portlet et ajoutez-le à un conteneur. 

  5. Enregistrez les modifications.

Utilisation du portlet

Pour accéder à la page que vous avez ajoutée au portlet :

  1. Dans le menu de personnalisation du portlet, configurez le portlet comme vous l’avez configuré dans le portail.

  2. Ouvrez la configuration (le portlet affiche l’adresse URL de début de la publication définie dans sa configuration) et apportez-y des modifications, au besoin, puis enregistrez-les.

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne