Activité HTTP Publier requête

L'activité HTTP Publier requête envoie une requête HTTP vers l'emplacement spécifié, le noeud final HTTP, et reçoit une réponse HTTP de cet emplacement.

La figure suivante montre l'activité HTTP Publier requête qui envoie une requête HTTP vers l'emplacement spécifié, le noeud final HTTP, et qui reçoit une réponse HTTP :

Figure 1.

Ajout d'une activité HTTP Publier requête dans 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. Déplacez l'activité Publier requête 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 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 d'accès de ressource vers lequel l'activité Publier requête publie la requête, par exemple : /chemin. La chaîne que vous indiquez dans cette zone doit exclure la chaîne : http://, le nom d'hôte et le numéro de port du dispositif d'intégration. L'adresse 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'adresse URL complète vers laquelle l'activité Publier requête publie la requête est http://myAR:Port/Chemin, dans cette zone, il vous suffit d'indiquer la chaîne : /Chemin. Le chemin spécifié doit être unique pour les activités Publier requête déployées simultanément sur le même dispositif d'intégration, à l'aide du même port.  
    Où le message de requête est De type Type de message attendu de la requête 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é HTTP Publier requête, les activités après l'activité HTTP Publier requête 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é HTTP Publier requête 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 Compression/décompression avec l'activité HTTP Publier requête.

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 Publier requête 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 définissez le nombre de tentatives à 3, 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 requête. Durée en secondes avant l'expiration du délai entre une requête de l'activité sur un noeud final et le temps nécessaire au noeud final pour répondre. Pour l'activité HTTP Publier requête, le délai d'expiration est l'attente par le dispositif d'intégration d'une réponse de la part du serveur HTTP après avoir envoyé une requête HTTP, avant que le dispositif d'intégration n'émette une erreur de dépassement de 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. Au moins une variable doit être mappée sur le paramètre d'entrée body, il s'agit d'un paramètre obligatoire. Le paramètre d'entrée body contient le corps du message de requête 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 facultatif :
    Tableau 3.
    Noeuds du paramètre d'entrée httpheaders Description
    httpheaders/uri Chemin de la ressource, par exemple, /Chemin.
    httpheaders/method Type de requête HTTP.
    httpheaders/otherHeaders/headerItem Elément qui contient un ensemble de paramètres d'en-tête HTTP sous la forme de paires valeur-nom. Plusieurs paramètres d'en-tête HTTP peuvent être spécifiés dans la requête HTTP. Il s'agit donc d'un noeud récurrent.
    ttpheaders/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'en-tête Contenu-Longueur est explicitement défini à l'aide des paramètres httpheaders/otherHeaders/headerItem/name et httpheaders/otherHeaders/headerItem/value, en phase d'exécution, la valeur n'est pas prise en compte. Cette activité définit automatiquement l'en-tête Contenu-Longueur par 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, en phase d'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. En phase d'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    
    host 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.
    mot de passe 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 réponse HTTP renvoyé du serveur HTTP en phase d'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, /Chemin.
    httpheaders/method Type de réponse HTTP.
    httpheaders/otherHeaders/headerItem Jeu de paires valeur-nom 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 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.