Activité HTTP Recevoir requête

Utilisez l'activité HTTP Recevoir requête pour configurer le dispositif d'intégration devant jouer le rôle de programme d'écoute HTTP

La figure suivante illustre le dispositif d'intégration agissant en tant que programme d'écoute HTTP.
Figure 1.
L'activité HTTP Recevoir requête est une activité de démarrage. Lorsque vous déployez une orchestration qui commence par l'activité HTTP Recevoir requête sur le dispositif d'intégration, ce dernier joue le rôle d'un programme d'écoute HTTP en attente de requêtes HTTP. Lorsqu'il reçoit une requête HTTP, les actions suivantes se produisent :
  1. Un travail d'orchestration est démarré.
  2. L'activité HTTP Recevoir requête traite la requête HTTP entrante et mappe cette requête sur les paramètres de sortie de l'activité.
  3. Les paramètres de sortie sont mappés sur les variables d'orchestration spécifiées. Pendant la conception dans la tâche Mapper les sorties de la Liste de contrôle, le mappage entre les paramètres de sortie et les variables d'orchestration est défini.
  4. Les activités restantes de l'orchestration sont traitées. (Dans la représentation graphique de l'orchestration, les activités restantes sont situées à droite de l'activité HTTP Recevoir requête).
Par défaut, la décompression est activée pour l'activité HTTP Recevoir requête. Pour plus d'informations, voir Décompression avec l'activité HTTP Recevoir requête.

Ajout d'une activité HTTP Recevoir 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é Recevoir requête sur l'orchestration.
  4. Sélectionnez l'activité. La Liste de contrôle est affichée avec la tâche Récapitulatif active dans le panneau de propriétés. Le panneau de propriétés est situé sous la représentation graphique de l'orchestration, dans l'espace de travail.

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 Description
    URL (chemin après le nom d'hôte) Chemin de ressource où le dispositif d'intégration écoute les requêtes HTTP entrantes, 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 que le dispositif d'intégration utilise pour écouter les requêtes HTTP entrantes 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 sur laquelle le dispositif d'intégration écoute les requêtes HTTP 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 HTTP Recevoir requête déployées simultanément sur le même dispositif d'intégration, à l'aide du même port.
    Remarque : Le chemin sur lequel le dispositif d'intégration écoute les requêtes HTTP entrantes est une chaîne de chemin de ressource que vous indiquez et ne correspond pas à un chemin de répertoire réel sur le dispositif d'intégration.
    De type Type de message attendu de la requête HTTP - Texte ou Binaire.
    Réponse requise Spécifie si une réponse doit être envoyée à l'expéditeur de la requête.
    Remarque : Si cette case est cochée, vous devez ajouter et configurer une activité HTTP Envoyer réponse dans votre orchestration.
    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 cochée. Désélectionnez la case Utiliser la compression/décompression pour désactiver la compression/décompression pour cette activité. Pour plus d'informations, voir Compression avec l'activité HTTP Envoyer réponse.

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 2.
    Paramètre de sortie Description
    httpheaders En-tête de la requête HTTP.
    body Corps du message de la requête HTTP.
    Le tableau suivant définit les noeuds du paramètre de sortie httpheaders facultatif .  
    Tableau 3.
    Noeuds du paramètre de sortie httpheaders Description
    httpheaders/uri Chemin de la ressource de la requête entrante, par exemple, /chemin.
    httpheaders/method Type de requête HTTP. Pour cette activité, POST est le 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.
    httpheaders/otherHeaders/headerItem/name Nom du paramètre d'en-tête HTTP.
    ttpheaders/otherHeaders/headerItem/value Valeur du paramètre d'en-tête 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 des instructions générales sur le mappage.
    Remarque : Pour tester l'orchestration qui commence par l'activité HTTP Recevoir requête, vous pouvez utiliser l'Utilitaire de publication HTTP inclus avec l'installation de Studio, pour envoyer des requêtes HTTP au dispositif d'intégration écoutant, au moment de l'exécution. Vous pouvez accéder à l'Utilitaire de publication HTTP à partir du menu Démarrer ; sélectionnez pour cela l'option Programmes > IBM > WebSphere Cast Iron Studio > Utilitaire de publication HTTP. L'adresse URL que vous spécifiez pour le connecteur entrant doit être complète, par exemple : http://myAR:Port/Chemin.