閱讀英文

共用方式為


Get 方法

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

語法

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

參數

參數 Description
key 一組必須存在於伺服器資料庫中的參數;若不存在這些參數,將會出現錯誤。 這些索引鍵對應至針對特定元件介面所定義的一組 Get 索引鍵。
properties 內含完整的元件介面屬性結構,完成呼叫時即會傳回這個結構。
getHistoryItems Boolean 值。 如果元件介面的屬性包含層級 0 以下的有效日期專案 (,則需要具有 EFFDT 名稱的索引鍵欄位,) getHistoryItems 需要其他參數。

如果值為:

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

備註

如果元件介面的屬性包含層級 0 以下的有效日期專案 (,則需要具有 EFFDT) 名稱的索引鍵欄位,則需要額外的參數 getHistoryItems 。 此參數類型為布林值, 而且一旦設為 True,即會傳回所有帶有生效日期的項目的序列 (可以以任何層級內嵌)。 這些項目包括所有帶有過去、現在與未來生效日期的項目。 getHistoryItems如果參數設定為 False,則只會傳回目前和所有未來的有效日期專案。 如果要對相同實例進行後續更新的呼叫, getHistoryItems 則應該設定為 False。 另請參閱 UpdateEx 方法

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

Get(properties)  

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

注意

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

另請參閱

附錄 A:元件介面方法