使用英语阅读

通过


UpdateEx 方法

用于更新基于输入键参数(key1、key2 … keyn)的属性。 使用 UpdateEx时,不能删除集合中的项。 可使用单独方法进行删除。 有关详细信息,请参阅 DeleteOnly 方法

语法

UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,  
    properties)  

参数

参数 说明
key 服务器数据库中必须存在的一组参数,或发生的错误。 这些键对应于为特定组件接口定义的一组 Get 键。
correctionMode 布尔型标志。 设置为 true 时,可通过更新字段值或将新项插入集合来修改生效日期项的组件接口。 特别是,允许在当前生效日期之前修改具有 EFFDT 的项目。 如果此标志未设置为 TRUE,则对这些项目的任何修改将导致从 PeopleSoft 服务器返回错误。

参数 correctionMode 仅针对包含有效日期项的组件接口公开。 否则,不会作为参数的一部分显示。

应避免在生产环境中将 设置为 correctionMode TRUE。 (这也是 PeopleSoft.) 事件的建议,这些事件已由过去的 EFFDT 键确定,不应修改。 允许创建审核记录。 中的 correctionModeUpdateEx 标志允许绕过此安全机制。 建议的做法是通过设置项目中的字段并添加(而不是删除)更新项目来停用过去的事件。
interactiveMode 用于错误处理的标志。

访问组件接口中的属性时,PeopleSoft Enterprise 的 BizTalk 适配器使用 PeopleSoft 提供的用于读写组件接口中各个字段的 API;但是,这些更改并不是逐一传播到 PeopleSoft 服务器的。 psjoa.jar(与 PeopleSoft Enterprise 的 BizTalk 适配器交互)会将所有更改打包,然后将这些更改通过一个程序包发送到服务器。 如果各个更新中有任何一个失败,则会返回一般错误,但未指明确切问题。 将交互模式设置为 TRUE 时,每个字段更新都会单独发送到服务器。 这样会对性能产生实质影响,但是在更新失败的情况下(例如,如果使用无效的值设置字段)会提供特定错误信息。

interactiveMode提供最佳性能,并在字段更新级别提供错误报告。 若要正确使用此功能,建议在设置为 FALSE 的情况下 interactiveMode 进行常规调用。 这应该不会对性能带来影响。 如果返回错误,可以在将 标志设置为 TRUE 的情况下 interactiveMode 重试相同的调用。 调用失败时,服务器将返回更准确的错误消息。

注解

调用此函数时,将使用输入参数属性替换与这些键相对应的记录的属性。 将删除原始记录的所有集合,并替换为输入参数中的集合。 这些集合的大小不必匹配,因为 中的 UpdateEx 过程是删除所有现有集合项,然后插入给定的集合项。

如果组件接口的属性包含生效日期项目,则属性参数必须包含所有未来的生效日期项目,因为原始列表已被替换。 这提供了添加和删除未来的生效日期项目的机制;但是,如果属性还包含过去的生效日期项目,则会因为无法修改过去的生效日期项目而返回错误。 如果还包含当前的生效日期项目,则将忽略该项目。 这允许客户端在参数设置为 False 的情况下getHistoryItems调用 Get() ,修改任何未来的有效日期项或添加新的生效日期项,并将 结构作为函数的参数UpdateEx()传入。

如果组件接口没有键(如只能存在一个实例的情况),则 UpdateEx() 方法的形式如下:

UpdateEx(correctionMode, interactiveMode, properties)  

备注

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

另请参阅

附录 A:组件接口方法