Get 方法

用于根据输入的键参数(key1、key2、...keyn)检索属性。 输出参数是一个结构,包含与键参数匹配的记录的属性。 如果组件接口只有一个实例(即没有键),则 Get 函数不包含任何键参数。 另请参阅 查找方法

语法

Get (key1, key2, ... keyn, properties)  
Get (key1, key2, ... keyn, getHistoryItems, properties)  

参数

参数 DESCRIPTION
key 服务器数据库中必须存在的一组参数;否则会发生错误。 这些键对应于为特定组件接口定义的获取密钥集。
properties 包含组件接口属性的完整结构,该属性在调用完成后返回。
getHistoryItems 布尔值。 如果组件接口的属性包含级别 0 以下的有效日期项(即,具有 EFFDT 名称的键字段), getHistoryItems 则需要其他参数。

如果值为:

- True—所有生效日期的项目都作为序列返回(可以嵌入到任何级别)。 其中包括所有过去的有效日期项、当前生效日期项以及所有将来生效日期的项目
- False——仅返回当前和所有未来的有效日期项。 如果要对同一实例进行更新的后续调用,则应 getHistoryItems 设置为 False。

注解

如果组件接口的属性包含级别 0 以下的有效日期项(即,具有 EFFDT 名称的键字段),则需要其他参数 getHistoryItems。 此参数的类型为布尔值。 如果设置为 True,则所有有效的日期项都将作为序列返回(可以嵌入到任何级别)。 其中包括所有过去的有效日期项、当前有效日期项以及所有未来的生效日期项。 如果参数 getHistoryItems 设置为 False,则仅返回当前和所有未来的有效日期项。 如果要对同一实例进行更新的后续调用,则应 getHistoryItems 设置为 False。 另请参阅 UpdateEx 方法

如果组件接口没有键,如只有一个实例可以存在的情况,则 Get() 该方法采用以下形式:

Get(properties)  

有关有效日期项的详细信息,请参阅 PeopleSoft Enterprise 文档。

注释

如果启用了组件接口中的 PeopleSoft Get 功能,则会提供用于 PeopleSoft Enterprise Get() 的 BizTalk 适配器方法。

另请参阅

附录 A:组件接口方法