Activité HTTP Demande Invoke

L'activité HTTP Demande Invoke envoie une demande HTTP à 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 Invoke à l'orchestration

  1. Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
  2. Sélectionnez l'onglet Activités et développez le dossier HTTP.
  3. Faites glisser l'activité Demande Invoke et déposez-la sur l'orchestration.
  4. Sélectionnez l'activité. La Liste de contrôle est affichée.

Création, sélection ou édition d'un noeud final HTTP

  1. 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 :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. 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 :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK.
      3. 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.
  2. Créez ou éditez un noeud final HTTP, voir Création ou édition d'un noeud final HTTP.

Configuration de l'activité

  1. Sélectionnez la tâche Configurer dans la Liste de contrôle. La tâche Configuration apparaît.
  2. 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 Invoke 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 Invoke 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 Invoke 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 Type de message attendu de la demande HTTP - Texte ou Binaire.  
    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 Invoke, les activités après l'activité Demande Invoke 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 Invoke 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

  1. 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.
  2. 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.
  3. 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

  1. 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.
  2. 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.
  3. 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

  1. Sélectionnez la tâche Réessayer dans la Liste de contrôle. Le panneau Réessayer apparaît.
  2. Configurez les options de tentative pour la connexion à un serveur HTTP. Le tableau suivant définit les options de tentative pour une connexion à un serveur HTTP :
    Tableau 2.
    Zones Description
    Réessayer  
    1) Attendre __ secondes entre chaque tentative. Nombre de secondes pendant lesquelles le dispositif d'intégration attend avant de tenter d'établir une connexion avec le 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 Post 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.

    Délai d'expiration de l'activité  
    3) Dépassement de délai d'attente 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é Demande Invoke, 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 HTTP.

Mappage de l'entrée dans l'activité

  1. 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 demande HTTP envoyé au serveur HTTP.
  2. Pour visualiser les paramètres d'entrée facultatifs dans le panneau Vers l'activité du panneau Mapper les entrées, sélectionnez Mapper > Afficher les paramètres facultatifs 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 Afficher les paramètres facultatifs. Si vous ne pouvez pas sélectionner l'option Mapper > Afficher les paramètres facultatifs 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 3.
    Noeuds du paramètre d'entrée httpheaders Description
    httpheaders/uri Chemin de la ressource, par exemple : /momchemin.
    httpheaders/method Type de demande HTTP. Si aucune valeur n'est mappée, la méthode par défaut est POST.
    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. 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.
    Remarque : Si, à l'exécution, l'en-tête Content-Length est explicitement défini avec les paramètres httpheaders/otherHeaders/headerItem/name et httpheaders/otherHeaders/headerItem/value, cette valeur n'est pas prise en compte. 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 . Si vous le souhaitez, vous pouvez remplacer les paramètres spécifiés dans la tâche Sélectionner le noeud final de la Liste de contrôle dynamiquement en phase d'exécution, en transmettant 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 4.
    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.  
    Hôte du 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 Définissez cette valeur booléenne par true afin d'activer le protocole HTTPS (HTTP sur SSL sécurisé). Définissez cette valeur booléenne par false pour désactiver la sécurité. Le noeud isSecure du paramètre d'entrée httpConnParameter remplace l'option Security 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.
  3. 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 accéder à des instructions générales sur le mappage.

Mappage de la sortie de l'activité

  1. 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 :
    Tableau 5.
    Paramètre de sortie Description
    httpheaders En-tête de la réponse HTTP.
    body Corps du message de la réponse HTTP.
    responsecode Code de réponse HTTP renvoyé par le serveur HTTP à l'exécution.  
    responsemessage Message associé au code réponse HTTP.
    Le tableau suivant définit les noeuds du paramètre de sortie httpheaders :
    Tableau 6.
    Noeuds du paramètre de sortie httpheaders Description
    httpheaders/uri Chemin de la ressource, par exemple : /momchemin.
    httpheaders/method Type de réponse HTTP.
    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 Jeu de paires nom-valeur contenant les paramètres HTTP de la réponse HTTP. Plusieurs paramètres HTTP peuvent être spécifiés dans la réponse HTTP. headerItem est donc un noeud récurrent.
    httpheaders/otherHeaders/headerItem/name Nom du paramètre HTTP.
    httpheaders/otherHeaders/headerItem/value Valeur du paramètre HTTP.
  2. 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 accéder à des instructions générales sur le mappage.

Utilisation de certificats avec Microsoft Internet Explorer

Si vous avez sélectionné l'option de sécurité HTTPS dans le noeud final HTTP, notez que Microsoft Internet Explorer ne reconnaît pas un certificat modifié et met en cache l'état SSL. Si vous modifiez des certificats, vous devez effacer l'état SSL. Pour effacer l'état SSL dans Microsoft Internet Explorer :
  1. Dans le menu de barre d'outils Microsoft Internet Explorer, sélectionnez Outils > Options Internet. Le panneau Options Internet apparaît.
  2. Cliquez sur l'onglet Contenu.
  3. Dans la section Certificats, cliquez sur Effacer l'état SSL. Le message "Le cache SSL a été effacé" apparaît.
  4. Cliquez sur OK, puis à nouveau sur OK.



Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/http_invoke_request_activity.html