Configuration d'un gestionnaire de réception WCF-Custom
Vous devez configurer les propriétés du gestionnaire de réception si vous souhaitez que l’adaptateur WCF-Custom recherche les extensions de comportement personnalisées à partir d’emplacements autres que machine.config.
Pourquoi WCF-Custom adaptateur recherche-t-il des extensions de comportement personnalisées à partir d’emplacements autres que machine.config ?
Les extensions de comportement personnalisées utilisées par BizTalk Server sont inscrites dans le machine.config. Avant de charger les extensions de comportement, l’adaptateur WCF-Custom recherche les extensions de comportement dans machine.config. Toutefois, machine.config est idéalement utilisé pour stocker les informations de configuration requises pour toutes les applications s’exécutant sur un ordinateur particulier. En revanche, les extensions de comportement personnalisés WCF peuvent être requises uniquement par BizTalk Server et non par toutes les applications exécutées sur l’ordinateur. Ainsi, si le fichier machine.config stocke de fait les extensions de comportement personnalisées, il ne constitue pas un emplacement optimal.
Avec BizTalk Server, les propriétés du gestionnaire d’adaptateur fournissent un emplacement supplémentaire à partir duquel l’adaptateur WCF-Custom peut rechercher les extensions de comportement personnalisées. Notez que cela ne remplace pas les extensions de comportement par ailleurs disponibles dans le fichier machine.config.
Considérations supplémentaires
Gardez les points suivants à l'esprit lors de la configuration des propriétés du gestionnaire de réception WCF-Custom :
Les extensions de comportement personnalisées doivent être disponibles dans le fichier machine.config ou les propriétés du gestionnaire d'adaptateur. Elles ne doivent pas figurer aux deux emplacements.
Si une extension de comportement personnalisée est déjà disponible dans le fichier machine.config et que vous tentez de définir la même extension de comportement dans les propriétés du gestionnaire d'adaptateur, une erreur est générée.
Si une extension de comportement personnalisée est déjà définie dans les propriétés du gestionnaire d'adaptateur et que vous mettez à jour le fichier machine.config avec la même extension de comportement, une erreur d'exécution est générée et consignée dans le journal des événements. L'emplacement de réception est également désactivé.
Les assemblys référencés dans l'extension de comportement personnalisée doivent figurer dans le GAC (Global Assembly Cache) avant la définition des propriétés du gestionnaire d'adaptateur.
Configuration des propriétés du gestionnaire d'adaptateur
Utilisez la procédure de cette rubrique pour configurer un gestionnaire de réception WCF-Custom.
Pour configurer les propriétés du gestionnaire d'adaptateur
Dans la console d’administration BizTalk, développez BizTalk ServerAdministration, BizTalk Group, Paramètres de la plateforme, puis Cartes.
Dans la liste de l’adaptateur développée, cliquez sur WCF-Custom, dans le volet droit, cliquez avec le bouton droit sur le gestionnaire de réception que vous souhaitez configurer, puis cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés du gestionnaire d’adaptateur, sous l’onglet Général , dans la liste Nom d’hôte , sélectionnez l’hôte auquel le gestionnaire de réception sera associé, puis cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés de transport personnalisées WCF , sous l’onglet Extensions WCF , procédez comme suit :
Propriété Pour Importer Importer un fichier de configuration WCF avec des extensions de comportement personnalisées WCF. Cliquez sur ce bouton pour ouvrir la boîte de dialogue Importer la configuration WCF pour parcourir et localiser un fichier de configuration WCF. Notez que le fichier doit être un fichier de configuration WCF valide. Pour plus d’informations sur le schéma de configuration WCF, consultez « Schéma de configuration de Windows Communication Foundation » à l’adresse https://go.microsoft.com/fwlink/?LinkId=163953. Export Exporter l'extension de comportement personnalisée WCF vers un fichier de configuration WCF. Cliquez sur ce bouton pour ouvrir la boîte de dialogue Exporter la configuration WCF pour parcourir et enregistrer le fichier de configuration WCF. Clear Effacer l'extension de comportement personnalisée WCF existante dans les propriétés du gestionnaire d'adaptateur.