Partager via

Déployer un adaptateur à l’aide du Kit de développement logiciel (SDK) de l’adaptateur métier WCF

  • Article

Pour déployer une carte, vous devez installer l’assembly d’adaptateur dans le global assembly cache (GAC), puis inscrire l’adaptateur dans le fichier machine.config.

Installer l’assembly d’adaptateur dans le GAC

Avant de consommer un adaptateur dans Visual Studio à l’aide de la commande Ajouter le plug-in de référence du service d’adaptateur ou dans BizTalk Server à l’aide de la fonctionnalité de complément Consommer le service d’adaptateur, vous devez installer l’assembly dans le GAC. Seuls les assemblys qui ont un nom fort peuvent être installés dans le GAC.

Notes

Pour effectuer cette procédure, vous devez être connecté avec un compte disposant des autorisations d’écriture sur le GAC. Le compte des administrateurs de l'ordinateur local dispose de ces autorisations.

Configurer un fichier de clé d’assembly de nom fort

  1. Dans Visual Studio, chargez le fichier projet de l’adaptateur qui a besoin d’un nom fort.

  2. Ouvrez une invite de commandes de Visual Studio.

  3. À l'invite de commandes, à partir du dossier dans lequel vous voulez stocker le fichier de clé, tapez la commande suivante, puis appuyez sur ENTRÉE :

    sn /kfile_name.snk

    Exemple : sn /k EchoAdapter.snk

    Message de confirmation, paire de clés écrite dans<file_name.snk>s’affiche, sur la ligne de commande.

  4. Dans Visual Studio Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis cliquez sur Propriétés.

  5. Dans le volet gauche, développez Propriétés communes, puis cliquez sur Assembly.

  6. Dans le volet droit, faites défiler jusqu’à la zone Nom fort .

  7. Dans la zone Nom fort , cliquez sur le champ en regard de Fichier de clé d’assembly, cliquez sur le bouton parcourir (...), puis accédez au fichier de clé.

  8. Cliquez sur le fichier de clé, sur Ouvrir, puis sur OK.

  9. Dans le menu Visual Studio, cliquez sur Générer, puis choisissez Générer une solution.

Notes

Si votre assembly d’adaptateur dépend d’autres assemblys, assurez-vous que ces assemblys référencés sont signés avec un nom fort ; sinon, vous obtiendrez une erreur.

Si vous avez la source, vous pouvez recompiler avec un nom fort comme indiqué précédemment. Si l’assembly de référence appartient à un tiers et que vous ne pouvez pas vous assurer qu’un nom fort lui sera attribué, vous pouvez désassembler puis réassembler l’assembly avec un nom fort.

Votre assembly d’origine étant remplacé, si vous souhaitez conserver la version d’origine, assurez-vous d’en faire une copie de sauvegarde avant de procéder aux étapes suivantes.

Utilisez le désassembleur MSIL (Microsoft Intermediate Language) pour désassembler l’assembly :

  • ILDASM thirdparty.dll /out :thirdparty.il

    Utilisez l’assembleur MSIL pour réassembler l’assembly avec un nom fort :

  • ILASM thirdparty.il /dll /key=strongkeyfile.snk

Installer un assembly dans le GAC

  1. Vérifiez que votre adaptateur a été signé.

  2. Ouvrez une invite de commandes de Visual Studio.

  3. Tapez la commande suivante :

    gacutil.exe /if »<chemin d’accès au fichier de .dll d’assembly»>

  4. Cette procédure installe l'assembly dans le GAC, en remplaçant tout autre assembly existant sous le même nom.

Inscrire l’adaptateur dans Machine.config

Un adaptateur développé à l’aide du Kit de développement logiciel (SDK) de l’adaptateur LOB WCF est mis en évidence sous la forme d’une liaison WCF. Pour plus d’informations, consultez Microsoft.ServiceModel.Channels.Common.AdapterBinding. La liaison d’adaptateur est inscrite auprès de WCF à l’aide <de la section bindingExtensions> dans le <système. ServiceModel> et l’élément de liaison de transport de l’adaptateur sont inscrits auprès de WCF à l’aide <de la section bindingElementExtensions> dans le <système. ServiceModel>.

Vous pouvez modifier manuellement le fichier machine.config à l’aide d’un éditeur de texte.

Modifier manuellement le fichier machine.config

  1. Modifiez le fichier machine.config situé dans le dossier de configuration Microsoft .NET. Pour ce faire, cliquez sur Démarrer, sur Exécuter, tapez bloc-notes <Chemin> d’installation Windows\Microsoft.NET\Framework\<version>\CONFIG\machine.config, puis cliquez sur OK.

  2. Mettez à jour le fichier machine.config. Si le fichier ne contient pas de section system.serviceModel, ajoutez la section suivante à la fin du fichier de configuration, mais avant la balise racine fermante.

    Notes

    Remplacez « myAdapterBinding », la version, la culture et d’autres informations spécifiques à l’assembly par les informations de votre adaptateur.

    <system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
        <add name="myAdapterBinding" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingCollectionElement,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken= fafafafafafafafa" />  
    </bindingExtensions>      <bindingElementExtensions>  
        <add name="echoAdapter" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingElementExtension,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken=37f23b4adb996dcf" />  
      </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>

    • - OU -

      Si votre fichier machine.config contient une section system.serviceModel, déterminez les éléments manquants et ajoutez-les, en remplaçant « MyAdapter » et d’autres informations par les informations de votre adaptateur.

    <extensions>  
  <bindingExtensions>  
        <add name="myAdapterBinding" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingCollectionElement,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken= fafafafafafafafa" />  
  </bindingExtensions>  
      <bindingElementExtensions>  
        <add name="echoAdapter" type="Microsoft.Adapters.Samples.Echo.EchoAdapterBindingElementExtension,EchoAdapter, Version=0.0.0.0, Culture=neutral, PublicKeyToken=37f23b4adb996dcf" />  
      </bindingElementExtensions>  
</extensions>

  3. Fermez et enregistrez le fichier machine.config.

    Vous pouvez également utiliser l’Éditeur de configuration du service pour modifier le fichier machine.config.

Modifier le fichier machine.config à l’aide de l’Éditeur de configuration de service

  1. Ouvrez l’Éditeur de configuration du service. Pour plus d’informations, consultez Éditeur de configuration de service .

  2. Dans le volet d’arborescence (intitulé Configuration), développez l’arborescence des nœuds. Cliquez sur le dossier Avancé , sur le dossier Extensions , puis sélectionnez l’élément extensions de liaison.

    Éditeur de configuration de service.

  3. Créez une extension de liaison. Cliquez sur le bouton Nouveau pour ouvrir la boîte de dialogue Éditeur d’éléments de configuration d’extension. Dans Nom de la configuration, entrez un nom unique pour les extensions, par exemple MyAdapterExtension.

    Éditeur d’élément de configuration d’extension

  4. Cliquez sur le champ Type , puis sur le bouton de sélection (...) pour ouvrir la boîte de dialogue Navigateur de type d’extension de liaison .

  5. Cliquez sur l’icône global assembly cache (GAC) pour répertorier les DLL dans le GAC.

  6. Cliquez sur votre assembly d’adaptateur.

    Capture d’écran montrant le navigateur de type d’extension de liaison.

  7. Cliquez sur le bouton Ouvrir pour sélectionner l’assembly.

  8. Dans la boîte de dialogue Explorateur de type d’extension de liaison , cliquez sur le nom de type qui implémente l’élément de collection de liaison.

    Capture d’écran montrant où sélectionner le nom de type qui implémente l’élément de collection de liaison.

  9. Cliquez sur le bouton Ouvrir pour sélectionner le type.

  10. Cliquez sur OK pour fermer la boîte de dialogue Éditeur d’éléments de configuration d’extension .

  11. Dans le volet d’informations de l’Éditeur d’extensions de liaison, vérifiez que votre extension de liaison s’affiche. Dans la figure suivante, MyAdapterExtension est mis en surbrillance.

    Éditeur de configuration de service avec extension ajoutée.

  12. Fermez l’Éditeur de configuration de service.

Voir aussi

Déployer un adaptateur à l’aide du Kit de développement logiciel (SDK) de l’adaptateur métier WCF