SPSEOUtilsSNC : global

L’include de script SPSEOUtilsSNC fournit des méthodes utilitaires qui renvoient des URL explicites pour une page spécifique, ou pour la page actuelle, en fonction de la demande de transaction.

En outre, cette API fournit d’autres méthodes utilitaires que vous pouvez utiliser pour obtenir les informations nécessaires pour appeler d’autres méthodes d’URL lisibles par l’homme.

SPSEOUtilsSNC : getHumanReadableUrl(GlideRecord pageGR, String queryString)

Renvoie l’URL explicite d’un enregistrement spécifié dans la table Page [sp_page ]. Utilise les paramètres de requête transmis pour résoudre toutes les variables de page dynamiques requises par l’URL.

Tableau 1. Paramètres

Nom	Type	Description
pageGR	GlideRecord	Objet GlideRecord de l’enregistrement dans la table Page [sp_page] pour lequel renvoyer l’URL explicite. Utilisez la SPSEOUtilsSNC : getPageRecordWithPageRoute (GlideRecord pageId, chaîne portalId, booléen preventReRoute) méthode pour obtenir le sp_page GlideRecord souhaité.
queryString	Chaîne	Chaîne de requête à utiliser pour résoudre tous les paramètres qui peuvent avoir besoin d’être transmis par l’URL. Par exemple : ?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34

Tableau 2. Renvoie

Type	Description
Chaîne	URL explicite de l’enregistrement spécifié Portail de services . Les variables d’URL sont résolues à l’aide du contenu du paramètre transmis queryString .

L’exemple de code suivant montre comment appeler cette méthode pour obtenir l’URL lisible par l’homme.

function() { 
  var util = new global.SPSEOUtilsSNC();
  var portalId = util.getPortalId();
  var pageGR = util.getPageRecordWithPageRoute(
    'kb_article', portalId, false); 
  var queryString = "?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34"; 
  var hrUrl = util.getHumanReadableUrl(pageGR, queryString);

Sortie :

"getting-around-in-windows"

SPSEOUtilsSNC : getHumanReadableUrlForCurrentRequest()

Renvoie l’URL explicite de l’enregistrement actuel Portail de services .

Cette méthode réplique les paramètres de l’URL cryptique de la page actuelle, tels que le paramètre et les paramètres de requête, lors de la id création de cette URL lisible par l’homme.

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
Chaîne	URL explicite de l’enregistrement actuel Portail de services .

L’exemple de code suivant montre comment appeler cette méthode. Dans cet exemple, l’enregistrement actuel Portail de services utilise l’URL cryptique <instance-url>/sp ?id=kb_article&sys_id=471ee81eff6002009b20ffffffff34 et est configuré pour afficher la brève description d’un article de la base de connaissances qui traite de la navigation dans Windows. L’URL explicite renvoyée pour cette URL cryptique est « getting-around-in-windows ».

// In a script include
function() {
  var util = new global.SPSEOUtilsSNC()
  var hrUrl = util.getHumanReadableUrlForCurrentRequest();
}

Sortie :

getting-around-in-windows

SPSEOUtilsSNC : getPageRecordWithPageRoute (GlideRecord pageId, chaîne portalId, booléen preventReRoute)

Retourne le GlideRecord de la table Pages [sp_page] dont le champ ID correspond au paramètre d’ID transmis (pageId). Appelez cette méthode avant d’appeler la méthode getHumanReadableUrl() pour obtenir la sp_pages GlideRecord souhaitée.

Vous pouvez également demander à la méthode d’utiliser les informations des cartes de routage des pages pour renvoyer le GlideRecord de la page finale Portail de services associée à l’ID de page transmis Portail de services . Pour plus d’informations sur les cartes de routage des pages, consultez Rediriger une référence vers un ID de page.

Tableau 5. Paramètres

Nom	Type	Description
pageId	Chaîne	ID de l’enregistrement de pages [sp_page] à renvoyer. Table : dans le champ ID de la table Pages [sp_page].
portalId	Chaîne	Sys_id de l’enregistrement [sp_portal] du portail de services associé. Nécessaire pour renvoyer la connexion appropriée ou les pages 404 au cas où l’enregistrement associé au paramètre transmis pageId ne serait pas accessible ou indisponible. Utilisez la SPSEOUtilsSNC : getPortalId() méthode pour obtenir l’ID souhaité Portail de services .
preventReroute	Booléen	Marqueur indiquant s’il faut utiliser des cartes de routage des pages pour renvoyer le GlideRecord pour la dernière sp_page à laquelle l’ID de page transmis est résolu, au lieu de l’enregistrement de sp_page correspondant. Valeurs possibles : true : utilisez les cartes de routage des pages pour renvoyer le dernier enregistrement de sp_page auquel l’ID de page transmis est résolu. false : renvoie l’enregistrement sp_page auquel correspond l’ID de page transmis.

Tableau 6. Renvoie

Type	Description
GlideRecord	Enregistrement qui correspond à la demande de requête pour l’enregistrement de sp_page.

L’exemple de code suivant montre comment appeler cette méthode avant d’appeler la méthode getHumanReadableUrl().

function() { 
  var util = new global.SPSEOUtilsSNC();
  var portalId = util.getPortalId();
  var pageGR = util.getPageRecordWithPageRoute(
    'kb_article', portalId, false); 
  var queryString = "?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34"; 
  var hrUrl = util.getHumanReadableUrl(pageGR, queryString);

SPSEOUtilsSNC : getPortalId()

Renvoie le sys_id du portail en cours de chargement en fonction du suffixe du portail dans l’URL de la demande. Appelez cette méthode avant d’appeler la méthode getPageRecordWithPageRoute() pour obtenir la sys_id souhaitée Portail de services .

Tableau 7. Paramètres

Nom	Type	Description
Aucun

Tableau 8. Renvoie

Type	Description
Chaîne	Sys_id de la demande Portail de services en fonction du suffixe de portail de l’URL de la demande.

L’exemple de code suivant montre comment appeler cette méthode pour une URL telle que <instance-url>/sp ?id=index.

function() { 
  var util = new global.SPSEOUtilsSNC();
  var portalId = util.getPortalId();
  var pageGR = util.getPageRecordWithPageRoute(
    'kb_article', portalId, false); 
  var queryString = "?id=kb_article&sys_id=471ee81eff6002009b20ffffffffff34"; 
  var hrUrl = util.getHumanReadableUrl(pageGR, queryString);

Sortie :

81b75d3147032100ba13a5554ee4902b