Ouvrir la rubrique avec les liens de navigation

L'action Envoyer une requête de service Web indique à Integration Service d'envoyer une requête HTTP à un service Web (REST ou SOAP).

You can configure the following properties for the Send Web Service Request action:

Action

• Nom : Indique le nom de l'action. Si vous le souhaitez, vous pouvez remplacer le nom par défaut en tapant un nouveau nom dans le champ.

• Description : Permet d'enregistrer une description de l'action.

• Exécuter une action : Permet de définir la fréquence d'exécution de l'action.

  • Toujours : Indique à Integration Service d'exécuter l'action à chaque exécution de l'intégration.

  • Jamais : Indique à Integration Service de ne pas exécuter l'action à l'exécution de l'intégration.

  • Sous conditions, en fonction de la variable : Indique à Integration Service d'exécuter l'action uniquement quand une variable sélectionnée répond à une condition spécifiée. Utilisez cette option dans les situations où une seule condition détermine l'exécution ou pas de l'action. Après avoir activé cette option, vous pouvez créer l'énoncé conditionnel dans la zone de saisie prévue à cet effet.

    Contrôles de zone de saisie

    • Variable : Saisissez la variable que vous souhaitez utiliser pour l'énoncé conditionnel. Autrement, vous pouvez aussi ajouter une variable pour la valeur de l'énoncé conditionnel.

    • [Opérateur relationnel] : Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour ouvrir une liste contenant d'autres opérateurs et sélectionnez celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.

    • Valeur : Définit la ou les valeurs à utiliser pour l'énoncé conditionnel. Pour certains opérateurs, par exemple Est nul et N'est pas égal à zéro, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.

    • Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.

       

  • Sous conditions, en fonction de l'expression : Définit les conditions selon lesquelles Integration Service doit exécuter l'action. Utilisez cette option pour les situations nécessitant plusieurs énoncés conditionnels. Après avoir activé cette option, vous pouvez créer l'expression conditionnelle dans la zone de saisie prévue en établissant les énoncés conditionnels souhaités. Vous pouvez créer et éditer l'expression conditionnelle dans l'onglet Vue arborescente. Cliquez sur l'onglet Vue arborescente pour afficher une vue en lecture seule de l'expression conditionnelle.

    Contrôles de zone de saisie (onglet Vue arborescente)

    • [Opérateur conditionnel] : Définit l'opérateur conditionnel pour les énoncés conditionnels du groupe. L'opérateur conditionnel par défaut est And.

      Cliquez sur l'opérateur conditionnel existant pour accéder à un menu permettant de configurer votre expression conditionnelle d'une des manières suivantes :

      • Sélectionner un opérateur conditionnel différent : Les options du menu comprennent une liste d'opérateurs conditionnels. Sélectionnez l'opérateur conditionnel que vous souhaitez utiliser pour les énoncés conditionnels. Pour en savoir plus sur les opérateurs conditionnels pris en charge, veuillez consulter Opérateurs conditionnels.

      • Ajouter une condition : Cliquez pour ajouter un autre énoncé conditionnel au groupe actuel.

      • Ajouter groupe : Cliquez pour ajouter un sous-groupe d'énoncés conditionnels au groupe actuel.

      • Supprimer le groupe : Disponible dans le menu lorsque celui-ci a été ouvert depuis un sous-groupe. Cliquez pour supprimer le sous-groupe.

      • Tout supprimer : Disponible dans le menu lorsque celui-ci a été ouvert depuis le sous-groupe du haut. Cliquez pour supprimer tous les énoncés conditionnels (y compris les sous-groupes).

    • : Visible juste à droite de chaque opérateur conditionnel de votre expression. Cliquez pour ajouter un énoncé conditionnel au groupe associé à cet opérateur.

    • : Visible en plaçant le curseur sur un énoncé conditionnel existant. Cliquez pour supprimer l'énoncé conditionnel.

    • Variable : Saisissez la variable que vous souhaitez utiliser pour l'énoncé conditionnel. Autrement, vous pouvez aussi ajouter une variable pour l'énoncé conditionnel.

    • [Opérateur relationnel] : Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour ouvrir une liste contenant d'autres opérateurs et sélectionnez celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.

    • Valeur : Définit la ou les valeurs à utiliser pour l'énoncé conditionnel. Pour certains opérateurs, par exemple Est nul et N'est pas égal à zéro, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur est masqué.

    • Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.

Requête de service Web

• URL : Saisissez l'URL du serveur Web de réception. Autrement, vous pouvez aussi ajouter une variable pour définir l'URL.

• Méthode : Sélectionnez la méthode de requête Web HTTP à utiliser. Vous pouvez choisir : POST, GET, PUT, DELETE ou HEAD.

• Type de contenu : Select the content-type to use for the web request. Disponible lorsque la méthode POST ou PUT est sélectionnée.

• En-têtes HTTP : Enter the HTTP header properties and values to be sent with the web request. You can select from a dictionary of HTTP header properties and values, or you can add a variable to specify the header property or value. You can also add a special character to the value you have entered.

Source

• Données de contenu : Specifies the content-data that you want to be sent with a POST or a PUT web request HTTP method. Disponible quand vous avez sélectionné la Méthode POST ou PUT.

• Chaîne de requête : Définit la chaîne de requête à envoyer avec une méthode de requête Web HTTP GET, DELETE ou HEAD. Disponible quand vous avez sélectionné une Méthode GET, DELETE ou HEAD.

  • Modèle intégré :

    • Valeur : Utilisez la zone de saisie prévue pour saisir le modèle que vous souhaitez que l'action utilise. Autrement, vous pouvez aussi ajouter une variable pour définir le modèle ou ajouter un caractère spécial à la valeur saisie.

    • Importer : Ouvre la boîte de dialogue Ouvrir un fichier où rechercher et sélectionner un fichier contenant le script souhaité. Le contenu du fichier est importé dans la zone de saisie Valeur.

    • Exporter : Ouvre la boîte de dialogue Enregistrer le fichier pour vous permettre d'enregistrer le contenu de la zone de saisie Valeur dans un fichier externe. Vous pouvez enregistrer la valeur dans un nouveau fichier ou remplacer le contenu d'un fichier existant.

  • Variable :

    • Variable : Tapez la variable que vous souhaitez utiliser pour la source. Autrement, vous pouvez aussi ajouter une variable.

  • Fichier externe :

    • Emplacement : Indique le système de fichiers où se trouve le dossier source. Les systèmes ou emplacements de fichiers peuvent comprendre des systèmes de fichiers locaux ou sur réseau, Librarian, voire un emplacement de stockage sur le cloud. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

    • Nom du fichier : Indique le chemin du fichier. Vous pouvez taper l'emplacement du dossier et le nom du fichier ou cliquer sur Parcourir pour localiser et sélectionner le fichier souhaité. Autrement, vous pouvez aussi ajouter une variable pour définir le fichier de votre choix ou ajouter un caractère spécial à la valeur saisie.

    • Codage de fichier : Définit le codage utilisé par le fichier source.

  • Variable de requête HTTP :

    • Nom de variable : Définit le nom de la variable de requête HTTP à utiliser comme source.

    • Valeur : Définit la valeur de la variable de requête HTTP.

Authentification

• Méthode :

  • Anonyme : Allows any user to access the client without providing a user name and password.

  • Utiliser l'authentifiant de Windows actuel : Uses the current Windows user account to connect to the client.

  • Utiliser l'authentifiant indiqué : Uses the user name, domain, and password that you provide to connect to the client.

Réponse

• Codes d'état réussi : Enables you to specify the status codes that you deem successful.

• Enregistrer la réponse de service Web dans la variable : Indique la variable dans laquelle vous souhaitez enregistrer la réponse du service Web. Enter the desired variable in the input box. Autrement, vous pouvez aussi ajouter une variable.

Options avancées

• Retour à la ligne automatique du contenu source dans la balise de corps SOAP : Specifies that the source content will be wrapped in a SOAP Body tag before being sent.

• Délai d'envoi : Specifies the amount of time in seconds to wait for a response from the client before the action fails.

• Décompte des tentatives : Specifies the number of times to re-send the request if the action fails.

Tester Envoyer une requête de service Web

• Test : Exécute l'action. Le volet Message affiche des informations sur la réussite ou l'échec de l'action.

  Le bouton Tester n'exécute que l'action et pas l'intégration. Par conséquent, même si l'action est configurée pour utiliser une intégration, elle s'exécutera sans les données correspondantes. Pour en savoir plus sur le test des intégrations, consultez Utiliser le volet de test.

Paramètres de connexion

• Hériter de l'action parente : Lorsque cette option est activée, l'action hérite des identifiants de compte utilisateur définis sur la page de propriétés Actions. Autrement, si l'action fait partie d'une action Grouper, elle héritera des identifiants de compte utilisateur définis sur la page de propriétés Grouper de l'action parente directe.

• Spécifier les identifiants d'utilisateur : Lorsque cette option est activée, l'action s'exécute en utilisant les identifiants spécifiés.

Erreur de traitement et diagnostic

• Ignorer les erreurs et continuer à exécuter les actions : Lorsque cette option est activée, si l'action échoue, les autres actions continueront à être exécutées.

  Si elle est désactivée, quand l'action échoue, le comportement adopté dépend des scénarios suivants : Si vous avez sélectionné Séquentiellement pour la propriété Exécuter les actions de la page de propriétés hiérarchique Actions ou Grouper de l'action sélectionnée, aucune autre action de ce groupe ne sera exécutée. Si vous avez sélectionné En parallèle pour la propriété Exécuter les actions de la page de propriétés hiérarchique Actions ou Grouper de l'action sélectionnée, les actions de ce groupe ne sont pas affectées ; les erreurs sont ignorées et les autres actions du groupe sont exécutées. Si l'action sélectionnée fait partie d'une action Grouper, les actions hors de ce groupe ne sont pas affectées.

• Réessayer en cas d'échec : Lorsque cette option est activée, si l'action échoue, Integration Service tente de l'exécuter à nouveau.

• Nombre maximum de nouvelles tentatives : Indique le nombre maximum de tentatives de réexécution de l'action par Integration Service. Disponible quand l'option Réessayer en cas d'échec est activée.

• Intervalle de nouvelles tentatives : Indique le temps d'attente après l'échec de l'action avant de tenter sa réexécution par Integration Service. Disponible quand l'option Réessayer en cas d'échec est activée.