Activité HTTP Demande Put
L'activité HTTP Demande Put envoie une demande Put à l'emplacement spécifié (le noeud final ou point d'extrémité HTTP) et reçoit une réponse HTTP de cet emplacement.
Ajouter une activité HTTP Demande Put à l'orchestration
- Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
- Sélectionnez l'onglet Activités et développez le dossier HTTP.
- Faites glisser l'activité Demande Put et déposez-la sur l'orchestration.
- Sélectionnez l'activité. La Liste de contrôle est affichée.
Création, sélection ou édition d'un noeud final HTTP
- Cliquez sur la tâche Sélectionner le noeud final dans la liste de contrôle et sélectionnez l'une des actions suivantes :
- Sélectionnez un noeud final existant :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK. Passez à la procédure "Configurer l'activité".
- Sélectionnez un noeud final existant et éditez le noeud final :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK.
- Cliquez sur Editer. Le panneau Editer un noeud final apparaît.
- Créez un nouveau noeud final : Sélectionnez Nouveau. Le panneau Créer un noeud final apparaît.
- Sélectionnez un noeud final existant :
- Créez ou éditez un noeud final HTTP. Voir Création ou édition d'un noeud final HTTP.
Configuration de l'activité
- Sélectionnez la tâche Configurer dans la Liste de contrôle. La tâche Configuration apparaît.
- Configurez toutes les zones et les cases à cocher de ce panneau, comme décrit dans le tableau suivant :
Tableau 1. Zone ou case à cocher Description URL (chemin après le nom d'hôte) Chemin de la ressource auquel l'activité Demande Put envoie la demande, par exemple : /chemin. La chaîne que vous indiquez dans cette zone doit exclure la partie http://, le nom d'hôte et le numéro de port du dispositif d'intégration. L'URL complète est automatiquement construite à partir du nom d'hôte du dispositif d'intégration, du numéro de port spécifié dans le noeud final HTTP et du chemin spécifié dans cette zone. Par exemple, si l'URL complète à laquelle l'activité Demande Put envoie la demande est http://monAR:monPort/Chemin, dans cette zone, il vous suffit d'indiquer la chaîne /Chemin. Le chemin spécifié doit être différent pour chacune des activités Demande Put déployées simultanément sur le même dispositif d'intégration et utilisant le même port. Pour utiliser des paramètres de chemin et des paramètres de requête, entrez une URL au format suivant : "url/{chemin}?nom1=valeur1&nom2=valeur2". Vous pouvez ainsi mapper une valeur de chaîne au paramètre "{chemin}" et spécifier des noms de paramètre de requête : "nom1" et "nom2" dans cet exemple. Si vous choisissez de déclarer plusieurs paramètres "{chemin}", veillez à ce qu'ils aient chacun un nom différent. Les paramètres portant le même nom sont représentés par un seul noeud dans la mappe. Les paramètres de chemin sont affichés sous /httpheaders/pathParameters dans le panneau Mapper les entrées. Les paramètres de requête sont affichés sous /httpheaders/queryParameters dans le panneau Mapper les entrées.
Remarque : Dans l'URL, la valeur que vous affectez à un paramètre de requête n'est pas passée au mappeur. Pour affecter une valeur au paramètre de requête, mappez explicitement une valeur au paramètre de requête dans le mappeur ou définissez une valeur par défaut.Où le message de demande est De type =)(Specifies the message type of the HTTP response - either Text or Binary. Où le message de réponse est De type Type de message de la réponse HTTP - Texte ou Binaire. Arrêter le traitement du travail d'orchestration ou
Continuer le traitement et renvoyer le code d'erreur HTTP
Comportement d'exécution de l'activité si une réponse d'erreur est renvoyée du serveur HTTP : - Arrêter le traitement du travail d'orchestration - Sélectionnez cette option si le travail d'orchestration doit arrêter le traitement lorsqu'une réponse d'erreur est reçue du serveur HTTP en phase d'exécution. L'orchestration arrête le traitement dans l'activité Demande Put, les activités après l'activité Demande Put dans l'orchestration ne sont pas traitées et une exception d'échec est envoyée.
- Continuer le traitement et renvoyer le code d'erreur HTTP - Sélectionnez cette option si le travail d'orchestration doit poursuivre le traitement lorsqu'une réponse d'erreur est reçue du serveur HTTP en phase d'exécution. Le travail d'orchestration doit continuer les activités de traitement après l'activité Demande Put dans l'orchestration et le code de réponse d'erreur ainsi que le message de réponse d'erreur sont renvoyés dans les paramètres de sortie responsecode et responsemessage respectivement.
Utiliser la compression/décompression Indique si la compression/décompression est activée ou désactivée au niveau de l'activité. Par défaut, la case Utiliser la compression/décompression est désélectionnée et la compression/décompression est désactivée pour cette activité. Cochez la case Utiliser la compression/décompression pour activer la compression/décompression pour cette activité. Pour plus d'informations, voir la rubrique Compression/décompression avec l'activité Demande HTTP Invoke/Get/Post/Head/Put/Delete.
Spécifier les en-têtes de demande
- Sélectionnez la tâche En-têtes de demande dans la Liste de contrôle. Le panneau En-têtes de demande apparaît. Celui-ci contient un tableau En-têtes personnalisés en haut, un case à cocher Inclure les en-têtes standard prédéfinis au milieu et un tableau En-têtes standard en bas.
- Cliquez sur le bouton Ajouter pour ajouter un en-tête au tableau En-têtes personnalisés. Cliquez sur la nouvelle entrée pour entrer un nom d'en-tête ou en sélectionner un dans la liste déroulante. Si le nom d'en-tête choisi est l'un des noms prédéfinis, sa description apparaît dans la colonne Description ; s'il s'agit d'un nom de votre choix, entrez votre propre description pour cet en-tête.
- Pour utiliser les en-têtes standard prédéfinis, cochez la case Inclure les en-têtes standard prédéfinis. Notez que les homonymies (même avec une casse différente) ne sont pas autorisées. Le cas échéant, vous êtes invité à supprimer les en-têtes en double dans le tableau En-têtes personnalisés. Les en-têtes HTTP sélectionnés sont affichés sous /httpheaders dans le panneau Mapper les entrées.
Spécifier les en-têtes de réponse
- Sélectionnez la tâche En-têtes de réponse dans la Liste de contrôle. Le panneau En-têtes de réponse apparaît. Celui-ci contient un tableau En-têtes personnalisés en haut, un case à cocher Inclure les en-têtes standard prédéfinis au milieu et un tableau En-têtes standard en bas.
- Cliquez sur le bouton Ajouter pour ajouter un en-tête au tableau En-têtes personnalisés. Cliquez sur la nouvelle entrée pour entrer un nom d'en-tête ou en sélectionner un dans la liste déroulante. Si le nom d'en-tête choisi est l'un des noms prédéfinis, sa description apparaît dans la colonne Description ; s'il s'agit d'un nom de votre choix, entrez votre propre description pour cet en-tête.
- Pour utiliser les en-têtes standard prédéfinis, cochez la case Inclure les en-têtes standard prédéfinis. Notez que les homonymies (même avec une casse différente) ne sont pas autorisées. Le cas échéant, vous êtes invité à supprimer les en-têtes en double dans le tableau En-têtes personnalisés. Les en-têtes HTTP sélectionnés sont affichés sous /httpheaders dans le panneau Mapper les sorties.
Spécification des options de nouvelle tentative
- Sélectionnez la tâche Réessayer dans la Liste de contrôle. Le panneau Réessayer apparaît.
- Configurez les options de nouvelle tentative de connexion à un serveur HTTP. Le tableau suivant définit les options de nouvelle tentative pour la connexion à un serveur HTTP :
Zone Description Réessayer 1) Attendre ___ secondes entre chaque tentative. Indique la durée (en secondes) pendant laquelle le dispositif d'intégration attend avant de tenter à nouveau d'établir une connexion au serveur HTTP. 2) Tenter de se connecter ___ fois avant l'échec. Nombre de tentatives - le nombre maximum de fois que le dispositif d'intégration tente d'établir une connexion avec le serveur HTTP avant d'émettre une erreur et d'arrêter le traitement du travail d'orchestration en cours. Si vous déployez une orchestration qui contient une activité HTTP Demande Put et que le dispositif d'intégration ne peut pas se connecter au serveur HTTP spécifié, le dispositif d'intégration consigne les erreurs de connexion en tant qu'avertissements dans les journaux du système et de l'orchestration jusqu'à ce que la valeur de nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans les journaux du système et de l'orchestration et arrête le traitement du travail d'orchestration en cours. Par exemple, si vous indiquez la valeur 3 pour le nombre de tentatives, les erreurs de première, seconde et troisième connexions apparaissent dans le journal système en tant qu'avertissements. Le dispositif d'intégration consigne la quatrième erreur de connexion en tant qu'erreur et arrête le traitement du travail d'orchestration en cours. 3) Dépassement de délai après __ secondes en l'absence de réponse du noeud final à une demande. Durée en secondes avant l'expiration du délai entre une demande de l'activité sur un noeud final et le temps nécessaire au noeud final pour répondre. Pour l'activité HTTP Demande Put, le délai d'activité est le délai pendant lequel le dispositif d'intégration attend une réponse du serveur HTTP après avoir envoyé une demande HTTP, avant de générer une erreur de dépassement de ce délai. Un délai d'activité est différent d'un délai de connexion car l'expiration du délai d'une activité se produit après que la connexion avec le noeud final a été établie. Un délai de connexion spécifie la durée en secondes avant l'expiration du délai entre la tentative du dispositif d'intégration pour établir une connexion avec le noeud final et le temps nécessaire au noeud final pour répondre à la demande de connexion. Vous définissez le délai de connexion dans l'onglet Noeud final HTTP. Pour plus d'informations sur les délais de connexion, voir Création ou édition d'un noeud final de service Web.
Mappage de l'entrée dans l'activité
- Sélectionnez la tâche Mapper les entrées dans la Liste de contrôle. Le paramètre d'entrée body est affiché dans le panneau Vers l'activité de la tâche Mapper les entrées. Le paramètre d'entrée body est obligatoire et au moins une variable doit être mappée dessus. Le paramètre d'entrée body contient le corps du message de réponse HTTP renvoyé au serveur HTTP.
- Pour visualiser le paramètre d'entrée facultatif dans le panneau Vers l'activité du panneau Mapper les entrées, sélectionnez Afficher les paramètres facultatifs.
Si vous ne pouvez pas sélectionner l'option dans le menu de la barre d'outils, cliquez sur un noeud dans le panneau Mapper les entrées pour activer cette option. Les paramètres d'entrée httpheaders et httpConnParameter apparaissent.Le tableau suivant définit les noeuds du paramètre d'entrée httpheaders :
Tableau 2. Noeuds du paramètre d'entrée httpheaders Description httpheaders/uri Chemin de la ressource, par exemple : /momchemin. httpheaders/<nom_en-tête_configuré> Si vous avez configuré au moins un en-tête de demande à l'étape En-têtes de demande, chacun est affiché ici. <nom_en-tête_configuré> représente les noms d'en-tête que vous avez sélectionnés ou entrés. httpheaders/pathParameters Si vous avez configuré des paramètres de chemin dans l'URL à l'étape Configurer, chacun est affiché ici. Si aucun paramètre de chemin n'est spécifié, ce noeud n'apparaît pas. httpheaders/queryParameters Si vous avez configuré des paramètres de requête dans l'URL à l'étape Configurer, chacun est affiché ici. Si aucun paramètre de requête n'est spécifié, ce noeud n'apparaît pas. httpheaders/otherHeaders/headerItem Elément qui contient un ensemble de paramètres d'en-tête HTTP sous la forme de paires nom-valeur pour la réponse HTTP. Plusieurs paramètres HTTP peuvent être spécifiés dans la réponse HTTP. Il s'agit donc d'un noeud récurrent. httpheaders/otherHeaders/headerItem/name Nom du paramètre HTTP. httpheaders/otherHeaders/headerItem/value Valeur du paramètre HTTP. Remarque : Cette valeur est ignorée si l'en-tête Content-Length est défini de manière explicite à l'aide de httpheaders/otherHeaders/headerItem/name et httpheaders/otherHeaders/headerItem/value lors de l'exécution. Cette activité règle automatiquement l'en-tête Content-Length à la taille du corps.Le tableau suivant définit les noeuds du paramètre d'entrée httpConnParameter facultatif . Au besoin, à l'exécution, vous pouvez outrepasser dynamiquement les réglages que vous avez spécifiés dans la tâche Sélectionner le noeud final de la Liste de contrôle en passant des valeurs de variables dans les noeuds indiqués dans le tableau suivant. Par exemple, à l'exécution, vous pouvez remplacer le nom d'hôte spécifié dans le noeud final en mappant une variable vers le noeud hôte du paramètre d'entrée httpConnParameter. A l'exécution, la valeur de la variable est le nom d'hôte utilisé pour la connexion au serveur HTTP.Tableau 3. Noeuds du paramètre d'entrée httpConnParameter Description Paramètres à remplacer dans le noeud final HTTP timeout Durée en secondes avant l'expiration du délai. host Spécifie le nom d'hôte ou l'adresse IP du serveur HTTP distant. Le noeud host du paramètre d'entrée httpConnParameter remplace la zone Nom d'hôte du noeud final HTTP. port Numéro de port du serveur HTTP distant. Le noeud port du paramètre d'entrée httpConnParameter remplace la zone Port du noeud final HTTP. isSecure Mettez ce booléen à true pour activer le protocole HTTPS (HTTP sécurisé sur SSL). Mettez ce booléen à false pour désactiver la sécurité. Le noeud isSecure du paramètre d'entrée httpConnParameter remplace l'option Sécurité du noeud final HTTP. username Nom d'utilisateur du compte utilisé pour la connexion au serveur HTTP. Le noeud username du paramètre d'entrée httpConnParameter remplace la zone Nom d'utilisateur du noeud final HTTP. password Mot de passe du compte utilisé pour la connexion au serveur HTTP. Le noeud password du paramètre d'entrée httpConnParameter remplace la zone Mot de passe du noeud final HTTP.
dans le menu de la barre d'outils ou cliquez avec le bouton droit de la souris dans le panneau Vers l'activité et sélectionnez l'option - Créez une mappe entre la ou les variables d'orchestration et le ou les paramètres d'entrée. Voir Création d'une mappe pour des instructions générales sur le mappage
Mappage de la sortie de l'activité
- Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle. Les paramètres de sortie de l'activité sont affichés dans le panneau Depuis l'activité de la tâche Mapper les sorties, comme décrit dans le tableau suivant :Le tableau suivant définit les noeuds du paramètre de sortie httpheaders facultatif .
Tableau 4. Paramètre de sortie Description httpheaders En-tête de la demande HTTP. body Corps du message de la demande HTTP. responsecode Code de réponse HTTP renvoyé par le serveur HTTP à l'exécution. responsemessage Message associé au code réponse HTTP. Tableau 5. Noeuds du paramètre de sortie httpheaders Description httpheaders/uri Chemin de ressource de la demande entrante ; par exemple, /chemin. httpheaders/<nom_en-tête_configuré> Si vous avez configuré au moins un en-tête de réponse à l'étape En-têtes de réponse, chacun est affiché ici. <nom_en-tête_configuré> représente les noms d'en-tête que vous avez sélectionnés ou entrés. httpheaders/otherHeaders/headerItem Elément qui contient un ensemble de paramètres d'en-tête HTTP sous la forme de paires nom-valeur. Plusieurs paramètres d'en-tête HTTP peuvent être spécifiés dans la demande HTTP. Il s'agit donc d'un noeud récurrent. httpheaders/otherHeaders/headerItem/name Nom du paramètre d'en-tête HTTP. httpheaders/otherHeaders/headerItem/value Valeur du paramètre d'en-tête HTTP. - Créez une mappe entre le ou les paramètres de sortie de l'activité et la ou les variables d'orchestration. Voir Création d'une mappe pour des instructions générales sur le mappage.
Utilisation de certificats avec Microsoft Internet Explorer
- Dans le menu de barre d'outils Microsoft Internet Explorer, sélectionnez . Le panneau Options Internet apparaît.
- Cliquez sur l'onglet Contenu.
- Dans la section Certificats, cliquez sur Effacer l'état SSL. Le message "Le cache SSL a été effacé" apparaît.
- Cliquez sur OK, puis à nouveau sur OK.