PeopleSoftRequest节点

使用 PeopleSoftRequest 节点与 PeopleSoft 应用程序交互。

本主题包含以下几部分：

用途

使用 PeopleSoftRequest 节点与 PeopleSoft 应用程序交互。 例如，PeopleSoftRequest 节点从 PeopleSoft 企业信息系统 (EIS) 请求信息。 客户 业务对象被发送到 PeopleSoft,导致 PeopleSoft检索客户信息，如地址和帐户详细信息。 PeopleSoftRequest节点获取的响应信息可用于信息流的其他部分。 PeopleSoftRequest节点可以发送和接收业务数据。

PeopleSoftRequest 节点包含在消息流节点调板的 Oracle PeopleSoft 抽屉中、并在 IBM® App Connect Enterprise 工具包中用以下图标表示：

PeopleSoftRequest 节点图标

在消息流中使用此节点

要正常运行，PeopleSoftRequest节点需要一个适配器组件（使用 Adapter 组件节点属性设置）和 业务对象定义（存储在节点引用的消息集中）。 因此，您必须提供一个消息集。 默认情况下，从 PeopleSoftRequest 节点传播的消息位于 DataObject 域中，因此 Message 域 属性被设置为 DataObject 。 您无法指定其他域。 节点将自动检测消息类型。

为最大限度地提高性能并避免不必要的数据转换，请确保传递给 PeopleSoftRequest 节点的消息包含正确的数据类型。 在解析由 PeopleSoftRequest 节点生成的消息时，DataObject 域是默认域。 但是，在向 PeopleSoftRequest 节点传递数据时（例如，使用 MQInput 节点），使用不同的域可以提高性能。 例如，将 XMLNSC 解析器与 MQInput 节点配合使用以解析 XML 消息。

PeopleSoftRequest节点使用集成节点本地事务管理器支持本地事务，使用集成节点外部同步点协调器支持全局事务。

要有效维护 PeopleSoft, 可以在策略上设置连接超时值（请参阅 配置 EIS 连接在指定时间后过期）。

您可以将多个使用同一适配器组件的 WebSphere® Adapters 请求节点部署到集成服务器。

可以使用以下格式的 mqsisetdbparms 命令为 Adapter for PeopleSoft Enterprise配置具有用户名和密码的帐户名称。
mqsisetdbparms -w workDir -n adapter name -u user name -p password
例如：
mqsisetdbparms -w c:\workdir\ACEServ1 -n eis::PeopleSoftCustomerOutbound.outadapter -u peoplesoftuid -p ********

对 PeopleSoft 节点使用策略

PeopleSoft 节点可以从适配器组件或策略获取 PeopleSoft 连接详细信息。 通过使用策略，您可以更改适配器的连接详细信息，而无需重新部署适配器 (请参阅 更改 PeopleSoft 适配器的连接详细信息)。

终端和属性

将 PeopleSoftRequest 节点实例放入消息流后，就可以对其进行配置；请参阅 配置消息流节点。 节点的属性在“属性”视图中显示。 如果双击 PeopleSoftRequest 节点，就会打开适配器连接向导。 所有必须输入值（未定义缺省值）的必需属性用星号标记。

PeopleSoftRequest节点终端如下表所示。

终端 描述
输入 接受请求 业务对象的输入终端。
输出 如果响应 业务对象 表示成功完成请求，并且需要在此消息流中进行进一步处理，那么将向其发送该响应的输出终端。
失败 如果 PeopleSoftRequest节点发生错误，消息将传播到故障终端。 有关错误和 业务对象 事件的信息也可以传播到 Failure 终端。

下表描述了此节点的属性。 标题为 M 的列指示属性是否为 必需 (如果在未定义缺省值时必须输入值，那么在面板上标有星号); 标题为 C 的列指示属性是否为 可配置 (您可以在将消息流添加到 BAR 文件以进行部署时更改该值)。

PeopleSoftRequest 节点描述属性如下表所示。

属性 M C 缺省 描述
节点名 否 否 节点类型，PeopleSoftRequest 节点的名称。
简短描述 否 否   节点的简要描述。
详细描述 否 否   描述消息流中节点用途的文本。
PeopleSoftRequest 节点的基本属性如下表所示。
属性 M C 缺省 描述 mqsiapplybaroverride 命令属性
主适配器组件 是 否   包含适配器配置属性的适配器组件名称。 请输入适配器文件名称，或单击浏览从参考消息集项目中可用的文件列表中选择适配器文件。

当PeopleSoftRequest节点从PeopleSoft系统接收数据时，它会将数据与方法名称关联起来。 PeopleSoftRequest 节点尝试调用主适配器中定义的方法。 如果未在主适配器中定义方法，那么节点可以调用部署至相同集成服务器的匹配辅助适配器中定义的方法。

在运行时，您可以通过创建 PeopleSoftConnection 策略来覆盖适配器文件中的属性。 必须在集成服务器的缺省策略项目中定义该策略。 有关更多信息，请参阅 更改 PeopleSoft 适配器的连接详细信息。

  
辅助适配器方式 否 是 无 指定节点是否可以调用辅助适配器中定义的方法。

如果将 Secondary adapter mode 属性设置为 None ，PeopleSoftRequest 节点将只调用主适配器中定义的方法。 如果未在主适配器中定义方法，那么发生错误。

如果将此属性设置为应用程序中的所有适配器，那么节点可以调用部署到同一应用程序的任何 PeopleSoft 出站适配器中定义的方法。 如果节点部署为独立资源（即，它不包含在应用程序中），那么节点可以调用同样部署为独立资源的任何 PeopleSoft 出站适配器中定义的方法。

 secondaryAdapterMode
缺省方法 是 是   要使用的缺省方法绑定。 defaultMethod
PeopleSoftRequest 节点响应消息解析属性如下表所示。
属性 M C 缺省 描述
消息域 否 否 DataObject 用于解析响应消息的域。 默认情况下，从 PeopleSoftRequest 节点传播的响应消息位于 DataObject 域中。 您无法指定其他域。
消息模型 是 否 自动设置 这是在其中定义响应消息的消息模型模式文件的名称或位置。 该字段在适配器组件属性中自动设置。

如果设置此属性，随后更新项目依赖关系以移除此消息模型引用，那么将发出警告。 请更新消息模型属性，或者复原对此消息模型的引用。
消息 否 否   响应消息的名称。 此节点自动检测消息类型。 您不能设置此属性。
物理格式 否 否   响应消息物理格式的名称。 您不能设置此属性。
PeopleSoftRequest 节点事务性属性如下表所示。
属性 M C 缺省 描述
事务方式 否 否 否 此属性指定更新应独立执行，而不是作为本地事务的一部分来执行。 此属性不能更改。
PeopleSoftRequest 节点请求属性如下表所示。
属性 M C 缺省 描述
方法位置 是 否 $LocalEnvironment/Adapter/MethodName 用于触发 PeopleSoftRequest 节点在外部系统上执行操作的业务方法（如 createPurchaseOrder 或 deletePurchaseOrder）的位置。
数据位置 是 否 $Body 从接收到的消息树中获取数据以形成从 PeopleSoftRequest 节点发送到 EIS 的请求的位置。
PeopleSoftRequest节点结果属性如下表所示。
属性 M C 缺省 描述
输出数据位置 否 否 $OutputRoot PeopleSoftRequest 节点发送输出的消息树位置。
复制本地环境 否 否 选中 此属性控制本地环境如何复制到输出消息。 如果选中此复选框，在消息流中每个节点上，都会在树中创建一个新的本地环境副本，并且使用前一个节点的本地环境的内容填充该副本。 因此，如果某个节点更改本地环境，上游节点看不到这些更改，因为它们都有自己的副本。 如果使用 FlowOrder 节点，或者在 Compute 节点上使用 propagate 命令，那么此行为可能是一个问题。

如果取消选中此复选框，各节点都不会生成自己的本地环境副本，而是使用上一个节点传递给它们的本地环境。 因此，如果某个节点更改本地环境，上游节点会看到这些更改。
下表中描述了该节点的监控属性。
属性 M C 缺省 描述
事件 否 否 无 您为节点定义的事件将显示在此选项卡上。 缺省情况下，不会在消息流中的任何节点上定义任何监视事件。 使用 添加， 编辑和 删除 来创建，更改或删除节点的监视事件; 请参阅 使用监视属性配置监视事件源 以获取详细信息。

通过选中或取消选中启用复选框，可以启用或禁用此处显示的事件。