SPSEOUtilsSNC : Global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Die SPSEOUtilsSNC- Skripteinbindung bietet Dienstprogrammmethoden, die visuell lesbare URLs für eine bestimmte Seite oder für die aktuelle Seite basierend auf der Transaktionsanforderung zurückgeben.

    Darüber hinaus bietet diese API andere Dienstprogrammmethoden, mit denen Sie Informationen abrufen können, die zum Aufrufen anderer visuell lesbarer URL-Methoden erforderlich sind.

    SPSEOUtilsSNC – getHumanReadableUrl(GlideRecord pageGR, Zeichenfolge queryString)

    Gibt die visuell lesbare URL für einen angegebenen Datensatz in der Tabelle „Seite“ [sp_page ] zurück. Verwendet die übergebenen Abfrageparameter, um alle dynamischen Seitenvariablen aufzulösen, die für die URL erforderlich sind.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    pageGR GlideRecord GlideRecord-Objekt des Datensatzes in der Tabelle „Seite“ [sp_page], für den die visuell lesbare URL zurückgegeben werden soll.

    Verwenden Sie die Methode SPSEOUtilsSNC – getPageRecordWithPageRoute(GlideRecord pageId, Zeichenfolge PortalId, Boolesche VerhindernReRoute), um den gewünschten sp_page-GlideRecord abzurufen.
    queryString Zeichenfolge Abfragezeichenfolge zum Auflösen von Parametern, die möglicherweise von der URL übergeben werden müssen.

    Beispiel: ?id=kb_article&sys_id=471ee81eff6002009b20fffffffffff34
    Tabelle : 2. Rückgaben
    Typ Beschreibung
    Zeichenfolge Visuell lesbare URL für den angegebenen Datensatz Serviceportal. Die URL-Variablen werden anhand des Inhalts des übergebenen Parameters queryString aufgelöst.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um die visuell lesbare URL zu erhalten.

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

    Ausgabe:

    "getting-around-in-windows"

    SPSEOUtilsSNC – getHumanReadableUrlForCurrentRequest ()

    Gibt die visuell lesbare URL für den aktuellen Serviceportal -Datensatz zurück.

    Diese Methode repliziert die Parameter in der kryptografischen URL der aktuellen Seite, z. B. den Parameter id und die Abfrageparameter, wenn diese visuell lesbare URL erstellt wird.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Visuell lesbare URL für den aktuellen Serviceportal -Datensatz.

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird. In diesem Beispiel verwendet der aktuelle Datensatz Serviceportal die verschlüsselte URL von<instance-url> /sp?id=kb_article&sys_id=471ee81eff6002009b20ffffffffffff34 und ist so konfiguriert, dass die Kurzbeschreibung eines KB-Artikels angezeigt wird, der die Navigation in Windows behandelt. Die zurückgegebene visuell lesbare URL für diese kryptografische URL lautet „getting-around-in-windows“.

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

    Ausgabe:

    getting-around-in-windows

    SPSEOUtilsSNC – getPageRecordWithPageRoute(GlideRecord pageId, Zeichenfolge PortalId, Boolesche VerhindernReRoute)

    Gibt den GlideRecord aus der Seitentabelle [sp_page] zurück, dessen ID-Feld mit dem übergebenen ID-Parameter (pageId) übereinstimmt. Rufen Sie diese Methode vor der getHumanReadableUrl()- Methode auf, um den gewünschten sp_pages-GlideRecord abzurufen.

    Sie können auch anfordern, dass die Methode die Informationen der Seiten-Weiterleitungszuordnungen verwendet, um den GlideRecord der endgültigen Seite Serviceportal zurückzugeben, die der übergebenen Seiten-ID Serviceportal zugeordnet ist. Weitere Informationen zu Seiten-Weiterleitungszuordnungen finden Sie unter Verweis auf Seiten-ID umleiten.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    pageId Zeichenfolge ID des zurückzugebenden Seiten-Datensatzes [sp_page].

    Tabelle: Im ID-Feld der Seitentabelle [sp_page].
    Portal-ID Zeichenfolge Sys_id des zugeordneten Serviceportal-Datensatzes [sp_portal]. Erforderlich, um die entsprechenden Anmelde- oder 404-Seiten zurückzugeben, falls der Datensatz, der dem übergebenen Parameter pageId zugeordnet ist, nicht zugänglich oder nicht verfügbar ist.

    Verwenden Sie die Methode SPSEOUtilsSNC – getPortalId(), um die gewünschte ID Serviceportal zu erhalten.
    VerhindernWeitereRoute Boolean Kennzeichnung, die angibt, ob Seiten-Weiterleitungszuordnungen anstelle des entsprechenden sp_page-Datensatzes verwendet werden sollen, um den GlideRecord für die letzte sp_page zurückzugeben, in die die übergebene Seiten-ID auflöst.
    Mögliche Werte:
    • „wahr“: Verwenden Sie die Seiten-Weiterleitungszuordnungen, um den letzten sp_page-Datensatz zurückzugeben, in den die übergebene Seiten-ID aufgelöst wird.
    • „falsch“: Gibt den sp_page-Datensatz zurück, der mit der übergebenen Seiten-ID übereinstimmt.
    Tabelle : 6. Rückgaben
    Typ Beschreibung
    GlideRecord Datensatz, der der Abfrageanforderung für den sp_page-Datensatz entspricht.

    Das folgende Codebeispiel zeigt, wie diese Methode vor dem Aufrufen der getHumanReadableUrl()- Methode aufgerufen wird.

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

    Gibt die sys_id des zu ladenden Portals basierend auf dem Portalsuffix in der Anforderungs-URL zurück. Rufen Sie diese Methode auf, bevor Sie die getPageRecordWithPageRoute()- Methode aufrufen, um die gewünschte Serviceportal sys_id zu erhalten.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Sys_id des angeforderten Serviceportal basierend auf dem Portalsuffix der Anforderungs-URL.

    Das folgende Codebeispiel zeigt, wie diese Methode für eine URL wie z. B. aufgerufen wird<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);

    Ausgabe:

    81b75d3147032100ba13a5554ee4902b