---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Fonctions de l'API du service Web direct SOAP

# Fonctions de l'API du service Web direct SOAP {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'API SOAP standard est un ensemble de petites fonctions définies globalement qui peuvent être exécutées sur une ressource ciblée.
La ressource (ou la table) ciblée est définie dans l'URL au format `https://<nom d'instance>.service-now.com/<table name>.do`.
{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb__entry__2}

| Résumé de la méthode | Description |
|-|-|
| [insérer](https://servicenow-prod.fluidtopics.net/OkyIUk8nqyFAuRgpSLYqaw "Crée un nouvel enregistrement pour la table ciblée dans l’URL.") | Crée un nouvel enregistrement pour la table ciblée dans l'URL. |
| [insérerMultiple](https://servicenow-prod.fluidtopics.net/Ew1sQiEu1YzgMZFbA9NOPQ "Crée plusieurs enregistrements pour la table ciblée dans l’URL.") | Crée plusieurs enregistrements pour la table ciblée dans l'URL. Pour activer plusieurs insertions, activez les [jeux d'importation de services Web](https://www.servicenow.com/docs/access?context=c_WebServiceImportSets&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US). |
| [mettre à jour](https://servicenow-prod.fluidtopics.net/qADqvdfBNcxngaUCrb5S_Q "Met à jour un enregistrement existant dans la table ciblée dans l’URL, identifié par le champ sys_id obligatoire.") | Met à jour un enregistrement existant dans la table ciblée dans l'URL, identifié par le champ sys_id obligatoire. |
| [deleteRecord](https://servicenow-prod.fluidtopics.net/PgFrXPSYuL0zrDeouS09Fg "Supprimez un enregistrement de la table ciblée en fournissant son sys_id.") | Supprime un enregistrement de la table ciblée en fournissant son `sys_id`. |
| [deleteMultiple](https://servicenow-prod.fluidtopics.net/RWY_CgJtToiQYH7eusWlJw "Supprimez plusieurs enregistrements de la table ciblée par exemples de valeurs.") | Supprimez plusieurs enregistrements de la table ciblée par exemples de valeurs. |
[Tableau 1. API de modification des données]

{#r_DirectWebServiceAPIFunctions__id_brv_hgt_3xb} {#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb__entry__2}

| Résumé de la méthode | Description |
|-|-|
| [getKeys (en anglais)](https://servicenow-prod.fluidtopics.net/WOe74JJVLAGYV0VnlxZSkQ "Interrogez la table ciblée par exemples de valeurs et renvoyez une liste de sys_id séparés par des virgules.") | Interrogez la table ciblée par exemples de valeurs et renvoyez une liste `de sys_id` séparés par des virgules. |
| [getRecords](https://servicenow-prod.fluidtopics.net/EeTG67u9iTz6mPWPoGoYhw "Interrogez la table ciblée par des exemples de valeurs et renvoyez tous les enregistrements correspondants et leurs champs.") | Interrogez la table ciblée par des exemples de valeurs et renvoyez tous les enregistrements correspondants et leurs champs. |
| obtenir | Interrogez un enregistrement unique de la table ciblée par `sys_id` et renvoyez l'enregistrement et ses champs. |
| [agrégat](https://servicenow-prod.fluidtopics.net/P3YdKJZrV8b2ZYMxMRllmA "Interrogez une table à l’aide d’une fonction d’agrégat incluant SUM, COUNT, MIN, MAX, LAST et AVG.") | Interroger les fonctions d'agrégat SUM, COUNT MIN, MAX, LAST et AVG. Pour activer les fonctions d'agrégation, activez le module d'extension Agrégat Web Service. |
[Tableau 2. API de récupération de données]

{#r_DirectWebServiceAPIFunctions__id_wz4_3gt_3xb}
* **[API de récupération de données](https://servicenow-prod.fluidtopics.net/883ab7zFdZDM~bQI64XKRw)**   
  Résumés et descriptions de la méthode de l'API de récupération de données.
* **[API de modification des données](https://servicenow-prod.fluidtopics.net/Z8fynqQwkGXwh~D4aS9AEg)**   
  Résumés et descriptions des méthodes de l'API de modification des données.

**Concepts associés**   

* [Utiliser des formulaires pour limiter ou étendre la réponse à la requête](https://servicenow-prod.fluidtopics.net/bx8LaYEEfyKSW8SC5G39xw "Parfois, il est nécessaire de limiter le nombre de valeurs de champ renvoyées par une requête SOAP.")
* [Renvoyer la valeur d'affichage pour les variables de référence](https://servicenow-prod.fluidtopics.net/4BthMZHZkq1CkQXWLhyzcw "Lorsque vous interrogez un enregistrement à l’aide d’une get fonction ou getRecords , l’instance renvoie tous les champs associés à cet enregistrement. Les champs sont souvent des champs de référence qui contiennent un sys_id pour un enregistrement sur une autre table.")
* [Effacer les valeurs d'une instance cible](https://servicenow-prod.fluidtopics.net/F9H3b8A9mO85TaoEIB20tg "Vous pouvez transmettre une valeur vide via un paramètre SOAP pour effacer la valeur respective dans l’instance cible.")
* [Récupérer des entrées de journal à l'aide de services Web directs](https://servicenow-prod.fluidtopics.net/B_4pB2~gPirlPl3tUNNKYA "Pour obtenir le contenu d’un champ journal, effectuez une deuxième requête SOAP sur la table sys_journal_field pour récupérer les enregistrements de journal appropriés pour l’enregistrement en question.")
* [Récupérer les champs de choix à l'aide de services Web directs](https://servicenow-prod.fluidtopics.net/tIRkJCbhtET_FuoPazvhSQ "Pour récupérer ou définir des champs de choix, utilisez la valeur de choix et non l’étiquette.")
* [Conserver une session HTTP sur tous les appels SOAP](https://servicenow-prod.fluidtopics.net/hFazUFd0q43IlD9_zYnW7g "Dans les cas où un client SOAP effectue de nombreux appels dans un court laps de temps, vous pouvez réutiliser une seule session HTTP pour tous les appels SOAP.")