Configuration de la conception de l'adaptateur
Les adaptateurs contiennent à la fois un composant de conception et un composant d'exécution. Le composant d'exécution n'est pas not visible pour les utilisateurs. Il est responsable en toute transparence de la transmission, de la réception et du traitement de BizTalk Server messages.
Le composant de conception d'un adaptateur est visible par l'intermédiaire d'interfaces utilisateur administratives. Il affiche les propriétés disponibles, accepte les saisies administratives et valide ces saisies dans un objectif de configuration de l'adaptateur. Il est indispensable que ce composant de conception permette une configuration appropriée des propriétés de l'adaptateur afin que le composant d'exécution puisse ensuite remplir sa fonction d'échange de messages.
Cette section décrit uniquement le composant de conception des adaptateurs. Elle s'attache principalement à expliquer comment afficher et définir la configuration de ces adaptateurs. Il existe deux façons de configurer un adaptateur :
Explorateur de propriétés. Les propriétés d’adaptateur d’un port d’envoi ou de réception, ou d’un gestionnaire d’envoi ou de réception, sont configurées via leur menu Propriétés à l’aide de la console Administration BizTalk Server. Pendant la configuration de ces artefacts, l'adaptateur (transport) est sélectionné et ses propriétés sont configurées grâce à un explorateur de propriétés. Les propriétés applicables sont affichées par l'intermédiaire d'un schéma avec un nom de groupe. Par exemple, pour un gestionnaire d'envoi (transmission), les propriétés figurent dans le fichier TransmitHandler.xsd. Pour un emplacement de réception, elles figurent dans le fichier ReceiveLocation.xsd. L’adaptateur implémente l’interface IAdapterConfig pour localiser et charger le schéma approprié afin d’exposer des propriétés spécifiques dans le navigateur de propriétés. L’interface IAdapterConfigValidation permet de valider ces entrées et d’apporter des modifications finales aux valeurs avant d’enregistrer les données de configuration.
Assistant Ajouter les métadonnées de l'adaptateur : Dans le cas des adaptateurs d’application et de base de données, vous devrez peut-être importer des schémas de prise en charge qui décrivent les types de messages et les types de port dont l’adaptateur a besoin dans le projet BizTalk dans Visual Studio. Il est également parfois nécessaire de consommer les services fournis par l'adaptateur. L'Assistant Ajouter les métadonnées de l'adaptateur vous permet de visualiser les services qu'un adaptateur prend en charge et d'importer les types de messages et de ports associés dans vos projets. Ce processus est appelé « collecte de métadonnées ». En tant que développeur d’adaptateurs, vous créez un fichier XML décrivant ces services et l’exposez à l’Assistant au moment de la conception via l’interface IStaticAdapterConfig ou IDynamicAdapterConfig , avec les résultats suivants :
Adaptateur statique. L'Assistant fournit une arborescence hiérarchique par défaut standard pour présenter les services de l'adaptateur. Un adaptateur statique est un adaptateur qui utilise l'interface utilisateur de l'arborescence standard fournie par l'Assistant. Utilisez les méthodes IStaticAdapterConfig.GetServiceOrganization et GetServiceDescription pour permettre l’ajout de services sélectionnés au projet BizTalk. Il s'agit de l'option de configuration la plus simple pour un développeur d'adaptateur. Cependant, l'inconvénient est la rigidité du format d'affichage.
Adaptateur dynamique. Si l'interface utilisateur de sélection de service de base fournie par l'Assistant n'est pas assez souple pour vous, vous pouvez créer une interface personnalisée, affichée de façon dynamique par l'Assistant. Utilisez la méthode IDynamicAdapterConfig.DisplayUI pour afficher l’interface utilisateur personnalisée afin de permettre l’ajout de services à un projet BizTalk.
Cette section propose deux ensembles d'instructions pour gérer la configuration de la conception de façon statique ou dynamique.
Le kit de développement logiciel (SDK) Microsoft BizTalk Server inclut un exemple d’adaptateur de fichier que vous pouvez utiliser comme modèle pour créer et personnaliser vos propres solutions de configuration au moment de la conception de l’adaptateur. Des notes et références portant sur cet exemple d'adaptateur sont fournies dans chaque rubrique de configuration de la conception pour vous aider à modifier vos propres exigences de configuration personnalisées. Pour mieux comprendre ces instructions, vous pouvez installer, créer et exécuter l'exemple d'adaptateur File fourni dans le kit. Pour plus d’informations, consultez Adaptateur de fichier (exemple BizTalk Server).