---
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


---

# Services Web directs

# Services Web directs {#ariaid-title1}

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

Un service Web direct est disponible pour n'importe quelle table du système si la liste de contrôle d'accès correcte est configurée.

Le format pris en charge pour le message entrant est les documents SOAP XML littéraux de style document (Document/Literal). Pour récupérer une description WSDL de service Web direct et un schéma XML, pointez vers l'URL relative \<nomtable\>.do ? WSDL. Par exemple, pour récupérer le WSDL pour la table Incident sur le système de démonstration en ligne, utilisez l'URL suivante : https://\<nom d'instance\>.service-now.com/incident.do?WSDL.

## Paramètres de requêtes étendues {#c_DirectWebServices__section_nj5_kfy_23b}

Les paramètres de requête étendus vous permettent de filtrer et de modifier les résultats renvoyés d'une requête SOAP lors de l'utilisation des fonctions get, getKeys et getRecords .  
Remarque :  
Les noms d'éléments de requête étendue sont précédés de deux traits de soulignement.
{#c_DirectWebServices__table_xwm_4fy_23b__entry__3}

| Paramètre | Description | Exemple |
|-|-|-|
| __encoded_query | Spécifiez une chaîne de requête codée à utiliser pour filtrer les résultats renvoyés. Le format de la chaîne de requête codée est similaire à la valeur qui peut être spécifiée dans un paramètre d'URL `sysparm_query` . Voir l'exemple de création de requêtes codées dans les exemples de générateurs de flux RSS. | `<__encoded_query>active=true^category='hardware'</__encoded_query>` |
| __order_by | Demander que les résultats renvoyés soient triés par le champ spécifié. | `<__order_by>priority</__order_by>` |
| __order_by_desc | Indiquez que les résultats renvoyés doivent être triés par le champ spécifié, dans l'ordre décroissant. | `<__order_by_desc>opened_date</__order_by_desc>` |
| __exclude_columns | Spécifiez une liste de noms de champs séparés par des virgules à exclure de l'ensemble de résultats. | `<__exclude_columns>sys_created_on,sys_created_by,caller_id,priority</__exclude_columns>` |
| __limite | Limitez le nombre d'enregistrements renvoyés. | `<__limit>100</__limit>` |
| __first_row | Indiquez que les résultats soient décalés de ce nombre d'enregistrements depuis le début de l'ensemble. Lorsqu'il est utilisé avec `__last_row` a pour effet d'interroger une fenêtre de résultats. Les résultats incluent le numéro de la première ligne. | `250 <__first_row></__first_row>` |
| __last_row | Indiquez que les résultats soient limités par ce nombre d'enregistrements depuis le début de l'ensemble, ou par la valeur `__start_row` lorsqu'elle est spécifiée. Lorsqu'il est utilisé avec `__first_row` a pour effet d'interroger une fenêtre de résultats. Les résultats sont inférieurs au numéro de la dernière ligne et n'incluent pas la dernière ligne. | `500 <__last_row></__last_row>` |
| __use_view | Spécifiez une vue de formulaire par nom, à utiliser pour limiter et développer les résultats renvoyés. Lorsque la vue de formulaire contient des champs référencés en profondeur tels que caller_id.email, ce champ est également renvoyé dans les résultats. | `<__use_view>soap_view</__use_view>` |
[Tableau 1. Paramètres de requêtes étendues disponibles]

{#c_DirectWebServices__table_xwm_4fy_23b}

## Espace de noms des services Web directs {#c_DirectWebServices__section_lc1_lgy_23b}

## Spécification d'un espace de noms unique pour chaque table {#c_DirectWebServices__section_hb2_kgy_23b}

La glide.wsdl.definition.use_unique_namespace propriété garantit que le WSDL de service Web direct de chaque table possède un attribut unique targetNamespace . Cette propriété est vraie par défaut, ce qui nécessite que le WSDL de service Web direct d'une table utilise une targetNamespace valeur de http://www.service-now.com/\<table name\>. Lorsque la valeur est false (ou lorsque la propriété n'est pas présente), toutes les tables utilisent la même targetNamespace valeur de http://www.service-now.com. Étant donné que toutes les tables partagent les mêmes noms d'opération, un client de service Web tentant d'utiliser plus d'un ServiceNow service Web ne serait pas en mesure de différencier les demandes entre plusieurs tables. L'utilisation d'une valeur unique targetNamespace permet aux clients de service Web de distinguer les demandes entre plusieurs tables.

Par exemple, le WSDL du service Web direct pour la table Incident utilise la valeur suivante targetNamepsace :

    <wsdl:definitions xmlns:soapenc= "http://schemas.xmlsoap.org/soap/encoding/"xmlns:wsdl = "http://schemas.xmlsoap.org/wsdl/"xmlns:http = "http://schemas.xmlsoap.org/wsdl/http/"xmlns:tns = "http://www.service-now.com/incident"xmlns:xsd = "http://www.w3.org/2001/XMLSchema"xmlns:mime = "http://schemas.xmlsoap.org/wsdl/mime/"xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"targetNamespace = "http://www.service-now.com/incident" ><wsdl:types><xsd:schema elementFormDefault = "unqualified"targetNamespace = "http://www.service-now.com/incident" >

## Définition des besoins en matière d'espace de noms {#c_DirectWebServices__section_yvp_mgy_23b}

Par défaut, le schéma WSDL de ServiceNow déclare un attribut de elementFormDefault="unqualified". Cet attribut indique si les éléments déclarés localement doivent être qualifiés par le dans un document d'instance targetNamepsace . Si la valeur de cet attribut n'est pas qualifiée, les éléments déclarés localement ne doivent pas être qualifiés par le targetNamepsace. Si la valeur de cet attribut est qualifiée, les éléments déclarés localement doivent être qualifiés par le targetNamepsace.

Cependant, cela est incompatible avec la façon dont les clients générés à partir de WSDL (par exemple, .NET, Axis2, webMethods) traitent le schéma intégré. En conséquence, il supprime l'espace de noms du schéma, ce qui rend la réponse de service Web non analysable.

Pour surmonter ce problème de compatibilité, une propriété booléenne appelée glide.wsdl.schema.UnqualifiedElementFormDefault est introduite. Par défaut, cette propriété a la valeur vrai . Le définir sur faux permet aux clients générés à partir de WSDL d'analyser la valeur de retour de l'invocation de service Web. Vous pouvez modifier cette propriété à l'aide de la page des propriétés des services Web à l'adresse Propriétés systèmeServices web.

## Autoriser les noms de services en double {#c_DirectWebServices__section_ytf_qjv_bdb}

Par défaut, les noms de service provenant de WSDL générés dynamiquement sont uniques et ont le format suivant :

    ServiceNow_<table name>

Pour autoriser les noms de service en double, les administrateurs peuvent définir la glide.wsdl.unique_service_name propriété sur false. Créez la propriété si elle n'existe pas.
* **[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.
* **[Fonctions de l'API du service Web direct SOAP](https://servicenow-prod.fluidtopics.net/iFv41cdCZNozKTdV6e2UlA)**   
  L'API SOAP standard est un ensemble de petites fonctions définies globalement qui peuvent être exécutées sur une ressource ciblée.

**Concepts associés**   

* [SOAP Web Service](https://servicenow-prod.fluidtopics.net/6KuA2fyy0y5MKxpkMi7ttA "Le SOAP (Simple Object Access Protocol) est un protocole basé sur XML pour accéder aux services Web sur HTTP.")