GlideURI – Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Aktiviert die Verarbeitung des URI-Parameters.

    Hinweis:
    Verwenden Sie die GlideURI- API nicht in Skripts, die während des Exports ausgeführt werden, oder in Hintergrundaufträgen.
    Weitere Informationen zur Verwendung von URIs:

    Siehe auch Aktion – getGlideURI().

    GlideURI – deleteMatchingParameter(String match)

    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 getFileFromPath()- Methode 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 eines sysparm_query-Felds 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 set()- Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: GlideURI – set(String name, String value).

    GlideURI – setView(String view)

    Fügt den Parameter sysparm_view der Abfrage mit der benannten Ansicht 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 Ansichtsverwaltung.

    Siehe auch:
    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Ansicht Zeichenfolge Name des Parameters sysparm_view, 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“.

    Mit der set()- Methode festgelegte Parameter 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 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

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