GlideSPUtil – Global

Die GlideSPUtil Die API stellt Dienstprogrammmethoden zur Ausführung allgemeiner Back-End-Funktionen bereit, die einen unterstützen Serviceportal.

Verfügbare Dienstprogrammmethoden:

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

Weitere Informationen finden Sie unter Serviceportal-Seiten .

GlideSPUtil: GlideSPUtil()

Instanziiert 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 Abfrageparameter „ID“ Um die Portalseite (pageGR) und zu identifizieren Verwendet die Abfragezeichenfolge der aktuellen Transaktion, um getHumanReadableUrl (GlideRecord pageGR, String QueryString) aufzurufen, und gibt das endgültige visuell lesbare zurück.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 3. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Visuell lesbare URL für die angegebene Serviceportal Datensatz mit den Variablen, die durch den Inhalt von ersetzt wurden queryParamsZeichenfolgenzuordnung.

Das folgende Codebeispiel Zeigt die Vorgehensweise .

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

Ausgabe:

GlideSPUtil – getHumanReadableUrl(GlideRecord pageGR, Zeichenfolge queryParams)

Konvertiert die bestanden queryParmsZeichenfolgenparameter in eine Zeichenfolgenzuordnung und löst dann die Variablen in auf Zeichenfolge „visuell lesbare url-Struktur“ Wird im Datensatz „sp_page“ bereitgestellt und gibt zurück Endgültiger visuell lesbarer Teil der URL.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
PageGR	GlideRecord	GlideRecord-Objekt des Datensatzes in der Tabelle „Seite“ [sp_page], für das die URL-Variablen aufgelöst werden sollen.
Abfrage Zeichenfolge	Zeichenfolge	Abfragezeichenfolge .

Tabelle : 5. Rückgaben

Typ	Beschreibung
Zeichenfolge	Visuell lesbare URL für die angegebene Serviceportal Datensatz mit den Variablen, die durch den Inhalt von ersetzt wurden queryParamsZeichenfolgenzuordnung.

Das folgende Codebeispiel Zeigt die Vorgehensweise .

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 in auf Visuell lesbare url-Struktur Feld des übergebenen Serviceportal Vorlagenseitenobjekt 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 zur Verfügung, um die Seite besser zu finden.

Beispiel: 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 der URL den Elementnamen hinzufügen, um den Zweck der URL besser zu verstehen:

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 verfügbaren sind Serviceportal Vorlagen, für die Sie dynamische Inhalte in die URL aufnehmen möchten. Weitere Informationen zum Hinzufügen dieser Variablen finden Sie unter Add human readable keywords to page URLs.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
PageGR	GlideRecord	GlideRecord-Objekt von Serviceportal Vorlagenseite, für die die dynamischen URL-Variablen aufgelöst werden sollen. Tabelle: Seite [sp_page]
queryParams	StingMap	URL-Abfrageparameter, die zum Abrufen der gewünschten verwendet werden sollen Serviceportal Seite. Zum Beispiel: { "id": "sc_cat_item", "sys_id": "ec80c13297968d1021983d1e6253af32", "sysparm_catgory": "1e80c15697969f1032083d1e6253be15" }

Tabelle : 7. Rückgaben

Typ

Beschreibung

Zeichenfolge

URL, die die aufgelösten visuell lesbaren Elemente für die in angegebenen dynamischen Variablen enthält Serviceportal Vorlagenseite. Beispiel: Wenn die definierte dynamische Variable ist %item_name, Die URL enthält den Namen des Elements, das der Anwender ausgewählt hat, 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 abrufen und aufrufen GetHumanReadableUrl() Zum Anwenden der zugeordneten dynamischen Variablen.

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