Activité HTTP Recevoir demande
Utilisez l'activité HTTP Recevoir demande pour configurer le dispositif d'intégration afin qu'il agisse comme écouteur HTTP.

- Un travail d'orchestration est démarré.
- L'activité HTTP Recevoir demande traite la demande HTTP entrante et la mappe à ses paramètres de sortie.
- 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.
- Les activités restantes de l'orchestration sont traitées. (Dans la représentation graphique de l'orchestration, les activités restantes sont celles qui se trouvent à droite de l'activité HTTP Recevoir demande).
Vous ne pouvez pas déployer deux activités HTTP Recevoir demande sur le dispositif avec les mêmes détails de noeud final, URL et méthode.
Pour une seule activité HTTP Recevoir demande
Si vous ne déployez qu'une seule activité HTTP Recevoir demande pour une URL, l'orchestration accepte toutes les demandes avec des URL commençant par cette URL de base. Par exemple, si l'URL en question est /customer, l'orchestration acceptera des demandes telles que /customer, /customer/21 et /customer/21/dept.
Si vous déployez une activité HTTP Recevoir demande pour une URL configurée avec des paramètres de chemin, l'orchestration acceptera uniquement les demandes dont les URL correspondent à l'URL configurée, avec des valeurs pour les paramètres de chemin. Par exemple, si l'URL configurée est /customer/{custid}, l'orchestration acceptera des demandes telles que /customer/10, /customer/21 et /customer/dept. En revanche, des URL telles que /customer et /customer/21/dept ne seront pas acceptées.
Pour plusieurs activités HTTP Recevoir demande
Si vous déployez deux activités HTTP Recevoir demande configurées avec la même URL de base, l'une d'elles étant par ailleurs configurée avec un paramètre de chemin, ces activités acceptent les demandes dont l'URL correspond strictement à leur URL configurée. Par exemple, si les deux activités déployées sont configurées l'une avec l'URL /customer, l'autre avec l'URL /customer/{paramètre de chemin}, une demande telle que /customer sera dirigée vers l'activité configurée avec /customer. Une demande telle que /customer/007 sera quant à elle dirigée vers l'activité configurée avec /customer/{paramètre de chemin}. Enfin, des demandes telles que /customer/dept/1 et /customer/12/21 ne seront acceptées par aucune des deux activités.
Ajouter une activité HTTP Recevoir demande à 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é Recevoir demande et déposez-la sur l'orchestration.
- 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
- 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 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 Description URL (chemin après le nom d'hôte) Chemin de ressource où le dispositif d'intégration écoute les demandes HTTP entrantes, 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 que le dispositif d'intégration utilise pour écouter les demandes 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'URL complète sur laquelle le dispositif d'intégration écoute les demandes HTTP 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 HTTP Recevoir demande 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 sorties. Les paramètres de requête sont affichés sous /httpheaders/queryParameters dans le panneau Mapper les sorties.
Remarque : Dans l'URL, la valeur que vous affectez à un paramètre de requête n'est pas passée au mappeur. La valeur utilisée provient du serveur et est tirée de la demande entrante.Remarque : Le chemin sur lequel le dispositif d'intégration écoute les demandes HTTP entrantes est une chaîne de chemin de ressource que vous indiquez ; elle ne correspond pas à un chemin de répertoire réel sur le dispositif d'intégration.Méthode Spécifie quelle méthode HTTP est acceptée par le serveur à l'écoute. De type Type de message attendu de la demande HTTP - Texte ou Binaire. Réponse requise Spécifie si une réponse doit être envoyée à l'émetteur de la demande. Remarque : Si cette case est cochée, vous devez ajouter et configurer une activité HTTP Envoyer une 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 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é 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 sorties.
Définition des informations Swagger
- Sélectionnez la tâche Swagger dans la liste de contrôle pour définir un exemple de message.
- Indiquez les informations relatives à l'exemple de demande (JSON) et à l'exemple de réponse (JSON). Si vous ne spécifiez aucun exemple de demande, la sortie Swagger qui s'affiche contient des exemples d'objet vides.
- Cliquez sur le bouton Generate Swagger qui affichera le code dans la zone de texte Swagger Output. Vous pouvez également cliquer sur Download Swagger pour télécharger et partager le fichier, si nécessaire.
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 2. Paramètre de sortie Description httpheaders En-tête de la demande HTTP. body Corps du message de la demande HTTP. Tableau 3. Noeuds du paramètre de sortie httpheaders Description httpheaders/uri Chemin de ressource de la demande entrante ; par exemple, /chemin. httpheaders/method Type de demande HTTP. httpheaders/host Spécifie l'adresse IP ou le nom d'hôte du client. 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/<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/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. Remarque : Pour tester l'orchestration qui commence par l'activité HTTP Recevoir demande, vous pouvez utiliser l'Utilitaire de publication HTTP inclus avec l'installation de Studio, pour envoyer des demandes 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 . L'adresse URL que vous spécifiez pour le connecteur entrant doit être complète, par exemple : http://monAR:Port/Chemin.