使用一组唯一键和指定的属性创建新记录。
Syntax
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
参数
| 参数 | 说明 |
|---|---|
Key in/out parameter |
单个键参数 （key1， key2， ...keyn，必须提供。 服务器数据库中不能存在此密钥集，也就是说，它们必须是唯一的。 这些键对应于为特定组件接口定义的 CreateEx 密钥集。 |
interactiveMode |
错误处理。 访问组件接口中的属性时，Microsoft BizTalk Adapter for PeopleSoft Enterprise 使用 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 函数，则会提供用于 PeopleSoft Enterprise CreateEx() 的 BizTalk 适配器方法。