Compartir a través de

Solución de problemas de instalación con el adaptador de SAP

  • Artículo

La instalación del paquete de adaptadores de Microsoft BizTalk copia los archivos binarios del producto en el equipo y registra los enlaces de cada adaptador. En esta sección se describen las técnicas de solución de problemas para resolver errores de instalación.

Registrar mensajes para acciones de configuración

El programa de instalación del paquete de adaptadores de BizTalk realiza la tarea estándar de instalar el paquete de adaptadores de BizTalk. Además, el programa de instalación también realiza determinadas acciones personalizadas, como registrar los enlaces del adaptador. Puede registrar mensajes tanto para el estándar como para las acciones personalizadas que realiza la configuración.

  • El programa de instalación del Paquete de adaptadores de BizTalk instala los archivos específicos del adaptador mediante una MSI. Por lo tanto, el registro de la instalación es el registro de MSI estándar.

  • Los registros de las acciones personalizadas que realiza el programa de instalación están disponibles en %TEMP%\adaptersetup.log. Si se produce un error en el seguimiento en el archivo de registro, los seguimientos también están disponibles en el registro de eventos.

El programa de instalación no puede registrar enlaces de adaptador o proveedores de datos

Problema

El Asistente para la instalación del paquete de adaptadores de Microsoft BizTalk no puede registrar los enlaces de adaptador o el proveedor de datos de .NET Framework para mySAP Business Suite, pero continúa con la instalación del adaptador.

Causa

Esto puede deberse a problemas con la instalación de Windows Communication Foundation (WCF), la instalación del SDK del adaptador de línea de negocio (LOB) de Microsoft Windows Communication Foundation (WCF) o el archivo machine.config está dañado. Los enlaces del adaptador se escriben en el archivo machine.config.

Resolución

Debe registrar manualmente el enlace del adaptador de SAP o el proveedor de datos para SAP.

Registrar los enlaces del adaptador o el proveedor de datos

  1. Vaya al archivo machine.config en el equipo. Por ejemplo, en una plataforma de 32 bits, el machine.config está disponible en <la unidad> del sistema:\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG.

    En esta ruta de acceso, <la versión> es la versión de .NET Framework.

  2. Abra el archivo con un editor de texto.

  3. Para registrar el enlace del adaptador de SAP:

    1. Busque el elemento "system.serviceModel" y agregue lo siguiente en él:

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

    2. Busque el elemento "bindingElementExtensions" en system.serviceModel\extensions.

    3. Busque el enlace de adaptador de SAP que falta. Agregue la siguiente sección en el nodo "bindingElementExtensions".

      Para el adaptador de SAP, agregue:

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

    4. Busque el elemento "bindingExtensions" en system.serviceModel\extensions.

    5. Busque el enlace de adaptador de SAP que falta. Agregue la siguiente sección en el nodo "bindingExtensions".

      Para el adaptador de SAP, agregue:

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

      Nota

      Para obtener información sobre cómo determinar la clave pública, vea Determinar la clave pública y la versión.

  4. Para registrar el proveedor de datos para SAP:

    1. Busque el elemento "DbProviderFactories" en el nodo "system.data".

    2. Busque el proveedor de datos que falta para SAP. Agregue la siguiente sección en el nodo "DbProviderFactories".

      En Proveedor de datos para SAP, agregue:

      <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. Guarde y cierre el archivo machine.config.

Determinar la clave pública y la versión

Realice los pasos siguientes para determinar la clave pública para el adaptador de SAP o el proveedor de datos para SAP.

  1. Vaya al directorio de Windows, normalmente C:\WINDOWS\assembly.

  2. Haga clic con el botón derecho en el archivo DLL para el que desea la clave pública y, a continuación, seleccione Propiedades. En la tabla siguiente se muestra el nombre de los archivos DLL para el adaptador de SAP y el proveedor de datos para SAP.

    Adaptador o proveedor de datos Nombre del archivo DLL
    SAP adapter Microsoft.Adapters.SAP
    Proveedor de datos para SAP Microsoft.Data.SAPClient

  3. En la pestaña General , el valor de la etiqueta Token de clave pública especifica la clave pública para el archivo DLL. Del mismo modo, el valor de la etiqueta Version especifica el número de versión del archivo DLL.

  4. Copie la clave pública y, a continuación, haga clic en Cancelar.

Error de instalación de ningún adaptador válido

Problema

El uso del complemento Agregar referencia de servicio de adaptador de Visual Studio o el complemento de proyecto de BizTalk del servicio de adaptador de Consumo de BizTalk desde Visual Studio en un equipo de 64 bits que ejecuta la versión de 64 bits del paquete de adaptadores de BizTalk da como resultado el siguiente error:

No valid adapters are installed on this machine

Causa

El adaptador de SAP es un enlace personalizado de WCF, que se registra en System.ServiceModel en el archivo machine.config. Una plataforma de 64 bits tiene dos archivos machine.config, uno utilizado por las aplicaciones de 32 bits y el otro usado por las aplicaciones de 64 bits. Por lo tanto, al instalar la versión de 64 bits del paquete de adaptadores de BizTalk, el asistente para instalación registra los enlaces en la versión de 64 bits del archivo machine.config. Sin embargo, Visual Studio se ejecuta como un proceso de 32 bits y, por lo tanto, al iniciar el complemento consumir servicio de adaptador desde Visual Studio, el complemento comprueba los enlaces en la versión de 32 bits del archivo machine.config y produce un error.

Resolución

  • Instale las versiones de 32 bits y 64 bits del paquete de adaptadores de BizTalk en una instalación del SDK del adaptador de LOB de WCF de 64 bits.

    Importante

    Solo debe tener una instalación del SDK del adaptador de LOB de WCF de 64 bits. No se admite la instalación en paralelo del SDK del adaptador de LOB de WCF de 32 y 64 bits en un solo equipo.

  • Agregue las versiones de 32 y 64 bits de los archivos DLL de cliente para el adaptador de SAP (como librfc32u.dll) a la variable PATH. La versión de 32 bits de los archivos DLL debe agregarse a la carpeta C:\Windows\SysWow64. La versión de 64 bits de los archivos DLL debe agregarse a la carpeta C:\Windows\System32.

    Importante

    Si el adaptador (32 o 64 bits) se ejecuta en un equipo que tiene un sistema operativo de 64 bits y usa el adaptador para escribir una aplicación, debe marcar la aplicación en el mismo tipo (32 o 64 bits) que el adaptador. Además, la versión del SDK de RFC (32 o 64 bits) debe ser la misma que la versión del adaptador (32 o 64 bits).

    Por ejemplo, si un adaptador de 32 bits se ejecuta en un equipo con un sistema operativo de 64 bits, la aplicación cliente del adaptador debe marcarse como de 32 bits.

    Para obtener más información sobre los archivos DLL de cliente de SAP, consulte Instalación de RFC personalizadas para el proveedor de datos para SAP.

Error de enlace no válido al configurar los puertos del adaptador de SAP

Problema

Al intentar configurar un puerto para el adaptador en BizTalk Server consola de administración, obtendrá el siguiente error:

"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."

Causa

El adaptador de SAP es un enlace personalizado de WCF, que se registra en System.ServiceModel en el archivo machine.config. Una plataforma de 64 bits tiene dos archivos machine.config, uno utilizado por las aplicaciones de 32 bits y el otro usado por las aplicaciones de 64 bits. Por lo tanto, al instalar la versión de 64 bits del paquete de adaptadores de BizTalk, el asistente para instalación registra los enlaces en la versión de 64 bits del archivo machine.config. Sin embargo, BizTalk Server consola de administración se ejecuta como un proceso de 32 bits y, por lo tanto, al configurar un puerto para el adaptador, comprueba los enlaces en la versión de 32 bits del archivo machine.config y produce un error.

Resolución

  • Instale las versiones de 32 bits y 64 bits del paquete de adaptadores de BizTalk en una instalación del SDK del adaptador de LOB de WCF de 64 bits.

    Importante

    Solo debe tener una instalación del SDK del adaptador de LOB de WCF de 64 bits. No se admite la instalación en paralelo del SDK del adaptador de LOB de WCF de 32 y 64 bits en un solo equipo.

  • Agregue las versiones de 32 y 64 bits de los archivos DLL de cliente para el adaptador de SAP (como librfc32u.dll) a la variable PATH. La versión de 32 bits de los archivos DLL debe agregarse a la carpeta C:\Windows\SysWow64. La versión de 64 bits de los archivos DLL debe agregarse a la carpeta C:\Windows\System32.

    Importante

    Si el adaptador (32 o 64 bits) se ejecuta en un equipo que tiene un sistema operativo de 64 bits y usa el adaptador para escribir una aplicación, debe marcar la aplicación en el mismo tipo (32 o 64 bits) que el adaptador. Además, la versión del SDK de RFC (32 o 64 bits) debe ser la misma que la versión del adaptador (32 o 64 bits).

    Por ejemplo, si un adaptador de 32 bits se ejecuta en un equipo con un sistema operativo de 64 bits, la aplicación cliente del adaptador debe marcarse como de 32 bits.

    Para obtener más información sobre los archivos DLL de cliente de SAP, consulte Instalación de RFC personalizadas para el proveedor de datos para SAP.

Consulte también

Solución de problemas del adaptador de SAP