--- sourceDocument: Australie : créer des workflows sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/build-workflows Release : - australia ft:locale : - fr-FR ft:publication_title : - Australie : créer des workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Étape SOAP # Étape SOAP {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes de lecture Permettez aux concepteurs d'action d'envoyer des demandes de service Web SOAP sortantes à des systèmes externes. Remarque : Étape SOAP n'est pas disponible dans le système de base et nécessite l'abonnement ServiceNow® Centre d'intégration . Une fois le module d'extension requis activé, l'étape est visible sous Intégrations. ## Rôles et disponibilité {#soap-step-action-designer__section_pq1_5jp_2fb} * Disponible en tant qu'étape d'action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d'action. * Les concepteurs d'action doivent disposer du rôle web_service_admin pour effectuer ces tâches de services Web. * Sélectionner WSDL * Charger le nouveau WSDL * Sélectionner une politique de sécurité WS {#soap-step-action-designer__ul_opp_tyd_ffb} {#soap-step-action-designer__ul_mcq_1c5_kcb} ## Champs {#soap-step-action-designer__section_jwt_gkp_2fb} {#soap-step-action-designer__table_ndq_3kp_2fb__entry__2}{#soap-step-action-designer__xml-stream} | Champ | Description | |-|-| | Détails de la connexion || | Connexion | Le type de connexion à utiliser. * Définir l'inline de la connexion : Définissez les informations de connexion dans l'étape d'action. * Utiliser des alias de connexion : Définissez les informations de connexion à l'aide de la table Alias de connexion. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n'avez pas besoin de mettre à jour votre action personnalisée. {#soap-step-action-designer__ul_mk2_cxz_kbb} Pour en savoir plus sur les connexions et les informations d'identification, consultez [Présentation des informations d'identification, des connexions et des alias](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). | | Alias de connexion | Enregistrement d'alias de connexion et d'informations d'identification que le système utilise pour exécuter l'étape d'action. Les utilisateurs disposant du rôle flow_designer ou admin peuvent créer ou sélectionner un enregistrement de connexion associé. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification et profils d'informations de connexion lors de l'utilisation d'une action dans plusieurs environnements. De même, si les informations de connexion changent, vous n'avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d'identification, consultez [Informations d'identification, connexions et alias](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). La valeur d'informations d'identification s'affiche sous la forme d'une pastille de données de mot de passe (chiffré dans 2 sens) sur le panneau de données. Remarque : Ce champ est disponible lorsque l'option Utiliser l'alias de connexion est sélectionnée dans la liste Connexion. | | Alias d'informations d'identification | Alias d'informations d'identification que le système utilise pour exécuter l'étape d'action. Les utilisateurs disposant du rôle flow_designer ou admin peuvent créer ou sélectionner un enregistrement de connexion associé. L'utilisation d'un alias élimine la nécessité de configurer plusieurs informations d'identification lors de l'utilisation d'une action dans plusieurs environnements. De même, si les informations d'identification changent, vous n'avez pas besoin de mettre à jour votre action personnalisée. Pour en savoir plus sur les connexions et les informations d'identification, consultez [Informations d'identification, connexions et alias](https://www.servicenow.com/docs/access?context=credentials-connections-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). La valeur d'informations d'identification s'affiche sous la forme d'une pastille de données de mot de passe (chiffré dans 2 sens) sur le panneau de données. Remarque : Ce champ est disponible lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion. | | Utiliser MID | Option permettant d'utiliser un Serveur MID pour exécuter le Étape SOAP fichier . Cochez cette case pour afficher les champs Sélection MID, Application MID et Options . Remarque : Ce champ est disponible lorsque l'option Utiliser l'alias de connexion est sélectionnée dans la liste Connexion. | | Point de terminaison | Point de terminaison de l'URL de la demande SOAP. Si l'option Utiliser des alias de connexion est sélectionnée, ce champ est en lecture seule et affiche l'URL du point de terminaison associée à l'alias. Si l'option Définir l'inline de la connexion est sélectionnée, entrez une URL de point de terminaison pour la connexion. | | Tester l'étape SOAP | Bouton permettant de tester l'étape SOAP. Pour tester, sélectionnez le bouton Tester l'étape SOAP . Saisissez les valeurs d'entrée requises et sélectionnez le bouton Exécuter le test . Une fois le test exécuté, les sorties d'étape ou les messages d'erreur s'affichent dans la section Résultats des tests de la fenêtre de test. | | Délai de connexion | Nombre de millisecondes pendant lesquelles le système attend une connexion réussie de l'hôte. Si l'étape n'établit pas de connexion réussie pendant ce temps, la demande de connexion expire. Si l'option Définir l'inline de la connexion est sélectionnée, entrez une valeur de délai d'expiration pour la connexion. Laissez ce champ vide pour utiliser la valeur de délai de connexion par défaut du système. Remarque : Évitez de définir la valeur du délai de connexion sur zéro, car cela pourrait entraîner l'expiration de la connexion. | | Sélection de MID | Option permettant de sélectionner un serveur MID ou une grappe MID spécifique. Choisissez l'une des options suivantes. * Sélection automatique d'un serveur MID : votre ServiceNow instance sélectionne l'sans Serveur MID entrée manuelle. * Serveur MID spécifique : votre ServiceNow instance utilise ce Serveur MID que vous spécifiez. * Grappe MID spécifique : votre ServiceNow instance utilise la grappe MID que vous spécifiez. Une grappe MID est un groupe de serveurs MID qui permet à votre ServiceNow instance de gérer plusieurs intégrations et d'améliorer la vitesse d'intégration. Pour plus d'informations, consultez [Configure a MID Server cluster](https://www.servicenow.com/docs/access?context=t_ConfigureAMIDServerCluster&version=australia&pubname=australia-servicenow-platform&ft:locale=en-US). {#soap-step-action-designer__ul_hqv_ddb_htb} Ce champ est disponible lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion et que l'option Utiliser MID est cochée. | | Grappe MID | Pastille de données pour la grappe MID que vous souhaitez utiliser. Ce champ est disponible lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion, que l'option Utiliser MID est cochée et que la grappe MID spécifique est sélectionnée dans la liste de sélection MID. | | Détails de la demande || | Enveloppe de version | La méthode à utiliser lors de la construction de l'enveloppe SOAP. * À partir de WSDL : sélectionnez cette option pour afficher les champs Sélectionner un WSDL et Opération . * Manuellement : sélectionnez cette option pour saisir ou coller manuellement du texte WSDL. {#soap-step-action-designer__ul_t13_slp_2fb} | | Sélectionner un WSDL | WSDL à utiliser pour construire l'enveloppe SOAP. Sélectionnez un enregistrement WSDL existant ou cliquez sur Charger le nouveau WSDL pour télécharger ou saisir manuellement un fichier WSDL. Le WSDL sélectionné renseigne les valeurs des champs Opération, Action SOAP et Enveloppe SOAP . Remarque : Ce champ est disponible lorsque vous sélectionnez À partir de WSDL dans la liste Enveloppe de version. | | Charger le nouveau WSDL | Option pour télécharger ou entrer manuellement un fichier WSDL. | | Opération | Opération à exécuter à partir du WSDL sélectionné. Chaque WSDL a sa propre liste d'opérations disponibles. | | SOAP Action | URL pour exécuter l'action SOAP. Si l'enveloppe de version est définie sur À partir de WSDL, ce champ est en lecture seule et affiche l'URL pour exécuter l'action SOAP. Si Enveloppe de version est définie sur Manuellement, entrez une URL pour exécuter l'action SOAP. | | Type de demande | Format de la demande. Les options comprennent. * Texte : demande au format JSON, XML ou autre format texte. * Binaire : demande au format de fichier binaire. {#soap-step-action-designer__ul_bnh_b4q_nlb} | | Enveloppe SOAP | Texte XML envoyé au point de terminaison. Si l'option Enveloppe de version est définie sur À partir de WSDL, le système ajoute le code XML nécessaire pour l'opération que vous sélectionnez. Si Enveloppe de version est définie sur Manuellement, saisissez le texte XML que vous souhaitez utiliser. Entrez les valeurs d'enregistrement dans les éléments d'enveloppe SOAP appropriés. Par exemple, saisissez une brève description d'incident dans l'élément `` . Remarque : Ce champ est disponible lorsque le Type de demande est Texte. | | Pièce jointe | Enregistrement de pièce jointe contenant la demande. Vous pouvez rechercher ou créer cet enregistrement à une étape antérieure et le définir comme variable d'entrée. Créez-le à l'aide des API [JSONStreamingBuilder](https://www.servicenow.com/docs/access?context=JSONStreamingBuilderScopedAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US) et [XMLStreamingBuilder](https://www.servicenow.com/docs/access?context=XMLStreamingBuilderScopedAPI&version=australia&pubname=australia-api-reference&ft:locale=en-US) à l'étape Script. Remarque : Ce champ est disponible lorsque le Type de demande est Binaire. | | Enveloppe de réinitialisation | Option permettant d'annuler tous les changements manuels que vous avez apportés à l'enveloppe SOAP. Cochez cette case pour rétablir l'état initial de l'enveloppe SOAP. Remarque : Ce champ est disponible lorsque vous sélectionnez À partir de WSDL dans la liste Enveloppe de version. | | Nouveau WSDL || | Nom | Nom de l'enregistrement WSDL que vous souhaitez créer. | | Méthode d'importation | La méthode pour entrer WSDL. * Télécharger à partir de l'URL : sélectionnez cette option pour afficher les champs URL WSDL, Nom d'utilisateur et Mot de passe afin de récupérer le WSDL à partir d'une source externe, généralement le fournisseur de services Web. * Renseigner manuellement le contenu WSDL : sélectionnez cette option pour afficher le champ Contenu WSDL afin de saisir ou coller manuellement du texte WSDL. {#soap-step-action-designer__ul_z32_xsp_2fb} | | URL WSDL | L'URL du service Web SOAP. Remarque : Ce champ est disponible lorsque vous sélectionnez Télécharger à partir de l'URL dans la liste Méthode d'importation. | | Nom d'utilisateur | Nom d'utilisateur à authentifier auprès du service web SOAP. Remarque : Ce champ est disponible lorsque vous sélectionnez Télécharger à partir de l'URL dans la liste Méthode d'importation. | | Mot de passe | Mot de passe à authentifier auprès du service Web SOAP. Le système masque toujours les mots de passe dans l'interface utilisateur et empêche leur exportation sous forme de texte brut. Remarque : Ce champ est disponible lorsque vous sélectionnez Télécharger à partir de l'URL dans la liste Méthode d'importation. | | Contenu WSDL | Document XML décrivant le service Web SOAP et ses opérations. Remarque : Ce champ est disponible lorsque vous sélectionnez Renseigner manuellement le contenu WSDL dans la liste Méthode d'importation. | | Importer | Option permettant d'ajouter le WSDL de service web SOAP à l'instance. | | Utiliser pour la sécurité WS || | Activer la politique de sécurité WS | Option permettant de restreindre le service web SOAP à une politique de sécurité. Cochez cette case pour afficher le champ Politique . | | Politique | L'enregistrement de politique que vous souhaitez utiliser pour restreindre les connexions au service web. Sélectionnez un enregistrement de politique existant. | | Politique des nouveaux essais || | Activer la politique des nouveaux essais | Option permettant d'activer la politique des nouveaux essais. Pour plus d'informations, consultez [la section Politique des nouveaux essais](https://servicenow-prod.fluidtopics.net/7I_OPI2yPzUHNulHjZqZKg#retry-policy "Réessayez automatiquement les demandes ayant échoué lorsqu’une étape rencontre un problème intermittent tel qu’une défaillance du réseau ou une limite de taux de demande. Définissez une politique de nouvelle tentative pour éviter d’avoir à déclencher manuellement l’étape à nouveau."). | | Remplacer la politique des nouveaux essais pour l'alias | Option permettant de remplacer la politique des nouveaux essais par défaut. Cette case à cocher ne s'applique pas lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion. | | Politique des nouveaux essais | Politique de nouvelle tentative par défaut associée à l'alias de connexion. Si l'option Remplacer la politique des nouveaux essais pour l'alias est sélectionnée, vous pouvez remplacer la politique des nouveaux essais par défaut et sélectionner une autre politique existante en fonction de vos besoins. | | Options avancées || | En-têtes | Paires nom-valeur à inclure dans le message SOAP en tant qu'en-têtes HTTP. Utilisez l'icône plus pour ajouter des en-têtes. Ajoutez un nom et une valeur pour chaque en-tête HTTP. | | En-têtesOmettre si vide | Option permettant d'exclure un en-tête si la valeur est vide ou nulle. Remarque : Cette case à cocher est disponible après avoir cliqué sur la flèche vers le bas pour afficher les options avancées. | [ ] {#soap-step-action-designer__table_ndq_3kp_2fb} ## Évaluation des erreurs d'action {#soap-step-action-designer__id_lg2_4s3_15b} En cas d'échec de cette étape : Type de données : Choice Option permettant de continuer à exécuter l'étape suivante ou d'accéder à l'évaluation des erreurs. Pour utiliser le code d'état d'étape ou le message pour une condition d'erreur d'action personnalisée, reportez-vous à la section [Évaluation des erreurs d'action](https://servicenow-prod.fluidtopics.net/P9G3fb5Smq62oYvl5p06lg "Activez les actions pour intercepter les défaillances d’étapes et continuer l’exécution. Identifiez quand des conditions d’erreur spécifiques se produisent et renvoyez votre propre code de statut de l’action, message d’état et état d’erreur."). ## Limite de taille de la réponse SOAP {#soap-step-action-designer__section_ymk_5lq_2fb} Le système limite la taille des réponses SOAP à 5 Mo. Les réponses SOAP directes qui dépassent cette limite génèrent une erreur. Pour prendre en charge des réponses de plus grande taille, augmentez la limite de taille de réponse avec la glide.pf.soap.response_payload_max_size propriété système. Cette propriété système prend en charge une valeur maximale de 10 Mo.