CreateEx 方法
使用一組唯一索引鍵和指定的屬性,建立新的記錄。
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
參數 | Description |
---|---|
Key in/out parameter |
個別索引鍵參數 (key1、key2、...keyn),這些是必須提供的參數。 這組索引鍵不得存在於伺服器資料庫中,也就是說,它們必須是唯一的。 這些索引鍵對應於針對特定元件介面所定義的 CreateEx 索引鍵集。 |
interactiveMode |
處理時發生錯誤。 在存取元件介面中的屬性時,Microsoft BizTalk Adapter for PeopleSoft Enterprise 會使用 PeopleSoft 提供的 API,這些 API 會讀取及寫入元件介面中的個別欄位;但這些變更並不會逐一傳播至 PeopleSoft 伺服器。 psjoa.jar (BizTalk Adapter for PeopleSoft Enterprise 的互動對象) 會先封裝所有變更,再以這個單一封裝將變更傳送至伺服器。 如果有任何個別的更新失敗,將會傳回一般錯誤,而不會指出實際錯誤。 在互動模式設為 TRUE 的情況下,每個欄位更新都會個別傳送至伺服器。 雖然這對效能會有相當程度的影響,但卻能在更新失敗時 (例如用以設定欄位的值無效時) 提供具體的錯誤資訊。 interactiveMode 可提供最大效能,並可提供欄位更新層級的錯誤報告。 若要適當使用此功能,建議您平常進行呼叫時,將 interactiveMode 設為 FALSE。 這樣效能應該不會受到影響。 如果傳回錯誤,您可以將 interactiveMode 旗標設為 TRUE,再重試相同的呼叫。 當呼叫失敗時,伺服器會傳回更精確的錯誤訊息。 |
properties |
結構,包含元件介面的所有屬性。 CreateEx 呼叫 方法時,這些屬性會插入以指定的索引鍵所建立的記錄中, (s) 。 |
在某些情況下,通常呼叫 CreateEx()
沒有一組明確索引鍵,但函 CreateEx
式會傳回索引鍵。 在伺服器上觸發的 PeopleCode 支援這種行為。 例如,在建立訂單時,客戶可能不知道下一個可用的訂單編號為何。 指定 NEXT 做為訂單編號索引鍵,呼叫即會觸發 PeopleCode 來決定下一個可用的訂單編號。 這項資訊必須以 in/out 索引鍵參數傳回給呼叫端客戶。
注意
若要讓此機制順利運作,索引鍵也必須是層級 0 的屬性。 否則將會傳回原始索引鍵。
如果已啟用元件介面中的 PeopleSoft Create 和 Save 函式,則會提供 BizTalk Adapter for PeopleSoft Enterprise CreateEx()
方法。