Étapes de post-installation pour BizTalk Adapter Pack 2016

Après avoir installé le pack d’adaptateurs BizTalk, il existe des étapes post-installation. Cette rubrique répertorie ces étapes.

Ajouter l’adaptateur à BizTalk Administration

1. Ouvrez la console Administration BizTalk Server.

2. Développez le groupe BizTalk, paramètres de la plateforme, puis sélectionnez Adaptateurs.

3. Cliquez avec le bouton droit sur Adaptateurs, sélectionnez Nouveau, puis Adaptateur.

   

4. Dans propriétés de l’adaptateur, sélectionnez un adaptateur dans la liste déroulante, par exemple WCF-SAP, puis entrez un nom, tel que WCF-SAP.

   

5. Sélectionnez OK.

Utiliser une version Oracle.DataAccess.dll plus récente

Lorsque vous configurez un port pour utiliser l’adaptateur WCF-OracleDB ou utilisez Visual Studio pour utiliser une carte générée, un message indique que l’adaptateur a besoin d'Oracle.DataAccess.dll version 2.111.7.0. Pour résoudre ce message, installez une version Oracle.DataAccess.dll prise en charge (voir la liste des versions prises en charge), puis mettez à jour l’élément bindingRedirect dans le fichier de configuration OracleDB en procédant comme suit :

1. Sur le BizTalk Server, accédez aux dossiers suivants :

   lecteur :\Program Files\Microsoft BizTalk Adapter Pack(x64)\bin

   drive :\Program Files (x86)\Microsoft BizTalk Adapter Pack\bin

2. Ouvrez le fichier Microsoft.Adapters.OracleDB.config.

3. Recherchez la section suivante, puis copiez/collez les éléments suivants :

   <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
             <dependentAssembly>
                       <assemblyIdentity name="Oracle.DataAccess" publicKeyToken="89b483f429c47342" culture="neutral" />
                       <bindingRedirect oldVersion="2.111.7.00" newVersion="2.112.1.00"/>
             </dependentAssembly>
   </assemblyBinding>
   
   

   Notes

   Dans cet exemple, nous définissons newVersion sur 2.112.1.00. Définissez cette valeur sur la version que vous avez installée.

Créer des objets de base de données SQL Server (adaptateur SAP uniquement)

Pour appeler des tRFCs dans un système SAP, exécutez le script SQL SapAdapter-DbScript-Install.sql . Ce script est installé avec l’installation du pack d’adaptateurs BizTalk et crée des objets de base de données dans SQL Server. Le script est généralement installé sur le <lecteur> d’installation :\Program Files\Microsoft BizTalk Adapter Pack. Vous pouvez exécuter ce script sur n’importe quelle base de données SQL Server, à condition d’entrer ce nom de base de données lors de l’utilisation de l’adaptateur pour appeler des TRFCs.

Inscrire les liaisons d’adaptateur

Pendant l’installation du pack d’adaptateurs BizTalk, l’Assistant Installation peut ne pas inscrire les liaisons d’adaptateur ou le fournisseur de données .NET Framework pour mySAP Business Suite. Et l’installation continue avec l’installation de l’adaptateur. Cela peut être dû à l’installation de Windows Communication Foundation (WCF), à l’installation du Kit de développement logiciel (SDK) de l’adaptateur métier Microsoft Windows Communication Foundation (WCF) ou à l’endommagement du fichier machine.config.

1. Accédez au fichier machine.config sur l’ordinateur. Par exemple, sur une plateforme 32 bits, le machine.config est disponible sous <lecteur> système :\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG.

2. Ouvrez le fichier dans un éditeur de texte.

3. Inscrivez les liaisons d’adaptateur :

   1. Recherchez l’élément system.serviceModel , puis ajoutez ce qui suit sous celui-ci :

      <client>
        <endpoint binding="sapBinding" contract="IMetadataExchange" name="sap" />
        <endpoint binding="siebelBinding" contract="IMetadataExchange" name="siebel" />
        <endpoint binding="oracleDBBinding" contract="IMetadataExchange" name="oracleDb" />
        <endpoint binding="oracleEBSBinding" contract="IMetadataExchange" name="oracleEBS" />
        <endpoint binding="sqlBinding" contract="IMetadataExchange" name="mssql" />
      </client>
      

   2. Recherchez l’élément bindingElementExtensions sous system.serviceModel\extensions.

   3. Recherchez la liaison d’adaptateur manquante. Ajoutez les sections suivantes sous le bindingElementExtensions nœud, en fonction de la liaison d’adaptateur manquante. Vous devez inscrire toutes les liaisons si l’Assistant Installation ne parvient pas à en inscrire.

      Pour l’adaptateur SAP, ajoutez :

      <add name="sapAdapter" type="Microsoft.Adapters.SAP.SAPAdapterExtensionElement,Microsoft.Adapters.SAP, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur Siebel, ajoutez :

      <add name="siebelAdapter" type="Microsoft.Adapters.Siebel.SiebelAdapterExtensionElement,Microsoft.Adapters.Siebel, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur Oracle Database, ajoutez :

      <add name="oracleDBAdapter" type="Microsoft.Adapters.OracleDB.OracleDBAdapterExtensionElement,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur Oracle E-Business, ajoutez :

      <add name="OracleEBSAdapter" type="Microsoft.Adapters.OracleEBS.OracleEBSBindingElementExtensionElement, Microsoft.Adapters.OracleEBS, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur SQL, ajoutez :

      <add name="sqlAdapter" type="Microsoft.Adapters.Sql.SqlAdapterBindingElementExtensionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

   4. Recherchez l’élément bindingExtensions sous system.serviceModel\extensions.

   5. Recherchez la liaison d’adaptateur manquante. Ajoutez les sections suivantes sous le bindingExtensions nœud, en fonction de la liaison d’adaptateur manquante. Vous devez inscrire toutes les liaisons si l’Assistant Installation ne parvient pas à en inscrire.

      Pour l’adaptateur SAP, ajoutez :

      <add name="sapBinding" type="Microsoft.Adapters.SAP.SAPAdapterBindingSection,Microsoft.Adapters.SAP, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur Siebel, ajoutez :

      <add name="siebelBinding" type="Microsoft.Adapters.Siebel.SiebelAdapterBindingSection,Microsoft.Adapters.Siebel, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur Oracle Database, ajoutez :

      <add name="oracleDBBinding" type="Microsoft.Adapters.OracleDB.OracleDBAdapterBindingSection,Microsoft.Adapters.OracleDB, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur Oracle E-Business, ajoutez :

      <add name="OracleEBSBinding" type="Microsoft.Adapters.OracleEBS.OracleEBSBindingCollectionElement, Microsoft.Adapters.OracleEBS,Microsoft.Adapters.OracleEBS, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour l’adaptateur SQL, ajoutez :

      <add name="sqlBinding" type="Microsoft.Adapters.Sql.SqlAdapterBindingCollectionElement,Microsoft.Adapters.Sql, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

   Notes

   Pour obtenir la valeur de la clé publique, consultez Déterminer la clé publique et la version (dans cette rubrique).

4. Inscrivez les fournisseurs de données .NET Framework :

   1. Recherchez l’élément DbProviderFactories sous le nœud system.data.

   2. Recherchez les fournisseurs de données .NET Framework manquants. Ajoutez les sections suivantes sous le DbProviderFactories nœud, en fonction du fournisseur manquant. Vous devez inscrire tous les fournisseurs si l’Assistant Installation ne parvient pas à en inscrire.

      Pour le fournisseur de données pour SAP, ajoutez :

      <add name="SAPClient Data Provider" invariant="Microsoft.Data.SAPClient"
          description=".NET Framework Data Provider for mySAP Business Suite"    type="Microsoft.Data.SAPClient.SAPClientFactory,Microsoft.Data.SAPClient, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

      Pour le fournisseur de données pour Siebel, ajoutez :

      <add name="SiebelClient Data Provider" invariant="Microsoft.Data.SiebelClient"
          description=".NET Framework Data Provider for Siebel eBusiness Applications"
          type="Microsoft.Data.SiebelClient.SiebelProviderFactory,Microsoft.Data.SiebelClient, Version=<version>, Culture=neutral, PublicKeyToken=<public key>" />
      

5. Enregistrez et fermez le fichier machine.config.

Déterminer la clé publique et la version

Effectuez les étapes suivantes pour déterminer la clé publique et la version d’un adaptateur ou du fournisseur de données .NET Framework.

1. Accédez au répertoire Windows, généralement C :\WINDOWS\assembly.

2. Cliquez avec le bouton droit sur la DLL pour laquelle vous souhaitez obtenir la clé publique, puis sélectionnez Propriétés. Le tableau suivant répertorie le nom des DLL de chaque adaptateur et fournisseur :

   Adaptateur/Fournisseur de données .NET Framework	Nom de la DLL
   Adaptateur SAP	Microsoft.Adapters.SAP
   Adaptateur Siebel	Microsoft.Adapters.Siebel
   Adaptateur de base de données Oracle	Microsoft.Adapters.OracleDB
   Adaptateur Oracle E-Business	Microsoft.Adapters.OracleEBS
   Adaptateur SQL	Microsoft.Adapters.Sql.dll
   Fournisseur de données pour SAP	Microsoft.Data.SAPClient
   Fournisseur de données pour Siebel	Microsoft.Data.SiebelClient

3. Sous l’onglet Général , la valeur Jeton de clé publique est la clé publique de la DLL. La valeur Version est le numéro de version de la DLL.

4. Copiez la clé publique, puis sélectionnez Annuler.

Installer les RFC personnalisés

Obligatoire uniquement si vous souhaitez utiliser le fournisseur de données pour SAP. Consultez Installer des RFC personnalisés dans la documentation de l’adaptateur SAP.

Installer les applications d’entreprise

Pour connaître les étapes et les conseils d’installation des différents systèmes métier d’entreprise, nous vous recommandons d’utiliser les guides d’installation fournis par le système d’entreprise. Reportez-vous également à la documentation de son adaptateur pour connaître les modifications de configuration spécifiques, le cas échéant.

Liste de vérification de l’installation et de la post-installation

• Vérifiez que vous avez installé tous les logiciels requis avec l’option d’installation correcte.

• Vérifiez que la version prise en charge des applications métier d’entreprise est installée sur votre ordinateur sur lequel vous avez installé le pack d’adaptateurs BizTalk. Consultez Systèmes métier pris en charge.

• Pour installer uniquement l’adaptateur pour le système métier d’entreprise que vous souhaitez connecter, vérifiez que vous avez installé le pack d’adaptateurs BizTalk à l’aide de l’option Installation personnalisée . Vérifiez que vous n’avez pas utilisé l’option Terminer l’installation. Consultez Installation du pack d’adaptateurs BizTalk.

• Si vous souhaitez effectuer des appels tRFC au système SAP à l’aide de l’adaptateur SAP, veillez à créer les tables requises dans une base de données SQL Server. Consultez Créer des objets de base de données SQL Server (dans cette rubrique).

• Lors de l’exécution de l’Assistant Installation du pack d’adaptateurs BizTalk, vous pouvez recevoir un message d’erreur indiquant que le programme d’installation n’a pas pu inscrire les liaisons. Si c’est le cas, inscrivez-les manuellement. Consultez Inscrire les liaisons d’adaptateur (dans cette rubrique).

• Si vous avez choisi d’installer le fournisseur de données pour SAP dans le cadre de l’installation du pack d’adaptateurs BizTalk, veillez à installer les RFC personnalisées sur le système SAP. Consultez Installer des RFC personnalisés.

Plus d’informations intéressantes

Faq sur la modification ou la suppression du pack d’adaptateurs BizTalk