--- 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 REST # Étape REST {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 14 minutes de lecture Envoyez une demande de service Web REST sortante à un système externe. Remarque : Étape REST 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. [Le service Web REST sortant](https://www.servicenow.com/docs/access?context=c_OutboundRESTWebService&version=australia&pubname=australia-api-reference&ft:locale=en-US) est une fonctionnalité de plateforme qui vous permet de récupérer, de créer, de mettre à jour ou de supprimer des données sur un serveur de services Web qui prend en charge l'architecture REST. ## Rôles et disponibilité {#rest-request-action-designer__section_pwq_rb5_kcb} 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. ## Champs {#rest-request-action-designer__section_cbz_tj5_kcb} {#rest-request-action-designer__table_p4n_cht_3cb__entry__2}{#rest-request-action-designer__xml-stream} | Champ | Description | |-|-| | Connexion | 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. {#rest-request-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 ServiceNow® Serveur MID pour exécuter le Étape REST fichier . Cochez cette case pour afficher les champs Application MID et Options . Remarque : Le système ne consigne pas les données d'exécution des demandes, des réponses et des paramètres REST envoyées via un serveur MID de la même manière que la [journalisation des services Web sortants](https://www.servicenow.com/docs/access?context=outbound-request-logging&version=australia&pubname=australia-api-reference&ft:locale=en-US) . Au lieu de cela, vous pouvez afficher ces données dans les [détails d'exécution du flux](https://servicenow-prod.fluidtopics.net/8yVtC4PGUuvgt_jU4l26og "Affichez les informations d’exécution d’une action ou d’un flux directement à partir de l’environnement de conception, telles que l’état actuel, les éléments exécutés et les valeurs produites. Ouvrez les enregistrements connexes à partir d’éditeurs intégrés ServiceNow AI Platform ou dans un nouvel onglet."). | | URL de base | URL de base de la demande REST. * Si l'option Utiliser des alias de connexion est sélectionnée, ce champ affiche l'URL de base associée à l'alias. Vous pouvez remplacer l'URL de base en cliquant sur l'icône de ![verrouillage ( icône de verrouillage]()) et en saisissant la vôtre. * Si l'option Définir l'inline de la connexion est sélectionnée, entrez une URL de base pour la connexion. {#rest-request-action-designer__ul_rrb_1zg_htb} | | Tester l'étape REST | Bouton permettant de tester l'étape REST. Pour tester, sélectionnez le bouton Tester l'étape REST . 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). {#rest-request-action-designer__ul_zdy_2cb_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. | | Application MID | Les capacités doivent être prises en charge pour être éligibles à la Serveur MID sélection. Le système exécute l'étape d'action à partir d'un Serveur MID qui prend en charge les options sélectionnées. Ce champ est disponible lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion, que la case Utiliser MID est activée et que la sélection automatique d'un serveur MID est sélectionnée dans la liste Sélection MID. | | Options | Les capacités doivent être prises en charge pour être éligibles à la Serveur MID sélection. Le système exécute l'étape d'action à partir d'un Serveur MID qui prend en charge les options sélectionnées. Ce champ est disponible lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion, que la case Utiliser MID est activée et que la sélection automatique d'un serveur MID est sélectionnée dans la liste Sélection MID. | | Serveur MID | Pastille de données du requis Serveur MID. Ce champ est disponible lorsque l'option Définir l'inline de la connexion est sélectionnée dans la liste Connexion, que la case Utiliser MID est activée et que le Serveur MID spécifique est sélectionné dans la liste de sélection MID. | | 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. | | Demande de version | Option permettant de créer la demande manuellement, d'importer une spécification OpenAPI ou d'importer un message REST. * Manuellement : créez des entrées d'action et remplissez manuellement le formulaire Étape REST. * À partir de la spécification OpenAPI : importez une spécification OpenAPI pour générer des entrées d'action et remplissez le formulaire d'étape REST. Pour plus d'informations, consultez [Prise en charge d'OpenAPI à l'étape REST](https://www.servicenow.com/docs/access?context=open-api-integration&version=australia&pubname=australia-integrate-applications&ft:locale=en-US). * À partir du message REST : importez un message REST de plateforme. Pour plus d'informations, consultez [Importer un message REST dans une étape REST](https://www.servicenow.com/docs/access?context=import-rest-message-step&version=australia&pubname=australia-integrate-applications&ft:locale=en-US). {#rest-request-action-designer__ul_kxt_z3x_xgb} | | Source de l'API | Option permettant de sélectionner une spécification OpenAPI utilisée pour construire la demande, ou sélectionnez Importer OpenAPI pour importer une nouvelle spécification OpenAPI. Vous pouvez importer des spécifications en fournissant une URL vers YAML ou JSON, ou en copiant et collant du contenu. Remarque : Ce champ est disponible lorsque vous sélectionnez À partir de la spécification OpenAPI dans la liste Demande de build. | | Opération API | Option permettant de sélectionner une opération dans la liste. Les opérations disponibles sont fournies par la spécification OpenAPI dans le champ Source de l'API . Remarque : Ce champ est disponible lorsque vous sélectionnez À partir de la spécification OpenAPI dans la liste Demande de build. | | Message REST | Nom du message REST à importer. Sélectionnez un message REST dans la liste. Remarque : Ce champ est disponible lorsque vous sélectionnez À partir du message REST dans la liste Demande de build. | | Fonction de message REST | Nom de la fonction à importer à partir du message REST. Les options disponibles sont déterminées par les méthodes HTTP associées au message REST sélectionné. Remarque : Ce champ est disponible lorsque vous sélectionnez À partir du message REST dans la liste Demande de build. | | Importer le message REST | Bouton permettant d'importer le message REST. Remarque : Ce champ est disponible lorsque vous sélectionnez un message REST à partir du champ Message REST . | | Chemin d'accès à la ressource | Chemin d'accès de la ressource. | | Méthode HTTP | Méthode HTTP utilisée pour traiter la demande. * GET * POST * PUT * PATCH * DELETE {#rest-request-action-designer__ul_ivc_211_lbb} | | Paramètres de requêtes | Paires nom-valeur à transmettre au point de terminaison REST. Vous pouvez créer ces paramètres manuellement ou faire glisser les variables d'entrée dans les champs de paramètres, puis affecter une valeur. Prenez en charge les demandes d'étape REST qui contiennent des noms de paramètres de requête en double. Si vous créez une demande REST qui contient des noms de paramètres de requête en double, Studio de workflow les paramètres de requête sont ajoutés à la demande dans l'ordre dans lequel vous les avez définis. Remarque : Lors de l'importation d'une spécification OpenAPI, le système ajoute tous les paramètres et en-têtes présents dans la spécification à l'étape REST. Examinez les valeurs finales de l'étape REST et supprimez les paramètres que vous ne souhaitez pas envoyer dans la demande. Par exemple, si l'API accepte les en-têtes de type contenu pour JSON et XML, le système ajoute les deux en-têtes à l'étape REST. Supprimez l'un des en-têtes en fonction du type de contenu que vous souhaitez recevoir dans la réponse. | | En-têtes | En-têtes à envoyer avec la demande. Vous pouvez créer des en-têtes manuellement ou faire glisser des variables d'entrée dans les champs de paramètres, puis affecter une valeur. Prise en charge des demandes de l'étape REST qui contiennent des en-têtes de demande en double. Si vous créez une demande REST qui contient des en-têtes de demande en double, les en-têtes sont envoyés dans le même ordre que celui dans lequel vous les avez définis. Remarque : Lors de l'importation d'une spécification OpenAPI, le système ajoute tous les paramètres et en-têtes présents dans la spécification à l'étape REST. Examinez les valeurs finales de l'étape REST et supprimez les paramètres que vous ne souhaitez pas envoyer dans la demande. Par exemple, si l'API accepte les en-têtes de type contenu pour JSON et XML, le système ajoute les deux en-têtes à l'étape REST. Supprimez l'un des en-têtes en fonction du type de contenu que vous souhaitez recevoir dans la réponse. | | Type de demande | Format de la demande. Les options comprennent. * Texte : demande au format JSON, XML ou autre format texte.{#rest-request-action-designer__text} {#rest-request-action-designer__text} * Binaire : demande au format de fichier binaire.{#rest-request-action-designer__binary} {#rest-request-action-designer__binary} * Plusieurs parties : demande composée de plusieurs types de contenu. * Codage URL de formulaire : demande dans une requête codée URL. {#rest-request-action-designer__ul_acb_ppv_ldb} Remarque : Ce champ est modifiable lorsque la méthode HTTP est POST,PUT, PATCH ou DELETE. | | Corps de la demande \[texte\] | Corps de la demande au format JSON ou XML. Les détails d'exécution du flux affichent le corps de la réponse sous la forme d'un lien vers la visionneuse de texte incorporé ou de l'sys_id de l'enregistrement de pièce jointe contenant la réponse. Remarque : Ce champ est modifiable si vous sélectionnez Texte dans la liste Type de demande. | | 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 vous sélectionnez Binaire dans la liste Type de demande. | | Nom, type de pièce, valeur | Contenu d'une demande en plusieurs parties. Pour chaque article, spécifiez son nom, son type d'article et sa valeur à l'aide des champs individuellement ou à l'aide d'un script en ligne pour tous les articles. Vous pouvez spécifier les valeurs en plusieurs parties en cliquant sur l'icône de script (icône ![Activer/désactiver le script en ligne]()) et en modifiant le script. Pour plus d'informations sur le scripting en ligne, reportez-vous à la section [Scripts Inline](https://servicenow-prod.fluidtopics.net/8wfCIq4YjkgbA6vB6EVAAg "Permettez aux utilisateurs ayant de l’expérience en codage d’écrire des scripts Inline qui définissent et modifient les valeurs d’entrée lors de la configuration d’une action ou d’un flux. Utilisez des scripts Inline pour modifier les valeurs d’entrée qui nécessitent des conversions de petit format, des transformations de données ou des opérations mathématiques."). * Nom : Le nom de la pièce. Il peut s'agir de n'importe quelle chaîne valide. * Type de pièce : le type de la pièce. Sélectionnez Texte ou Fichier. * Texte : le texte de la pièce. Une fois le texte sélectionné, vous pouvez spécifier le type de contenu. * Fichier :Le fichier de la pièce. Lorsque Fichier est sélectionné, la valeur doit être le sys_id de l'enregistrement de pièce jointe contenant le contenu. Vous pouvez rechercher cet enregistrement à une étape antérieure ou le définir comme valeur d'entrée. Une fois le fichier sélectionné, vous pouvez spécifier le nom du fichier et le type de contenu. * Pour Définir le nom de fichier, sélectionnez À partir de la pièce jointe pour utiliser le nom de fichier de l'enregistrement joint ou sélectionnez À partir de l'entrée Nom de fichier pour saisir le vôtre. * Pour Définir le type de contenu, sélectionnez À partir de la pièce jointe pour utiliser le type de contenu de l'enregistrement joint ou sélectionnez À partir de l'entrée Type de contenu pour saisir le vôtre. {#rest-request-action-designer__ul_zgm_l4m_gtb} {#rest-request-action-designer__ul_o4p_4nm_gtb} * Valeur : le contenu de la pièce. Pour le texte, la valeur est le contenu du texte. Pour un fichier, la valeur est le sys_id de l'enregistrement de pièce jointe contenant le contenu. {#rest-request-action-designer__ul_ttq_wzj_f2b} Remarque : Ces champs sont disponibles lorsque vous sélectionnez Plusieurs parties dans la liste Type de demande. | | Nom, valeur | Contenu d'une demande codée URL de formulaire. Spécifiez chaque partie de la demande codée en URL avec une paire nom-valeur en utilisant les champs individuellement ou en utilisant un script en ligne pour toutes les parties. Vous pouvez spécifier le script inline des valeurs encodées par l'URL du formulaire en cliquant sur l'icône activer/désactiver le ![scripting (icône Activer/désactiver le scripting inline]()) et en modifiant le script. Pour plus d'informations sur le scripting en ligne, reportez-vous à la section [Scripts Inline](https://servicenow-prod.fluidtopics.net/8wfCIq4YjkgbA6vB6EVAAg "Permettez aux utilisateurs ayant de l’expérience en codage d’écrire des scripts Inline qui définissent et modifient les valeurs d’entrée lors de la configuration d’une action ou d’un flux. Utilisez des scripts Inline pour modifier les valeurs d’entrée qui nécessitent des conversions de petit format, des transformations de données ou des opérations mathématiques."). Remarque : Ce champ est disponible lorsque vous sélectionnez URL de formulaire encodée dans la liste Type de demande. | | 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. | | Enregistrer en tant que pièce jointe | Option permettant de spécifier si la réponse doit être sauvegardée en tant qu'enregistrement dans la table des pièces jointes \[sys_attachment\]. | | Nom de fichier de la pièce jointe | Nom de la pièce jointe créée par la réponse REST. Par exemple, rest-response.txt. Remarque : Ce champ est disponible lorsque l'option Enregistrer en tant que pièce jointe est sélectionnée. | | Enregistrement du fichier de la pièce jointe | Enregistrement cible auquel la pièce jointe est associée. L'enregistrement cible doit être une pastille de données de type Enregistrement. Par exemple, un enregistrement d'incident spécifique. Vous pouvez rechercher cet enregistrement à une étape antérieure ou le définir comme variable d'entrée. Les détails d'exécution du flux affichent la sys_id de l'enregistrement associé. Remarque : Ce champ est disponible lorsque l'option Enregistrer en tant que pièce jointe est sélectionnée. | [ ] {#rest-request-action-designer__table_p4n_cht_3cb} ## Évaluation des erreurs d'action {#rest-request-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."). ## Limites de taille des réponses REST {#rest-request-action-designer__section_tps_xtd_kdb} Par défaut, le système limite à 5 Mo la taille des réponses REST qui ne sont pas enregistrées en tant que pièces jointes. Les réponses REST directes qui dépassent cette limite génèrent une erreur. Pour prendre en charge des réponses de plus grande taille, enregistrez la réponse en tant que pièce jointe ou augmentez la taille limite de réponse avec la glide.pf.rest.response_payload_max_size propriété système. Cette propriété système prend en charge une valeur maximale de 10 240 Ko, ce qui limite la réponse REST à une taille de 10 Mo. ## Analyse d'une réponse REST {#rest-request-action-designer__section_umb_5q3_tzb} Les appels de l'API REST renvoient les données dans le corps de la réponse. Les données du corps de la réponse sont généralement structurées au format JSON ou XML. Vous pouvez utiliser un [Étape Script](https://servicenow-prod.fluidtopics.net/3gM3ddJuKuNNbysYG2SgjA "Ajoutez du JavaScript personnalisé à exécuter dans une action réutilisable. Bien que la plupart des actions et étapes de base correspondent aux cas d’utilisation courants, vous pouvez créer une étape de script pour exécuter un comportement insatisfait par les étapes de base.") pour analyser les données structurées en variables à utiliser ailleurs dans l'action ou dans un flux. Il existe également une [XML parser step](https://www.servicenow.com/docs/access?context=xml-parser-step-action-designer&version=australia&pubname=australia-integrate-applications&ft:locale=en-US) option permettant d'analyser un corps de réponse au format XML. La stratégie générale pour obtenir les données extraites de la réponse consiste à procéder comme suit. 1. Examinez le corps de la réponse pour sélectionner les données à renvoyer. 2. Créez des variables d'entrée et de sortie dans l'étape Script. * Créez une variable d'entrée à transmettre dans le corps de la réponse à partir de l'étape REST. * Créez des variables de sortie pour renvoyer les données de la réponse. {#rest-request-action-designer__ul_t5w_rr3_tzb} 3. Créez un script pour analyser et mapper des données. * Utilisez la méthode `JSON.parse()` dans une étape Script pour analyser un corps de réponse JSON. * Mappez les données analysées aux variables de sortie. {#rest-request-action-designer__ul_avq_tr3_tzb} 4. Créez des sorties d'action pour les variables de sortie afin de rendre les données disponibles à un flux. {#rest-request-action-designer__ol_ngr_lr3_tzb} Pour obtenir un exemple détaillé, consultez la section sur l'analyse d'une réponse REST dans la [formation de développeur REST dans IntegrationHub (Zurich).](https://developer.servicenow.com/dev.do#!/learn/courses/australia/app_store_learnv2_rest_australia_rest_integrations/app_store_learnv2_rest_australia_rest_in_integration_hub/app_store_learnv2_rest_australia_rest_in_integration_hub_objectives)