用來根據輸入金鑰參數擷取屬性 (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 方法。