允許你刪除收藏中的項目。
語法
DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,
properties)
參數
| 參數 | 說明 |
|---|---|
key |
是一組必須提供的參數。 這組金鑰必須存在於伺服器資料庫中，否則會發生錯誤。 這些鍵對應於特定元件介面所定義的 Get 鍵數集合。 |
correctionMode |
一面布林旗。 當設定為 true時，允許刪除集合中過去有效日期的項目。 具體來說，它允許在當前生效日前刪除有EFFDT的項目。 若未將此標記設為 TRUE，任何對這些項目的修改都會從 PeopleSoft 伺服器回傳錯誤。
註：correctionMode該論證僅在包含有效日期項目的元件介面中被揭露。 否則，這不會作為論證的一部分呈現。 |
interactiveMode |
用於錯誤處理。 在元件介面存取屬性時，PeopleSoft Enterprise 的 BizTalk 介面卡會使用 PeopleSoft 提供的 API，能在元件介面中讀寫個別欄位;然而，這些變更不會逐一傳遞到 PeopleSoft 伺服器。 相反地，psjoa.jar（PeopleSoft Enterprise 的 BizTalk 轉接器與之互動）會將所有變更打包，並將變更寄送至伺服器。 若任一個別更新失敗，會回傳一個通用錯誤，但無法精確指出實際錯誤。 當互動模式設為 TRUE，每次欄位更新都會單獨傳送到伺服器。 這對效能有重大影響，但若更新失敗（例如設定欄位使用無效值），會提供特定錯誤資訊。 該 interactiveMode 參數提供最大效能，並在現場更新層級提供錯誤回報。 要正確使用此功能，建議您將正常通話 interactiveMode 設定為 FALSE。 不應該會影響效能。 若回傳錯誤，則可將 InteractiveMode 標誌設為 TRUE 重試同一呼叫。 當呼叫失敗時，伺服器會回傳更精確的錯誤訊息。 |
properties |
包含伺服器上結構的子集。 所有屬於葉子的項目都會被刪除。 |
備註
屬性與此元件介面的 or UpdateEx 方法具有相同的資料型態CreateEx;但只有關鍵值是重要的。 非關鍵值則被忽略。 鍵值必須與伺服器上的值相符，否則會觸發例外。
以下說明了關鍵值的使用方法。 若一個收藏包含以下項目：
項目0
item1
item2
第三項
你可以透過屬性中提供 item1 和 item3 的鍵來刪除 item1 和 item3：
item1
第三項
呼叫結束後，伺服器會保留集合中剩餘的項目：
項目0
item2
第二個範例顯示包含其他集合的項目：
項目0
- 項目0a
item1
項目1a
項目1b
項目1c
item2
項目2a
項目2b
你可以透過將金鑰給 item1b 和 item2 來刪除 item1b 和整個 item2：
item1
- 項目1b
item2
提供 item2 的空子集合後，它會變成葉子，整個子分支就會被刪除。 通話結束後，伺服器擁有剩餘的項目：
項目0
- 項目0a
item1
項目1a
項目1c