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()
方法。