DeleteOnly 方法
允许删除集合中的项。
DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,
properties)
参数 | 说明 |
---|---|
key |
必须提供的一组参数。 这组密钥必须存在于服务器数据库中,否则会发生错误。 这些键对应于为特定组件接口定义的一组 Get 键。 |
correctionMode |
布尔型标志。 如果设置为 true,则允许删除集合中过去的生效日期项。 具体而言,它允许删除在当前生效日期之前具有 EFFDT 的项目。 如果此标志未设置为 TRUE,则对这些项目的任何修改将导致从 PeopleSoft 服务器返回错误。 注意: 参数 correctionMode 仅针对包含有效日期项的组件接口公开。 否则,它不会显示为 参数的一部分。 |
interactiveMode |
用于错误处理。 访问组件接口中的属性时,适用于 PeopleSoft Enterprise 的 BizTalk 适配器使用 PeopleSoft 提供的 API,这些 API 在组件接口中读取和写入各个字段;但是,这些更改不会一次传播到 PeopleSoft 服务器。 相反,psjoa.jar (BizTalk Adapter for PeopleSoft Enterprise 与之交互) 将所有更改打包,并将更改发送到一个包中的服务器。 如果各个更新中有任何一个失败,则会返回一般错误,但未指明确切问题。 将交互模式设置为 TRUE 时,每个字段更新都会单独发送到服务器。 这样会对性能产生实质影响,但是在更新失败的情况下(例如,如果使用无效的值设置字段)会提供特定错误信息。 参数 interactiveMode 提供最佳性能,并在字段更新级别提供错误报告。 若要正确使用此功能,建议在设置为 FALSE 的情况下 interactiveMode 进行常规调用。 这应该不会对性能带来影响。 如果返回错误,可以在 interactiveMode 标志设置为 TRUE 的情况下重试相同的调用。 调用失败时,服务器将返回更准确的错误消息。 |
properties |
包含服务器上存在的 结构的子集。 将删除所有离开的项目。 |
属性的数据类型 CreateEx
与此组件接口的 或 UpdateEx
方法相同;但是,只有键值才重要。 忽略非键值。 键值必须与服务器上的键值匹配,否则将引发异常。
下面演示了键值的用法。 如果集合包含以下项:
item0
item1
item2
item3
可以通过在属性中提供 item1 和 item3 的键来删除 item1 和 item3:
item1
item3
调用后,服务器具有集合中的剩余项:
item0
item2
第二个示例显示包含其他集合的项:
item0
- item0a
item1
item1a
item1b
item1c
item2
item2a
item2b
可以通过向 item1b 和 item2 提供键来删除 item1b 和所有 item2:
item1
- item1b
item2
通过为 item2 提供空子集合,可将其转换为叶,并删除整个子分支。 调用后,服务器具有剩余项:
item0
- item0a
item1
item1a
item1c