使用英语阅读

通过


CreateEx 方法

使用一组唯一的项和指定的属性创建新记录。

语法

CreateEx  
(key1, key2, ..., keyn, interactiveMode, properties)  

参数

参数 说明
Key in/out parameter 各个项参数(key1、key2...keyn),必须提供。

此项集不得存在于服务器数据库中,即它们必须是唯一的。

这些项对应于为特定组件接口定义的“CreateEx”项集。
interactiveMode 错误处理。

访问组件接口中的属性时,用于 PeopleSoft Enterprise 的 Microsoft BizTalk 适配器使用 PeopleSoft 提供的 API,这些 API 可以读取和写入组件接口中的各个字段;但是,这些更改不会一次一个地传播到 PeopleSoft 服务器上。 相反,psjoa.jar (BizTalk Adapter for PeopleSoft Enterprise 与之交互) 将所有更改打包,并将更改发送到一个包中的服务器。

如果各个更新中有任何一个失败,则会返回一般错误,但未指明确切问题。 将交互模式设置为 TRUE 时,每个字段更新都会单独发送到服务器。 这样会对性能产生实质影响,但是在更新失败的情况下(例如,如果使用无效的值设置字段)会提供特定错误信息。

interactiveMode 提供最佳性能,并在字段更新级别提供错误报告。 若要正确使用此功能,建议将 interactiveMode 设置为 FALSE 的情况下进行正常调用。 这应该不会对性能带来影响。 如果返回错误,可以在 interactiveMode 标志设置为 TRUE 的情况下重试相同的调用。 调用失败时,服务器将返回更准确的错误消息。
properties 包含组件接口所有属性的结构。 CreateEx调用 方法时,这些属性将插入到使用指定键 () 创建的记录中。

注解

在某些情况下,在不使用一组显式键的情况下调用 CreateEx() 是一种常见做法,但 CreateEx 函数会返回这些键。 在服务器上触发的 PeopleCode 支持此行为。 例如,若要创建采购订单,客户端可能不知道下一个可用的 PO 编号。 通过将 NEXT 指定为 PO 编号项,调用会触发 PeopleCode,这将确定下一个可用 PO 编号。 此信息必须返回到调用客户端(使用 in/out 项参数)。

备注

要使此机制正常工作,键还必须是级别 0 的属性。 否则,将返回原始密钥。

如果组件接口中启用了 PeopleSoft Create 和 Save 函数,则会提供 BizTalk Adapter for PeopleSoft Enterprise CreateEx() 方法。

另请参阅

附录 A:组件接口方法