通过

教程：使用 PeopleSoft Enterprise 的 BizTalk 适配器以从 PeopleSoft Enterprise 中检索数据

  • 项目

PeopleSoft Enterprise 的 BizTalk 适配器可以用于执行针对 PeopleSoft 系统的查询，并返回查询的结果。 本演练介绍了可演示此功能的 SDK 示例。

必备条件

  • Java 2 平台必须安装在运行 PeopleSoft Enterprise Geis 的 BizTalk 适配器BizTalk Server上。

  • 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\PeopleSoftTwoWaySend

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

Runtime 项目文件名 Runtime 项目文件说明
TwoWaySend.btproj,

TwoWaySend.sln		 应用程序的项目和解决方案文件。
LOCATIONService.xsd、

LOCATIONService_1.xsd、

LOCATIONService_2.xsd		 应用程序的架构文件。 注意： 项目中的适配器架构文件最初是使用 “添加适配器元数据向导”创建的。 有关添加适配器元数据向导的详细信息，请参阅BizTalk Server文档中的主题“如何将适配器元数据添加到 BizTalk 项目”。
PeopleSoftTwoWaySend.odx 应用程序使用的业务流程。
PeopleSoftTwoWaySend.snk 强命名密钥文件。

如何使用本示例

创建 PeopleSoft Enterprise 适配器的新实例

  1. 启动 BizTalk Server 管理控制台。 依次单击“开始”、“程序”、“MicrosoftBizTalk ServerBizTalk Server管理”。

  2. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“平台设置”，然后单击“适配器”。

  3. 右键单击“ 适配器 ”并指向“ 新建”，“ 适配器 ”以显示“ 适配器属性 ”对话框。

  4. 输入 “名称” 字段的值，例如 PeopleSoft。

  5. 从“适配器”下拉列表中提供的适配器列表中选择“PeopleSoft Enterprise (r) ”，然后单击“确定”。

创建要求响应 BizTalk 发送端口

  1. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“发送端口”。

  2. 右键单击“ 发送端口 ”，然后指向 “新建”、“ 静态”Solicit-Response“发送端口 ”以显示“ 发送端口属性 ”对话框。

  3. 输入 “名称” 字段的值，例如 PeopleSoftTwoWaySP。

  4. 从“ 类型 ”下拉框中的可用适配器列表中选择 PeopleSoft 适配器，然后单击“ 配置 ”按钮以显示适配器 的“传输属性 ”对话框。

    注意

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

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

    属性 值
    应用程序服务器路径 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 系统的用户名 。

  6. 单击 “确定” 。

  7. 从“发送管道”下拉列表中提供的管道列表中选择 XMLTransmit 管道。

  8. 从“接收管道”下拉列表中提供的管道列表中选择 XMLReceive管道 ，然后单击“ 确定”。

  9. 右键单击发送端口，然后单击“ 开始 ”以登记并启动发送端口。

创建单向 BizTalk 发送端口

  1. 创建发送端口使用的目标文件夹，例如 C:\Files\Out。

  2. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“发送端口”。

  3. 右键单击“ 发送端口 ”，然后指向 “新建”、“ 静态”One-Way“发送端口 ”以显示“ 发送端口属性 ”对话框。

  4. 输入 “名称” 字段的值，例如 PeopleSoftTwoWayFileSP。

  5. 从“类型”下拉框中的可用适配器列表中选择“文件”，然后单击“配置”按钮以显示适配器的“传输属性”对话框。

  6. 输入前面为 “目标 文件夹”属性创建的文件夹的位置，然后单击“ 确定”。

  7. 从“发送管道”下拉列表中提供的管道列表中选择 XMLTransmit 管道，然后单击“确定”。

  8. 右键单击发送端口，然后单击“ 开始 ”以登记并启动发送端口。

创建文件接收端口

  1. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”、“BizTalk 应用程序 1”，然后单击“接收端口”。

  2. 右键单击“接收端口”文件夹，然后单击“新建单向接收端口”以显示“接收端口属性”对话框。

  3. 输入 “名称” 字段的值，例如 PeopleSoftTwoWayFileRP，然后单击“ 确定”。

创建文件接收位置

  1. 创建由文件接收位置监视的文件夹，例如 C:\Files\In。

  2. 右键单击新的接收端口，然后单击 “新建”、“ 接收位置 ”以显示“ 接收位置属性 ”对话框。

  3. 输入 “名称” 字段的值，例如 PeopleSoftTwoWayFileRL。

  4. 从“类型”下拉框中的可用适配器列表中选择“文件”，然后单击“配置”按钮以显示适配器的“传输属性”对话框。

  5. 输入之前为 “接收 文件夹”属性创建的文件夹的位置，然后单击“ 确定”。

  6. 从“接收管道”下拉框中的可用管道列表中选择“XMLReceive”，然后单击“确定”。

  7. 右键单击接收位置，然后单击“ 启用”。

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

  1. 启动 Visual Studio 并打开 TwoWaySend.sln。 单击“文件”、“打开”、“项目/解决方案”以显示“打开项目”对话框。

  2. 浏览到 TwoWaySend.sln 文件，单击以选择此文件，然后单击“ 打开 ”打开包含示例项目的解决方案。

  3. 单击“视图”菜单，然后选择“解决方案资源管理器”以显示解决方案资源管理器。

  4. 双击“解决方案资源管理器”中的 LOCATIONService_1.xsd 文件以将其打开。

  5. 右键单击 LOCATIONService_1.xsd 的 “架构 ”节点，然后选择“ 属性” 菜单选项以显示架构的属性。

  6. 编辑 “目标命名空间” 属性以使用适配器名称的相应值，例如 ，“目标命名空间” 属性应如下所示：

    http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]

    其中，PeopleSoft 是在 BizTalk Server 管理控制台中查看的 PeopleSoft 适配器的名称。

    重要

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

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

  1. 双击 解决方案资源管理器 中的 LOCATIONService_1.xsd，在架构编辑器中打开该文件。

  2. 在架构<编辑器中右键单击“架构>”节点，然后单击“属性”以显示该节点的属性。

  3. 从“根引用”下拉框中的可用节点列表中选择“获取”。 应执行此操作，以便在生成示例文档实例时，该实例将从架构的 Get 节点生成。

  4. 在解决方案资源管理器中右键单击“LOCATIONService_1.xsd”，然后单击“属性”以显示属性窗口中的属性。

  5. 在属性窗口，单击以选择“输出实例文件名”选项。

  6. 单击省略号按钮 (...) 以显示 “选择输出文件 ”对话框。

  7. 指定输出文件实例的文件夹和名称，例如 C:\instance.xml 并单击“ 保存”。

    注意

    请勿指定为此处的文件接收位置指定的文件夹位置。

  8. 在解决方案资源管理器中右键单击“LOCATIONService_1.xsd”，然后单击“生成实例”，在指定位置生成文档实例。

  9. 右键单击“<架构>编辑器”中的“架构”节点，然后单击“属性”以显示该节点的属性。

  10. 从“根引用”下拉框中的可用节点列表中选择“ (默认) ”。

修改生成的文档实例

  1. 在文本编辑器（如记事本）中打开生成的文档实例，并编辑文档实例的内容，以确保这些字段中的数据将返回现有记录：

    <ns0:Get xmlns:ns0="http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]">  
<ns0:SETID>SHARE</ns0:SETID>  
<ns0:LOCATION>WFKLOC</ns0:LOCATION>  
<ns0:getHistory>true</ns0:getHistory>  
</ns0:Get>

    注意

    在上面的示例中， PeopleSoft 是适配器的实际名称的占位符，如 BizTalk 管理控制台中所示。 SHARE 和 WFKLOC 是用于标识 PeopleSoft 系统中特定记录的值的占位符。

  2. 保存修改后的文档实例。

生成并部署项目

  1. 右键单击解决方案资源管理器中的 TwoWaySend 项目，然后单击“属性”以显示该项目的项目Designer。

  2. 单击 Project Designer中的“部署”选项卡。

  3. 在 BizTalk 组下为“服务器”属性和“配置数据库”属性输入相应的值。

  4. 右键单击 解决方案资源管理器 中的 TwoWaySend 项目，然后单击“部署”生成项目并将程序集部署到BizTalk Server配置数据库。

绑定并登记业务流程

  1. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“业务流程”。

  2. 单击BizTalk Server管理控制台工具栏中的“刷新”按钮，或按键盘上的 F5 键刷新BizTalk Server管理控制台视图。

  3. 双击业务流程以显示“ 业务流程属性 ”对话框。

  4. 单击对话框左窗格中的“ 绑定 ”以显示业务流程的“绑定”选项。

  5. 指定绑定选项的适当值，例如：

    参数 值
    主机 BizTalkServerApplication
    FileReceivePort PeopleSoftTwoWayFileRP
    PeopleSoftTwoWaySend678 PeopleSoftTwoWaySP
    ResponsePort PeopleSoftTwoWayFileSP

  6. 单击“确定”。

启动业务流程

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

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

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

验证文档实例是否由 PeopleSoft Enterprise 的 BizTalk 适配器处理。

  • 打开将文件发送端口配置为发送到的目标文件夹，并验证是否已生成输出文档。 此文件应包含 PeopleSoft Enterprise 的 BizTalk 适配器处理的查询结果。

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

  1. 文件适配器从文件夹中检索文件，并作为 BizTalk 消息将其发布到 MessageBox。

  2. 业务流程会订阅此发布的消息，以便 BizTalk 消息引擎能够激活业务流程的实例，并将该消息发送到业务流程实例。

  3. 业务流程实例将此消息发布回 MessageBox。

  4. 要求响应发送端口会订阅此发布的消息，因此 BizTalk 消息引擎会将消息发送到 PeopleSoft 发送端口中。

  5. 发送端口会将消息交给适用于 PeopleSoft Enterprise 的 BizTalk 适配器。

  6. PeopleSoft Enterprise 的 BizTalk 适配器会使用定义在输入文件中的参数针对 PeopleSoft 系统执行 Get 语句。

  7. PeopleSoft Enterprise 的 BizTalk 适配器会为业务流程中的要求响应端口以响应消息形式返回 Get 语句的结果。

  8. 业务流程将结果集发布到 MessageBox。

  9. 文件发送端口会订阅此消息，以便 BizTalk 能够将消息发送到文件适配器。

  10. 文件适配器将包含结果集的消息写入到指定的输出文件夹。

另请参阅

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