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