Adaptateur HTTP (exemple BizTalk Server)
L’exemple d’adaptateur HTTP montre comment implémenter les paradigmes de communication de requête/réponse et de sollicitation/réponse utilisés dans BizTalk Server.
Accès à l'exemple
<Samples Path>\AdaptersDevelopment\HttpAdapter\
Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.
| Fichier(s) | Description |
|---|---|
| \Design-Time\Adapter Management | Contient le projet qui implémente la phase de conception de cet adaptateur. |
| \Run-Time\HttpReceive | Contient le projet qui implémente le modèle de communication de l'adaptateur de requête/réponse. Il s'agit d'un récepteur isolé. |
| \Run-Time\HttpSend | Contient le projet qui implémente le modèle de communication de l'adaptateur de type sollicitation/réponse. |
Guide pratique pour utiliser cet exemple
Cet exemple est conçu comme une infrastructure que vous utilisez pour développer des adaptateurs personnalisés. Il peut arriver que BizTalk Server doive acheminer des messages vers une application personnalisée ou utiliser un protocole pour lequel aucun adaptateur natif n'est prévu. Des entreprises tierces ont élaboré des adaptateurs qui prennent en charge des protocoles supplémentaires, et vous souhaitez peut-être savoir s'il existe un adaptateur adapté à votre protocole avant d'écrire le vôtre. Si vous ne parvenez pas à trouver un adaptateur qui prenne en charge vos conditions de communication, il vous reste la possibilité de développer votre propre adaptateur.
L'écriture d'un adaptateur personnalisé peut se révéler difficile. Pour vous faciliter la tâche, Microsoft a développé une structure de base appelée Infrastructure d'adaptateurs. Vous pouvez vous baser sur cette infrastructure, de même que vous pouvez utiliser l'exemple de code source fourni dans le kit SDK de BizTalk Server. Pour plus d’informations sur les adaptateurs personnalisés et l’infrastructure d’adaptateur, reportez-vous à la section Voir aussi à la fin de ce document.
Création et initialisation de l'exemple d'adaptateur
Important
Si l'installation BizTalk est 64 bits ou si son emplacement a été modifié, les valeurs OutboundAssemblyPath, InboundAssemblyPath, AdapterMgmtAssemblyPath doivent être modifiées en conséquence.
Pour créer et initialiser l'exemple d'adaptateur HTTP
Dans une fenêtre de commande, accédez au dossier suivant :
<Chemin d’accès> des exemples\AdaptersDevelopment\HttpAdapter
Exécutez le fichier Setup.bat, qui effectue les actions suivantes :
Compile HTTPAdapter et toutes ses dépendances.
Crée une application IIS utilisée par le côté récepteur de l'adaptateur.
Sous IIS port d'envoi, vous devez vérifier que l'identité du pool d'applications exécutant cette application IIS est membre des groupes suivants :
groupe Utilisateurs d'hôtes BizTalk isolés ;
groupe IIS_WPG.
Sur IIS 7.0, vous devez migrer l’application pour qu’elle fonctionne avec le mode .NET intégré. Vous pouvez migrer la configuration de l’application, y compris le contenu de la <section de configuration httpHandlers> , à l’aide de ce qui suit à partir d’une fenêtre de ligne de commande (la fenêtre doit s’exécuter en tant qu’administrateur) :
%systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"Après avoir migré votre application, elle sera exécutée en mode classique et en mode .NET intégré, tout comme sur les plateformes de niveau inférieur.
Notes
Avant de tenter d'exécuter cet exemple, vous devez vérifier qu'aucune erreur n'a été signalée 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.
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.
Enregistrement de l'exemple d'adaptateur
Pour enregistrer l'exemple d'adaptateur HTTP
Dans Windows Explorer, accédez au lecteur d’installation pour BizTalk Server, puis accédez à <Samples Path>\AdaptersDevelopment\HTTPAdapter.
Pour ajouter l’exemple d’adaptateur au Registre, double-cliquez sur HTTP. NET.reg.
Notes
HTTP. NET.reg inclut des chemins codés en dur vers le répertoire d’installation BizTalk Server. Si vous n’avez pas installé BizTalk Server à l’emplacement par défaut ou si vous avez mis à niveau votre installation de BizTalk Server à partir d’une version précédente de BizTalk Server, vous devez modifier le fichier HTTP. NET.reg avec les chemins appropriés. Mettez à jour les chemins d'accès associés aux valeurs « OutboundAssemblyPath » et « AdapterMgmtAssemblyPath » afin qu'ils pointent vers l'emplacement exact des fichiers spécifiés.
Important
Si vous installez BizTalk sur un ordinateur 64 bits, modifiez toutes les instances de l’entrée de Registre HKEY_CLASSES_ROOT\CLSID\ en HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ dans le http. Fichier de Registre NET.reg .
Dans la boîte de dialogue Éditeur du Registre , cliquez sur Oui pour ajouter l’exemple d’adaptateur au Registre, puis cliquez sur OK.
Pour fermer Windows Explorer, dans le menu Fichier, cliquez sur Fermer.
Installation de l'exemple d'adaptateur
Pour installer l'exemple d'adaptateur HTTP
Cliquez sur le menu Démarrer, sélectionnez Tous les programmes, Microsoft BizTalk Server 20xx, puis BizTalk Server Administration.
Dans la console Administration BizTalk Server, développez l’arborescence Administration BizTalk Server, puis l’arborescence BizTalk Group, puis l’arborescence Paramètres de plateforme.
Cliquez avec le bouton droit sur Adaptateurs, cliquez sur Nouveau, puis sur Adaptateur.
Dans la boîte de dialogue Propriétés de l’adaptateur, procédez comme suit.
Propriété Pour Nom Tapez HTTP.NET. Adaptateur Sélectionnez HTTP.NET dans la liste déroulante. Description Type Sample HTTP.NET Adapter. Cliquez sur OK.
L'adaptateur apparaît dans la liste des adaptateurs, dans la fenêtre droite de la console Administration de BizTalk.
Arrêt et redémarrage de l'instance de l'hôte
Pour arrêter et redémarrer l'instance de l'hôte pour l'exemple d'adaptateur HTTP
Cliquez sur le menu Démarrer, sélectionnez Tous les programmes, Microsoft BizTalk Server 20xx, puis BizTalk Server Administration.
Dans la console Administration BizTalk Server, développez l’arborescence Administration BizTalk Server, puis Paramètres de plateforme, puis cliquez sur Instances d’hôte.
Dans le volet de résultats, cliquez avec le bouton droit sur le instance hôte (généralement, le nom de l’ordinateur), puis cliquez sur Arrêter.
Le status de l’hôte instance passe à Arrêté.
Dans le volet de résultats, cliquez avec le bouton droit sur l’hôte instance, puis cliquez sur Démarrer.
L'adaptateur HTTP.NET peut maintenant être utilisé par votre application. Lors de la configuration de l’adaptateur, le format de la propriété de transport Virtual Directory est de la forme suivante : /httpreceive/httpreceive.aspx ?optionalQueryString.
Commentaires
L’adaptateur HTTP.NET utilise les classes BaseAdapter fournies dans <Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0.. 2\. Les classes fournies dans le projet BaseAdapter sont conçues pour accélérer le développement de l'adaptateur. Pour plus d'informations sur les classes fournies, consultez les commentaires du code BaseAdapter.
Voir aussi
Inscription d’un adaptateur
Exemples d’adaptateurs- Utilisation
Développement d’adaptateurs personnalisés
Présentation de l’infrastructure d’adaptateurs
Utilisation des outils de l’infrastructure d’adaptateurs
Développement d’un adaptateur de réception
Développement d’un adaptateur d’envoi
Déploiement d'un adaptateur personnalisé
Conseils pour la conception de votre adaptateur
Configuration de l’adaptateur au moment du design