--- 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 --- # Scripted SOAP Web Services # Scripted SOAP Web Services {#ariaid-title1} * Rversion finale: Xanadu * * Mis à jour 1 août 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture Les services Web SOAP basés sur un script permettent à un administrateur de créer des ServiceNow services Web SOAP personnalisés. Vous pouvez définir des paramètres d'entrée et de sortie pour le service Web SOAP et utiliser JavaScript pour effectuer des opérations. Bien que cette fonctionnalité soit très puissante, utilisez des [services Web directs](https://servicenow-prod.fluidtopics.net/qiseS~nEYS13iBpHwrG22w "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.") ou [des jeux d'importation de services Web SOAP](https://servicenow-prod.fluidtopics.net/JoxqV4Qrn~PL5Cdbfaj1uw "Les jeux d’importation de services Web complètent les services Web directs et les services Web SOAP scriptés en fournissant une interface de service Web pour importer des tables de jeux.") dans la mesure du possible, car ils sont plus simples à implémenter et à gérer. ## Sécurité Les services Web SOAP basés sur un script ont les mêmes options de sécurité de base que tous les services Web SOAP. Pour plus d'informations sur la sécurité des services Web SOAP, reportez-vous à la section [Sécurité des services web SOAP](https://servicenow-prod.fluidtopics.net/6KuA2fyy0y5MKxpkMi7ttA#c_SOAPWebService__SOAP-web-services-security). Lorsqu'une [sécurité stricte](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.") est appliquée sur un système, l'utilisateur authentifié HTTP doit avoir le [rôle soap_script](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.") pour exécuter le service Web scripté. ## WSDL {#c_ScriptedWebServices__section_px4_kjf_f3b} Toutes les ServiceNow tables et tous les jeux d'importation génèrent dynamiquement des documents XML WSDL (Web Service Definition Language) qui décrivent son schéma de table et les opérations disponibles. ## Mise en application de la conformité WSDL {#c_ScriptedWebServices__section_ay4_vff_f3b} Vous pouvez forcer la réponse pour répertorier les valeurs de sortie dans le même ordre que celui défini dans le WSDL. Lorsque vous créez un service web SOAP scripté, le WSDL généré est basé sur les listes connexes Paramètres d'entrée et Paramètres de sortie. La réponse SOAP réelle envoyée par le service scripté est déterminée par le script. Ce comportement peut amener le script à renvoyer les valeurs de sortie dans un ordre différent de celui défini dans le WSDL. Pour appliquer l'ordre des paramètres de sortie tel que défini dans la liste connexe, cochez la case Conformité WSDL . Lorsque cette case est cochée, le service Web réorganise les paramètres renvoyés par le script pour qu'ils correspondent à l'ordre dans WSDL. Remarque : Si des paramètres de réponse supplémentaires sont renvoyés par le script, mais ne sont pas définis dans la liste connexe Paramètres de réponse, ces paramètres sont exclus de la réponse lorsque la conformité WSDL est sélectionnée. {#c_ScriptedWebServices__table_ump_jgf_f3b__entry__2} | Paramètre | Ordre | |-|-| | Param. 1 | 200 | | Param. 2 | 300 | | Paramètre 3 | 100 | [Tableau 1. Liste connexe Paramètres de sortie] {#c_ScriptedWebServices__table_ump_jgf_f3b} Voici le script qui définit les valeurs des paramètres de sortie définis. Notez que dans cet exemple de script, les paramètres sont définis dans un ordre différent de celui défini dans la liste connexe Paramètres de sortie. Notez également le paramètre param4 supplémentaire qui n'est pas défini dans la liste connexe. Response.param1 = 1; Response.param4 = 4; Response.param3 = 3; Lorsque la case à cocher Conformité WSDL est false, la réponse SOAP générée par le script est la suivante : 1 4 3 Lorsque la case à cocher Conformité WSDL est true, la réponse SOAP générée par le script est la suivante : 3 1 ## WSDL statique {#c_ScriptedWebServices__section_yfd_p2f_f3b} Certains clients de service Web nécessitent un accès SOAP à votre instance via un format WSDL spécifique. Ce format requis peut différer du format WSDL standard de ServiceNow. Dans ce cas, vous pouvez créer un WSDL statique correspondant au format requis. ## Variables globales Pour faciliter le traitement personnalisé des demandes SOAP entrantes, les variables globales suivantes sont disponibles dans le contexte du script : * soapRequestDocument : objet Java org.w3c.dom.Document représentant l'enveloppe SOAP entrante. * soapRequestXML : objet de chaîne représentant le XML de l'enveloppe SOAP entrante. * request : objet JavaScript qui contient les valeurs mappées (mappées aux noms de paramètres d'entrée) de l'enveloppe SOAP entrante. * réponse : objet JavaScript qui vous permet de personnaliser les valeurs de réponse. Voir [Personnaliser la réponse](https://servicenow-prod.fluidtopics.net/F8jy10WrBvQchLS~DTtyAA "Suivez cet exemple pour personnaliser et contrôler la charge utile XML d’une réponse SOAP.") {#c_ScriptedWebServices__ul_qxr_xw2_f3b} * **[Créer un service web SOAP scripté](https://servicenow-prod.fluidtopics.net/6g5nUQNtaNapYiiWvJRR7g)** Suivez ces exemples pour créer un service Web SOAP scripté. * **[Personnaliser la réponse](https://servicenow-prod.fluidtopics.net/F8jy10WrBvQchLS~DTtyAA)** Suivez cet exemple pour personnaliser et contrôler la charge utile XML d'une réponse SOAP. * **[Créer un service Web SOAP scripté à l'aide d'un WSDL statique](https://servicenow-prod.fluidtopics.net/5GHN8joH3VSZGavA79pe6Q)** Suivez ces exemples pour créer un service Web SOAP scripté à l'aide d'un WSDL statique.