GlideURI – Global

Die GlideURI Die API stellt Methoden zur Verarbeitung von URI-Parametern in einer globalen Anwendung bereit.

Hinweis:

Verwenden Sie nicht GlideURI API in Skripts, die während des Exports oder in Hintergrundaufträgen ausgeführt werden.

Weitere Informationen zur Verwendung von URIs:

• Navigieren Sie nach URL
• Navigationsstapel

Siehe auch Aktion – getGlideURI() .

GlideURI – deleteMatchingParameter(Zeichenfolgenübereinstimmung)

Löscht einen oder mehrere Parameter aus dem URI, die dem Anfang der angegebenen Zeichenfolge entsprechen.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Treffer	Zeichenfolge	Teilname eines oder mehrerer Parameter, die aus dem Abfrageteil eines URI entfernt werden sollen.

Tabelle : 2. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie URI-Parameter gelöscht werden, die teilweise mit dem angegebenen Namen übereinstimmen.

// create the GlideURI object
var uri = action.getGlideURI();

uri.deleteMatchingParameter('sysparm_list_');
uri.deleteMatchingParameter('sysparm_record_');

Bereichsbezogenes Äquivalent

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

GlideURI – deleteParameter(Zeichenfolgenname)

Entfernt einen angegebenen Parameter aus dem Abfrageteil des URI.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Name	Zeichenfolge	Name des Parameters, der aus dem Abfrageteil eines URI entfernt werden soll.

Tabelle : 4. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein URI-Parameter gelöscht wird.

// create the GlideURI object
var uri = action.getGlideURI(); 

uri.deleteParameter('sysparm_referring_url');

Bereichsbezogenes Äquivalent

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

GlideURI – get(String name)

Gibt den Wert des angegebenen Parameters zurück.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Der Parametername.

Tabelle : 6. Ausgabe

Typ	Beschreibung
Zeichenfolge	Der Wert für den angegebenen Parameter.

// create the GlideURI object
var uri = action.getGlideURI();
uri.set('sysparm_query', 'priority=2^active=true' );
var fileString = uri.get('sysparm_query');
gs.info(fileString);

Ausgabe:

priority=2^active=true

Bereichsbezogenes Äquivalent

Zur Verwendung von Get() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI – GET(Zeichenfolgenname) .

GlideURI – getFileFromPath()

Gibt den Dateinamen des URI zurück.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. Ergebnisse

Typ	Beschreibung
Zeichenfolge	Der Dateinamenabschnitt des URI.

var gURI = action.getGlideURI();
        
var fileString = gURI.getFileFromPath();
gs.info(fileString);

Bereichsbezogenes Äquivalent

Zur Verwendung von GetFileFromPath() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI – getFileFromPath() .

GlideURI – getMap()

Gibt eine Zuordnung (Schlüssel-Wert-Paare) zurück, die jeden Parameter in der Abfrage und den zugehörigen Wert enthält.

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. Ergebnisse

Typ	Beschreibung
Objekt

Das folgende Beispiel zeigt, wie abgerufen werden kann Sysparm_query Parameter. Siehe auch Aktion – getGlideURI() .

gs.action.getGlideURI().getMap().get('sysparm_query');

Bereichsbezogenes Äquivalent

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

GlideURI – set(String name, String value)

Legt den angegebenen Parameter auf den angegebenen Wert fest.

Tabelle : 11. Parameter

Name	Typ	Beschreibung
name	Zeichenfolge	Der Parametername.
Wert	Zeichenfolge	Der Wert.

Tabelle : 12. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der Wert eines Felds „sysparm_query“ festgelegt wird. Siehe auch Aktion – getGlideURI() .

var gURI = action.getGlideURI();
gURI.set('sysparm_query', 'priority=2^active=true' );
var fileString = gURI.get('sysparm_query');
gs.info(fileString);

Ausgabe:

priority=2^active=true

Bereichsbezogenes Äquivalent

Zur Verwendung von Satz () Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI – Set(Zeichenfolgenname, Zeichenfolgenwert) .

GlideURI – setView(Zeichenfolgenansicht)

Fügt hinzu sysparm_viewParameter für die Abfrage mit der benannten Ansicht.

Eine Ansicht definiert die Elemente, die angezeigt werden, wenn ein Anwender ein Formular oder eine Liste öffnet. Die sysparm_viewParameter gibt die Ansicht an, die für eine Liste oder ein Formular verwendet werden soll. Weitere Informationen zu Ansichten finden Sie unter Ansichtsverwaltung .

Siehe auch:

• Aktion – getGlideURI()
• GlideModalV3 – SwitchView()

Tabelle : 13. Parameter

Name	Typ	Beschreibung
Ansicht	Zeichenfolge	Name des sysparm_viewParameter, der in der URI-Abfrage festgelegt werden soll.

Tabelle : 14. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die Ansicht „schwerwiegende Incidents“ der URI-Abfrage in der Tabelle „Incidents“ [Incident] hinzugefügt wird. Beispiel: Sysparm_View=schwerwiegende%20Incidents . Siehe auch Aktion – getGlideURI() .

// create the GlideURI object
var uri = action.getGlideURI(); 

// Adds the Major incidents to the query
uri.setView('Major Incidents');

// https://instance.service-now.com/incident.do?sys_id=0&sysparm_view=Major%20Incidents ...

Bereichsbezogenes Äquivalent

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

GlideURI – toString(String path)

Rekonstruiert die URI-Zeichenfolge und führt die korrekte URL-Codierung durch, indem nicht gültige Zeichen in ihren URL-Code umgewandelt werden. Beispiel: Konvertieren von & in „%26“.

Parameter, die mit festgelegt wurden Satz () Die Methode ist auch mit dem URI codiert.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
path	Zeichenfolge	Der Basisteil der System-URL, an die der URI angehängt wird.

Tabelle : 16. Ausgabe

Typ	Beschreibung
Zeichenfolge	Die URL.

Die folgenden Beispiele zeigen, wie ungültige Zeichen in URL-Code in einer Instanz-URL konvertiert werden. Siehe auch Aktion – getGlideURI() .

var gURI = action.getGlideURI();
fileString = gURI.toString('https://<your instance>.service-now.com/navpage.do');

Bereichsbezogenes Äquivalent

Zur Verwendung von ToString() Methode in einer bereichsbezogenen Anwendung verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI – toString(Zeichenfolgenpfad) .