Navigation dans Portail de services les pages par URL

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Vous pouvez accéder à un portail ou à une page à l’aide d’une Portail de services URL.

    Portail de services Les URL ont la structure suivante :

    https://<instance>/<portal suffix>/<guest language>/<keywords>?id=<page id>&lang=<language>&<page parameters>
    Élément Description
    instance Adresse Web unique et sécurisée pour chaque instance. Le format par défaut est https://<nom d’instance>.service-now.com.
    Suffixe du portail Suffixe établi pour le portail. Par exemple, /sp.
    Langue de l’invité ID de langue de la langue du portail. Par exemple, es pour l’espagnol. La page est renvoyée dans la langue spécifiée si la langue est active et que l’utilisateur accédant à la page est un utilisateur invité.
    Mots clés

    Mots-clés lisibles par l’homme qui améliorent l’optimisation des moteurs de recherche (SEO) et les taux de clics pour les pages publiques. Les URL lisibles par l’homme aident également les utilisateurs à comprendre à quoi s’attendre sur une page pour les pages publiques et non publiques. Par exemple, https://<instance>/kb/en/faq/what-is-a-cookie ?id=kb_article_view&sysparm_article=KB0000007.

    Pour plus d'informations, consultez Ajouter des mots clés lisibles par l’homme aux URL des pages.
    id ID de la page vers laquelle naviguer dans le cadre du portail. Par exemple, ?id=index.
    language ID de langue de la langue du portail. Par exemple, lang=es pour l’espagnol. La page est renvoyée dans la langue demandée si la langue est active et que l’utilisateur accédant à la page est un utilisateur invité ou un utilisateur authentifié sans préférence de langue définie.
    Paramètres de page

    Des paramètres supplémentaires sont requis par certaines pages pour charger du contenu dynamique en recherchant un enregistrement (table, sys_id). Recherchez les appels $sp.getParameter dans un script de serveur de widgets pour afficher les paramètres qu’un widget utilise. Pour plus de détails sur cette méthode, consultez GlideSPScriptable - Scoped.

    Si vous n’incluez pas ces paramètres supplémentaires lorsque cela est nécessaire, vous risquez d’obtenir un message d’erreur Vous n’avez pas l’autorisation requise ou l’enregistrement n’est pas valide .

    Par exemple, l’URL d’une page de la base de connaissances publique en espagnol en Portail de services peut être https://<instance>/sp/es/faq/what-is-a-cookie ?id=kb_article&sys_id=KB0000007.

    Remarque :
    Si vous utilisez la gestion des versions d’article avec le module d’extension Gestion des connaissances - Portail de services (com.snc.knowledge_serviceportal), vous devez ajouter le numéro de version de l’article à l’URL pour ouvrir un article de la base de connaissances dans le système de base ou le portail de connaissances. Par exemple, au lieu d’accéder à un article à l’aide de l’URL https://<instance>/sp ?id=kb_article&sys_id=KB0000005, vous devez inclure le numéro de version de l’article : https://<instance>/sp ?id=kb_article&sys_id=KB0000005%20V1.0. Pour en savoir plus, consultez Gestion des versions d’article.

    Référencement d’un ID de page

    Pages de référence Portail de services des widgets et des options d’instance de widget à l’aide de l’ID de page. Par exemple, un lien vers la page de sc_home dans un modèle HTML de widget peut apparaître comme suit :

    <div><a href="?id=sc_home">${Order something...}</a></div>