GlideURI : global

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 :

    Voir aussi Action - getGlideURI().

    GlideURI : deleteMatchingParameter(correspondance de chaîne)

    Supprime un ou plusieurs paramètres de l’URI qui correspondent au début de la chaîne fournie.

    Tableau 1. Paramètres
    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 2. Renvoie
    Type Description
    Aucun

    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

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

    GlideURI : deleteParameter(nom de chaîne)

    Supprime un paramètre spécifié de la partie requête de l’URI.

    Tableau 3. Paramètres
    Nom Type Description
    nom Chaîne Nom du paramètre à supprimer de la partie requête d’un URI.
    Tableau 4. Renvoie
    Type Description
    Aucun

    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

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

    GlideURI : obtenir (nom de chaîne)

    Renvoie la valeur du paramètre spécifié.

    Tableau 5. Paramètres
    Nom Type Description
    nom Chaîne Nom du paramètre.
    Tableau 6. Renvoie
    Type Description
    Chaîne La valeur du paramètre spécifié. 
    // 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

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

    GlideURI : getFileFromPath()

    Renvoie la partie nom de fichier de l’URI.

    Tableau 7. Paramètres
    Nom Type Description
    Aucun
    Tableau 8. Renvoie
    Type Description
    Chaîne La partie nom de fichier de l’URI. 
    var gURI = action.getGlideURI();
        
var fileString = gURI.getFileFromPath();
gs.info(fileString);

    Équivalent dans le champ d’application

    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() .

    GlideURI : getMap()

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

    Tableau 9. Paramètres
    Nom Type Description
    Aucun
    Tableau 10. Renvoie
    Type Description
    Objet

    L’exemple suivant montre comment obtenir sysparm_query paramètres. Voir aussi Action - getGlideURI() .

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

    Équivalent dans le champ d’application

    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)

    Définit le paramètre spécifié sur la valeur spécifiée.

    Tableau 11. Paramètres
    Nom Type Description
    nom Chaîne Nom du paramètre.
    valide Chaîne La valeur.
    Tableau 12. Renvoie
    Type Description
    Aucun

    L’exemple suivant montre comment définir la valeur d’un champ sysparm_query. Voir aussi Action - getGlideURI() .

    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

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

    GlideURI : setView(vue de chaîne)

    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.

    Voir aussi :
    Tableau 13. Paramètres
    Nom Type Description
    vue Chaîne Nom du sysparm_view paramètre à définir dans la requête URI.
    Tableau 14. Renvoie
    Type Description
    Aucun

    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() .

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

    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)

    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.

    Tableau 15. Paramètres
    Nom Type Description
    chemin d'accès Chaîne Partie de base de l’URL système à laquelle l’URI est ajouté.
    Tableau 16. Renvoie
    Type Description
    Chaîne L’URL.

    Les exemples suivants montrent comment convertir des caractères non valides en code URL dans une URL d’instance. Voir aussi Action - getGlideURI() .

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

    Équivalent dans le champ d’application

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