PeopleSoftRequest 结点

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

本主题包含以下几部分:

用途

使用 PeopleSoftRequest 节点与 PeopleSoft 应用程序进行交互。 例如,一个 PeopleSoftRequest 节点请求 PeopleSoft 企业信息系统(EIS)的信息。 客户业务对象发送至 PeopleSoft, ,导致 PeopleSoft 检索客户信息,例如地址和账户详情。 节点检索到的响应信息可以被消息流的其余部分使用。 PeopleSoftRequest 节点检索到的响应信息可以被消息流的其余部分使用。 节点可以发送和接收业务数据。 PeopleSoftRequest 节点可以发送和接收业务数据。

节点包含在 PeopleSoftRequest 节点包含在 WebSphere Adapters 消息流节点面板的抽屉中, 在 IBM App Connect Enterprise 工具包中用以下图标表示:

PeopleSoftRequest 节点图标

在消息流中使用此节点

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

为了最大限度地提高性能并避免不必要的数据转换,请确保传递给 PeopleSoftRequest 节点的信息包含正确的数据类型。 解析节点生成的消息时, DataObject 域是默认域。 PeopleSoftRequest 节点生成的消息时,xml-ph-0000@deepl.internal域是默认域。 然而,当向 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 适配器的连接详细信息

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

如果将辅助适配器模式属性设置为 ,则 PeopleSoftRequest 仅调用主适配器中定义的方法。 如果未在主适配器中定义方法,那么发生错误。

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

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

如果设置此属性,随后更新项目依赖关系以移除此消息模型引用,那么将发出警告。 请更新消息模型属性,或者复原对此消息模型的引用。

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

如果取消选中此复选框,各节点都不会生成自己的本地环境副本,而是使用上一个节点传递给它们的本地环境。 因此,如果某个节点更改本地环境,上游节点会看到这些更改。

下表描述了节点的“监视”属性。
属性 M C 缺省 描述
事件 为节点定义的事件显示在此选项卡上。 缺省情况下,不会在消息流中的任何节点上定义任何监视事件。 使用 添加编辑删除 来创建,更改或删除节点的监视事件。

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