Instanciation d'un adaptateur par BizTalk Server

Lorsque le service BizTalk démarre, tous les adaptateurs de réception sont instanciés, à condition qu'ils disposent d'au moins un emplacement de réception configuré et actif. Par défaut, l'adaptateur d'envoi n'est instancié que lorsque le moteur de messagerie supprime de la file d'attente le premier message à envoyer par son intermédiaire (Cela est parfois appelé « création paresseuse. ») Toutefois, si vous devez instancier une carte d’envoi au démarrage du service, vous pouvez utiliser la fonctionnalité d’adaptateur InitTransmitterOnServiceStart . Cette fonction entraîne la création, par le moteur de messagerie, de l'adaptateur d'envoi au démarrage du service et permet d'empêcher la création différée par défaut. Cette création différée permet de limiter la quantité de ressources système utilisées lorsque les adaptateurs ne sont pas configurés sur les points de terminaison.

Il est recommandé, lors de la création d'un adaptateur personnalisé, d'utiliser un code géré. Il n'est toutefois pas impossible d'avoir recours aux composants COM natifs. Pour les composants COM, l’adaptateur est instancié normalement à l’aide de CoCreateInstance.

Pour le code managé, vous devez spécifier le type .NET dans le fichier de configuration ; le chemin d’assembly est facultatif.

Les options de déploiement suivantes sont possibles :

Type .NET Chemin de l'assembly Méthode de déploiement des assemblys
Spécifié Non spécifié Copier l'assembly dans le répertoire de produit ou sous-répertoire du répertoire de produit portant le même nom que l'assembly
Spécifié Non spécifié Assembly du GAC (Global Assembly Cache)
Spécifié Spécifié Copier l'assembly dans le répertoire spécifié

Conseil de résolution des problèmes : Lorsque vous créez un adaptateur à l’aide de code managé, si la création échoue, utilisez l’outil fuslogvw.exe pour déterminer s’il existe des références à des assemblys qui ne peuvent pas être résolues. Il s'agit d'une erreur fréquemment rencontrée.

Le schéma suivant montre la logique de création des adaptateurs, en fonction de la configuration spécifiée :

Image montrant la logique de création d’adaptateurs, en fonction de la configuration spécifiée.

Le tableau suivant montre un exemple de configuration pour un adaptateur de réception et un assembly d'exécution.

Méthode de déploiement des assemblys InboundTypeName InboundAssemblyPath
Spécifier l'emplacement de l'assembly Microsoft.Samples.MyReceiveAdapter C:\MyAdapter\MyAdapter.dll
Spécifier le type .NET (inclure la clé publique, la version et les informations de culture) Microsoft.Samples.MyReceiveAdapter, MyReceiveAdapter, Version=1.0.2510.24622, Culture=neutral, PublicKeyToken=077cf886a2d1c020 N/A
Assembly GAC Microsoft.Samples.MyReceiveAdapter, MyReceiveAdapter, Version=1.0.2510.24622, Culture=neutral, PublicKeyToken=077cf886a2d1c020 N/A