Exporter directement à partir d’une URL

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 l’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é a un accès en lecture.

    Pourquoi et quand exécuter cette tâche

    Vous pouvez utiliser des requêtes d’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 table et de ServiceNow colonne pour exporter des données directement à partir de l’URL. Reportez-vous à la rubrique Accéder à un enregistrement ou à un module à l’aide d’une URL.

    Vous pouvez contrôler s’il faut exporter la valeur d’affichage ou la valeur brute des champs, ainsi que l’étiquette ou le nom de champ des en-têtes, à l’aide de paramètres de requête ou de propriétés système.
    • Pour plus d’informations sur l’utilisation des paramètres de requête, reportez-vous à la section .
    • Pour en savoir plus sur l’utilisation des propriétés système, reportez-vous à la section .
    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 la table, le formulaire 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 ni les champs de journal. Pour exporter des pièces jointes et des champs de journal comme les champs Notes de travail ou Commentaires supplémentaires , exportez les enregistrements 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 effectuer un tri sur une seule colonne à l’aide de sysparm_orderby. Pour effectuer un tri sur plusieurs colonnes, utilisez plusieurs entrées de tri. Par exemple :
      sysparm_query=ORDERBYassigned_to^ORDERBYpriority
    6. Facultatif : Exportez les 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 depuis la vue en libre-service (ess).
      • Par défaut, l’exportation des données d’une liste exporte uniquement les champs visibles dans 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. Reportez-vous à la section 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 du sysparm_fields 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 les 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 l’incluez sysparm_view 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 dans 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 dans un fichier texte de valeur séparée 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é à .