Exporter directement à partir d’une URL

Rversion finale: Yokohama

Mis à jour 30 janv. 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.

Pour plus d’informations sur l’utilisation des paramètres de requête, reportez-vous à la section Query parameters for display value and header.
Pour plus d’informations sur l’utilisation des propriétés système, reportez-vous à la section System properties for display value and header.

Les paramètres de requête, s’ils sont présents, remplacent les propriétés système.

Procédure

Spécifiez l’URL de l’instance.
Par exemple :
```
https://<instance name>.service-now.com/
```
Spécifiez le formulaire de table ou la liste à exporter.
Par exemple :
```
incident_list.do
```
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.
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.
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
```
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.
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
```
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é à .