Navigation dans les pages par Portail de services URL

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Vous pouvez accéder à un portail ou à une page à l’aide Portail de services d’une 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 si 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 L’ID de la page à laquelle vous naviguez 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 si 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 le contenu dynamique en recherchant un enregistrement (table, sys_id). Recherchez les appels $sp.getParameter dans un script serveur de widgets pour voir les paramètres utilisés par un widget. 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’êtes pas autorisé ou l’enregistrement n’est pas valide .

    Par exemple, l’URL d’une page de base de connaissances publique en espagnol Portail de services pourrait ê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 les portails de la base 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

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

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