Configuration de la navigation entre les portlets

Use URIs to identify, access, and display HCL Connections content and profiles in a portlet.

Avant de commencer

Utilisez des URI pour identifier, accéder et afficher le contenu et les profils HCL Connections dans un portlet. HCL Digital Experience Portal uses Piece of Content (POC) URIs to identify and address specific pieces of content in HCL Connections independent of the page that is used to display the content. Avec un URI POC, vous pouvez identifier précisément quel contenu afficher sans avoir besoin de savoir où il se trouve dans votre serveur WebSphere Portal au moment où le lien est généré. Par exemple, lorsqu'un utilisateur clique sur un lien dans un portlet récapitulatif de Blogues, l'URI POC identifie le contenu du blogue. Si vous cliquez sur un lien qui utilise un URI POC, l'entrée de blogue s'affiche dans le portlet de détails Blogues, sur la page appropriée. L'évolution vers des URI POC fournit une plus grande précision pour l'identification, l'extraction et l'affichage du contenu. L'URI indique l'identité du contenu, et non l'emplacement de la vue du document. L'emplacement de la vue du document s'appelle l'URL Portal, ou simplement URL, et les informations contenues dans cette URL comprennent l'état de navigation, ou simplement état. Lorsque vous utilisez un URI POC, vous n'avez pas besoin de connaître la page de Portal dans laquelle l'élément de contenu s'affiche. Vous devez simplement connaître certaines données d'identification de l'élément de contenu pour créer l'URL. La page d'HCL Portal dans laquelle doit s'afficher le contenu est obtenue lorsque l'utilisateur clique sur un lien avec un format d'URI POC.

Le programme de résolution POC gère la navigation de la manière suivante :
  • Si l'élément de contenu est un contenu de communauté :
    • Il cherche dans la page de communauté un portlet de détails pour afficher le contenu.
    • S'il ne détecte aucune page de communauté statique, il cherche une page autonome.
    • S'il ne trouve aucune page autonome, il navigue jusqu'à une page d'erreur.
  • Si l'élément de contenu appartient à une page autonome plutôt qu'à une communauté :
    • Il cherche dans la page autonome un portlet de détails pour afficher le contenu.
    • S'il ne trouve aucune page autonome, il navigue jusqu'à une page d'erreur.
Trois nouveaux paramètres facultatifs sont pris en charge dans l'URL POC pour indiquer où rechercher et naviguer à l'aide du lien POC. Ces paramètres sont les suivants :
page
Contient la valeur de la page cible exacte sur laquelle l'URL POC recherche le portlet approprié pour afficher le contenu.
rootpage
Contient la valeur de la page racine sur laquelle la fonction POC commence sa recherche avant de traverser les pages enfant afin de trouver le portlet approprié pour afficher le contenu.
errorpage
Contient la valeur de la page d'erreur vers laquelle le contenu POC est dirigé si le portlet approprié est introuvable sur page/rootpage.
Remarque : Le paramètre rootpage ou le paramètre page peut être défini dans l'URL en même temps que errorpage. Par exemple: http://<portal_server>/wps/mypoc/!ut/p/digest!LLOg7KmZaRIqf_q-eMb7Sw/connections/forums/atom/topic?type=topic&atomUriQuery=%3FtopicUuid%3D22b41c17-96a4-4ecf-ac35-dfef42994c18&actionType=TOPIC_READ&service=Forums&forumUuid=cbfcd6f4-e94a-4c06-8aeb-8832edecd2aa&rootpage=rootPage&errorpage=errorPage Les valeurs suivantes sont prises en charge pour les paramètres page, rootpage et errorpage dans l'URL :
  • Nom unique de la page.
  • ID objet sérialisé de la page.
  • La valeur "current" peut être définie pour les paramètres rootpage et page. POC recherchera le portlet approprié sur la page en cours.
  • Il s'agit de paramètres non obligatoires. Vous pouvez ne pas indiquer de valeur pour ces paramètres afin qu'ils ne soient pas pris en compte.
  • Le nom unique des libellés de portail peut être défini en tant que valeur du paramètre rootpage.
Le tableau ci-après décrit les combinaisons de paramètres possibles et le comportement attendu.
Tableau 1. Combinaisons de paramètres pour l'URL POC et comportement correspondant

Combinaisons du paramètre page comportement correspondant
Paramètres page, rootpage ou errorpage non définis Aucun changement de comportement.
Seul le paramètre errorpage est défini Accès à la page d'erreur spécifiée.
Seul le paramètre page est défini Accès à la page si un portlet avec une préférence correspondante est trouvé. Sinon, retour au flux normal.
Seul le paramètre rootpage est défini Accès à la première page correspondante dans la hiérarchie de la page racine si un portlet avec la préférence correspondante est trouvé. Sinon, retour au flux normal.
Les paramètres page et errorpage sont définis Accès à la page si un portlet avec la préférence correspondante est trouvé. Sinon, accès à la page d'erreur.
Les paramètres rootpage et errorpage sont définis Accès à la première page correspondante dans la hiérarchie de la page racine si un portlet avec la préférence correspondante est trouvé. Sinon, accès à la page d'erreur.
Le paramètre page, rootpage ou errorpage est défini Accès à la page si un portlet avec une préférence correspondante est trouvé. Sinon, accès à la page d'erreur. La spécification d'une page racine n'affecte pas le comportement.
Une valeur incorrecte est spécifiée pour un paramètre page Un flux d'erreur logique est généré. Par exemple, si un nom de page racine n'existe pas et qu'une page d'erreur est produite, l'utilisateur est dirigé vers la page d'erreur spécifiée. Sinon, retour au flux normal.

Pourquoi et quand exécuter cette tâche

La procédure suivante est un exemple de connexion possible des portlets dans une application. Vous pouvez l'utiliser pour connecter n'importe quel portlet HCL Connections dans une application.

Procédure

  1. Pour configurer la navigation vers les pages de la communauté, vérifiez que vous avez défini les propriétés appropriées lors de la définition de ses pages, comme indiqué à la rubrique Mappage d'une page de communauté vers une communauté.
  2. Pour configurer la navigation dans du contenu qui n'est pas dans une communauté, ou pour lequel il n'existe pas de page de communauté, vérifiez que vous avez créé des pages par défaut pour chaque service, comme indiqué à la rubrique Configuration des portlets sur une page.

Que faire ensuite

Vous pouvez configurer et personnaliser certains aspects liés à la navigation en modifiant le fournisseur d'environnement de ressources. Pour plus d'informations, voir Configuration d'un fournisseur d'environnement de ressources pour POC.

  • Les ID de portlet
  • Le nom des pages autonomes
  • La page affichée par défaut lorsqu'une page cible n'est pas disponible