Exemple d'URL conviviale pour contenu Web

Cet exemple illustre la façon dont les adresses URL conviviales pour le contenu Web fonctionnent avec plusieurs afficheurs de contenu Web sur une page de portail unique. The example describes the portal page structure referenced by the friendly URLs and explains the underlying structure of the content in an HCL Web Content Manager site framework.

L'exemple décrit également la configuration des afficheurs de contenu Web. A partir du fichier Readme concernant le groupe de correctifs CF03, l'exemple explique également comment utiliser la fonction afin de valider des URL conviviales pour le contenu Web. Cet exemple part de l'hypothèse qu'HCL est configuré pour prendre en charge des URL conviviales pour le contenu Web et les valider.

Eléments de l'exemple

Cet exemple se compose des éléments suivants :

Hiérarchie de la page de portail

La hiérarchie des pages de portail dans cet exemple est la suivante :

Content Root
     > Home
          > Human Resources
     > Missing Content

Remarque : La page Missing Content s'applique uniquement au fichier Readme concernant le groupe de correctifs combinés CF03.

La page Home porte le nom d'URL conviviale home et la page Human Resources porte le nom d'URL conviviale hr. Vous pouvez accéder directement à ces pages à l'aide des URL conviviales suivantes :

http://www.example.com:10039/wps/portal/home
http://www.example.com:10039/wps/portal/home/hr

Les paramètres de page ci-dessous s'appliquent aux pages suivantes dans la hiérarchie de page de portail :

La page Missing Content porte le nom unique missing.content et n'apparaît pas dans la navigation lorsque le paramètre de page com.ibm.portal.Hidden a pour valeur true.
La page Content Root est associée à un paramètre de page friendly.pathinfo.validation.errorURI dont la valeur est nm:oid:missing.content.
La page Human Resources est associée à un paramètre de page friendly.pathinfo.validation.errorContentPath dont la valeur est /Web Content/Home/Human Resources/HR Default.

Structure de site Web Content Manager

La structure de site Web Content Manager ressemble à la hiérarchie des pages de portail :

Web Content (Web Content Library)
     > Home (site area)
          > Human Resources (site area)
               > HR Welcome (content item)
               > Health (site area)
                    > Workplace Safety (content item)
                    > Personal Wellness (content item)
               > HR Default (content item)
     > Missing Content (site area)
          > Content Not Found (content item)
     > HR Menu (menu component)

Remarque : Les pages HR Default, Missing Content et Content Not Found s'appliquent uniquement au fichier Readme concernant le groupe de correctifs combinés 03 (CF03).

Les objets de contenu de la zone de site Home peuvent être référencés par les chemins de contenu suivants :

Web Content/home/human resources/hr welcome
Web Content/home/human resources/health/workplace safety
Web Content/home/human resources/health/personal wellness
Web Content/home/human resources/hr default

La zone de site Missing Content stocke un objet de contenu par défaut qui s'affiche par défaut sur la page correspondante.

Le composant de menu HR Menu est défini pour l'affichage du contenu à partir de la zone de site human resources et de la zone de site health.

Association de contenu

La page de portail Human Resources contient l'association de contenu par défaut à la zone de site Web Content/home/human resources.

The portal page Missing Content has the default content association to the Web Content/missing content site area.

Afficheurs de contenu Web

La page Human Resources contient deux instances de l'afficheur de contenu Web, Web Content Viewer A et Web Content Viewer B.

L'afficheur Web Content Viewer A affiche le composant de menu HR Menu et est configuré en vue de la diffusion de liens vers cette page de portail.
L'afficheur Web Content Viewer B hérite du contenu à afficher à partir de l'association de contenu définie pour la page Human Resources. L'afficheur est configuré pour recevoir des liens à partir d'autres portlets et de lui-même.

La page Missing Content contient une instance de l'afficheur de contenu Web. L'afficheur hérite du contenu à afficher à partir de l'association de contenu définie pour la page Missing Content. L'afficheur est configuré pour recevoir des liens à partir d'autres portlets et de lui-même.

Parcours du contenu de l'exemple

Si la page de portail et la structure de site du contenu Web sont définies, le parcours du contenu permet de comprendre comment les différents éléments fonctionnent les uns avec les autres :

Accédez à la page Human Resources pour la première fois.
- L'adresse URL qui apparaît dans la barre d'adresse du navigateur est http://www.example.com:10039/wps/portal/home/hr/!ut/p/b1/...
- L'adresse URL reflète les noms d'adresse URL conviviale des pages de portail Home et Human Resources.
- L'afficheur Web Content Viewer A affiche le composant de menu ainsi que les liens vers les objets de contenu HR Welcome, Workplace Safety et Personal Wellness.
- L'afficheur Web Content Viewer B affiche l'objet de contenu par défaut HR Welcome à partir de la zone de site Human Resources, conformément à l'association de contenu définie sur la page de portail.
  Remarque : Lorsque la page de portail s'affiche pour la première fois, le chemin de l'objet de contenu par défaut n'est pas inclus dans l'URL conviviale.
Cliquez sur Workplace Safety dans la liste des objets de contenu.
- L'adresse URL qui apparaît dans la barre d'adresse du navigateur est http://www.example.com:10039/wps/portal/home/hr/health/workplace%20safety/!ut/p/b1/...
- L'afficheur Web Content Viewer B présente l'objet de contenu Workplace Safety.
- L'adresse URL est modifiée de façon à intégrer le chemin vers l'objet de contenu (health/workplace%20safety).
Cliquez sur HR Welcome dans la liste des objets de contenu.
- L'adresse URL qui apparaît dans la barre d'adresse du navigateur est http://www.example.com:10039/wps/portal/home/hr/hr%20welcome/!ut/p/b1/...
- L'afficheur Web Content Viewer B affiche l'objet de contenu HR Welcome à nouveau, et génère le même résultat que lorsque la page de portail a été affichée pour la première fois.
- Etant donné que l'afficheur Web Content Viewer A diffuse le lien vers l'objet de contenu, l'adresse URL qui est affichée dans le navigateur est mise à jour pour référencer le chemin d'accès à l'objet de contenu (hr%20welcome).

Références d'objet de contenu avec des adresses URL conviviales pour le contenu Web

L'adresse URL affichée dans le navigateur Web peut parfois inclure le chemin d'accès à l'objet de contenu lorsque vous parcourez des pages et du contenu avec des afficheurs de contenu Web. Toutefois, vous pouvez aussi référencer des objets de contenu directement dans des adresses URL conviviales pour le contenu Web.

Par exemple, pour référencer les objets de contenu HR Welcome, Workplace Safety et Personal Wellness dans le contexte de la page Human Resources, vous devez utiliser les URL conviviales pour contenu Web suivantes :

http://www.example.com:10039/wps/portal/home/hr/hr%20welcome
http://www.example.com:10039/wps/portal/home/hr/health/workplace%20safety
http://www.example.com:10039/wps/portal/home/hr/health/personal%20wellness

Remarque : Ces URL conviviales pour contenu Web contiennent des espaces codés en URL (%20) et non des espaces non codés. Votre navigateur Web peut accepter les espaces non codés lorsque vous spécifiez des noms d'objet de contenu dans des adresses URL conviviales pour le contenu Web. Toutefois, pour garantir un comportement cohérent du portail, utilisez la valeur codée pour les URL.

Test des URL conviviales pour le contenu Web

Parfois, il arrive que l'URL conviviale entrée par un utilisateur ou demandée par un moteur de balayage soit incorrecte. Le tableau ci-après présente des URL conviviales contenant des informations de chemins qui ne permettent pas d'identifier un objet de contenu disponible, ainsi que la réponse fournie par le portail lorsqu'une URL conviviale non valide est demandée.

Tableau 1. Exemples d'URL conviviales non valides pour le contenu Web, réponse fournie par le serveur de portail et explication de cette réponse
URL conviviale non valide pour le contenu Web	Réponse du portail	Explication
http://www.example.com:10039/wps/portal/home/products/appliances	HTTP Status code `404` Page Missing Content Contenu Web `Content Not Found`	Résolution de la page Le dernier segment de chemin de l'URL conviviale que le portail peut mettre en correspondance avec un nom d'URL conviviale est home. Par conséquent, la page résolue est Home et le chemin /products/appliances correspond aux informations de chemin de la demande. Validation des informations de chemin Lors de la validation de l'URL conviviale pour le contenu Web, le portail assemble le chemin de contenu à valider en ajoutant les informations de chemin au chemin de l'association de contenu par défaut de la page résolue. Dans la mesure où la page Home ne comporte pas d'association de contenu par défaut pour construire le chemin de contenu, l'URL conviviale pour le contenu Web est considérée comme incorrecte. Traitement des informations de chemin non valides Le code d'état HTTP de la réponse a pour valeur la valeur par défaut (`404`) car friendly.pathinfo.validation.errorCode n'est pas défini. La page résolue (Home) hérite du paramètre friendly.pathinfo.validation.errorURI de Content Root. Par conséquent, le portail résout l'URI `nm:oid:missing.content` qui traite la page Missing Content. Le portlet Afficheur de contenu Web sur la page Missing Content utilise le mappage de contenu par défaut de la page afin de déterminer le contenu Web à afficher (`Content Not Found`).
http://www.example.com:10039/wps/portal/home/hr/group incentives	HTTP Status code `404` Page Missing Content Contenu Web `HR Default`	Résolution de la page The last path segment of the friendly URL that portal can match to a friendly URL name is hr. Par conséquent, la page résolue est Human Resources et le chemin /group incentives correspond aux informations de chemin de la demande. Validation des informations de chemin Lors de la validation de l'URL conviviale pour le contenu Web, le portail assemble le chemin de contenu à valider en ajoutant les informations de chemin au chemin de l'association de contenu par défaut de la page résolue. Le résultat pour la page Human Resources est /Web Content/home/human resources/group incentives. Comme il n'y a pas d'objet de contenu pour le chemin de contenu calculé, l'URL conviviale pour le contenu Web est considérée comme incorrecte. Traitement des informations de chemin non valides Le code d'état HTTP de la réponse a pour valeur la valeur par défaut (`404`), car friendly.pathinfo.validation.errorCode n'est pas défini. La page résolue (Human Resources) hérite du paramètre friendly.pathinfo.validation.errorURI de Content Root. Par conséquent, le portail résout l'URI `nm:oid:missing.content` qui traite la page Missing Content. En outre, le portail configure le contexte Web Content Manager public, tel qu'il est défini par le paramètre de page friendly.pathinfo.validation.errorContentPath de la page résolue (/Web Content/Home/Human Resources/HR Default).
http://www.example.com:10039/wps/portal/home/hr/health/medical prevention and rehabilitation	HTTP Status code `404` Page Missing Content Contenu Web `HR Default`	Résolution de la page The last path segment of the friendly URL that portal can match to a friendly URL name is hr. Therefore, the resolved page is Human Resources and /health/medical prevention and rehabilitation becomes the path information of the request. Validation des informations de chemin Lors de la validation de l'URL conviviale pour le contenu Web, le portail assemble le chemin de contenu à valider en ajoutant les informations de chemin au chemin de l'association de contenu par défaut de la page résolue. Le résultat pour la page Human Resources est /Web Content/home/human resources/health/medical prevention and rehabilitation. Comme il n'y a pas d'objet de contenu pour le chemin de contenu calculé, l'URL conviviale pour le contenu Web est considérée comme incorrecte. Traitement des informations de chemin non valides The HTTP status code of the response is set to the default value (`404`) because friendly.pathinfo.validation.errorCode is not set. The resolved page (Human Resources) inherits the friendly.pathinfo.validation.errorURI setting from Content Root. Therefore, the portal resolves the URI `nm:oid:missing.content` that addresses the page Missing Content. En outre, le portail configure le contexte Web Content Manager public, tel qu'il est défini par le paramètre de page friendly.pathinfo.validation.errorContentPath de la page résolue (/Web Content/Home/Human Resources/HR Default).