教程：使用 BizTalk 适配器，以便让 PeopleSoft Enterprise 将数据写入 PeopleSoft Enterprise

项目
07/21/2023

适用于 PeopleSoft Enterprise 的 BizTalk 适配器可以用来向带有从贸易合作伙伴或内部应用程序接收的信息的 PeopleSoft 系统写入数据。本演练介绍了可演示此功能的 SDK 示例。

必备条件

必须在运行适用于 PeopleSoft Enterprise 的 BizTalk 适配器BizTalk Server上安装 Java 2 平台。
PeopleSoft Java 对象适配器 JAR 文件 psjoa.jar 应复制到运行 BizTalk Adapter for PeopleSoft Enterprise 的BizTalk Server可访问的文件夹。
若要生成和部署示例，必须在运行适用于 PeopleSoft Enterprise 的 BizTalk 适配器的BizTalk Server上安装 Visual Studio。

本示例的用途

本示例从文件夹中提取 XML 文件，将此文件发送到业务流程，然后使用适用于 PeopleSoft Enterprise 的 BizTalk 适配器，在 PeopleSoft 系统中使用 XML 文件中的数据创建记录。

此示例的设计方式和原因

此示例是在 Visual Studio 中设计的，创建是为了演示将 BizTalk Adapter for PeopleSoft Enterprise 与 BizTalk 业务流程配合使用的基本功能。

本示例所在的位置

本示例位于以下文件夹中：

\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise(r)\Sdk\PeopleSoftOneWaySend

下表显示了本示例中的文件及其用途说明：

Runtime 项目文件名	Runtime 项目文件说明
OneWaySend.btproj, OneWaySend.sln	应用程序的项目和解决方案文件。
LOCATIONService.xsd、 LOCATIONService_1.xsd、 LOCATIONService_2.xsd	应用程序的架构文件。注意：项目中的适配器架构文件最初是使用 “添加适配器元数据向导”创建的。有关添加适配器元数据向导的详细信息，请参阅BizTalk Server文档中的主题“如何将适配器元数据添加到 BizTalk 项目”。
PeopleSoftOneWaySend.odx	应用程序使用的业务流程。
PeopleSoftOneWaySend.snk	强命名密钥文件。

如何使用本示例

创建 PeopleSoft Enterprise 适配器的新实例

启动 BizTalk Server 管理控制台。依次单击“开始”、“所有程序”、“Microsoft BizTalk Server 20xx”BizTalk Server管理”。
在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“平台设置”，然后单击“适配器”。
右键单击“适配器”并指向“新建”、“适配器...”以显示“适配器属性”对话框。
输入 “名称” 字段的值，例如 PeopleSoft。
从“适配器”下拉列表中提供的适配器列表中选择“PeopleSoft Enterprise (r) ”，然后单击“确定”。

创建 BizTalk 发送端口

在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“发送端口”。
右键单击“ 发送端口 ”，然后指向 “新建”、“ 静态”One-Way“发送端口 ”以显示“ 发送端口属性 ”对话框。
输入 “名称” 字段的值，例如 PeopleSoftOneWaySP。
从“ 类型 ”下拉框中的可用适配器列表中选择 PeopleSoft 适配器，然后单击“ 配置 ”按钮以显示适配器 的“传输属性 ”对话框。

注意

此值是在 BizTalk Server 管理控制台中创建 PeopleSoft Enterprise 适配器时指定的名称。

为 “适配器所需属性”输入以下值：

属性	值
应用程序服务器路径	PeopleSoft Server 的计算机和端口位置，例如 //PSServer:8888。注意：如果未指定端口号，将使用默认端口 9000，因此在上面的示例中，如果 PeopleSoft 服务器使用默认端口值 9000，则可以输入值 //PSServer。
JAVA_HOME	与 Java 2 平台 SDK 文件相关联的主目录路径，例如 C:\j2sdk1.4.2_08
密码	连接到 PeopleSoft 系统时使用的密码。
PeopleSoft 8.x JAR 文件	PeopleSoft Java 对象适配器 JAR 文件 psjoa.jar 的位置，例如 C：\JARS\psjoa.jar。
用户名	用于连接到 PeopleSoft 系统的用户名。

单击 “确定” 。
从“发送管道”下拉列表中提供的管道列表中选择 XML 传输管道，然后单击“确定”。
右键单击发送端口，然后单击“ 开始 ”以登记并启动发送端口。

创建文件接收端口

在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”、“BizTalk 应用程序 1”，然后单击“接收端口”。
右键单击“接收端口”文件夹，然后单击“新建单向接收端口”以显示“接收端口属性”对话框。
输入 “名称” 字段的值，例如 PeopleSoftOneWayFileRP，然后单击“ 确定”。

创建文件接收位置

创建文件接收位置监视的文件夹，例如 C:\Filesource。
右键单击新的接收端口，然后单击 “新建”、“ 接收位置 ”以显示“ 接收位置属性 ”对话框。
输入 “名称” 字段的值，例如 PeopleSoftOneWayFileRL。
从“类型”下拉框中的可用适配器列表中选择“文件”，然后单击“配置”按钮以显示适配器的“传输属性”对话框。
输入之前为 “接收 文件夹”属性创建的文件夹的位置，然后单击“ 确定”。
从“接收管道”下拉框中的可用管道列表中选择“XMLReceive”，然后单击“确定”。
右键单击接收位置，然后单击“ 启用”。

修改适配器架构目标命名空间属性

启动 Visual Studio 并打开 OneWaySend.sln。单击“文件”、“打开”、“项目/解决方案...”以显示“打开项目”对话框。
浏览到 OneWaySend.sln 文件，单击以选择此文件，然后单击“ 打开 ”打开包含示例项目的解决方案。
单击“视图”菜单，然后选择“解决方案资源管理器”以显示解决方案资源管理器。
双击“解决方案资源管理器”中的 LOCATIONService_1.xsd 文件以将其打开。
右键单击 LOCATIONService_1.xsd 的 “架构 ”节点，然后选择“ 属性” 菜单选项以显示架构的属性。
编辑 “目标命名空间” 属性以使用适配器名称的相应值，例如 ，“目标命名空间” 属性应如下所示：
```
http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]  
```
其中 ，PeopleSoft 是在 BizTalk 管理控制台中查看的 PeopleSoft 适配器的名称。

重要

如果“目标命名空间”的配置值与输入文档实例中指定的命名空间不匹配，则在BizTalk Server处理输入文档实例时，将发生路由失败。

从适配器架构生成文档实例

双击解决方案资源管理器中的“LOCATIONService_1.xsd”，在“架构编辑器”中打开该文件。
右键单击“<架构>编辑器”中的“架构”节点，然后单击“属性”以显示该节点的属性。
从“根引用”下拉框中的可用节点列表中选择“CreateEx”。应执行此操作，以便在生成示例文档实例时，它将从架构的 CreateEx 节点生成。
在解决方案资源管理器中右键单击“LOCATIONService_1.xsd”，然后单击“属性”。
在属性窗口，单击以选择“常规”部分下的“输出实例文件名”选项。
单击省略号按钮 (...) 以显示 “选择输出文件 ”对话框。
指定输出文件实例的文件夹和名称，例如 C:\instance.xml 并单击“ 保存”。

注意

请勿指定为此处的文件接收位置指定的文件夹位置。
在解决方案资源管理器中右键单击“LOCATIONService_1.xsd”，然后单击“生成实例”，在指定位置生成文档实例。
右键单击“<架构>编辑器”中的“架构”节点，然后单击“属性”以显示该节点的属性。
从“根引用”下拉框中的可用节点列表中选择“ (默认) ”。

修改生成的文档实例

在文本编辑器中（如 Notepad），打开生成的文档实例，然后编辑文档实例的内容，以确保这些字段中的数据将在 PeopleSoft 系统中生成唯一的记录，例如，以下 XML 文件介绍了定义位置的记录中的字段：

<ns0:CreateEx xmlns:ns0="http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]">  
  <ns0:SETID>SHARE</ns0:SETID>  
  <ns0:LOCATION>9991</ns0:LOCATION>  
  <ns0:interactiveMode>true</ns0:interactiveMode>  
   <ns0:properties>  
    <ns0:LOCATION_TBL_sequence>  
      <ns0:LOCATION_TBL>  
        <ns0:COUNTRY>USA</ns0:COUNTRY>  
        <ns0:DESCR>Adapter Test</ns0:DESCR>  
        <ns0:EFFDT>2006-05-31</ns0:EFFDT>  
        <ns0:EFF_STATUS>A</ns0:EFF_STATUS>  
        <ns0:SETID>SHARE</ns0:SETID>  
      </ns0:LOCATION_TBL>  
    </ns0:LOCATION_TBL_sequence>  
  </ns0:properties>  
</ns0:CreateEx>

注意

在上面的示例中， PeopleSoft 是适配器的实际名称的占位符，如 BizTalk 管理控制台中所示。

保存修改后的文档实例。

生成并部署项目

右键单击解决方案资源管理器中的 OneWaySend 项目，然后单击“属性”以启动 Project Designer。
单击“ 部署 ”选项卡。
在 BizTalk 组下为“服务器”属性和“配置数据库”属性输入相应的值。
右键单击解决方案资源管理器中的 OneWaySend 项目，然后单击“部署”生成项目并将程序集部署到BizTalk Server配置数据库。

绑定并登记业务流程

在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“业务流程”。
单击 MMC 工具栏中的“刷新”按钮，或按键盘上的 F5 键刷新BizTalk Server管理控制台视图。
双击业务流程以显示“ 业务流程属性 ”对话框。
单击对话框左窗格中的“ 绑定 ”以显示业务流程的“绑定”选项。
指定绑定选项的适当值，例如：

参数值

主机 BizTalkServerApplication

FileReceivePort PeopleSoftOneWayFileRP

PeopleSoftOneWaySendPort PeopleSoftOneWaySP
单击“确定”。

参数	值
主机	BizTalkServerApplication
FileReceivePort	PeopleSoftOneWayFileRP
PeopleSoftOneWaySendPort	PeopleSoftOneWaySP

启动业务流程

在BizTalk Server管理控制台中，右键单击业务流程，然后单击“启动”以登记并启动业务流程。

将文档实例拖到由文件接收位置监视的文件夹

将以前创建的文档实例复制到文件接收位置配置为监视的文件夹中。

验证 PeopleSoft 系统是否已更新

使用 PeopleSoft Web 界面验证记录是否是从 XML 文件中的数据创建的。

成功处理文档实例后，会发生以下事件序列：

文件适配器从文件夹中检索文件，并作为 BizTalk 消息将其发布到 MessageBox。
业务流程订阅此发布消息，以便 BizTalk 消息引擎会激活业务流程的实例，并将该消息发送到该业务流程实例。
业务流程实例使用业务流程中指定的逻辑处理该消息，并将该消息发布回 MessageBox。
PeopleSoft 发送端口订阅此发布的消息，以便 BizTalk 消息引擎能够将此消息发布到 PeopleSoft 发送端口。
发送端口会将消息交给适用于 PeopleSoft Enterprise 的 BizTalk 适配器。
适用于 PeopleSoft Enterprise 的 izTalk 适配器调用 CreateEx 方法，以使用 XML 文件中的数据创建记录。

另请参阅

教程：使用用于 PeopleSoft Enterprise 的 BizTalk 适配器

通过