使用一組獨特鍵和指定的屬性建立新紀錄。
語法
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
參數
| 參數 | 說明 |
|---|---|
Key in/out parameter |
個別金鑰參數（key1、key2、...Keyn），必須提供。 這組金鑰必須不存在於伺服器資料庫中，也就是說，它們必須是唯一的。 這些鍵對應於特定元件介面定義的 CreateEx 鍵集合。 |
interactiveMode |
錯誤處理。 在存取元件介面中的屬性時，Microsoft BizTalk Adapter for PeopleSoft Enterprise 使用 PeopleSoft 提供的 API，能在元件介面中讀寫個別欄位;然而，這些變更不會逐一傳遞到 PeopleSoft 伺服器。 相反地，psjoa.jar（PeopleSoft Enterprise 的 BizTalk 轉接器與之互動）會將所有變更打包，並將變更寄送至伺服器。 若任一個別更新失敗，會回傳一個通用錯誤，但無法精確指出實際錯誤。 當互動模式設為 TRUE，每次欄位更新都會單獨傳送到伺服器。 這對效能有重大影響，但若更新失敗（例如設定欄位使用無效值），會提供特定錯誤資訊。 互動模式提供最大效能，並在現場更新層級提供錯誤回報。 為了正確使用此功能，建議正常呼叫時將 InteractiveMode 設為 FALSE。 不應該會影響效能。 若回傳錯誤，則可將 InteractiveMode 標誌設為 TRUE 重試同一呼叫。 當呼叫失敗時，伺服器會回傳更精確的錯誤訊息。 |
properties |
一個包含元件介面所有屬性的結構。 當 CreateEx 方法被呼叫時，這些屬性會入以指定鍵值建立的記錄中。 |
備註
在某些情況下，通常會呼叫 CreateEx() 未包含一組明確鍵，但函 CreateEx 式會回傳鍵。 這種行為是被伺服器觸發的 PeopleCode 支援的。 例如，要建立採購單時，客戶可能不知道下一個可用的採購單號碼。 透過指定 NEXT 作為郵政號碼鍵，通話會觸發 PeopleCode，決定下一個可用的郵政號碼。 這些資訊必須透過輸入/輸出鍵參數回傳給呼叫的客戶端。
備註
此機制必須同時具備 0 級的屬性。 否則，原始金鑰會被歸還。
如果元件介面中的 PeopleSoft 建立與儲存功能啟用，則會提供 BizTalk Adapter for PeopleSoft 企業 CreateEx() 版方法。