安装和配置适用于企业应用程序的 Microsoft BizTalk 适配器

项目
02/13/2024

适用于企业应用程序的 Microsoft BizTalk 适配器包括以下适配器：

用于 JD Edwards OneWorld 的 Microsoft BizTalk 适配器
用于 JD Edwards EnterpriseOne 的 Microsoft BizTalk 适配器
用于 PeopleSoft Enterprise 的 Microsoft BizTalk 适配器
用于 TIBCO Rendezvous 的 Microsoft BizTalk 适配器
用于 TIBCO Enterprise Message Service 的 Microsoft BizTalk 适配器

重要

在进行任何配置更改之前，请备份所有数据。
在进行任何配置更改之前，你必须非常熟悉特定的企业应用程序。

支持的版本 & 要求

组件	要求
操作系统	适配器支持与 BizTalk Server 相同的 OS： BizTalk Server 2020 要求 BizTalk Server 2016 要求 BizTalk Server 2013 R2/2013 要求
支持的企业系统	BizTalk Server 2020 旧版
JD Edwards OneWorld XE	Windows 上的 JD Edwards Enterprise 服务器 Windows 上的 JD Edwards 部署服务器
JD Edwards EnterpriseOne	适配器调用使用 JDBC 的 JD Edwards EnterpriseOne API，该 API 需要数据库驱动程序。如果安装 JD Edwards EnterpriseOne 的同时安装了 SQL 数据库，则需要 MS-SQL 驱动程序。同样，如果通过 Oracle 数据库安装了 JD Edwards EnterpriseOne，则需要 Oracle 驱动程序;或者，如果随 DB2 数据库一起安装，则需要 DB2 驱动程序。
PeopleSoft Enterprise	Sun Systems Java 开发工具包 (JDK) PeopleSoft Tools 版本 PeopleSoft 应用程序版本此适配器需要对 PeopleSoft 应用程序进行修改。若要使用组件接口，请将自定义组件接口（GET_CI_INFO）上传到 PeopleSoft 中。 GET_CI_INFO.pc 位于 Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise (r) \Config 中。
TIBCO Rendezvous	必须在运行 BizTalk Adapter for TIBCO Rendezvous 的计算机上安装 TIBCO Rendezvous 运行时组件必须在运行 BizTalk Adapter for TIBCO Rendezvous 的计算机上配置 TIBCO Rendezvous 许可证。 TIBCO Rendezvous 二进制文件目录必须对该适配器可见：在环境变量 PATH 值中，或在 BizTalk Server 中的每个 Rendezvous 端口上指定。这对于 Rendezvous 程序集查找它的库和可执行文件是必需的。
TIBCO Enterprise Message Service	Enterprise Message Service (EMS)版本 5.x 及更高版本包括客户端 SDK（使用 TIBCO EMS C# API）。 BizTalk Adapter for TIBCO EMS 使用此适配器与服务器通信。

JD Edwards OneWorld XE

本部分包括有关将 Microsoft BizTalk Adapter for JD Edwards OneWorld XE 与 BizTalk Server 配合使用的关键信息。

创建 JAR 文件

本节介绍 JD Edwards OneWorld 与用于 JD Edwards OneWorld 的 Microsoft BizTalk 适配器一起工作的要求。

JAR 文件和 CLASSPATH

JD Edwards OneWorld JAR 文件必须可用于适配器。例如，若要连接到 B7.3.3.3 版本，需要以下 jar 文件。根据你连接的服务器，jar 文件列表可能会更改：

Connector.jar
Kernel.jar

这些文件位于运行 JD Edwards OneWorld 的计算机上的以下位置：

JD Edwards OneWorld XE_install_Directory\System\classes\Connector.jar
JD Edwards OneWorld XE_install_Directory\System\classes\Kernel.jar

你可将这些文件复制到任何位置；但是，必须指定 CLASSPATH 中的 JAR 文件位置。 CLASSPATH 必须包括文件的完整路径和 JAR 文件的名称（用分号隔开）。

用于 JD Edwards OneWorld 的 BizTalk 适配器提供 JDEJAccess JAR 文件以用于 JD Edwards OneWorld。默认情况下，从 Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards OneWorld (r) \classes\JDEJAccess.jar 引用JDEJAccess.jar文件。

注意

你必须在可以使用用于 JD Edwards OneWorld 的 BizTalk 适配器之前验证 jdeinterop.ini 文件的注册。在 BizTalk Server 中创建发送端口时，请确保在 JDE 传输属性页中包含此文件的路径。有关完整说明，请参阅“自定义 jdeinterop.ini 文件”。

创建BTSLIBinterop.jar文件

创建文件，并确认适配器可以访问该文件。使用以下示例作为指南：

创建包括以下代码的 BTSLIB.cmd 文件：

define library BTSLIB
login
library BTSLIB
interface JDEAdapter
import B5500900
build
logout

运行以下命令：
```
GenJava  /cmd  .\BTSLIB.cmd
```

验证设置

使用支持的版本，包括 Service Pack 编号 (受支持的业务线 (LOB) 和企业系统) 。服务包（ESU 和 ASU）更新系统二进制文件。必备的服务包提供用于导入的 ASU/ESU 菜单选项。
将 jdeinterop.ini 文件配置为使用正确的驱动器进行日志记录（如果它与驱动器 C 不同）。例如，如果 TEMP 目录空间不足，JD Edwards OneWorld 更新可能会失败。
确定是否必须添加用于左/右填充 JD Edwards OneWorld 字段的配置文件。
请验证你的 JAVA_HOME 的环境变量指向 Java 开发工具包 (JDK) 安装以便从计算机上的任何程序启用 javac 和 java 命令。
验证是否已设置 CLASSPATH 环境变量。这使 JD Edwards OneWorld 的 BizTalk 适配器能够查找Kernel.jar和Connect.jar文件。

JAR 文件的路径是区分大小写的。
通过键入区分大小写的以下命令来测试环境。
```
javap -s -p com.microsoft.jde.JDEJAccess
```

你给出的命令 (javap) 是 Java 类文件拆装器：

http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javap.html

命令 javap 会反汇编类文件。其输出取决于所使用的选项。如果没有使用任何选项，javap 输出包、受保护的公共字段和传递给它的类的方法。javap 打印其输出到 stdout。

如果没有错误，所有 Java 文件及其依赖项都在 CLASSPATH 中。
通过将本地主机文件 (C：\WINNT\system32\drivers\etc\hosts) （服务器名称为 JD Edwards OneWorld 系统）来设置 DNS 解析。

创建并安装自定义包

安装 BTSREL 自定义包以使用适用于 JD Edwards OneWorld 的 BizTalk 适配器。本节介绍以下内容：

JD Edwards OneWorld 自定义包创建过程
如何创建和安装 BTSREL
在 JD Edwards OneWorld 中创建的 BTSREL 对象

注意

BTSREL.exe 是一个自定义包（在 JD Edwards OneWorld 术语中为自动化的软件更新或 ASU）。它包含业务功能以提取元数据。应为特定的 JD Edwards OneWorld 配置和版本创建自定义包。

定义自定义包

自定义包是一个后发布的可交付结果，为特定目的（例如法规更改或增强功能）提供软件更改。这些自定义包是为特定功能创建的。例如，创建 BTSREL 来提取元数据。当安装 BTSREL 自定义包时，它会更新在 JD Edwards OneWorld 环境中的选定的模块。若要更新，必须将 BTSREL 对象合并到适当的 JD Edwards OneWorld 环境中。有关通过 BTSREL 进行更新的模块的详细列表，请参阅模块列表。

安装 BTSREL 自定义包

下载 BTSREL。将其安装在部署服务器上，然后将其部署到企业服务器。

现有的 BTSREL.exe 程序包可直接用于 B7333 版本。对于要与 B7334 版本一起使用的包，请：

下载并将 BTSREL.exe 的内容提取到你的工作文件夹。
在 Deployment.Inf 文件中将 ReleaseLevelRequired 和 Release 值修改为 B7334。
运行安装程序。

若要安装 BTSREL，需要满足以下条件：
- 部署服务器安装
- 安装工作台

在部署服务器上安装 BTSREL

自定义包仅适用于 Windows 操作系统，并与部署服务器一起使用。它必须在部署服务器上构建，然后部署到企业服务器。企业服务器通常是生产服务器，并且可在 Windows 或 UNIX 的操作系统上使用。

注意

将 ASU 应用到 JD Edwards OneWorld 部署服务器时，请验证是否处于更新模式。证明模式验证 ASU 中没有 bug，而更新模式是在应用 ASU 时指定的。

以用户 JDE 身份登录到部署服务器。
在部署服务器 (root)/B7 文件夹上创建一个名为 BTSREL 的新文件夹。
将 BTSREL.exe 复制到新创建的 BTSREL 文件夹。
从.../B7/BTSREL 文件夹运行 BTSREL.exe。安装管理器会自动启动。
在设置窗口中，选择“ 下一步”，然后选择“ 完成”。如果安装成功，将显示一条消息。
以 JD Edwards OneWorld 部署服务器上的JDE 用户身份登录到 JDEPLAN 环境。
1. 如果系统上未安装包含 SAR #4533357 的 ESU) (电子软件更新，请从“系统安装工具”菜单中选择“软件汇报” (GH9612) 。
2. 在 “处理选项” 面板中为选项 1 输入 02。
3. 如果系统上已安装包含 SAR #4533357 的 ESU，请从“系统安装工具”菜单中选择“应用程序软件更新” (GH9612) 。

在 JD Edwards OneWorld WorkBench 上安装 BTSREL

在“ 使用应用程序更新” 屏幕上，双击 BTSREL 更新，然后选择“ 下一步”。
双击要安装更新的环境，然后选择“ 下一步”。
1. 如果希望软件更新在无人参与模式下运行，请检查 无人参与的 Workbench 。
2. 如果要备份规范 (，请选择“ 备份 ”，以便可以) 还原原始规范。
在“使用安装计划”屏幕上，选择要安装的更新的计划，然后选择。
安装完成后，请查看自动生成的 PDF 是否存在错误。

注意

如果出现错误，在 JD Edwards OneWorld 软件更新指南中查找故障排除技巧，或直接与 JD Edwards OneWorld 联系。
使用本部分中“手动注册业务函数库”中包含的步骤手动注册业务函数库。

卸载自定义包

无需卸载自定义包。但是，如果想要清理系统，可以不同方式卸载。卸载后，使用以下方法之一重新生成包：

使用 JD Edwards OneWorld 部署服务器 Gh8612— P96470，在 “行 ”菜单上，选择“ 更新”，然后选择“ 卸载”。
将所有自定义对象 (BTSREL) 签出到客户端计算机并将其删除。
应用之前的数据库快照。

在清理过程中，验证对 JD Edwards OneWorld 的其他对象做出的任何其他修改。

手动注册业务函数库

由于 JD Edwards OneWorld 产品打包过程的限制，用于 JD Edwards OneWorld 的 BizTalk 适配器的自定义业务函数库 DLL 必须使用 JD Edwards OneWorld 进行手动注册。此过程包括以下步骤。

步骤 1：创建自定义业务函数库

使用 JD Edwards OneWorld 对象管理工作台 (OMW) 创建自定义业务函数库。以下过程必须在初始设置中执行，并且适用于所有平台。

启动对象管理 Workbench (快速路径：“OMW”或菜单选择：GH902 对象：P98220) 。
选择“ 添加”，然后选择“ 业务函数库”选项。
对新业务函数库对象输入以下信息：
- 名字： ACBLIB
- 描述： Microsoft DLL
- 产品代码： 55
- 产品系统代码： 55
选择“确定” 。

步骤 2：从部署服务器重新生成库

在每个平台的初始设置中完成以下步骤。

若要在独立模式下启动 BusBuild 程序，请选择“ 启动”，选择“ 运行”，然后选择 “busbuild.exe”。
使用路径代码 (PY7333、PD7333 或 DV7333) 登录到 JD Edwards OneWorld。
在 “重新生成库” 列表中，选择“ 生成”。

步骤 3：复制自定义 DLL

将自定义 DLL 从 pathcode 目录复制到 JD Edwards OneWorld 部署服务器和 JD Edwards OneWorld Enterprise Server 上的父包目录。

在 JD Edwards OneWorld XE 部署服务器上

将 ACBLIB.dll 从 DV7333\bin32 复制到 DV7333\Packages\DV7333FA\bin32。
将 ACBLIB.def、ACBLIB.dmp 和 ACBLIB.mak 从 DV7333\obj 文件夹复制到 DV7333\Packages\DV7333FA\obj 文件夹。
将 ACBLIB.exp、ACBLIB.lib 和 sACBLIB.lib.lib 从 DV7333\lib32 文件夹复制到 DV7333\Packages\DV7333FA\lib32 文件夹。

在 JD Edwards OneWorld Enterprise 服务器上

在创建每个目录和文件后，验证授权。

在 DV7333FA\obj\ 下创建一个目录 ACBLIB。
在 DV7333FA\source 下创建目录 ACBLIB。
从部署服务器 DV7333\source 目录到 DV7333FA\source\ACBLIB 目录的 FTP b5500900.c。
从部署服务器 DV7333\include 目录到 DV7333FA\include 目录的 FTP b5500900.h。

步骤 4：生成完整包

由于 JD Edwards 包生成过程的限制，请为应用 BTSREL 更新的环境生成完整包，否则更新包生成无法正常工作。请参阅有关如何生成完整包内部版本的 JD Edwards 文档。

注意

当应用 JD Edwards OneWorld ASU/ESU 时，ASU/ESU 通常不创建新的库和业务函数。因此，此过程很简单：但是，适用于 JD Edwards OneWorld 自定义包的 BizTalk 适配器会创建新库。因此，必须执行额外的步骤，例如手动创建目录并运行完整的包生成。

模块列表

BTSREL 自定义包在 JD Edwards OneWorld 中创建以下对象。 BTSREL 包含用来提取元数据的业务功能和测试数据类型的自定义函数。

注意

JD Edwards OneWorld 的更新中有一个 bug。如果没有所有业务和自定义函数，请验证是否已完成完整的包生成，而不是更新包生成。

如果列表缺失文件，例如，在 ACBTEST 之下有所有内容而其上没有任何内容，则你可能缺失数据字典 (DD) 项目。可以转到 “处理数据项” 并查找缺少的文件。

如果缺少其他项，例如ACBCHAR01、ACBDATE01、ADBINT01、ACBMATH01和ACBSTR01，这些是 主数据元素。如果你从及计划者到开发人员合并对象，许多报表将在后台运行。你可以打开合并报告并检查错误。报告应列出的所有项目并指示它们已完成，且无错误或警告。有了此验证，你可以继续，因为所有项都已检查过。

ACBCHAR01 - 测试字符类型 01
ACBCUST - ACB 客户 ID
ACBDATE01 - 测试数据类型 01
ACBDEF - ACB 函数类型定义
ACBFCNT - ACB 函数名称列表计数
ACBFUNC - ACB 函数名称列表
ACBFUNCN - ACB 函数名称
ACBINT01 - 测试整数类型 01
ACBLIB - 控制 BROKER 库
ACBMATH01 - 测试数学类型 01
ACBNEWS - ACB 新状态
ACBORDER - ACB 订单号
ACBPRC - ACB 商品价格
ACBPROD - ACB 产品 ID
ACBQTY - ACB 商品数量
ACBRES - ACB 结果指示器
ACBSTAT - ACB 状态
ACBSTR01 - 测试字符串类型 01
ACBTEST - ACB 测试屏幕
ACBTEST2 - ACB 测试屏幕 2
ACBTEST3 - ACB 测试屏幕 3
B5500900 - 控制 BROKER 支持模块
D5500900 - 控制 BROKER 数据结构
D5500900A - 控制 BROKER 数据结构
D5500900B - FETCH 价格数据结构
D5500900C - 获得客户状态数据结构
D5500900D - 设置客户状态数据结构
D5500900E - 更新销售订单状态数据结构
D5500900F - 测试整数
D5500900G - 测试字符串
D5500900H - 测试日期
D5500900I - 测试字符
D5500900J - 测试数学数值
D5500900K - 测试日期 2

自定义 jdeinterop.ini 文件

Connector.jar 和 Kernel.jar 中的 JD Edwards OneWorld XE 连接器类要求使用 jdeinterop.ini 配置文件。此文件由 JD Edwards OneWorld 软件定义，并使用其术语。 JD Edwards 互操作性指南版本 OneWorld 可能会提供有关此文件的用途和术语的详细信息。中有一个示例 jdeinterop.ini 文件 <Adapter_Installation>\config\jde。

更新 jdeinterop.ini 以匹配在 “传输属性” 屏幕中定义的参数值。如果它们的参数兼容，则多个 JD Edwards OneWorld 逻辑系统可以共享同一个 jdeinterop.ini 文件。通常，如果两个逻辑系统指向两个不同的 JD Edwards OneWorld 计算机，则它们需要两个不同的 jdeinterop.ini 副本。

注意

应关闭 jdeinterop.ini 中的日志记录，并且可以安全地忽略各种日志文件的参数。

下表列举 jdeinterop.ini 文件中的设置。信息是按节组织的。例如 [JDENET] 与本节按其在 JD Edwards OneWorld 软件中出现的顺序列出。

jdeinterop.ini 文件设置

部分	参数和说明
[JDENET]	EnterpriseServerTimeout。对企业服务器的请求的超时值（以毫秒为单位）。默认大小为 120000。 maxPoolSize。 JDENET 套接字连接池大小。默认大小为 30。
[SERVER]	glossaryTextServer。提供词汇表文本信息的企业服务器和端口。这是返回错误的文本说明的服务器。这通常是与 JD Edwards OneWorld 应用程序服务器相同的主机和端口。不同的受支持的语言编码可能有不止一个词汇表服务器。例如，JDED:6010 或 actsrv1:6009。这些值必须与“系统定义”中设置的相匹配。 codePage。编码方案。默认为 1252。 - 1252 英语和西欧 - 932 日语 - 950 繁体中文 - 936 简体中文 - 949 韩语
[LOGS]	log= c:\jas.log. 日志文件的位置。可以安全地忽略此参数。 debuglog = c:\jasdebug.log. 调试日志文件的位置。可以安全地忽略此参数。调试。确定是否已启用 JDENET 调试。默认值为 FALSE。
[DEBUG]	JobFile= c:\Interop.log. 错误文件的位置。可以安全地忽略此参数。 DebugFile= c:\InteropDebug.log. 调试文件的位置。可以安全地忽略此参数。 log= c:\net.log. 日志文件的位置。可以安全地忽略此参数。 debugLevel = 0-12. 调试级别。可以安全地忽略此参数。此项定义了由仅在 COM 服务器中的指定日志文件中的 COM 连接器和 Callobject 组件提供的跟踪级别。 - 0 无。关闭日志记录并仅将错误写入 JobFile。 - 2 (错误消息) - 4 个系统错误 (异常消息) - 6 警告信息 - 8 分钟跟踪 (密钥操作。例如，Logon、Logoff、Business Function calls.) - 10 个故障排除信息 (帮助) 。 - 12 完整的调试信息 (记录所有) - 默认情况下，不必启用跟踪，但在调试代码时，跟踪非常有用。 - NetTraceLevel=0。跟踪级别。可以安全地忽略此参数。仅在 COM 服务器中定义由指定日志文件中的 ThinNet 组件提供的跟踪级别。对于未来要添加的级别保留奇数值。 - 以下列表更进一步介绍了调试级别： - 0 无跟踪 - 1 引用添加新连接并搜索套接字池时记录进程 ID、线程 ID 和可用套接字状态。 - 2 包括跟踪级别 1 中的信息，还跟踪连接管理器类中所做的每次调用。 - 3 包括跟踪级别 2 中的所有信息，以及跟踪 getPort () 调用和 getHost () 调用。
[INTEROP]	enterpriseServer。此值是主机服务器的名称。请确保此值与在“传输属性”对话框的系统定义中的“JDE 凭据”部分的“主机名”字段中输入的值相同。默认值为 JDED。港口。此值是用于交换数据的端口号。请确保此值与在传输属性、系统定义中的“JD Edwards 凭据”部分的“端口号”字段中输入的值相同。例如，6010 或 6009。这些值必须与系统定义中设置的值匹配。 inactive_timeout。自动提交模式下的事务的超时值（以毫秒为单位）。如果用户在这段时间（以毫秒为单位）处于非活动状态，互操作的服务器将注销用户。可以将此值更改为较短的时间段。默认值为 1200000。 manual_timeout。手动提交模式下事务的超时值（以毫秒为单位）。默认值为 120000。存储库。指向包含 Connector.jar 和 Kernel.jar 的目录的位置。在 UNIX 上，这是完整路径。
[CORBA]	可以安全地忽略此参数。多线程。可以忽略该设置。将 CORBA 的多线程支持设置为 1。 Objects= CORBA::Connector；CORBA::OneWorldVersion 定义要在启动时创建的 CORBA 服务器的对象。此外，替换 -DIORFILENAME = 命令行选项，例如：CORBA：：Connector=connector.ior。

JD Edwards EnterpriseOne

本部分包含有关将 Microsoft BizTalk Adapter for JD Edwards EnterpriseOne 与 BizTalk Server 配合使用的关键信息。

执行 JD Edwards EnterpriseOne 主业务函数

用于 JD Edwards EnterpriseOne 的 BizTalk 适配器可用于调用 JD Edwards EnterpriseOne 主业务函数，例如通讯簿、采购订单或销售订单。也可使用适配器作为集成工作的一部分来将 JD Edwards EnterpriseOne 和 BizTalk Server 相连接。

访问存储在 JD Edwards EnterpriseOne 中的数据

适配器接受 XML 消息，使 BizTalk Server 应用程序能够使用以下端口之一与 JD Edwards EnterpriseOne 进行通信和事务交换：

传输适配器，它使用静态 Solicit-Response 发送端口将消息发送到 JD Edwards EnterpriseOne，并期待响应。
接收适配器，它使用静态 One-Way 接收端口从 JD Edwards EnterpriseOne 接收消息。

互操作性框架

JD Edwards EnterpriseOne 为通过其互操作性框架与系统集成做准备。适配器使用 JD Edwards EnterpriseOne 框架，并利用各种集成访问方法提供最大的灵活性和功能。

用于 JD Edwards EnterpriseOne 的 BizTalk 适配器支持以下集成访问方法：

JD Edwards EnterpriseOne ThinNet API
JD Edwards EnterpriseOne XML
JD Edwards EnterpriseOne 未编辑的事务表（Z 表）

适配器使用 JD Edwards EnterpriseOne ThinNet API 与 JD Edwards EnterpriseOne 应用程序进行通信。通过使用 ThinNet API，该适配器可以调用单个工作单元 (UOW) 中的一个主业务函数 (MBF)。当 MBF 失败时，整个 UOW 无法正常工作。这样可以防止部分更新。数据验证、业务规则和与基础数据库的通信都由 JD Edwards EnterpriseOne 应用程序处理。

JD Edwards 出站处理框架

在出站过程中，当在 JD Edwards EnterpriseOne 环境中执行一个特定的 MBF 时，事件启动。 MBF 将该事件所需的信息写入到适当的接口表并随后通知发生事件的子系统批处理函数 (BF)。随后子系统 BF 包括一个关于子系统数据队列上的事件的条目。

出站子系统检索数据队列条目，并在数据输出控制表中查找外部进程以进行通知。随后出站子系统调用用于 JD Edwards EnterpriseOne 侦听器的 BizTalk 适配器并发出通知。侦听器将通知传递给生成器。随后生成器使用 JD Edwards EnterpriseOne ThinNet API 检索来自接口表的相应信息。

在 Jdearglist 中设置字符串对齐

若要在 J.D. Edwards EnterpriseOne jdearglist.txt 文件中将某些字符串参数配置为右对齐和左填充，您必须知道要访问的业务函数;具体而言，必须知道要调用业务函数中的哪些字段。

您必须先更新该 jdearglist.txt，然后在业务流程中生成绑定（架构）。有关更新 jdearglist.txt 文件的说明，请参阅“处理字符串值”部分。

如果在日志中收到 jdearglist.txt 警告消息，其用途是通知你缺少 jdearglist.txt。但是，如果要运行 SalesOrder 或 PurchaseOrder 业务函数，则必须在 PATH 中具有该文件，否则该文件不起作用。

了解 jdeinterop.ini

Connector.jar 和 Kernel.jar 中的 JD Edwards EnterpriseOne 连接器类需要你使用名为 jdeinterop.ini 的配置文件。此文件由 JD Edwards EnterpriseOne 软件定义，并使用其术语。有关此文件的用途和术语的详细信息，请参阅 JD Edwards 互操作性指南。有一个示例 jdeinterop.ini 文件：Program Files\ Microsoft BizTalk Adapters for Enterprise Applications\ J.D. Edwards EnterpriseOne (r) \config。

建议不要手动编辑此文件，因为它与发送端口的“传输属性”对话框交互，例如，由 BizTalk> 标记为<配置的字段。

PeopleSoft Enterprise

本部分包含有关将 Microsoft BizTalk Adapter for PeopleSoft Enterprise 与 BizTalk Server 配合使用的关键信息。

接收处理程序 PeopleSoft 要求

PeopleSoft Integration Broker 必须能够与 BizTalk Server 进行通信。以下情况可能已经在现有 PeopleSoft 环境中发生，你可以重新使用现有节点；因此，除了从 PeopleSoft 系统管理员那里获取 HTTP 规范之外，你不需要进行任何操作。有关详细信息，请参阅 PeopleSoft 文档。

以下步骤提供在 PeopleSoft 中完成的概述：

设置消息，并通过应用程序Designer使其处于活动状态。
对 PeopleSoft integration.gateway.properties 文件进行一次性更改。
创建并配置网关和节点以激活 HTTP：
- 节点必须使用一些触发方法，例如 LOCATION_SYNC 机制。
- 节点必须使用 HTTP。
- 节点必须指向发送该事件的主机和端口。

发送处理程序 PeopleSoft 要求

适用于 PeopleSoft Enterprise 的 BizTalk 适配器由自定义组件接口 (CI) 组成，该接口通过 Java API 提供访问权限。自定义 CI 对象 （GET_CI_INFO）使用 PeopleSoft 工具部署在 PeopleSoft 系统中，以提供 BizTalk Adapter for PeopleSoft Enterprise 所需的元数据信息。有关详细信息，请参阅 PeopleSoft 文档。

上载自定义组件接口是一次性的。文件 GET_CI_INFO.pc 是随产品提供的，且在使用适配器来浏览 CI 之前必须安装在 PeopleSoft 系统中。必须有权访问 PeopleSoft 应用程序Designer;但是，应用程序Designer不必靠近BizTalk Server计算机。使用应用程序Designer将自定义 CI 上传到浏览的 PeopleSoft 计算机。

您必须有权访问 PeopleSoft 计算机，因为您必须设置环境变量 CLASSPATH (或将 传输属性 窗口中的信息) 设置为指向 PeopleSoft PSJOA/psjoa.jar 文件。

设置环境变量并使用组件接口

有关 PeopleSoft 的详细信息，请参阅 PeopleSoft 文档。

设置 ClassPath 环境变量

更新JAVA_HOME

设置 JAVA_HOME 变量，使其指向您的 JDK 安装，例如：

set JAVA_HOME=C:\j2sdk1.4.2_06

更新 CLASSPATH

若要仅将组件接口 (PeopleSoft 8) 必须更新 CLASSPATH 以包含 PeopleSoft 组件接口 jar 文件：

在控制面板中，打开“系统”。
在“ 高级 ”选项卡上，选择“ 环境变量”，然后选择“ CLASSPATH”。
添加路径。例如，输入：
```
<PeopleSoft_Home>\web\PSJOA\psjoa.jar
```
用于 PeopleSoft Enterprise 的 BizTalk 适配器需要 psjoa.jar 文件。创建发送端口时执行此操作。有关详细信息，请参阅适配器文档中的"在 PeopleSoft 系统中设置传输属性"。

注意

只要你的 PATH 中有一个目录，就可确保用于 PeopleSoft Enterprise 的 BizTalk 适配器拾取正确的 DLL。未能对你想要的 PeopleSoft 版本正确设置环境可能导致难以追踪的错误。

使用组件接口

将自定义 CI 上传到 PeopleSoft

用于 PeopleSoft Enterprise 的 BizTalk 适配器要求对 PeopleSoft 应用程序进行修改。要使用组件接口，必须将自定义组件接口 GET_CI_INFO 上载到 PeopleSoft。只需在初始安装过程中导入 GET_CI_INFO 以使用适配器。适配器使用 GET_CI_INFO 获取有关 PeopleSoft 中的其他现有组件接口的信息。

本部分介绍如何手动导入自定义组件接口，以便浏览 PeopleSoft 中的组件接口。请注意自定义的方法不使用或修改它所安装的位置中的任何组件接口属性。若要导入自定义组件接口，可以使用以下方法之一：

创建新的组件导入自定义方法。
使用未包含键的现有的组件，例如，INSTALLATION_RS。

简单的组件接口不得包含键。如果不确定特定组件接口是否包含键，可以使用 SQL 查询工具运行以下 SQL 语句。它提供应用程序中没有密钥的所有组件接口的列表。
```
select distinct BCNAME
from PSBCITEM bc1
where not exists
(select 1 from PSBCITEM bc2 where bc1.BCNAME = bc2.BCNAME and bc2.BCTYPE in (1, 2))
```

你可以按照 PeopleSoft 文档创建用于存储 PeopleSoft Enterprise 自定义方法的 BizTalk 适配器的唯一简单组件。你还可以克隆一个预先存在的组件接口并使用它来存储自定义方法。

要验证 GET_CI_INFO 不包含键，请运行 PeopleTools 应用程序设计器组件接口测试工具。

创建新的组件接口

按照以下步骤使用 PeopleSoft、Application Designer创建新的组件接口：

打开 PeopleSoft 应用程序Designer。
输入三层连接类型，然后单击“ 确定”。例如，从列表中选择应用程序服务器。
在“应用程序Designer的”文件“菜单上，选择”新建”。
在“ 新建 ”对话框中，选择“ 组件接口”，然后单击“ 确定”。
单击“选择”。
从所有组件的列表，选择任何简单组件。例如，选择 INSTALLATION_RS 或你创建一个新的 PeopleSoft 组件。

自定义方法不使用或修改安装它的组件接口的任何属性。

此简单组件接口不得包含键。如果不确定特定组件接口是否包含键，可以使用 SQL 查询工具运行以下 SQL 语句。它提供应用程序中没有密钥的所有组件接口的列表：
```
select distinct BCNAME from PSBCITEM bc1 where not exists (select 1 from PSBCITEM bc2 where bc1.BCNAME = bc2.BCNAME and bc2.BCTYPE in (1, 2))
```

注意

还可以按照 PeopleSoft 文档创建一个唯一的简单组件，用于存储 BizTalk Adapter for PeopleSoft Enterprise 的自定义方法。

要验证 GET_CI_INFO 不包含键，请运行 PeopleTools 应用程序设计器组件接口测试工具。

检查组件接口

你已完成将 PeopleSoft GET_CI_INFO 的 Microsoft BizTalk 适配器的上载到 PeopleSoft 系统的工作。 GET_CI_INFO 是一个用户定义的自定义组件接口。它包含用户定义的方法。 GET_CI_INFO 组件接口允许你在 PeopleSoft 系统中使用 Microsoft 适配器向导浏览组件接口。你可以找到并展开 GET_CI_INFO 以查看其用户定义的方法。

注意

有关用户定义的方法的详细信息，请参阅适配器文档中的“PeopleSoft：组件接口 User-Defined 方法”。

设置组件接口安全性

在 PeopleSoft 上安装自定义GET_CI_INFO PeopleSoft 组件接口后，为适用于 PeopleSoft Enterprise 的 BizTalk 适配器设置 GetCINamespace、 GetDetails 和 GetCollections 方法的安全设置。这是创建自定义组件或用户定义方法的标准做法。

注意

以下过程介绍如何在所有支持的模式下为 PeopleSoft 的所有支持发行版配置安全性。

要配置组件接口的安全性

依次指向“PeopleTools”、“安全性”、“权限 & 角色”，然后选择“权限Lists”。
在“ 维护安全性 ”窗口中，单击“ 搜索”，选择相关的 “权限列表”，然后单击相应的列表超链接。
在右侧的“ 权限列表 ”窗格中，单击“ 登录时间 ”选项卡旁边的右箭头以显示“ 组件接口 ”选项卡。
单击“ 组件接口 ”选项卡。
单击加号 (+) ，将新行添加到 “组件接口” 列表。
选择 GET_CI_INFO 组件接口，然后单击“ 编辑”。
若要将方法设置为 “完全访问”，请单击“ 完全访问 (所有) ”，然后单击“ 确定”。
滚动到“ 组件接口” 窗口的底部，然后单击“ 保存”。

测试组件接口

你已经为以 PeopleSoft Enterprise 的 BizTalk 适配器传递的 GET_CI_INFO 组件接口完成了配置安全性的工作。你的 PeopleSoft 组件接口已准备就绪，可浏览 PeopleSoft 组件接口。

请按照以下步骤在应用程序设计器中测试组件接口。

测试组件接口

启动 PeopleSoft 应用程序Designer。
在“ 文件 ”菜单上，指向“ 打开”，然后选择“ 定义 = 组件接口”。
从组件接口列表中，选择“ GET_CI_INFO CI”。
打开GET_CI_INFO后，右键单击组件接口定义的右窗格中的任意位置，然后选择“ 测试组件接口”。

此时会打开 “组件接口测试程序 ”窗口。不应列出任何键。如果GET_CI_INFO包含键，或者还有另一个选项可供选择，请返回到应用程序Designer，并从GET_CI_INFO消除所有键。

安装步骤

在安装之前，请确保BizTalk Server，并且已安装适配器的所有软件必备组件。建议你运行安装程序之前关闭所有应用程序。

运行BizTalk Server Setup.exe，然后选择“安装适用于企业应用程序的 Microsoft BizTalk 适配器”。

对于 2016 年及更早版本BizTalk Server：
运行BizTalk Server Setup.exe，选择“安装 Microsoft BizTalk 适配器”，然后选择“为企业应用程序安装 Microsoft BizTalk 适配器”。
注意
- 还可以使用以下命令运行无提示安装： msiexec /i <msi\> /qn /l* <logfile\> -- 其中 <logfile\> 是可选的，但在安装失败时很有用。
- 安装更新了 PATH 环境变量。要确保正在使用正确的变量，请关闭安装命令窗口来更新你的变量。
接受 许可协议，然后选择“ 下一步”。
输入 “客户信息”，然后选择“ 下一步”。
选择 “完整” 或 “自定义 安装”：
- 完成：安装所有适用于企业应用程序的 Microsoft BizTalk 适配器、所有程序功能，并用于开发和运行时。
- 自定义：选择要安装的适配器和功能以及它们的安装位置。
若要设置目标，请选择“ 浏览”，并设置安装路径。

选择“下一步”继续操作。
安装，完成后选择“ 完成 ”。

重要

安装过程中可能会遇到以下错误：

Error 1609. An error occurred while applying security settings. CREATOR OWNER is not a valid user or group

若要解决此错误，请执行下列操作，然后再次运行安装：

打开命令提示符
键入：net user "CREATOR OWNER" /add。这会创建一个名为 CREATOR OWNER 的新用户。
键入：net localgroup Users /add。这会创建一个名为“用户”的新组。

若要将适配器添加到 BizTalk Server，请参阅本主题中的“将适配器添加到 BizTalk 管理员”。

将适配器添加到 BizTalk 管理员

注意

如果在多计算机环境中安装 BizTalk， (仅运行时安装在一台计算机上，并在另一台) 的计算机上安装仅管理工具安装，则应在这两台计算机上安装 BizTalk Adapters for Enterprise Applications。

打开“BizTalk Server管理控制台”，展开“Microsoft BizTalk Server”，然后展开“平台设置”。
右键单击“ 适配器”，选择“ 新建”，然后选择“ 适配器”。
输入名称，例如 PeopleSoft。
从“ 适配器 ”列表中选择输入的名称，然后选择“ 确定”。

安装后 - JD Edwards OneWorld

适用于 JD Edwards OneWorld 的 Microsoft BizTalk 适配器由一个传输适配器组成，该适配器可将支持的数据库和服务器系统与 Microsoft BizTalk Server相连接。通过传输适配器，你可以从 BizTalk Server 调用服务器系统。传输适配器（BizTalk Server 管理发送处理程序）配置指定 SQL 数据库的位置。

有关如何使用用于 JD Edwards OneWorld 的 BizTalk 适配器以及在它的模型和 BizTalk Server 模型之间进行映射的详细信息，请参阅适配器文档。

单一登录

适用于 JD Edwards OneWorld 的 BizTalk 适配器支持企业单 Sign-On (SSO) 。如果在“ 传输属性” 页中选择使用 SSO，将使用 SSO 凭据数据库中关联应用程序的凭据。关联应用程序表示一个应用程序 - 一个需要凭据的后端。

已安装的组件

适配器安装会在全局程序集缓存中安装并注册以下组件， (GAC) 。可以通过在资源管理器中打开程序集文件夹 (<%WINDIR%>\assembly) ，或使用 gacutil /l Visual Studio 命令提示符中的来验证注册：
- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
btsTask.exe 安装文件并将其部署到 Microsoft.BizTalk.Adapters.JDEProperties.dll GAC。 BizTalk Server部署日志结果位于 \Program Files\Microsoft BizTalk Adapters for Enterprise Applications\jdeDeploy.html 和 jdeDeploy.xml中。
适配器特定的文件安装在和 Program Files\Common Files中Program Files。
安装在 sdk\ 中 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards OneWorld(r)。
Program Files\Microsoft BizTalk Adapters for Enterprise Applications\JD Edwards OneWorld(r)\ 包含以下文件：
- classes\JDEJAccess.jar
- Config\ J.D. Edwards OneWorld (r) \BTSREL.exe
- Config\ J.D. Edwards OneWorld (r) \jdearglist.txt
- Config\ J.D. Edwards OneWorld (r) \jdeinterop.ini
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin\ 包含以下文件：
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- jdecba.dll

安装后 - JD Edwards EnterpriseOne

适用于 JD Edwards EnterpriseOne 的 Microsoft BizTalk 适配器包含一个传输适配器，该适配器与支持的数据库和服务器系统相连接，以BizTalk Server。传输适配器允许你从 BizTalk Server 调用服务系统。

适用于 JD Edwards EnterpriseOne 的 BizTalk 适配器支持企业单 Sign-On (SSO) 。如果在“ 传输属性” 页中选择使用 SSO，将使用 SSO 凭据数据库中关联应用程序的凭据。关联应用程序表示一个应用程序 - 一个需要凭据的后端。

已安装的组件

适配器安装会在全局程序集缓存中安装并注册以下组件， (GAC) 。可以通过在资源管理器中打开程序集文件夹 (<%WINDIR%>\assembly) ，或使用 gacutil /l Visual Studio 命令提示符中的来验证注册：
- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
特定于适配器的文件安装在 Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin 文件夹中。此文件夹包含以下文件：
- Jdecba.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
以下文件安装在中 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards EnterpriseOne(r)：
- Bin\BTAJDEEnterpriseOneTrace.cmd
- Classes\JDEDynAccess.jar
- Config\btaJDEEnterpriseOneTrace.mof
- Config\jdearglist.txt
- Config\jdeinterop.ini
- Config\jdelog.properties
- Sdk

安装后 - PeopleSoft Enterprise

用于 PeopleSoft Enterprise 的 Microsof BizTalk 适配器包括一个传输适配器，该适配器将支持的数据库和服务器系统与 BizTalk Server 相连接。传输适配器允许你从 BizTalk Server 调用服务系统。传输适配器（BizTalk Server 管理发送处理程序）配置指定 SQL 数据库的位置。

适用于 PeopleSoft Enterprise 的 BizTalk 适配器支持企业单 Sign-On (SSO) 。如果在“ 传输属性” 页中选择使用 SSO，将使用 SSO 凭据数据库中关联应用程序的凭据。关联应用程序表示一个应用程序 - 一个需要凭据的后端。

适配器安装包括 \sdk 目录中的示例。

已安装的组件

适配器安装会在全局程序集缓存中安装并注册以下组件， (GAC) 。可以通过在资源管理器中打开程序集文件夹 (<%WINDIR%>\assembly) ，或使用 gacutil /l Visual Studio 命令提示符中的来验证注册：
- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
特定于适配器的文件安装在 *Program Files Program Filesand\Common Files. The following files are installed in Program Files\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise (r) '：
- bin\BTAPeopleSoftTrace.cmd
- config\btaPeopleSoftTrace.mof
- config\GET_CI_INFO.pc
- config\GET_CI_INFO.pc
- sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications 包含以下文件：
- bin\psosa.dll
- bin\Microsoft.BizTalk.Adapters.CoreManagement.dll
- bin\Microsoft.BizTalk.Adapters.CoreReceiver.dll
- bin\Microsoft.BizTalk.Adapters.CoreTransmitter.dll

安装后概述 - TIBCO Rendezvous

用于 TIBCO Rendezvous 的 BizTalk 适配器包括接收和传输功能，该功能将支持的数据库和服务器系统与 BizTalk Server 相连接。

接收端侦听来从服务器系统出站的调用。
传输端使你能够从 BizTalk Server 调用服务器系统。

有关如何使用 Microsoft BizTalk Adapter for TIBCO Rendezvous 以及其模型与BizTalk Server模型之间的映射的信息，请参阅适配器文档。

已安装的组件

适配器安装会在全局程序集缓存中安装并注册以下组件， (GAC) 。可以通过在资源管理器中打开程序集文件夹 (<%WINDIR%>\assembly) ，或使用 gacutil /l Visual Studio 命令提示符中的来验证注册：
- Microsoft.BizTalk.Adapters.TibcoRV
- Microsoft.BizTalk.Adapters.TibcoRV.Common
- Microsoft.BizTalk.Adapters.TibcoRV.Service
- Microsoft.BizTalk.Adapters.TibRV.Properties
- Microsoft.BizTalk.Adapters.TibcoEMS
- Microsoft.BizTalk.Adapters.TibcoEMS.Properties
- Microsoft.BizTalk.Adapters.TibcoRVManagement
- Microsoft.BizTalk.Adapters.TibcoRVReceiver
- Microsoft.BizTalk.Adapters.TibcoRVTransmitter
适配器特定的文件安装在和 Program Files\Common Files中Program Files。以下文件安装在中 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\ TIBCO(r) Rendezvous(r)：
- bin\BTATibcoRVTrace.cmd
- bin\mbaRV.exe
- bin\Microsoft.BizTalk.Adapters.TibcoRV.Common.dll
- bin\Microsoft.BizTalk.Adapters.TibcoRV.dll
- bin\Microsoft.BizTalk.Adapters.TibcoRV.Service.dll
- bin\Microsoft.BizTalk.Adapters.BizUtil.dll
- bin\Microsoft.BizTalk.Adapters.CoreManagement.dll
- bin\Microsoft.BizTalk.Adapters.CoreReceiver.dll
- bin\Microsoft.BizTalk.Adapters.CoreTransmitter.dll
- bin\Microsoft.BizTalk.Adapters.TibRV.Properties.dll
- Config\btaTibcoRVTrace.mof
- sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications 包含以下文件：
- bin\tibcorvcba.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll

将 TIBCO.Rendezvous.dll 添加到 GAC

用于 TIBCO Rendezvous 的 BizTalk 适配器需要 TIBCO.Rendezvous.dll 文件。所需的最低版本为 1.0.3036.23330 FileVersion，它随产品版本 8.1 一起提供。如果未安装此程序集，则适配器会触发异常并记录相应的消息。

必须使用后期绑定来加载程序集，以便当特定版本的 TIBCO.Rendezvous.dll 和 TIBCO.Rendezvous.net 模块不在目标计算机上时，TIBCO 会合程序集不会失败。

运行时组件

验证你的计算机上安装了 TIBCO Rendezvous 运行时组件。运行时组件是安装 TIBCO Rendezvous 时必须安装的唯一组件。

在 Visual Studio 命令提示符下，将目录更改为 TIBCO.Rendezvous.dll 文件的位置。默认安装的 TIBCO Rendezvous 中此 DLL 的路径 为C:\TIBCO\TIBRV\BIN\TIBCO.Rendezvous.dll。
在命令提示符处，键入以下内容：

C:\TIBCO\TIBRV\BIN > gacutil /i TIBCO.Rendezvous.dll

TIBCO.Rendezvous.dl 现在显示 GAC 列表。若要查看列表，请在控制面板中打开“管理员工具”，打开“Microsoft .NET Framework配置”，然后打开“程序集缓存”。

安装后 - TIBCO 企业消息服务

Microsoft BizTalk Adapter for TIBCO Enterprise Message Service (EMS) 包含接收和传输功能，这些功能与支持的数据库和服务器系统相连接，以BizTalk Server。

接收端侦听来从服务器系统出站的调用。
传输端使你能够从 BizTalk Server 调用服务器系统。

有关如何将 BizTalk 适配器用于 TIBCO EMS 的信息以及其模型与BizTalk Server模型之间的映射的信息，请参阅适配器文档。

已安装的组件

适配器安装会在全局程序集缓存 (GAC) 中安装并注册 Microsoft.BizTalk.Adapters.TibcoEMS.dll 文件。可以通过在资源管理器中打开程序集文件夹来 <验证注册 (%WINDIR%>\assembly) ，或者从 Visual Studio 命令提示符使用 gacutil /l 。
适配器特定的文件安装在和 Program Files\Common Files中Program Files。以下文件安装在下 Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)：
- bin\BTATibcoEMSTrace.cmd
- Microsoft.BizTalk.Adapters.TibcoEMS.dll
- Config\btaTibcoEMSTrace.mof
- sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\bin 文件夹包含以下文件：
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
  
  注意
  
  必须使用后期绑定来加载程序集，以便在目标计算机上不存在特定版本的 TIBCO.EMS.dll 时，TIBCO EMS 程序集不会失败。

将 TIBCO.EMS.dll API 添加到 GAC

用于 TIBCO EMS 的 BizTalk 适配器要求将 TIBCO.EMS.dll 添加到 GAC。如果未安装该程序集，则用于 TIBCO EMS 的 BizTalk 适配器触发异常并记录相应的消息。

将 TIBCO EMS C #API 复制到 BizTalk 计算机。
在 Visual Studio 命令提示符下，将目录更改为 C# API 文件的位置。
在 Visual Studio 命令提示符下，键入以下内容：
```
C:\\<TIBCO EMS Folder\>bin> gacutil /i TIBCO.EMS.dll
```
TIBCO.EMS.dll 现在显示在 C:\Windows\assembly 列表中。或者，在控制面板中，打开管理员工具>Microsoft .NET Framework>Assembly Cache 以查看 GAC 列表。

限制

适用于 TIBCO EMS 的 BizTalk 适配器使用 TIBCO.EMS.dll 与服务器通信。使用 TIBCO.EMS.dll 的限制如下：
消息压缩不可用，它允许 TIBCO EMS 客户端以压缩格式向 EMS 发送消息。
适配器与服务器之间的消息加密不可用。 TIBCO.EMS.dll 不允许 SSL 加密使用 OpenSSL 库，但适配器使用 ProductVersion 5.0 及以上的 Tibco.EMS.dll 支持 SLL。
不支持用于 EMS 的管理 API。

适配器跟踪

启用跟踪

Windows 跟踪所用的文件名由管理员决定。应用程序写入到操作系统，除非你想要关于特定后端系统的日志，否则此操作将忽略所有日志。通过运行一个单独的用于企业应用程序的 BizTalk 适配器的命令文件来执行此操作。该命令的参数之一是用于捕获跟踪信息的文件的名称。有关详细信息，请参阅本主题) 中的“使用 Windows 跟踪事件” (。

跟踪文件安装到 \Program Files\Microsoft BizTalk Adapters for Enterprise Applications\。

bin\BTATrace.cmd
config\btaTrace.mof

使用 Windows 跟踪事件

适配器将错误、警告和信息性消息记录到 Windows 事件查看器。可以使用 Windows (ETW 事件跟踪) 工具查看其他跟踪消息。如果启用 ETW，将创建一个 *.etl 文件以接收消息。该文件为二进制格式，必须将其转换为可读格式。为此，必须具有可用于解释 *.etl 文件的使用者应用程序，例如 Windows tracerpt.exe 或 tracedmp.exe。

ETW 组件

Windows 事件跟踪包括以下三个组件：

控制器应用程序： 激活和停用提供程序。例如，tracelog.exe 或 logman.exe。

设置 PATH 环境变量以指向 tracelog.exe 的位置。这可确保 BTA<适配器名称>跟踪调用可以在系统中找到 tracelog.exe。默认情况下，BTA<适配器名称>跟踪将搜索当前路径。

注意

tracelog.exe 可从 Microsoft SDK 获取，并与 Microsoft BizTalk Adapters for Enterprise Applications 提供的命令兼容。若要使用 logman.exe，请参阅 logman 文档。
使用者应用程序： 读取记录的事件。

为了让使用者应用程序能够读取 .etl 文件中的事件，Windows 事件跟踪必须将其转储到该文件中。通常，当控制器停用跟踪时执行此操作。

若要在不停用跟踪的情况下使用使用者应用程序，控制器必须使用实时选项 <> 实时 = -rt 激活跟踪。
供应商： 用于提供事件。

每个适配器包括五个不同的提供程序。它们在 Windows Management Instrumentation (WMI) 中进行注册。若要在根 \WMI\EventTrace 路径中找到已注册的提供程序，您可以使用诸如 WMI CIM Studio 之类的工具。

五个提供程序允许你记录不同种类的消息：
- 接收方日志记录提供程序： <跟踪元素> 开关为 - receiver。
- 接收方 CastDetails 提供程序：Trace <元素> 开关为 - castDetailsReceive。
- 发送器日志记录提供程序： <跟踪元素> 开关为 - 发送器。
- 发射机 CastDetails 提供程序： <Trace 元素> 开关为 - castDetailsTransmit。
- 管理日志记录提供程序： <Trace 元素> 开关为 - 管理。

若要使用 ETW，请运行特定适配器的命令： BTA<Adapter Name\>Trace.cmd。如下所示使用此命令：

BTA<Adapter Name>Trace <Trace element> -start [-cir <MB>|
    -seq <MB>] [-rt] logfile
BTA<Adapter Name>Trace <Trace element> -stop

其中：

<跟踪元素> (必需的) 是提供程序的类型。选项包括：

-castDetailsTransmit

-transmitter

-castDetailsReceive

-接收机

-管理

-start、-stop： 激活或停用提供程序。

-cir <MB>： 文件大小和文件类型。 -cir 是一个循环文件。 <MB>： 大小（以 MB 为单位）。

-seq <MB>： 文件大小和文件类型。 -seq 是一个顺序文件。 <MB>： 大小（以 MB 为单位）。

-Rt： 将实时模式设置为打开。

日志文件： (c：\rtlog.etl 的日志文件的名称是默认) 。

例如：

BTAXXXTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTAXXXTrace -transmitter -stop

注意

使用 tracerpt.exe 命令设置 .etl 文件的格式。

安装和配置适用于企业应用程序的 Microsoft BizTalk 适配器

支持的版本 & 要求

JD Edwards OneWorld XE

创建 JAR 文件

JAR 文件和 CLASSPATH

创建BTSLIBinterop.jar文件

验证设置

创建并安装自定义包

定义自定义包

安装 BTSREL 自定义包

在部署服务器上安装 BTSREL

在 JD Edwards OneWorld WorkBench 上安装 BTSREL

卸载自定义包

手动注册业务函数库

步骤 1：创建自定义业务函数库

步骤 2：从部署服务器重新生成库

步骤 3：复制自定义 DLL

步骤 4：生成完整包

模块列表

自定义 jdeinterop.ini 文件

jdeinterop.ini 文件设置

JD Edwards EnterpriseOne

执行 JD Edwards EnterpriseOne 主业务函数

访问存储在 JD Edwards EnterpriseOne 中的数据

互操作性框架

JD Edwards 出站处理框架

在 Jdearglist 中设置字符串对齐

了解 jdeinterop.ini

PeopleSoft Enterprise

接收处理程序 PeopleSoft 要求

发送处理程序 PeopleSoft 要求

设置环境变量并使用组件接口

设置 ClassPath 环境变量

使用组件接口

将自定义 CI 上传到 PeopleSoft

创建新的组件接口

检查组件接口

设置组件接口安全性

测试组件接口

安装步骤

将适配器添加到 BizTalk 管理员

安装后 - JD Edwards OneWorld

单一登录

已安装的组件

安装后 - JD Edwards EnterpriseOne

已安装的组件

安装后 - PeopleSoft Enterprise

已安装的组件

安装后概述 - TIBCO Rendezvous

已安装的组件

将 TIBCO.Rendezvous.dll 添加到 GAC

安装后 - TIBCO 企业消息服务

已安装的组件

将 TIBCO.EMS.dll API 添加到 GAC

适配器跟踪

启用跟踪

使用 Windows 跟踪事件

ETW 组件

后续步骤

反馈

反馈

其他资源