GlideURI : Global

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

Hinweis:

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

Weitere Informationen zur Verwendung von URIs:

• Navigieren Sie mit der 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. Ergebnisse

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

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. Ergebnisse

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

Um die get()- Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI - get(String name).

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

Um die Methode „getFileFromPath() “ in einer bereichsbezogenen Anwendung zu verwenden, 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 sysparm_query- Parameter abgerufen werden. 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 des 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

Um die Methode „ set() “ in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI - set(String name, String value).

GlideURI – setView(String view)

Fügt der Abfrage mit der benannten Ansicht den Parameter sysparm_view hinzu.

Eine Ansicht definiert die Elemente, die angezeigt werden, wenn ein Benutzer ein Formular oder eine Liste öffnet. Der Parameter sysparm_view gibt die Ansicht an, die für eine Liste oder ein Formular verwendet werden soll. Weitere Informationen zu Ansichten finden Sie unter Verwaltungvon Ansichten.

Siehe auch:

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

Tabelle : 13. Parameter

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

Tabelle : 14. Ergebnisse

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=Major%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 der Methode set() festgelegt wurden, werden ebenfalls 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 einer Instanz-URL in URL-Code konvertiert werden. Siehe auch Aktion – getGlideURI().

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

Bereichsbezogenes Äquivalent

Um die toString()- Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI - toString(String path).