共用方式為


Get 方法

用來根據輸入金鑰參數擷取屬性 (key1, key2, ...keyn)。 輸出參數是包含符合索引鍵參數之記錄屬性的結構。 如果元件介面只有一個實例(也就是沒有索引鍵),Get 函式就不會包含任何索引鍵參數。 另請參閱 Find 方法

語法

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

參數

參數 說明
key 伺服器資料庫中必須存在的一組參數;否則會發生錯誤。 這些鍵對應至為特定元件介面所定義的 Get Keys 集合。
properties 包含元件介面屬性的完整結構,此屬性會在呼叫完成時傳回。
getHistoryItems 布爾值。 如果元件介面的屬性包含層級 0 以下的有效日期的項目(也就是索引鍵欄位名稱為 EFFDT),則需要額外的 getHistoryItems 參數。

如果值為:

- True—所有有效的日期項目都會以序列回傳(這些項目可以內嵌在任何層級中)。 其中包括所有過去的有效日期專案、目前的有效日期專案,以及所有未來的有效日期專案
- False — 只會傳回目前和所有未來有效日期的項目。 如果後續對相同實例進行更新的呼叫, getHistoryItems 則應該設定為 False。

備註

如果元件介面的屬性包含層級 0 以下的有效日期條目(也就是具有 EFFDT 名稱的鍵欄位),則需要額外的參數 getHistoryItems。 此參數的類型為 Boolean。 如果設定為 True,則所有有效的日期項目都會以序列傳回(它可以內嵌在任何層級中)。 其中包括所有過去的有效日期專案、目前的有效日期專案,以及所有未來的有效日期專案。 getHistoryItems 參數如果設定為 False,則只會傳回當前以及未來所有有效日期的項目。 如果要對相同實例進行後續更新的呼叫, getHistoryItems 則應該設定為 False。 另請參閱 UpdateEx 方法

如果元件介面沒有索引鍵,就像只有一個實例可以存在的情況一樣,則 Get() 方法的格式如下:

Get(properties)  

如需有效日期項目的詳細資訊,請參閱 PeopleSoft Enterprise 文件。

備註

如果元件介面中的 PeopleSoft Get() 函式已啟用,將提供 PeopleSoft Enterprise BizTalk Adapter Get 方法。

另請參閱

附錄 A:元件介面方法