Exporter directement à partir d’une URL

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Exportez dynamiquement les données à partir d’un script ou d’un service Web en créant une requête d’URL.

    Avant de commencer

    Rôle requis : aucun

    Remarque :
    ServiceNow applique une authentification de base pour un accès direct à l’URL. Les données extraites de l’URL contiennent uniquement les champs auxquels l’utilisateur actuellement authentifié dispose d’un accès en lecture.

    Pourquoi et quand exécuter cette tâche

    Vous pouvez utiliser des requêtes URL pour générer des listes filtrées d’enregistrements par programmation avant de les exporter. Les requêtes d’URL sont utiles pour les scripts qui génèrent une liste d’enregistrements ou lorsqu’aucun utilisateur ne peut ajouter manuellement le filtre à partir de l’interface utilisateur.

    Vous devez connaître les noms de tables et de ServiceNow colonnes pour exporter des données directement à partir de l’URL. Voir Accéder à un enregistrement ou à un module à l’aide d’une URL.

    Vous pouvez contrôler l’exportation de la valeur d’affichage ou de la valeur brute des champs et de l’étiquette ou du nom de champ pour les en-têtes à l’aide des paramètres de requête ou des propriétés système. Les paramètres de requête, s’ils sont présents, remplacent les propriétés système.

    Procédure

    1. Spécifiez l’URL de l’instance.
      Par exemple :
      https://<instance name>.service-now.com/
    2. Spécifiez le formulaire de table ou la liste à exporter.
      Par exemple :
      incident_list.do
    3. Spécifiez le processeur de format d’exportation à utiliser pour l’exportation.
      Vous pouvez spécifier CSV, XLS, JSON, XLSX ou XML. Par exemple :
      ?CSV
      Remarque :
      Le processeur XML d’une exportation d’URL n’exporte pas les pièces jointes ou les champs de journal. Pour exporter des pièces jointes et des champs de journal tels que les champs Notes de travail ou Commentaires supplémentaires , exportez les enregistrements à partir d’une liste à l’aide de la commande Exporter > XML dans le menu contextuel.
    4. Facultatif : Interrogez des enregistrements spécifiques en ajoutant le sysparm_query paramètre.
      La syntaxe requise est sysparm_query=[nom de colonne][opérateur][valeur]. Par exemple :
      https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1
      Remarque :
      Toutes les requêtes utilisent un nom de colonne, un opérateur et une valeur. Consultez Créateur de conditions pour obtenir la liste des opérateurs disponibles.
    5. Facultatif : Triez les enregistrements par nom de colonne à l’aide du sysparm_orderby paramètre.
      La syntaxe requise est sysparm_orderby=[nom de colonne]. Par exemple :
      https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to
      Remarque :
      Vous pouvez trier par une seule colonne à l’aide sysparm_orderbyde . Pour trier par plusieurs colonnes, utilisez plusieurs entrées de tri. Par exemple :
      sysparm_query=ORDERBYassigned_to^ORDERBYpriority
    6. Facultatif : Exportez des champs à partir d’une vue spécifique à l’aide du sysparm_view paramètre.
      La syntaxe requise est sysparm_view=[nom de la vue]. Par exemple :
      https://<instance name>.service-now.com/incident.do?CSV&sysparm_view=ess
      Cette URL exporte les champs d’incident visibles à partir de la vue Libre-service (ESS).
      • Par défaut, l’exportation des données d’une liste exporte uniquement les champs visibles à partir de la vue actuelle. Si vous souhaitez exporter des champs à partir d’une autre vue de liste, vous pouvez changer de vue à partir de l’interface utilisateur. Voir Gestion des vues.
      • Si vous exportez des données CSV ou Excel et que vous ne spécifiez pas de vue, l’exportation utilise la vue de liste par défaut.
      • Si vous exportez des données XML, tous les champs sont exportés par défaut, sauf si vous spécifiez une vue particulière.
    7. Facultatif : Exportez des champs spécifiques de la table à l’aide sysparm_fields du paramètre.
      La syntaxe requise est sysparm_fields=[field1],[field2]. Par exemple :
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_fields=sys_id,number
    8. Facultatif : Exporter tous les champs de la table, y compris le sys_id, à l’aide du sysparm_default_export_fields paramètre.
      La syntaxe requise est sysparm_default_export_fields=all. Par exemple :
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_default_export_fields=all
      Le sysparm_default_export_fields paramètre n’a aucun effet sur les exportations XML, sauf si vous incluez le sysparm_view paramètre pour spécifier une vue autre que celle par défaut.

    Exemples d’URL

    URL Description
    https://<nom d’instance>.service-now.com/incident_list.do?CSV Exporter tous les incidents vers un fichier texte de valeur séparée par des virgules.
    https://<nom d’instance>.service-now.com/incident_list.do?CSV&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27 Exporter un incident particulier vers un fichier texte de valeur séparée par des virgules.
    https://<nom d’instance>.service-now.com/incident_list.do?CSV&sysparm_orderby=sys_id Exportez tous les incidents vers un fichier texte séparé par des virgules et triez la liste par sys_id.
    https://<nom d’instance>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to Exporter une liste de tous les incidents de priorité 1 vers un fichier XML et trier la liste par champ Affecté à .