GlideSPUtil : global

L’API GlideSPUtil fournit des méthodes utilitaires pour exécuter des fonctions back-end courantes qui prennent en charge un Portail de servicesfichier .

Méthodes utilitaires disponibles :

• Résolvez les variables spécifiées dans la table Variables de page dynamique [sp_page_title_variable] associées à une page spécifiée Portail de services située dans la table Page [sp_page].
• Autres méthodes

Pour plus d’informations, consultez Pages du portail de servicesPages du portail de services Pagesdu portail de services.

GlideSPUtil : GlideSPUtil()

Instancie un objet GlideSPUtil.

Tableau 1. Paramètres

Nom	Type	Description
Néant

L’exemple de code suivant montre comment instancier un objet GlideSPUtil avant d’appeler l’une de ses méthodes associées.

function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryParams = RP.getParameters();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

GlideSPUtil : getHumanReadableUrl()

Prend en compte le paramètre de requête « id » pour identifier la page du portail (pageGR) et utilise la chaîne de requête de la transaction actuelle pour appeler getHumanReadableUrl(GlideRecord pageGR, String queryString) et renvoie la valeur lisible par l’homme finale.

Tableau 2. Paramètres

Nom	Type	Description
Aucun

Tableau 3. Renvoie

Type	Description
Chaîne	URL lisible par l’homme pour l’enregistrement spécifié Portail de services avec les variables remplacées par le contenu du mappage queryParams de chaînes.

L’exemple de code suivant montre comment faire.

function() {
  var spUtil = new GlideSPUtil();
  var hrUrl = spUtil.getHumanReadableUrl();
}

Sortie :

GlideSPUtil : getHumanReadableUrl(GlideRecord pageGR, String queryParams)

Convertit le paramètre de chaîne transmis queryParms en un mappage de chaînes, puis résout les variables de la chaîne « Structure d’URL lisible par l’homme » fournie dans l’enregistrement sp_page et renvoie la dernière partie lisible par l’homme de l’URL.

Tableau 4. Paramètres

Nom	Type	Description
pageGR (en anglais seulement)	GlideRecord	Objet GlideRecord de l’enregistrement dans la table Page [sp_page] sur laquelle résoudre les variables URL.
chaîne de requête	Chaîne	Chaîne de requête.

Tableau 5. Renvoie

Type	Description
Chaîne	URL lisible par l’homme pour l’enregistrement spécifié Portail de services avec les variables remplacées par le contenu du mappage queryParams de chaînes.

L’exemple de code suivant montre comment faire.

function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryString = GlideTransaction.get().getRequest().getQueryString();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

Sortie :

GlideSPUtil : getHumanReadableUrl(GlideRecord pageGR, StringMap queryParams)

Résout les variables dans le champ Structure de l’URL lisible par l’homme de l’objet de page de Portail de services modèle transmis et renvoie une URL contenant les paramètres de requête spécifiés et les paramètres lisibles par l’homme résolus.

Utilisez des mots clés lisibles par l’homme dans une URL pour :

• Permettez à vos clients de mieux comprendre le but de l’URL lorsqu’elle n’est pas dans le contexte de la page associée.
• Fournissez aux moteurs de recherche des mots-clés pour mieux localiser la page.

Par exemple, au lieu d’avoir simplement une URL qui contient des paires clé-valeur méconnaissables telles que ceci :

https ://instance_name.servicenow.com/sp/en ?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15

Vous pouvez ajouter le nom de l’élément à l’URL afin de faciliter la compréhension du but de l’URL :

https ://instance_name.servicenow.com/sp/en/apple-iphone-13 ?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15

Avant de pouvoir utiliser cette méthode, vous devez définir les variables de page dynamiques disponibles pour chacun des Portail de services modèles pour lesquels vous souhaitez inclure du contenu dynamique dans l’URL. Pour plus d’informations sur l’ajout de ces variables, voir Ajouter des mots clés lisibles par l’homme aux URL des pagesAjouter des mots clés lisibles par l’homme aux URL des pagesAjoutez des mots clés lisibles par l’homme aux URL des pages.

Tableau 6. Paramètres

Nom	Type	Description
pageGR (en anglais seulement)	GlideRecord	Objet GlideRecord de la page de modèlePortail de services pour laquelle résoudre les variables d’URL dynamiques. Situé dans la table Page [sp_page].
queryParams	StingMap (en anglais seulement)	Paramètres de requête URL à utiliser pour obtenir la page souhaitée Portail de services . Par exemple : { "id": "sc_cat_item", "sys_id": "ec80c13297968d1021983d1e6253af32", "sysparm_catgory": "1e80c15697969f1032083d1e6253be15" }

Tableau 7. Renvoie

Type

Description

Chaîne

URL contenant les éléments résolus lisibles par l’homme pour les variables dynamiques spécifiées dans la page de Portail de services modèle. Par exemple, si la variable dynamique définie est %item_name, l’URL contient le nom de l’élément sélectionné par l’utilisateur, par exemple « apple-iphone-13 », et tous les paramètres de requête spécifiés : https ://instance_name.servicenow.com/sp/en/apple-iphone-13 ?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15.

L’exemple de code suivant montre comment obtenir un article de la base de connaissances spécifique et appeler getHumanReaadableUrl() pour appliquer les variables dynamiques associées.

function() {
  var spUtil = new GlideSPUtil();
  var pageGR = spUtil.getPageRecordWithPageRoute('kb_article', '81b75d3147032100ba13a5554ee4902b', false);
  var queryParams = RP.getParameters();
  var hrUrl = spUtil.getHumanReadableUrl(pageGR, queryParams);
}

Sortie :