GlideSPUtil – Global

Die GlideSPUtil- API bietet Dienstprogrammmethoden zum Ausführen allgemeiner Back-End-Funktionen, die Serviceportalunterstützen.

Verfügbare Dienstprogrammmethoden:

• Lösen Sie Variablen auf, die in der Tabelle „Dynamische Seitenvariablen“ [sp_page_title_variable] angegeben sind, die einer angegebenen Seite Serviceportal zugeordnet sind, die sich in der Seitentabelle [sp_page] befindet.
• Andere Methoden

Weitere Informationen finden Sie unter Service Portal-SeitenService Portal-SeitenService Portal-Seiten.

GlideSPUtil – GlideSPUtil()

Instantiiert ein GlideSPUtil-Objekt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

Das folgende Codebeispiel zeigt, wie ein GlideSPUtil-Objekt instanziiert wird, bevor eine der zugehörigen Methoden aufgerufen wird.

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()

Berücksichtigt 'id'-Abfrageparameter, um die Portalseite (pageGR) zu identifizieren, und verwendet die Abfragezeichenfolge der aktuellen Transaktion, um getHumanReadableUrl(GlideRecord pageGR, String queryString) aufzurufen, und gibt das endgültige visuell lesbare Element zurück.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Visuell lesbare URL für den angegebenen Datensatz Serviceportal, wobei die Variablen durch den Inhalt der Zeichenfolgenzuordnung queryParams ersetzt werden.

Das folgende Codebeispiel zeigt, wie] funktioniert.

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

Ausgabe:

GlideSPUtil – getHumanReadableUrl(GlideRecord pageGR, String queryParams)

Konvertiert den übergebenen Zeichenfolgenparameter queryParms in eine Zeichenfolgenzuordnung und löst dann die Variablen in der Zeichenfolge „Menschlich lesbare URL-Struktur“ auf, die im sp_page-Datensatz angegeben ist, und gibt den endgültigen visuell lesbaren Teil der URL zurück.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
pageGR	GlideRecord	GlideRecord-Objekt des Datensatzes in der Seitentabelle [sp_page], in dem die URL-Variablen aufgelöst werden sollen.
queryZeichenfolge	Zeichenfolge	Abfragezeichenfolge.

Tabelle : 5. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Visuell lesbare URL für den angegebenen Datensatz Serviceportal, wobei die Variablen durch den Inhalt der Zeichenfolgenzuordnung queryParams ersetzt werden.

Das folgende Codebeispiel zeigt, wie] funktioniert.

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);
}

Ausgabe:

GlideSPUtil – getHumanReadableUrl(GlideRecord pageGR, StringMap queryParams)

Löst die Variablen im Feld Visuell lesbare URL-Struktur des übergebenen Vorlagenseitenobjekts Serviceportal auf und gibt eine URL zurück, die die angegebenen Abfrageparameter und die aufgelösten visuell lesbaren Parameter enthält.

Verwenden Sie visuell lesbare Stichwörter in einer URL, um:

• Ermöglichen Sie Ihren Kunden, den Zweck der URL besser zu verstehen, wenn sie sich nicht im Kontext der zugehörigen Seite befindet.
• Stellen Sie Suchmaschinen Stichwörter bereit, um die Seite besser zu finden.

Anstatt nur eine URL zu haben, die nicht erkennbare Schlüssel-Wert-Paare wie diese enthält:

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

Sie können den Elementnamen der URL hinzufügen, damit der Zweck der URL leichter verständlich ist:

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

Bevor Sie diese Methode verwenden können, müssen Sie die dynamischen Seitenvariablen definieren, die für jede der Serviceportal Vorlagen verfügbar sind, für die Sie dynamische Inhalte in die URL aufnehmen möchten. Weitere Informationen zum Hinzufügen dieser Variablen finden Sie unter Visuell lesbare Stichwörter zu Seiten-URLs hinzufügen Visuell lesbare Stichwörter zu Seiten-URLshinzufügenVisuelllesbareStichwörter zu Seiten-URLs hinzufügen.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
pageGR	GlideRecord	GlideRecord-Objekt der VorlagenseiteServiceportal, für das die dynamischen URL-Variablen aufgelöst werden sollen. Befindet sich in der Seitentabelle [sp_page].
queryParams	StingMap	URL-Abfrageparameter, die zum Abrufen der gewünschten Serviceportal -Seite verwendet werden sollen. Beispiel: { "id": "sc_cat_item", "sys_id": "ec80c13297968d1021983d1e6253af32", "sysparm_catgory": "1e80c15697969f1032083d1e6253be15" }

Tabelle : 7. Ergebnisse

Typ

Beschreibung

Zeichenfolge

URL, die die aufgelösten visuell lesbaren Elemente für die dynamischen Variablen enthält, die auf der Vorlagenseite Serviceportal angegeben sind. Beispiel: Wenn die definierte dynamische Variable %item_namelautet, enthält die URL den Namen des vom Benutzer ausgewählten Elements, z. B. „apple-iphone-13“, und alle angegebenen Abfrageparameter: https://instance_name.servicenow.com/sp/en/apple-iphone-13?id=sc_cat_item&sys_id=ec80c13297968d1021983d1e6253af32&sysparm_catgory=1e80c15697969f1032083d1e6253be15.

Das folgende Codebeispiel zeigt, wie Sie einen bestimmten KB-Artikel erhalten und getHumanReaadableUrl() aufrufen, um die zugehörigen dynamischen Variablen anzuwenden.

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

Ausgabe: