Configuration de la validation d'URL conviviales pour le contenu Web
Après avoir activé la validation d'URL conviviales pour le contenu Web, vous pouvez choisir différentes options de configuration. Ces options vous permettent de spécifier la façon dont le portail répond à des URL conviviales contenant des informations de chemin qui n'identifient pas un objet de contenu disponible. Cette rubrique présente les différentes combinaisons de paramètres possibles et la façon dont celles-ci impactent la réponse du portail.
Vous pouvez spécifier les paramètres suivants en tant que propriétés ou paires clé-valeur dans le service de configuration de portail pour l'ensemble du portail ou en tant que paramètres de page pour des pages individuelles. Les paramètres de page que vous définissez pour une page spécifique remplacent les paramètres globaux spécifiés dans le service de configuration de portail. Toutes les pages enfant héritent des paramètres de page. Pour plus d'informations, voir Service de configuration dans la section des liens connexes.
- friendly.pathinfo.validation.errorCode = (404)
- Cette clé spécifie le code d'état HTTP qui est renvoyé par le portail si les informations de chemin d'une URL conviviale ne peuvent pas être résolues en objet de contenu pour la page demandée. Vous pouvez indiquer l'une des valeurs suivantes :
- 404
- Valeur par défaut. Ce code d'état HTTP indique à un appelant, tel qu'un moteur de balayage ou un navigateur Web, qu'aucun contenu n'a été trouvé pour l'URL conviviale. Ce contenu peut être temporairement ou définitivement manquant.
- 410
- Ce code d'état HTTP indique à un appelant, tel qu'un moteur de balayage ou un navigateur Web, que la ressource pour l'URL conviviale n'est plus disponible. Cette ressource est définitivement manquante.
- friendly.pathinfo.validation.errorTextProvider
- Cette clé spécifie le fournisseur de texte du message d'état HTTP localisé à envoyer, ainsi que le code d'état HTTP configuré. Si vous configurez un fournisseur de texte et qu'une URL de demande comporte des informations de chemin non valides, le portail répond en envoyant une page blanche qui contient uniquement le code d'état HTTP et le message localisé correspondant spécifié par le fournisseur de texte. La valeur de ce paramètre doit correspondre à l'ID d'une implémentation de l'interface com.ibm.workplace.wcm.api.plugin.textprovider.TextProvider. Pour utiliser les messages par défaut de HCL, spécifiez le fournisseur de texte portant l'ID PathInfoValidationTextProvider. Si vous implémentez un fournisseur de texte personnalisé, assurez-vous qu'il prend en charge les clés de message composées du préfixe HTTP_STATUS_MESSAGE_ et du code d'état HTTP configuré. HTTP_STATUS_MESSAGE_404. Important : Le portail ignore ce paramètre si vous spécifiez également la propriété ou le paramètre de page friendly.pathinfo.validation.errorURI.
- friendly.pathinfo.validation.errorResourceBundle
- Cette clé spécifie un regroupement de ressources Java comme solution alternative à l'implémentation d'un fournisseur de texte personnalisé. Si vous configurez un regroupement de ressources Java et qu'une URL de demande comporte des informations de chemin non valides, le portail répond en envoyant une page blanche qui contient uniquement le code d'état HTTP et le message localisé correspondant provenant du regroupement de ressources Java. La valeur de ce paramètre doit correspondre au nom qualifié complet du regroupement de ressources Java. Si vous fournissez un regroupement de ressources Java personnalisé, assurez-vous qu'il contient des clés de message composées du préfixe HTTP_STATUS_MESSAGE_ et du code d'état HTTP configuré. Par exemple : HTTP_STATUS_MESSAGE_404. Important : Le portail ignore ce paramètre si vous spécifiez également la propriété ou le paramètre de page friendly.pathinfo.validation.errorURI. Le portail ignore également ce paramètre si vous affectez à la propriété ou au paramètre de page friendly.pathinfo.validation.errorTextProvider un ID fournisseur de texte personnalisé.
- friendly.pathinfo.validation.errorURI
- Cette clé spécifie l'URI d'objet de contenu que le portail résout si l'URL de demande comporte des informations de chemin non valides. La valeur de ce paramètre doit correspondre à un URI d'objet de contenu que le portail peut résoudre. Par exemple :
- nm:oid:unique_page_name
- Cet URI de modèle de navigation redirige la demande vers une page de portail spécifique en fonction du nom unique de la page cible.
- custom:resolutionserviceuri
- Cette implémentation personnalisée de l'interface com.ibm.portal.resolver.ResolutionService résout les informations de chemin non valides en un état de navigation déterminé de manière dynamique. Lorsque le portail résout l'URI d'objet de contenu, le chemin de contenu dont la validation par le portlet a échoué est transmis au service de résolution en tant que paramètre wcmContentPath.
- friendly.pathinfo.validation.errorContentPath
- Cette clé spécifie le chemin de contenu complet que le portail définit en tant que contexte Web Content Manager public de la page résolue si l'URL de demande comporte des informations de chemin non valides. Les portlets Afficheur de contenu Web sur la page de contenu qui sont configurés pour écouter d'autres portlets peuvent rendre le contenu avec le chemin spécifié. La valeur de ce paramètre doit correspondre au chemin d'un objet de contenu qui est disponible pour les utilisateurs. Par exemple : /Web Content/home/human_resources/health/topic_not_found.
| Réponse apportée par le portail à des URL conviviales non valides pour le contenu Web : Code d'état HTTP | Réponse apportée par le portail à des URL conviviales non valides pour le contenu Web : Page | Réponse apportée par le portail à des URL conviviales non valides pour le contenu Web : Contenu Web | friendly.pathinfo.validation.errorCode | friendly.pathinfo.validation.errorTextProvider ou friendly.pathinfo.validation.errorResourceBundle | friendly.pathinfo.validation.errorURI | friendly.pathinfo.validation.errorContentPath |
|---|---|---|---|---|---|---|
| 404 | Page qui est spécifiée dans l'URL demandée. | Le contenu Web est rendu en fonction du contexte Web Content Manager public ou privé, mais il ne dépend pas des informations de chemin. Les informations de chemin n'étaient pas valides et ont été retirés de l'état. | S/O | S/O | S/O | S/O |
| 410 | Page qui est spécifiée dans l'URL demandée. | Le contenu Web est rendu en fonction du contexte Web Content Manager public ou privé, mais il ne dépend pas des informations de chemin. Les informations de chemin n'étaient pas valides et ont été retirés de l'état. | 410 | S/O | S/O | S/O |
| 404 | La page affiche le texte suivant : Erreur 404 : Le contenu demandé n'existe pas. Vérifiez que l'adresse URL est correcte. | S/O | S/O |
|
S/O | S/O |
| 404 | La page portant le nom unique missing.content s'affiche. | Web content is rendered according to the private or public Web Content Manager context, but not based on the path information. Les informations de chemin n'étaient pas valides et ont été retirés de l'état. | S/O | S/O | nm:oid:missing.content |
S/O |
| 404 | Page qui est spécifiée dans l'URL demandée. | Le contenu Web est rendu en fonction du contexte Web Content Manager privé du portlet Afficheur de contenu Web ou du chemin /Web Content/Home/Missing Content. | S/O | S/O | S/O | /Web Content/Home/Missing Content |
| 410 | The page with the unique name missing.content displays. | Web content is rendered according to the private Web Content Manager context of the Web Content Viewer portlet or /Web Content/Home/Missing Content. | 410 | S/O | nm:oid:missing.content |
/Web Content/Home/Missing Content |