HTTPRequestResponse
L’exemple HTTPRequestResponse montre comment utiliser le filtre ISAPI (Internet Server Application Programming Interface) Microsoft BizTalk Server pour permettre à une application ASP.NET de communiquer avec une orchestration BizTalk Server.
Fonctions de l'exemple
Dans cet exemple, l’application ASP.NET envoie une demande au filtre ISAPI BizTalk Server. L'orchestration traite ce message et le renvoie à l'application ASP.NET à l'aide d'une réponse synchrone. Vous obtenez l’intégration entre l’orchestration BizTalk Server et l’application ASP.NET à l’aide du filtre ISAPI BizTalk Server.
Dans cet exemple, BizTalk Server et une application ASP.NET échanger des bons de commande (PO) et des messages d’accusé de réception de bon de commande à l’aide de la séquence d’étapes suivante :
Une application ASP.NET, à l’aide d’une requête HTTP, envoie un message DE commande XML à BizTalk Server.
BizTalk Server reçoit le message XML PO et construit un message d’accusé de réception XML PO, puis renvoie ce message à l’application ASP.NET dans la réponse HTTP.
L'application ASP.NET reçoit l'accusé de réception de bon de commande et actualise le formulaire Web avec des informations d'état extraites de la réponse.
Accès à l'exemple
<Chemin d’accès> d’exemples\AdaptersUsage\HTTPRequestResponse\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| Cleanup.bat | Annule le déploiement des assemblys et les supprime du GAC, supprime les ports d'envoi et de réception, ainsi que les répertoires virtuels Microsoft Internet Information Services. |
| HTTPRequestResponse.btproj, HTTPRequestResponse.sln | Fournit les fichiers source et de projet du projet BizTalk qui reçoit la requête HTTP, traite le message de bon de commande et émet la réponse. |
| HTTPRequestResponseBinding.xml | Fournit une installation automatisée, telle qu'une liaison de port. |
| POAck.xsd, POSchema.xsd | Fournissent respectivement des schémas pour l'accusé de réception de bon de commande et les fichiers .xml de bon de commande. |
| POReceiveOrchestration.odx | Fournit une orchestration BizTalk Server qui reçoit le bon de commande, le traite et émet l’accusé de réception du bon de commande. |
| Setup.bat | Crée et initialise l'exemple. |
| Dans le dossier \RequestResponse : AssemblyInfo.cs, default.aspx, default.aspx.cs, Global.asax, Global.asax.cs, RequestResponse.csproj, RequestResponse.csproj.webinfo, RequestResponse.sln, Web.config |
Fichiers constituant l'application ASP.NET qui sert de pilote pour cet exemple, y compris les fichiers de projet et de solution, les fichiers ASPX, Microsoft Visual C# .NET, les fichiers sources, etc. |
Génération et initialisation de cet exemple
Les procédures suivantes permettent de créer et d'initialiser l'exemple HTTPRequestResponse.
Pour créer et initialiser l'exemple
Dans une fenêtre de commande, accédez au dossier suivant :
<Chemin d’accès> des exemples\AdaptersUsage\HTTPRequestResponse
Exécutez le fichier Setup.bat, qui effectue les actions suivantes :
Compile et configure l'application ASP.NET utilisée pour piloter l'exemple.
Notes
Lors de la création d’un pool d’applications dans le Gestionnaire des services Internet, définissez la version de DefaultAppPool .NET Framework sur .Net Framework v4.0.
Compile et déploie l’orchestration BizTalk Server utilisée dans cet exemple.
Compile et déploie les projets Microsoft Visual Studio pour cet exemple.
Crée et lie les ports BizTalk Server nécessaires.
Démarre l’orchestration BizTalk Server.
Important
Vous devez modifier l'exemple de code qui implémente l'application Web (Default.aspx.cs) pour refléter votre environnement :
< http:// nom> de serveur/<dir> virtuel/BTSHTTPReceive.dll où
<servername>est le nom du serveur web sur lequel vous publiez, et<virtual dir>est le répertoire virtuel où réside ce fichier.Notes
Avant de tenter d'exécuter cet exemple, vous devez confirmer que BizTalk n'a signalé aucune erreur durant le processus de création et d'initialisation.
Notes
Si vous décidez d'ouvrir et de créer les projets de cet exemple sans exécuter le fichier Setup.bat, vous devez commencer par créer une paire de clés de nom fort à l'aide de .NET Framework Strong Name Utility (sn.exe). Celle-ci permet de signer les assemblys obtenus. Avant de tenter de créer ce projet, vous devez également supprimer manuellement les références aux fichiers default.aspx.resx et Global.asax.resx dans le fichier RequestResponse.csproj.
Notes
Pour annuler les modifications effectuées par Setup.bat, exécutez Cleanup.bat. Vous devez exécuter Cleanup.bat avant d'exécuter Cleanup.bat une seconde fois.
Notes
Vous devez configurer et activer les services IIS pour utiliser l'adaptateur de réception HTTP. Pour plus d’informations, consultez Comment configurer IIS pour un emplacement de réception HTTP.
Le fichier setup.bat configure le répertoire virtuel pour que cet exemple soit exécuté dans le pool d'applications IIS associé au site Web par défaut. Pour configurer le répertoire virtuel pour que cet exemple s’exécute dans le contexte d’un utilisateur dans les groupes d’utilisateurs hôtes isolés BizTalk et IIS_IURS , vous devez configurer le répertoire virtuel pour qu’il s’exécute dans un nouveau pool d’applications IIS. Configurez le répertoire virtuel pour qu’il s’exécute dans un nouveau pool d’applications IIS en effectuant les étapes suivantes :
Notes
Si vous avez déjà créé un pool d'applications pour un autre exemple de Kit de développement logiciel (SDK), vous pouvez passer à la dernière étape ci-dessous.
Cliquez sur Démarrer, pointez sur Tous les programmes et sur Outils d'administration, puis cliquez sur Gestionnaire des services Internet (IIS).
Dans le Gestionnaire des services Internet (IIS), accédez au dossier Pools d’applications .
Cliquez avec le bouton droit sur le dossier Pools d’applications , puis cliquez sur Nouveau, Pool d’applications...
Entrez un nom pour l’ID du pool d’applications : par exemple BizTalkSDKSamples, vérifiez que l’option Utiliser les paramètres par défaut pour le nouveau pool d’applications est sélectionnée, puis cliquez sur OK pour créer le nouveau pool d’applications.
Cliquez avec le bouton droit sur le nouveau pool d’applications, puis cliquez sur Propriétés.
Cliquez sur l’onglet Identité de la boîte de dialogue propriétés et modifiez l’identité sous laquelle ce pool d’applications s’exécute en un utilisateur membre du groupe d’utilisateurs d’hôtes isolés BizTalk . Cet utilisateur doit également être membre du groupe d’utilisateurs local IIS_IURS .
Configurez le répertoire virtuel pour que cet exemple de Kit de développement logiciel soit exécuté sous le nouveau pool d'applications. Le paramètre Pool d’applications est disponible sous l’onglet Répertoire virtuel de la boîte de dialogue Propriétés du répertoire virtuel. Le répertoire virtuel créé pour cet exemple est HttpRequestResponseSample.
Exécution de cet exemple
La procédure suivante permet d'exécuter l'exemple HTTPRequestResponse.
Pour exécuter l'exemple
Dans Internet Explorer, accédez àhttp://localhost/RequestResponse/.
Renseignez les champs nécessaires dans le formulaire Web, puis cliquez sur Passer une commande pour envoyer votre commande.
Observez l'état de votre commande lorsque le formulaire Web est actualisé après la réception d'une réponse.
Commentaires
L’extension BTSHTTPReceiveISAPI utilisée dans cet exemple est configurée pour fonctionner sur une installation par défaut d’un seul ordinateur. Pour étendre cet exemple pour d’autres configurations, consultez Adaptateur HTTP.
Vous pouvez étendre cet exemple aux applications qui sont requises pour envoyer des données à BizTalk Server via un formulaire Web ou via HTTP en général. En étendant la partie application ASP.NET de cet exemple, vous pouvez demander plus d’informations et effectuer d’autres prétraitements avant d’envoyer les données à BizTalk Server.