OrderItemDelete 指令
這個指令會從擱置的訂單中刪除訂單項目或產品。

參數值
- http://host_name/path/
- (必要)WebSphere Commerce Server 和架構路徑的完整名稱。
- forUser
- 將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
- langId
- 設定或重設在階段作業期間的屬意語言;
有關商店的支援語言可在 STORELANG 表格中找到。
- storeId
- 商店的參考號碼。
- URL
- (必要)當指令順利完成時所要呼叫的 URL。
- orderItemId
- (必要)訂單中所要刪除之項目的參考號碼。
只在沒有指定 catEntryId 時,這個參數才是必要的。
- catEntryId
- 要從訂單中刪除之項目的型錄項目 ID。
- orderId
- 使用訂單參考號碼或下列特殊縮寫之一來指定零或多項訂單:"."、"*"、".t"、"*t"。
請參閱訂單縮寫,以取得這些縮寫的說明。
如省略此參數,預設值為 "."。
- outOrderName
- 指定將新增到重新導向 URL 中的「名稱 / 值」配對名稱。所新增之「名稱 / 值」配對的值為輸入訂單的參考號碼。
範例 1
下列範例會從客戶訂單中刪除出貨地址號碼 2 所關聯的項目,並呼叫 OrderItemDisplay 指令來重新顯示客戶訂單中的項目:
http://myhostname/webapp/wcs/stores/servlet/OrderItemDelete?
orderItemId=2&URL=/webapp/wcs/stores/servlet/OrderItemDisplay
範例 2
下列範例會從客戶的現行擱置訂單中刪除型錄項目 ID 為 2 的項目。
現行擱置訂單的參考號碼會利用 orderId 參數來傳給 OrderItemDisplay 指令。
http://myhostname/webapp/wcs/stores/servlet/OrderItemDelete?
&catEntryId=2&orderId=.&outOrderName=orderId&URL=/webapp/wcs/stores/servlet/OrderItemList
規則
- 呼叫 AllocateInventory 指令及在 reverseOrderItems 參數中指定訂單中的所有 OrderItems,來從已刪除或取消的 OrderItems 中取消配置現有或預期的庫存。
- 如果有指定 orderItemId,指令會就要刪除的每個訂單項目來執行下列動作:
- 取得與訂單項目相關聯的訂單。
- 如訂單在擱置或編輯狀態,則會將它解除鎖定及更新時間戳記。
- 刪除訂單項目。
- 如果有指定 catEntryId,指令會執行下列動作:
- 編譯訂單清單以進行處理。
視需要呼叫 ResolveOrdersCmd 作業指令來取得目前擱置訂單。
- 針對清單中的每一個訂單執行下列動作:
- 如果訂單處於擱置狀態且訂單的訂單項目含有指定產品,則會解開訂單的鎖定,並更新時間戳記。
- 刪除所有內含指定產品的訂單項目。
- 當順利完成時,會呼叫指定的 URL。
異常狀況
若無產品或訂單符合指定的參數,則指令執行失敗。