SPSEOUtilsSNC – Global

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

Darüber hinaus stellt diese API andere Dienstprogrammmethoden bereit, 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 dynamische Seitenvariablen aufzulösen, die für die URL erforderlich sind.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
PageGR	GlideRecord	GlideRecord-Objekt des Datensatzes in der Seitentabelle [sp_page], für das die visuell lesbare URL zurückgegeben werden soll. Verwenden Sie SPSEOUtilsSNC – getPageRecordWithPageRoute(GlideRecord pageId, Zeichenfolgen-PortalId, boolescher Wert „preventReRoute“) Methode zum Abrufen des gewünschten sp_page-GlideRecord.
Abfragezeichenfolge	Zeichenfolge	Abfragezeichenfolge, die zum Auflösen von Parametern verwendet werden soll, die möglicherweise von der URL übergeben werden müssen. Beispiel: ?ID=kb_article&sys_ID=471ee81eff6002009b20ffffffffffffffffffffff34

Tabelle : 2. Rückgaben

Typ	Beschreibung
Zeichenfolge	Visuell lesbare URL für die angegebene Serviceportal Datensatz. Die URL-Variablen werden mit dem Inhalt der übergebenen aufgelöst queryStringParameter.

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

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 die aktuelle zurück Serviceportal Datensatz.

Diese Methode repliziert die Parameter in der kryptischen URL der aktuellen Seite, z. B. idParameter und die Abfrageparameter beim Erstellen dieser visuell lesbaren URL.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Visuell lesbare URL für die aktuelle Serviceportal Datensatz.

Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird. In diesem Beispiel die aktuelle Serviceportal Datensatz verwendet die kryptische URL von <instance-url>/sp?ID=kb_article&sys_ID=471ee81eff6002009b20ffffffffffffffffff34 Und ist so konfiguriert, dass die Kurzbeschreibung eines KB-artikels angezeigt wird, der die Navigation in Windows beschreibt. Die zurückgegebene visuell lesbare URL für diese kryptische 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, Zeichenfolgen-PortalId, boolescher Wert „preventReRoute“)

Gibt den GlideRecord aus der Tabelle „Seiten“ [sp_page] zurück, dessen ID-Feld mit dem übergebenen ID-Parameter ( pageId). Rufen Sie diese Methode auf, bevor Sie aufrufen GetHumanReadableUrl() Methode zum Abrufen des gewünschten sp_pages-GlideRecord.

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

Tabelle : 5. Parameter

Name	Typ	Beschreibung
pageId	Zeichenfolge	ID des zurückzugebenden Seitendatensatzes [sp_page]. Tabelle: Im ID-Feld der Tabelle „Seiten“ [sp_page].
PortalID	Zeichenfolge	SYS_ID des zugehörigen Serviceportal-Datensatzes [sp_Portal]. Erforderlich, um die entsprechende Anmeldung oder 404 Seiten zurückzugeben, falls der Datensatz dem „Bestanden“ zugeordnet ist pageIdParameter ist nicht zugänglich oder nicht verfügbar. Verwenden Sie SPSEOUtilsSNC – getPortalId() Methode zum Abrufen des gewünschten Serviceportal ID.
VorbeugenWeiterleiten	Boolean	Kennzeichnung, die angibt, ob Seitenroutenzuordnungen verwendet werden sollen, um den GlideRecord für die letzte sp_page zurückzugeben, in die die übergebene Seiten-ID aufgelöst wird, anstatt den übereinstimmenden sp_page-Datensatz. Mögliche Werte: Wahr: Verwenden Sie die Seiten-Routenzuordnungen, 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, mit dem die übergebene 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 von aufgerufen wird GetHumanReadableUrl() Methode.

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 aufrufen GetPageRecordWithPageRoute() Methode zum Abrufen des gewünschten Serviceportal sys_ID.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Zeichenfolge	SYS_ID der angeforderten Serviceportal Basierend auf dem Portalsuffix der Anforderungs-URL.

Das folgende Codebeispiel zeigt, wie diese Methode für eine URL wie 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