BizTalk 适配器包 2016 的安装后步骤

项目
07/21/2023

安装 BizTalk 适配器包后，有一些安装后的步骤。本主题列出了这些步骤。

将适配器添加到 BizTalk 管理

打开 BizTalk Server 管理控制台。
展开 BizTalk 组，展开 “平台设置”，然后选择“ 适配器”。
右键单击“ 适配器”，选择“ 新建”，然后选择“ 适配器”。
在 “适配器属性”中，从下拉列表中选择一个适配器，例如 WCF-SAP，然后输入名称，例如 WCF-SAP。
选择“确定”。

使用较新的 Oracle.DataAccess.dll 版本

将端口配置为使用 WCF-OracleDB 适配器或使用 Visual Studio 使用生成的适配器时，会显示一条消息，指出适配器需要 Oracle.DataAccess.dll 版本 2.111.7.0。若要解决此消息，请安装受支持的 Oracle.DataAccess.dll 版本 (查看支持的版本列表) ，然后使用以下步骤更新 bindingRedirect OracleDB 配置文件中的元素：

在BizTalk Server，转到以下文件夹：

drive：\Program Files\Microsoft BizTalk Adapter Pack (x64) \bin

drive：\Program Files (x86) \Microsoft BizTalk Adapter Pack\bin
打开 Microsoft.Adapters.OracleDB.config 文件。

找到以下部分，然后复制/粘贴以下内容：

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

注意

在此示例中，我们将 newVersion 设置为 2.112.1.00。将此值设置为已安装的版本。

重要

如果此组中有多个 BizTalk 服务器，请在组中的所有 BizTalk 服务器上进行此更改。
需要根据计算机上安装的 Oracle.DataAccess.dll 文件的版本更新 newVersion 值。 Oracle.DataAccess.dll 包含在从 Oracle 安装的 Oracle 客户端中。必须仅安装 BizTalk 适配器包支持的 Oracle 客户端版本。

仅) (SAP 适配器创建 SQL Server 数据库对象

若要在 SAP 系统中调用 tRFC，请运行 SapAdapter-DbScript-Install.sql SQL 脚本。此脚本随 BizTalk 适配器包安装一起安装，并在 SQL Server 中创建数据库对象。该脚本通常安装在安装驱动器>：\Program Files\Microsoft BizTalk 适配器包中<。只要在使用适配器调用 tRFC 时输入该数据库名称，就可以针对任何SQL Server数据库运行此脚本。

注册适配器绑定

在 BizTalk 适配器包安装过程中，安装向导可能无法为 mySAP Business Suite 注册适配器绑定或.NET Framework数据提供程序。安装适配器后，安装过程会继续。这可能是由 Windows Communication Foundation (WCF) 安装、Microsoft Windows Communication Foundation (WCF) 业务线 (LOB) 适配器 SDK 安装或 machine.config 文件损坏造成的。

重要

仅当安装向导无法注册适配器绑定或在 machine.config 文件中.NET Framework数据提供程序时，才完成以下步骤。

转到计算机上的 machine.config 文件。例如，在 32 位平台上，machine.config 位于系统驱动器>：\WINDOWS\Microsoft.NET\Framework\<version>\CONFIG 下<。
使用文本编辑器打开该文件。

注册适配器绑定：

system.serviceModel搜索元素，并在其下添加以下内容：

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

在 system.serviceModel\extensions 下搜索 bindingElementExtensions 元素。

查找缺少的适配器绑定。根据缺少的适配器绑定，在 bindingElementExtensions 节点下添加以下部分。如果安装向导无法注册任何绑定，则必须注册所有绑定。

对于 SAP 适配器，请添加：

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

对于 Siebel 适配器，请添加：

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

对于 Oracle 数据库适配器，请添加：

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

对于 Oracle 电子商务适配器，请添加：

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

对于 SQL 适配器，请添加：

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

在 system.serviceModel\extensions 下搜索 bindingExtensions 元素。

查找缺少的适配器绑定。根据缺少的适配器绑定，在 bindingExtensions 节点下添加以下部分。如果安装向导无法注册任何绑定，则必须注册所有绑定。

对于 SAP 适配器，请添加：

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

对于 Siebel 适配器，请添加：

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

对于 Oracle 数据库适配器，请添加：

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

对于 Oracle 电子商务适配器，请添加：

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

对于 SQL 适配器，请添加：

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

注意

若要获取公钥值，请参阅本主题) 中的确定公钥和版本 (。

在 system.data 节点下搜索 DbProviderFactories 元素。

查找缺少.NET Framework数据提供程序。根据缺少的提供程序，在 DbProviderFactories 节点下添加以下部分。如果安装向导无法注册任何提供程序，则必须注册所有提供程序。

对于适用于 SAP 的数据提供程序，请添加：

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

对于 Siebel 的数据提供程序，请添加：

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

保存并关闭 machine.config 文件。

确定公钥和版本

完成以下步骤以确定适配器或.NET Framework数据提供程序的公钥和版本。

转到 Windows 目录，通常为 C：\WINDOWS\assembly。

右键单击需要其公钥的 DLL，然后选择“ 属性”。下表列出了每个适配器和提供程序的 DLL 名称：

适配器/.NET Framework数据提供程序	DLL 的名称
SAP 适配器	Microsoft.Adapters.SAP
Siebel 适配器	Microsoft.Adapters.Siebel
Oracle 数据库适配器	Microsoft.Adapters.OracleDB
Oracle 电子商务适配器	Microsoft.Adapters.OracleEBS
SQL 适配器	Microsoft.Adapters.Sql.dll
用于 SAP 的数据提供程序	Microsoft.Data.SAPClient
用于 Siebel 的数据提供程序	Microsoft.Data.SiebelClient

在“ 常规 ”选项卡上， “公钥令牌 ”值是 DLL 的公钥。 Version 值是 DLL 的版本号。
复制公钥，然后选择“ 取消”。

安装自定义 RFC

仅当想要使用适用于 SAP 的数据提供程序时才需要。请参阅 SAP 适配器文档中的安装自定义 RFC 。

重要

如果使用 BizTalk 适配器包随附的自定义 RFC 的早期版本，则必须将其升级到随此版本一起提供的 RFC。为此，请删除早期 RFC，然后安装此版本附带的 RFC。

安装企业应用程序

有关安装不同企业 LOB 系统的步骤和指南，建议使用企业系统提供的安装指南。另请参阅其适配器文档了解特定的配置更改（如果有）。

安装和安装后清单

请确保使用正确的安装选项安装了所有软件必备组件。
请确保在安装了 BizTalk 适配器包的计算机上安装了受支持的企业 LOB 应用程序版本。请参阅支持的业务线 (LOB) 系统。
若要仅为要连接的企业 LOB 系统安装适配器，请确保使用 自定义 安装选项安装 BizTalk 适配器包。请确保未使用 “完成 安装”选项。请参阅安装 BizTalk 适配器包。
如果要使用 SAP 适配器对 SAP 系统进行 tRFC 调用，请确保在 SQL Server 数据库中创建所需的表。请参阅本主题 ) 中的创建SQL Server数据库对象 (。
运行 BizTalk 适配器包安装向导时，可能会收到一条错误消息，指出安装程序未能注册绑定。如果是，请手动注册它们。请参阅本主题) 中的 注册适配器绑定 (。
如果选择在 BizTalk 适配器包安装过程中安装用于 SAP 的数据提供程序，请确保在 SAP 系统上安装自定义 RFC。请参阅安装自定义 RFC。

通过