Exporter directement à partir d’une URL

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 3 minutes de lecture

    • Exportez dynamiquement des 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 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 colonne ServiceNow pour exporter des données directement à partir de l’URL. Reportez-vous à la section 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 pour les en-têtes, à l’aide de paramètres de requête ou de 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 de pièces jointes ni de champs journalisés. 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 l’icône 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 colonne seulement à l’aide de sysparm_orderby. Pour effectuer un tri sur plusieurs colonnes, utilisez plusieurs entrées de tri par. 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 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 Libre-service (ESS).
      • Par défaut, l’exportation de données à partir 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 la suivante : sysparm_fields=[field1],[field2]. Par exemple :
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_fields=sys_id,number
    8. Facultatif : Exportez 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 pour spécifier une vue autre que celle sysparm_view par défaut.

    Exemples d’URL

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