Exportation et conversion d’enregistrements en types de données complexes

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture

    • Utilisez les paramètres d’URL pour exporter des enregistrements de table et les convertir en types de données complexes, tels que JSON, XML, PDF, CSV et XLS.

    Exportation d’enregistrements en tant que types de données complexes

    Vous pouvez utiliser une demande HTTP GET pour récupérer des enregistrements d’une table et les placer dans un format spécifié. Par exemple, utilisez le PDF paramètre dans une demande GET pour exporter des enregistrements d’une table sous forme de fichiers PDF ; utilisez le XLS paramètre pour exporter des enregistrements à partir d’une table sous forme de fichiers XLS. Par exemple, pour récupérer une liste d’enregistrements d’incidents sous forme de fichiers XLS, émettez un HTTP GET à l’aide de l’URL suivante : https ://instance_name.service-now.com/incident.do ?XLS. Le fichier retourné est incident.xls. incident.do s’agit essentiellement d’un GET qui renvoie une liste des enregistrements de la table d’incidents. Le XLS paramètre convertit ces enregistrements en fichiers XLS.

    La syntaxe générale est la suivante : https://<nom-instance-serviceNow>/<nom-table>.do ?<Paramètre-type-de-données>

    Paramètres d'URL

    Le tableau suivant présente les paramètres d’URL que vous pouvez utiliser dans les demandes GET , les filtres que vous pouvez utiliser pour filtrer les enregistrements de table indésirables dans le retour et un indicateur indiquant si vous pouvez PUBLIER le type de données directement dans une table. Le paramètre devient l’extension du fichier retourné, par exemple, l’utilisation du XLS paramètre renvoie un fichier sous la forme <nom-table>.xls.
    Tableau 1. Paramètres d'URL
    Type de données Paramètre Filtres valides PUBLIER directement sur la table ?
    CSV CSV sysparm_query, sysparm_view Y
    Excel XLS, EXCEL, XLSX sysparm_query, sysparm_view Y
    JSON JSONv2 Divers. Consultez API de récupération de données JSON. Y
    PDF PDF sysparm_query, sysparm_view N
    RSS RSS sysparm_query, sysparm_view et plus encore. Voir Limiter les résultats avec une vue. N
    XML XML, XSD, SCHÉMA sysparm_query, useUnloadFormat N

    Pour plus d’informations sur la récupération et la conversion des enregistrements de table au format de fichier JSON, consultez Service Web JSONv2.

    Pour plus d’informations sur la récupération et la conversion des enregistrements de table au format de fichier RSS, voir Générateur de flux RSS.

    Conversion d’enregistrements en PDF

    Pour l’exportation PDF, il existe une distinction entre le ciblage d’une table et le ciblage de sa liste. Pour générer le PDF d’une liste d’enregistrements, ajoutez un suffixe de _list à la cible. Pour cibler un enregistrement unique, vous devez spécifier le sys_id paramètre permettant d’identifier l’enregistrement pour lequel vous générez le PDF.

    Filtres

    Tous les paramètres d’URL fonctionnent avec des filtres qui vous permettent d’exporter un sous-ensemble d’enregistrements de table. Par exemple, sysparm_query=active=true dans une demande GET exporte uniquement les enregistrements actifs. L’exemple suivant exporte uniquement les enregistrements d’incidents actifs au format Excel : https ://instance_name.service-now.com/incident.do ? EXCEL&sysparm_query=active=true.

    La syntaxe générale est la suivante : https://<nom-instance-serviceNow>/<table_list>.do ?<paramètre-type-données>&<filtre>

    Les filtres comprennent :
    • sysparm_query : filtre les données à l’aide de la requête codée avant d’exporter des fichiers. Par exemple, sysparm_query=active=true exporte uniquement les enregistrements actifs.
    • sysparm_view : spécifiez le nom d’une vue de liste pour contrôler les champs renvoyés. Par exemple, pour renvoyer la vue ESS, utilisez sysparm_view=ess.
    • useUnloadFormat : indique que le format XML renvoyé est un format de déchargement. Le format de déchargement est le même que celui que vous obtenez lorsque, à partir d’une liste dans l’interface utilisateur, vous sélectionnez Exporter > XML > ... Vous pouvez importer des fichiers XML non formatés dans les tables. Pour activer le format de déchargement à partir d’une URL, utilisez le paramètre d’URL useUnloadFormat=true , par exemple, https ://instance_name.service-now.com/incident.do ?XML&useUnloadFormat=true.

    Exemples de requêtes GET

    Tableau 2. Exemples de demandes GET
    Type de données Exemple de requête :
    CSV https://instance_name.service-now.com/incident.do?CSV&sysparm_query=active=true
    Excel https://instance_name.service-now.com/incident.do?XLS&sysparm_query=active=true
    PDF https://instance_name.service-now.com/incident.do?PDF&sysparm_view=ess
    RSS https://instance_name.service-now.com/incident.do?RSS&sysparm_view=ess
    XML https://instance_name.service-now.com/incident.do?XML&sysparm_query=active=true

    Fichiers renvoyés

    Les requêtes GET renvoient des enregistrements d’une table au format spécifié dans la demande. Par exemple, une requête qui utilise ce XLS paramètre renvoie un enregistrement de table dans un fichier avec l’extension .xls .

    L’en-tête Content-Disposition dans la réponse affiche le nom et l’extension du fichier renvoyé. Le nom du fichier est basé sur la table à partir de laquelle vous exportez, par exemple incident.xls, incident.pdf ou incident.xml.

    Exportation de données dans des tables

    Vous pouvez PUBLIER les types de données suivants directement dans les tables :
    • CSV
    • Excel
    • JSON

    Les en-têtes de fichier doivent correspondre aux colonnes de champ de la table ciblée. Pour plus d’informations, consultez Publier des fichiers CSV ou Excel directement dans un jeu d’importation.