使用英语阅读

通过


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

另请参阅

附录 A:组件接口方法