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()
方法。