http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javap.html
命令 javap
会反汇编类文件。 其输出取决于所使用的选项。 如果没有使用任何选项,javap 输出包、受保护的公共字段和传递给它的类的方法。javap 打印其输出到 stdout。
如果没有错误,所有 Java 文件及其依赖项都在 CLASSPATH 中。
使用 JD Edwards OneWorld 系统的服务器名称 (C:\WINNT\system32\drivers\etc\hosts) 配置本地主机文件来设置 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 环境。
如果系统上未安装包含 SAR #4533357 的 ESU) (电子软件更新,请从“系统安装工具”菜单中选择“软件汇报” (GH9612) 。
在 “处理选项” 面板中为选项 1 输入 02。
如果系统上已安装包含 SAR #4533357 的 ESU,请从“系统安装工具”菜单中选择“应用程序软件更新” (GH9612) 。
无需卸载自定义包。 但是,如果想要清理系统,可以不同方式卸载。 卸载后,使用以下方法之一重新生成包:
使用 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。
FTP b5500900.h 从部署服务器 DV7333\include 目录到 DV7333FA\include 目录。
步骤 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 版可能会提供有关此文件的用途和术语的详细信息。 中 <Adapter_Installation>\config\jde
提供了一个示例jdeinterop.ini文件。
更新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 分钟跟踪 (密钥操作。例如,登录、注销、业务函数调用。)
- 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 中完成的概述:
设置消息,并通过应用程序设计器使其处于活动状态。
对 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 应用程序设计器;但是,应用程序设计器不必靠近BizTalk Server计算机。 使用应用程序设计器将自定义 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 应用程序设计器创建新的组件接口:
打开 PeopleSoft 应用程序设计器。
输入三层连接类型,然后单击“ 确定”。 例如,从列表中选择应用程序服务器。
在应用程序设计器的“ 文件 ”菜单上,选择“ 新建”。
在“ 新建 ”对话框中,选择“ 组件接口”,然后单击“ 确定”。
单击“选择”。
从所有组件的列表,选择任何简单组件。 例如,选择 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”、“安全性”、“权限&角色”,然后选择“权限列表”。
在“ 维护安全性 ”窗口中,单击“ 搜索”,选择相关的 “权限列表”,然后单击相应的列表超链接。
在右侧的“ 权限列表 ”窗格中,单击“ 登录时间 ”选项卡旁边的右箭头以显示“ 组件接口 ”选项卡。
单击“ 组件接口 ”选项卡。
单击加号 (+) ,将新行添加到 “组件接口” 列表。
选择 GET_CI_INFO 组件接口,然后单击“ 编辑”。
若要将方法设置为 “完全访问”,请单击“ 完全访问 (所有) ”,然后单击“ 确定”。
滚动到“ 组件接口” 窗口的底部,然后单击“ 保存”。
测试组件接口
你已经为以 PeopleSoft Enterprise 的 BizTalk 适配器传递的 GET_CI_INFO 组件接口完成了配置安全性的工作。 你的 PeopleSoft 组件接口已准备就绪,可浏览 PeopleSoft 组件接口。
请按照以下步骤在应用程序设计器中测试组件接口。
测试组件接口
启动 PeopleSoft 应用程序设计器。
在“ 文件 ”菜单上,指向“ 打开”,然后选择“ 定义 = 组件接口”。
从组件接口列表中,选择 “GET_CI_INFO CI”。
打开GET_CI_INFO后,右键单击组件接口定义的右窗格中的任意位置,然后选择“ 测试组件接口”。
此时会打开 “组件接口测试器 ”窗口。 不应列出任何键。 如果GET_CI_INFO包含键,或者如果有其他选项可供选择,请返回到应用程序设计器,并从GET_CI_INFO删除所有键。
在安装之前,请确保BizTalk Server,并且已安装适配器的所有软件先决条件。 建议你运行安装程序之前关闭所有应用程序。
运行 BizTalk Server Setup.exe,然后选择“Microsoft BizTalk 适配器安装企业应用程序”。
对于 BizTalk Server 2016 及更早版本:
运行BizTalk Server Setup.exe,选择“安装Microsoft BizTalk 适配器”,然后选择“Microsoft安装适用于企业应用程序的 BizTalk 适配器”。
还可以使用以下命令运行无提示安装: msiexec /i <msi\> /qn /l* <logfile\>
-- 其中 <logfile\>
是可选的,但在安装失败时很有用。
安装更新了 PATH 环境变量。 要确保正在使用正确的变量,请关闭安装命令窗口来更新你的变量。
接受 许可协议,然后选择“ 下一步”。
输入 客户信息,然后选择“ 下一步”。
选择 “完整 ”或 “自定义 ”安装:
完成:安装所有Microsoft BizTalk Adapters for Enterprise Applications、所有程序功能,并用于开发和运行时。
自定义:选择要安装的适配器和功能及其安装位置。
若要设置目标,请选择“ 浏览”,并设置安装路径。
选择“下一步”继续操作。
安装,完成后选择“ 完成 ”。
安装过程中可能会遇到以下错误:
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
Microsoft BizTalk Adapter for JD Edwards OneWorld 包含一个传输适配器,该适配器将支持的数据库和服务器系统连接到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
Microsoft BizTalk Adapter for JD Edwards EnterpriseOne 包含一个传输适配器,该适配器与支持的数据库和服务器系统对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
安装后 - 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 Filesand
Program Files\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
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
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
BizTalk Adapter for TIBCO Rendezvous 需要 TIBCO.Rendezvous.dll 文件。 所需的最低版本为 1.0.3036.23330 FileVersion,这是产品版本 8.1 附带的。 如果未安装此程序集,则适配器会触发异常并记录相应的消息。
必须使用后期绑定来加载程序集,以便当特定版本的 TIBCO.Rendezvous.dll 和 TIBCO.Rendezvous.net 模块不在目标计算机上时,TIBCO Rendezvous 程序集不会失败。
运行时组件
验证你的计算机上安装了 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 Adapter for TIBCO EMS 以及其模型与 BizTalk Server 模型之间的映射的信息,请参阅适配器文档。
已安装的组件
适配器安装会在 GAC) (全局程序集缓存中安装并注册 Microsoft.BizTalk.Adapters.TibcoEMS.dll
该文件。 可以通过在资源管理器中打开程序集文件夹来 <验证注册, (%WINDIR%>\assembly) ,或使用 gacutil /l
Visual Studio 命令提示符中的 。
适配器特定的文件安装在 和 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
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 缓存以查看 GAC 列表。
BizTalk Adapter for TIBCO EMS 使用 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 之类的工具。
五个提供程序允许你记录不同种类的消息:
接收方日志记录提供程序:Trace <元素> 开关为 - receiver。
接收方 CastDetails 提供程序:跟踪 <元素> 开关为 - 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>: 大小(以兆字节为单位)。
-seq <MB>: 文件的大小和类型。 -seq 是一个顺序文件。 <MB>: 大小(以兆字节为单位)。
-Rt: 将实时模式设置为“打开”。
日志文件: 日志文件的名称 (c:\rtlog.etl 是默认) 。
BTAXXXTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTAXXXTrace -transmitter -stop
使用 tracerpt.exe 命令设置 .etl 文件的格式。
JD Edwards EnterpriseOne 适配器
JD Edwards OneWorld 适配器
PeopleSoft Enterprise 适配器
TIBCO 企业消息服务适配器
TIBCO Rendezvous 适配器