Partager via

Résoudre les problèmes d’installation avec l’adaptateur SAP

  • Article

L’installation du pack d’adaptateurs Microsoft BizTalk copie les fichiers binaires de produit sur l’ordinateur et enregistre les liaisons pour chaque carte. Cette section décrit les techniques de résolution des problèmes pour résoudre les erreurs d’installation.

Journalisation des messages pour les actions d’installation

Le programme d’installation du pack d’adaptateurs BizTalk effectue la tâche standard d’installation du pack d’adaptateurs BizTalk. En outre, le programme d’installation effectue également certaines actions personnalisées telles que l’inscription des liaisons d’adaptateur. Vous pouvez enregistrer des messages pour les actions standard et personnalisées effectuées par l’installation.

  • Le programme d’installation du pack d’adaptateurs BizTalk installe les fichiers spécifiques de l’adaptateur à l’aide d’un MSI. Par conséquent, la journalisation de l’installation est la journalisation MSI standard.

  • Les journaux des actions personnalisées effectuées par le programme d’installation sont disponibles dans %TEMP%\adaptersetup.log. Si le suivi du fichier journal échoue, les traces sont également disponibles dans le journal des événements.

Le programme d’installation ne parvient pas à inscrire les liaisons d’adaptateurs ou les fournisseurs de données

Problème

L’Assistant Configuration du pack d’adaptateurs Microsoft BizTalk ne parvient pas à inscrire les liaisons d’adaptateur ou le fournisseur de données .NET Framework pour mySAP Business Suite, mais poursuit l’installation de l’adaptateur.

Cause

Cela peut résulter de problèmes liés à l’installation de Windows Communication Foundation (WCF), à l’installation du Kit de développement logiciel (SDK) de l’adaptateur métier (LOB) Microsoft Windows Communication Foundation (WCF) ou à l’endommagement du fichier machine.config. Les liaisons d’adaptateur sont écrites dans le fichier machine.config.

Résolution :

Vous devez inscrire manuellement la liaison d’adaptateur SAP ou le fournisseur de données pour SAP.

Inscrire les liaisons d’adaptateur ou le fournisseur de données

  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.

    Dans ce chemin, <la version> est la version du .NET Framework.

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

  3. Pour inscrire la liaison d’adaptateur SAP :

    1. Recherchez l’élément « system.serviceModel » et ajoutez les éléments suivants sous celui-ci :

      <client>  
  <endpoint binding="sapBinding" contract="IMetadataExchange" name="sap" />  
</client>

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

    3. Recherchez la liaison d’adaptateur SAP manquante. Ajoutez la section suivante sous le nœud « bindingElementExtensions ».

      Pour l’adaptateur SAP, ajoutez :

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

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

    5. Recherchez la liaison d’adaptateur SAP manquante. Ajoutez la section suivante sous le nœud « bindingExtensions ».

      Pour l’adaptateur SAP, ajoutez :

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

      Notes

      Pour plus d’informations sur la façon de déterminer la clé publique, consultez Détermination de la clé publique et de la version.

  4. Pour inscrire le fournisseur de données pour SAP :

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

    2. Recherchez le fournisseur de données manquant pour SAP. Ajoutez la section suivante sous le nœud « DbProviderFactories ».

      Pour 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>" />

  5. Enregistrez et fermez le fichier machine.config.

Détermination de la clé publique et de la version

Effectuez les étapes suivantes pour déterminer la clé publique de l’adaptateur SAP ou du fournisseur de données pour SAP.

  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 pour l’adaptateur SAP et le fournisseur de données pour SAP.

    Adaptateur/fournisseur de données Nom de la DLL
    Adaptateur SAP Microsoft.Adapters.SAP
    Fournisseur de données pour SAP Microsoft.Data.SAPClient

  3. Sous l’onglet Général , la valeur par rapport à l’étiquette Jeton de clé publique spécifie la clé publique pour la DLL. De même, la valeur par rapport à l’étiquette Version spécifie le numéro de version de la DLL.

  4. Copiez la clé publique, puis cliquez sur Annuler.

Erreur Aucune carte valide n’est installée

Problème

L’utilisation du plug-in Visual Studio Add Adapter Service ou du complément Consumer Adapter Service BizTalk Project à partir de Visual Studio sur un ordinateur 64 bits exécutant la version 64 bits du pack d’adaptateurs BizTalk entraîne l’erreur suivante :

No valid adapters are installed on this machine

Cause

L’adaptateur SAP est une liaison personnalisée WCF, inscrite sous System.ServiceModel dans le fichier machine.config. Une plateforme 64 bits a deux fichiers machine.config, l’un utilisé par les applications 32 bits et l’autre par les applications 64 bits. Par conséquent, lorsque vous installez la version 64 bits du pack d’adaptateurs BizTalk, l’Assistant Installation enregistre les liaisons dans la version 64 bits du fichier machine.config. Toutefois, Visual Studio s’exécute comme un processus 32 bits et, par conséquent, lorsque vous lancez le complément Consume Adapter Service à partir de Visual Studio, le plug-in vérifie les liaisons dans la version 32 bits du fichier machine.config et échoue, ce qui génère une erreur.

Résolution :

  • Installez les versions 32 bits et 64 bits du pack d’adaptateurs BizTalk sur une installation du Kit de développement logiciel (SDK) wcf LOB Adapter 64 bits.

    Important

    Vous devez uniquement disposer d’une installation du KIT de développement logiciel (SDK) de l’adaptateur LOB WCF 64 bits. L’installation côte à côte du Kit de développement logiciel (SDK) de l’adaptateur WCF LOB 32 bits et 64 bits sur un seul ordinateur n’est pas prise en charge.

  • Ajoutez les versions 32 bits et 64 bits des DLL clientes pour l’adaptateur SAP (par exemple, librfc32u.dll) à la variable PATH. La version 32 bits des DLL doit être ajoutée au dossier C :\Windows\SysWow64. La version 64 bits des DLL doit être ajoutée au dossier C :\Windows\System32.

    Important

    Si l’adaptateur (32 ou 64 bits) s’exécute sur un ordinateur doté d’un système d’exploitation 64 bits et que vous utilisez l’adaptateur pour écrire une application, vous devez marquer l’application avec le même type (32 ou 64 bits) que l’adaptateur. En outre, la version du Kit de développement logiciel (SDK) RFC (32 ou 64 bits) doit être identique à la version de l’adaptateur (32 ou 64 bits).

    Par exemple, si une carte 32 bits s’exécute sur un ordinateur doté d’un système d’exploitation 64 bits, l’application cliente de l’adaptateur doit être marquée comme 32 bits.

    Pour plus d’informations sur les DLL du client SAP, consultez Installer des RFC personnalisés pour le fournisseur de données pour SAP.

Erreur de liaison non valide lors de la configuration des ports d’adaptateur SAP

Problème

Lorsque vous essayez de configurer un port pour l’adaptateur dans BizTalk Server console Administration, vous obtenez l’erreur suivante :

"Unable to create binding configuration element for editing. Check the values of the BindingType and BindingConfiguration properties.  
(Microsoft.Biztalk.Adapter.Wcf.Converters.CreateBindingException) Unable to get binding type for binding extension "sapBinding".  
Verify the binding extension is registered in machine.config."

Cause

L’adaptateur SAP est une liaison personnalisée WCF, inscrite sous System.ServiceModel dans le fichier machine.config. Une plateforme 64 bits a deux fichiers machine.config, l’un utilisé par les applications 32 bits et l’autre par les applications 64 bits. Par conséquent, lorsque vous installez la version 64 bits du pack d’adaptateurs BizTalk, l’Assistant Installation enregistre les liaisons dans la version 64 bits du fichier machine.config. Toutefois, BizTalk Server console Administration s’exécute en tant que processus 32 bits et, par conséquent, lorsque vous configurez un port pour l’adaptateur, elle vérifie les liaisons dans la version 32 bits du fichier machine.config et échoue, ce qui génère une erreur.

Résolution :

  • Installez les versions 32 bits et 64 bits du pack d’adaptateurs BizTalk sur une installation du Kit de développement logiciel (SDK) wcf LOB Adapter 64 bits.

    Important

    Vous devez uniquement disposer d’une installation du KIT de développement logiciel (SDK) de l’adaptateur LOB WCF 64 bits. L’installation côte à côte du Kit de développement logiciel (SDK) de l’adaptateur WCF LOB 32 bits et 64 bits sur un seul ordinateur n’est pas prise en charge.

  • Ajoutez les versions 32 bits et 64 bits des DLL clientes pour l’adaptateur SAP (par exemple, librfc32u.dll) à la variable PATH. La version 32 bits des DLL doit être ajoutée au dossier C :\Windows\SysWow64. La version 64 bits des DLL doit être ajoutée au dossier C :\Windows\System32.

    Important

    Si l’adaptateur (32 ou 64 bits) s’exécute sur un ordinateur doté d’un système d’exploitation 64 bits et que vous utilisez l’adaptateur pour écrire une application, vous devez marquer l’application avec le même type (32 ou 64 bits) que l’adaptateur. En outre, la version du Kit de développement logiciel (SDK) RFC (32 ou 64 bits) doit être identique à la version de l’adaptateur (32 ou 64 bits).

    Par exemple, si une carte 32 bits s’exécute sur un ordinateur doté d’un système d’exploitation 64 bits, l’application cliente de l’adaptateur doit être marquée comme 32 bits.

    Pour plus d’informations sur les DLL du client SAP, consultez Installer des RFC personnalisés pour le fournisseur de données pour SAP.

Voir aussi

Résoudre les problèmes liés à l’adaptateur SAP