InterestItemAdd 指令
這個網站層次下的指令會新增一或多項產品或 SKU(或兩者)到一或多份喜好項目清單中。
請搭配 SSL(安全 Sockets 層次)使用此指令,以確保客戶的登入密碼與個人資訊皆經過加密。其做法是鍵入指令與 HTTPS 安全通信協定。

參數值
- http://host_name/path/
-
WebSphere Commerce Server 與架構路徑的完整名稱
- langId
- 設定或重設在階段作業期間的屬意語言。
有關商店的支援語言可在 STORELANG 表格中找到。
- forUser
- 將代替其執行指令之使用者的登入 ID。只有具備處理訂單權限的人才可指定這個參數。
- forUserId
- 與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
- URL
- 當指令順利完成時所要呼叫的 URL。
- storeId
- 型錄項目所關聯且是執行這個指令時所使用的商店參考號碼。
- catEntryId_i
-
要新增到喜好項目清單中之型錄項目的參考號碼。
- attrName_i
-
在 ATTRVALUE 表格中,定義給型錄項目的任何屬性參考 ID。
- attrValue_i
-
在 ATTRVALUE 表格中,定義給型錄項目的屬性直欄 STRINGVALUE 或 INTEGERVALUE。
- listId
-
喜好項目清單的參考號碼;可以使用縮寫:
- 若指定的型錄項目不復存在,則不會新增之。
- 如遺漏此參數,則此指令的規則如同指定 "." 。
- 如果參數試圖將已存在於清單中的型錄項目新增到清單中,
其結果將視 updatable 參數的設定而定。
- 若指定".",則會呼叫 GetCurrentIIListsCmd
作業指令,以取得客戶的現行喜好項目清單,且指令會認為您指定的是現行的喜好項目清單。如果 GetCurrentIIListsCmd
作業指令發現並無現行喜好項目清單,則會採用最近更新的清單。
如果找不到任何清單,則作業會新建一個。
- 如果指定 "*",則指令會認定您是指定客戶的所有喜好項目清單。
- listIdName
- 一旦此指令完成,如果使用重新導向會造成執行第二個指令,
則 listIdName 會指定採用第一個指令中之 listId 參數值之第二個指令的參數名稱。在大部份情況下,
第二個指令也有一個 listId 參數,因而 &listIdName=listId
- quantity_i
- 項目的數量。 預設值為 1。
- UOM_i
- 度量單位。預設值會關聯於商店。
- field1_i, field2_i, field3_i
- 儲存在 IITEM 表格之 FIELD1、FIELD2 與 FIELD3 直欄(保留給商店使用)中的值。
- updateable_i
- 當指令要求應將型錄項目新增到清單中,但該項目早已存在於該清單中時,該如何做:
範例
下列範例會新增型錄項目的 deluxe 版(參考號碼為 9,是參考號碼為 1 的商店所賣出)到客戶的現行訂單中,且會呼叫 InterestItemDisplay 指令。
這個範例會假設項目的有效屬性 ID 為 3,且 ATTRVALUE 表格定義了其屬性值 "deluxe"。
https://host_name/webapp/wcs/stores/servlet/InterestItemAdd?storeId=1&catEntryId=9
&URL=/webapp/commerce/InterestItemDisplay&attrName=3&attrValue=deluxe
規則
異常狀況
- 如果指定給 AuthIIListAccessCmd 作業指令的錯誤指令執行失敗,
則 AuthIIListAccesErr 異常作業會處理此錯誤。
- 如果指定給 ResolveSkuCmd 作業指令的錯誤指令發現有必要的產品屬性遺漏,
則指令會設定 ProductAttributeErrorView 異常作業,以處理錯誤。如果指令發現使用指定屬性的產品並未存在於資料庫中,
則作業會設定同一 ProductAttributeErrorView 異常作業以處理該錯誤。