---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideURI : global

# GlideURI : global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 minutes de lecture

L'API GlideURI fournit des méthodes pour gérer les paramètres d'URI dans une application globale.  
Remarque :  
N'utilisez pas l'API GlideURI dans les scripts exécutés pendant l'exportation ou dans les tâches en arrière-plan.  
Pour plus d'informations sur l'utilisation des URI :

* [Naviguer par URL](https://www.servicenow.com/docs/access?context=navigate-using-url&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [Pile de navigation](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}

Voir aussi [Action - getGlideURI()](https://servicenow-prod.fluidtopics.net/f~sYB4w~W7~tPfYN5VSqqQ#Action_getGlideURI "Obtient un objet GlideURI pour déterminer la vue utilisateur.").

## GlideURI : deleteMatchingParameter(correspondance de chaîne) {#ariaid-title2}

Supprime un ou plusieurs paramètres de l'URI qui correspondent au début de la chaîne fournie.
{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb__entry__3}

| Nom | Type | Description |
|-|-|-|
| correspondre | Chaîne | Nom partiel d'un ou de plusieurs paramètres à supprimer de la partie requête d'un URI. |
[Tableau 1. Paramètres]

{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 2. Renvoie]

{#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb}  
L'exemple suivant montre comment supprimer des paramètres d'URI qui correspondent partiellement au nom fourni.

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

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

### Équivalent dans le champ d'application {#GlideURI_deleteMatchingParameter_S__section_bct_nbs_mcb}

Cette méthode n'est pas disponible dans les applications incluses dans le périmètre.

## GlideURI : deleteParameter(nom de chaîne) {#ariaid-title3}

Supprime un paramètre spécifié de la partie requête de l'URI.
{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom du paramètre à supprimer de la partie requête d'un URI. |
[Tableau 3. Paramètres]

{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteParameter_S__table_wh4_ftg_rmb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 4. Renvoie]

{#GlideURI_deleteParameter_S__table_wh4_ftg_rmb}  
L'exemple suivant montre comment supprimer un paramètre d'URI.

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

    uri.deleteParameter('sysparm_referring_url');

### Équivalent dans le champ d'application {#GlideURI_deleteParameter_S__section_bct_nbs_mcb}

Cette méthode n'est pas disponible dans les applications incluses dans le périmètre.

## GlideURI : obtenir (nom de chaîne) {#ariaid-title4}

Renvoie la valeur du paramètre spécifié.
{#GlideURI_get_S__table_bff_yp3_ks__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom du paramètre. |
[Tableau 5. Paramètres]

{#GlideURI_get_S__table_bff_yp3_ks} {#GlideURI_get_S__table_cff_yp3_ks__entry__2}

| Type | Description |
|-|-|
| Chaîne | La valeur du paramètre spécifié. |
[Tableau 6. Renvoie]

{#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);

Sortie :

    priority=2^active=true

### Équivalent dans le champ d'application {#GlideURI_get_S__section_q2n_wgs_mcb}

Pour utiliser la méthode get() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : [GlideURI - get(Nom de la chaîne)](https://servicenow-prod.fluidtopics.net/BOWKZdsARJ6o8h~0fckOsA#r_ScopedGlideURIGet_String "Renvoie la valeur du paramètre spécifié.") .

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

Renvoie la partie nom de fichier de l'URI.
{#GlideURI_getFileFromPath__table_nzz_gs3_ks__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

{#GlideURI_getFileFromPath__table_nzz_gs3_ks} {#GlideURI_getFileFromPath__table_ozz_gs3_ks__entry__2}

| Type | Description |
|-|-|
| Chaîne | La partie nom de fichier de l'URI. |
[Tableau 8. Renvoie]

{#GlideURI_getFileFromPath__table_ozz_gs3_ks}  

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

### Équivalent dans le champ d'application {#GlideURI_getFileFromPath__section_q2n_wgs_mcb}

Pour utiliser la méthode getFileFromPath() dans une application incluse dans le périmètre, utilisez la méthode correspondante incluse dans le périmètre : [GlideURI - getFileFromPath()](https://servicenow-prod.fluidtopics.net/BOWKZdsARJ6o8h~0fckOsA#r_ScopedGlideURIGetFileFromPath "Renvoie la partie nom de fichier de l’URI.") .

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

Renvoie une carte (paires clé-valeur) contenant chaque paramètre de la requête et sa valeur associée.
{#GlideURI_getMap__table_g2b_b5g_rmb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 9. Paramètres]

{#GlideURI_getMap__table_g2b_b5g_rmb} {#GlideURI_getMap__table_h2b_b5g_rmb__entry__2}

| Type | Description |
|-|-|
| Objet |   |
[Tableau 10. Renvoie]

{#GlideURI_getMap__table_h2b_b5g_rmb}  
L'exemple suivant montre comment obtenir `sysparm_query` paramètres. Voir aussi [Action - getGlideURI()](https://servicenow-prod.fluidtopics.net/f~sYB4w~W7~tPfYN5VSqqQ#Action_getGlideURI "Obtient un objet GlideURI pour déterminer la vue utilisateur.") .

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

### Équivalent dans le champ d'application {#GlideURI_getMap__section_bct_nbs_mcb}

Cette méthode n'est pas disponible dans les applications incluses dans le périmètre.

## GlideURI : set(nom de chaîne, valeur de chaîne) {#ariaid-title7}

Définit le paramètre spécifié sur la valeur spécifiée.
{#GlideURI_set_S_S__table_z2w_tq3_ks__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Nom du paramètre. |
| valide | Chaîne | La valeur. |
[Tableau 11. Paramètres]

{#GlideURI_set_S_S__table_z2w_tq3_ks} {#GlideURI_set_S_S__table_afw_tq3_ks__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 12. Renvoie]

{#GlideURI_set_S_S__table_afw_tq3_ks}  
L'exemple suivant montre comment définir la valeur d'un champ sysparm_query. Voir aussi [Action - getGlideURI()](https://servicenow-prod.fluidtopics.net/f~sYB4w~W7~tPfYN5VSqqQ#Action_getGlideURI "Obtient un objet GlideURI pour déterminer la vue utilisateur.") .

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

Sortie :

    priority=2^active=true

### Équivalent dans le champ d'application {#GlideURI_set_S_S__section_q2n_wgs_mcb}

Pour utiliser la méthode set() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : [GlideURI - set(Nom de la chaîne, Valeur de la chaîne)](https://servicenow-prod.fluidtopics.net/BOWKZdsARJ6o8h~0fckOsA#r_ScopedGlideURISet_String_String "Définit le paramètre spécifié sur la valeur spécifiée.") .

## GlideURI : setView(vue de chaîne) {#ariaid-title8}

Ajoute le sysparm_view paramètre à la requête avec la vue nommée.
Une vue définit les éléments qui s'affichent lorsqu'un utilisateur ouvre un formulaire ou une liste. Le sysparm_view paramètre spécifie la vue à utiliser pour une liste ou un formulaire. Pour plus d'informations sur les vues, reportez-vous à [la rubrique Gestion des vues](https://www.servicenow.com/docs/access?context=view-management-overview&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US).  
Voir aussi :

* [Action : getGlideURI()](https://servicenow-prod.fluidtopics.net/f~sYB4w~W7~tPfYN5VSqqQ#Action_getGlideURI "Obtient un objet GlideURI pour déterminer la vue utilisateur.")
* [GlideModalV3 - switchView()](https://servicenow-prod.fluidtopics.net/a7T_lXmQ9ibLGdFo5BGh8g#r_GMODV3-switchView_S "Changez la vue et rechargez la fenêtre modale.")
{#GlideURI_setView_S__ul_bll_frk_smb}
{#GlideURI_setView_S__table_tgr_g5g_rmb__entry__3}

| Nom | Type | Description |
|-|-|-|
| vue | Chaîne | Nom du sysparm_view paramètre à définir dans la requête URI. |
[Tableau 13. Paramètres]

{#GlideURI_setView_S__table_tgr_g5g_rmb} {#GlideURI_setView_S__table_ugr_g5g_rmb__entry__2}

| Type | Description |
|-|-|
| Aucun |   |
[Tableau 14. Renvoie]

{#GlideURI_setView_S__table_ugr_g5g_rmb}  
L'exemple suivant montre comment ajouter la vue des incidents majeurs à la requête URI dans la table Incidents \[incident\]. Par exemple, `sysparm_view=Major%20Incidents`. Voir aussi [Action - getGlideURI()](https://servicenow-prod.fluidtopics.net/f~sYB4w~W7~tPfYN5VSqqQ#Action_getGlideURI "Obtient un objet GlideURI pour déterminer la vue utilisateur.") .

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

### Équivalent dans le champ d'application {#GlideURI_setView_S__section_bct_nbs_mcb}

Cette méthode n'est pas disponible dans les applications incluses dans le périmètre.

## GlideURI : toString(chemin d'accès de la chaîne) {#ariaid-title9}

Reconstruit la chaîne d'URI et effectue le codage d'URL approprié en convertissant les caractères non valides en leur code d'URL. Par exemple, conversion de \& en '%26'.
Les paramètres définis avec la méthode set() sont également codés avec l'URI.
{#GlideURI_toString_S__table_zjw_4r3_ks__entry__3}

| Nom | Type | Description |
|-|-|-|
| chemin d'accès | Chaîne | Partie de base de l'URL système à laquelle l'URI est ajouté. |
[Tableau 15. Paramètres]

{#GlideURI_toString_S__table_zjw_4r3_ks} {#GlideURI_toString_S__table_akw_4r3_ks__entry__2}

| Type | Description |
|-|-|
| Chaîne | L'URL. |
[Tableau 16. Renvoie]

{#GlideURI_toString_S__table_akw_4r3_ks}  
Les exemples suivants montrent comment convertir des caractères non valides en code URL dans une URL d'instance. Voir aussi [Action - getGlideURI()](https://servicenow-prod.fluidtopics.net/f~sYB4w~W7~tPfYN5VSqqQ#Action_getGlideURI "Obtient un objet GlideURI pour déterminer la vue utilisateur.") .

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

### Équivalent dans le champ d'application {#GlideURI_toString_S__section_q2n_wgs_mcb}

Pour utiliser la méthode toString() dans une application incluse dans le périmètre, utilisez la méthode incluse dans le périmètre correspondante : [GlideURI - toString(Chemin de chaîne)](https://servicenow-prod.fluidtopics.net/BOWKZdsARJ6o8h~0fckOsA#r_ScopedGlideURIToString_String "Reconstruit la chaîne d’URI et effectue le codage d’URL approprié en convertissant les caractères non valides en leur code d’URL. Par exemple, conversion de & en '%26'.") .