---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideURI : Global

# GlideURI : Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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](https://www.servicenow.com/docs/access?context=navigate-using-url&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [Navigationsstapel](https://www.servicenow.com/docs/access?context=c_NavigationStack&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
{#GlideURIGlobalAPI__ul_swn_bjb_rmb}

Siehe auch [Aktion -- getGlideURI()](https://www.servicenow.com/docs/ZChg7VLXpiww0lBjZjss7g#Action_getGlideURI "Ruft ein GlideURI-Objekt ab, um die Benutzeransicht zu bestimmen.").

## GlideURI -- deleteMatchingParameter (Zeichenfolgenübereinstimmung) {#ariaid-title2}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Treffer | Zeichenfolge | Teilname eines oder mehrerer Parameter, die aus dem Abfrageteil eines URI entfernt werden sollen. |
[Tabelle : 1. Parameter]

{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Ergebnisse]

{#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb}  
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 {#GlideURI_deleteMatchingParameter_S__section_bct_nbs_mcb}

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

## GlideURI -- deleteParameter(String name) {#ariaid-title3}

Entfernt einen angegebenen Parameter aus dem Abfrageteil des URI.
{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Name des Parameters, der aus dem Abfrageteil eines URI entfernt werden soll. |
[Tabelle : 3. Parameter]

{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteParameter_S__table_wh4_ftg_rmb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 4. Ergebnisse]

{#GlideURI_deleteParameter_S__table_wh4_ftg_rmb}  
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 {#GlideURI_deleteParameter_S__section_bct_nbs_mcb}

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

## GlideURI -- get(String name) {#ariaid-title4}

Gibt den Wert des angegebenen Parameters zurück.
{#GlideURI_get_S__table_bff_yp3_ks__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Parametername. |
[Tabelle : 5. Parameter]

{#GlideURI_get_S__table_bff_yp3_ks} {#GlideURI_get_S__table_cff_yp3_ks__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Wert für den angegebenen Parameter. |
[Tabelle : 6. Ausgabe]

{#GlideURI_get_S__table_cff_yp3_ks}  

    // 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 {#GlideURI_get_S__section_q2n_wgs_mcb}

Um die get()- Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: [GlideURI - get(String name)](https://www.servicenow.com/docs/zfg4uC34TLehkgUNkRPk1Q#r_ScopedGlideURIGet_String "Gibt den Wert des angegebenen Parameters zurück.").

## GlideURI -- getFileFromPath() {#ariaid-title5}

Gibt den Dateinamen des URI zurück.
{#GlideURI_getFileFromPath__table_nzz_gs3_ks__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#GlideURI_getFileFromPath__table_nzz_gs3_ks} {#GlideURI_getFileFromPath__table_ozz_gs3_ks__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Der Dateinamenabschnitt des URI. |
[Tabelle : 8. Ergebnisse]

{#GlideURI_getFileFromPath__table_ozz_gs3_ks}  

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

### Bereichsbezogenes Äquivalent {#GlideURI_getFileFromPath__section_q2n_wgs_mcb}

Um die Methode „getFileFromPath() " in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: [GlideURI - getFileFromPath()](https://www.servicenow.com/docs/zfg4uC34TLehkgUNkRPk1Q#r_ScopedGlideURIGetFileFromPath "Gibt den Dateinamen des URI zurück.").

## GlideURI -- getMap() {#ariaid-title6}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 9. Parameter]

{#GlideURI_getMap__table_g2b_b5g_rmb} {#GlideURI_getMap__table_h2b_b5g_rmb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt |   |
[Tabelle : 10. Ergebnisse]

{#GlideURI_getMap__table_h2b_b5g_rmb}  
Das folgende Beispiel zeigt, wie `sysparm_query-` Parameter abgerufen werden. Siehe auch [Aktion -- getGlideURI()](https://www.servicenow.com/docs/ZChg7VLXpiww0lBjZjss7g#Action_getGlideURI "Ruft ein GlideURI-Objekt ab, um die Benutzeransicht zu bestimmen.").

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

### Bereichsbezogenes Äquivalent {#GlideURI_getMap__section_bct_nbs_mcb}

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

## GlideURI -- set(String name, String value) {#ariaid-title7}

Legt den angegebenen Parameter auf den angegebenen Wert fest.
{#GlideURI_set_S_S__table_z2w_tq3_ks__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Der Parametername. |
| Wert | Zeichenfolge | Der Wert. |
[Tabelle : 11. Parameter]

{#GlideURI_set_S_S__table_z2w_tq3_ks} {#GlideURI_set_S_S__table_afw_tq3_ks__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 12. Ausgabe]

{#GlideURI_set_S_S__table_afw_tq3_ks}  
Das folgende Beispiel zeigt, wie der Wert des Felds „sysparm_query" festgelegt wird. Siehe auch [Aktion -- getGlideURI()](https://www.servicenow.com/docs/ZChg7VLXpiww0lBjZjss7g#Action_getGlideURI "Ruft ein GlideURI-Objekt ab, um die Benutzeransicht zu bestimmen.").

    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 {#GlideURI_set_S_S__section_q2n_wgs_mcb}

Um die Methode „ set() " in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: [GlideURI - set(String name, String value)](https://www.servicenow.com/docs/zfg4uC34TLehkgUNkRPk1Q#r_ScopedGlideURISet_String_String "Legt den angegebenen Parameter auf den angegebenen Wert fest.").

## GlideURI -- setView(String view) {#ariaid-title8}

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 [Verwaltung](https://www.servicenow.com/docs/access?context=view-management-overview&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)von Ansichten.  
Siehe auch:

* [Aktion - getGlideURI()](https://www.servicenow.com/docs/ZChg7VLXpiww0lBjZjss7g#Action_getGlideURI "Ruft ein GlideURI-Objekt ab, um die Benutzeransicht zu bestimmen.")
* [GlideModalV3 -- SwitchView ()](https://www.servicenow.com/docs/Y_5eOyijOldNViMtagvSUw#r_GMODV3-switchView_S "Ändert die Ansicht und lädt das Modal erneut.")
{#GlideURI_setView_S__ul_bll_frk_smb}
{#GlideURI_setView_S__table_tgr_g5g_rmb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ansicht | Zeichenfolge | Name des sysparm_view -Parameters, der in der URI-Abfrage festgelegt werden soll. |
[Tabelle : 13. Parameter]

{#GlideURI_setView_S__table_tgr_g5g_rmb} {#GlideURI_setView_S__table_ugr_g5g_rmb__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 14. Ergebnisse]

{#GlideURI_setView_S__table_ugr_g5g_rmb}  
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()](https://www.servicenow.com/docs/ZChg7VLXpiww0lBjZjss7g#Action_getGlideURI "Ruft ein GlideURI-Objekt ab, um die Benutzeransicht zu bestimmen.").

    // 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 {#GlideURI_setView_S__section_bct_nbs_mcb}

Diese Methode ist in bereichsbezogenen Anwendungen nicht verfügbar.

## GlideURI -- toString(String path) {#ariaid-title9}

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.
{#GlideURI_toString_S__table_zjw_4r3_ks__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| path | Zeichenfolge | Der Basisteil der System-URL, an die der URI angehängt wird. |
[Tabelle : 15. Parameter]

{#GlideURI_toString_S__table_zjw_4r3_ks} {#GlideURI_toString_S__table_akw_4r3_ks__entry__2}

| Typ | Beschreibung |
|-|-|
| Zeichenfolge | Die URL. |
[Tabelle : 16. Ausgabe]

{#GlideURI_toString_S__table_akw_4r3_ks}  
Die folgenden Beispiele zeigen, wie ungültige Zeichen in einer Instanz-URL in URL-Code konvertiert werden. Siehe auch [Aktion -- getGlideURI()](https://www.servicenow.com/docs/ZChg7VLXpiww0lBjZjss7g#Action_getGlideURI "Ruft ein GlideURI-Objekt ab, um die Benutzeransicht zu bestimmen.").

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

### Bereichsbezogenes Äquivalent {#GlideURI_toString_S__section_q2n_wgs_mcb}

Um die toString()- Methode in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie die entsprechende bereichsbezogene Methode: [GlideURI - toString(String path)](https://www.servicenow.com/docs/zfg4uC34TLehkgUNkRPk1Q#r_ScopedGlideURIToString_String "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“.").