InterestItemListCopy 指令

這個網站層次下的指令會將某個喜好項目清單中的喜好項目複製到另一個清單中, 藉以建立或更新喜好項目清單。

參數值

http://host_name/path/
WebSphere Commerce Server 與架構路徑的完整名稱
langId
設定或重設在階段作業期間的屬意語言; 有關商店的支援語言可在 STORELANG 表格中找到。
forUser
將代替其執行指令之使用者的登入 ID;只有具備處理訂單權限的人才可指定這個參數。
forUserId
與 forUser 相同,但卻是 USERS 表格中之內部使用者 ID 所指的使用者。
URL
當指令順利完成時所要呼叫的 URL。
storeId
執行這個指令時所用的商店參考號碼。如果這個參數的值沿用先前指令的值,就不需要指定 storeId,否則,請指定 storeId。
catEntryId
指定 IITEM 表格之 CATENTRY_ID 直欄中指定的喜好項目參考號碼, 以便從喜好項目清單中複製。 若指定 "*", 則指令會認定您是指定所指喜好項目清單中的所有喜好項目;將會忽略 catEntryId 的無效值。
inListMemberId
將複製其喜好項目清單之使用者的參考號碼; 若未指定此參數,則預設值為現行使用者
inListId
指定要複製的輸入喜好項目清單;可以使用縮寫
inListIdName
指出將加到重新導向 URL 中的「名稱-值」配對名稱。 所新增之「名稱-值」配對的值會是 inlistId 所指定之喜好項目清單的參考號碼。提供此參數的用意在於您可以指定一個喜好項目清單,而不必另行使用 inlistId。
outListId
指定喜好項目要複製到其中的喜好項目清單;可以使用縮寫
outListIdName
指出將加到重新導向 URL 中的「名稱-值」配對名稱。 所新增之「名稱-值」配對的值會是 outlistId 所指定之喜好項目清單的參考號碼。提供此參數的用意在於您可以指定一個喜好項目清單,而不必另行使用 outlistId。
outListDesc
指定輸出喜好項目清單的說明。如果該清單已存在,並已有一則說明,則此新說明將會取代之。 如果您正在建立輸出喜好項目清單,並且尚未提供說明,則會採用輸入喜好項目清單的說明。 否則,說明將預設為空白。
displaySeq
指出將複製進喜好項目之喜好項目清單的顯示順序。若未指定此參數,且建有新訂單, 其顯示順序會設為比現有清單之最大顯示順序值還大的值;如果此客戶目前尚無喜好項目清單,則顯示順序將設為 "1"。

下例中所用的加號 (+) 是以空格型式儲存在資料庫中。

範例 1
下列範例是從客戶之現行喜好項目清單(參考號碼為 1)中複製出所有產品,藉以建立新喜好項目清單。 並指定新喜好項目清單的說明。 指令亦會重新導向到一個 URL 中,以顯示新清單。並使用 outListId 參數, 以指出需將 listId 參數傳給 InterestItemDisplayCmd 指令。 InterestItemDisplayCmd 指令中的 listId 參數值為新喜好項目清單的參考號碼。
     http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
     inListId=1&catEntryId=*&outListId=*
     &outListDesc=The+new+list+Description&outListIdName=listId
     &URL=/webapp/commerce/InterestItemDisplay

範例 2
下列範例是建立新的空喜好項目清單,並沿用喜好項目清單 4 的說明。
     http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
     inListId=4&outListId=**&URL=/

範例 3

下列範例是變更喜好項目清單 12 的說明。如果此清單不存在,則會發生錯誤: 
     http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
     outListId=12&outListDesc=The+new+Description&URL=/

範例 4

下列範例是將現行客戶的所有喜好項目清單合併到一個新清單中, 而其說明為 "The contents of all my current shopping carts"(現行所有購物車中的內容)。 重新導向的 URL 含有一個「名稱-值」配對 outlistId=<nnn>; 其中 <nnn> 為新喜好項目清單的參考號碼。
     http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
     inListId=.&catEntryId=*&outListId=**&outListIdName=outlistId
     &outListDesc=The+contents+of+all+my+current+shopping+carts&URL=/

範例 5

下列範例是將客戶現行喜好項目清單中的所有項目複製到客戶所有現有的喜好項目清單中。同時,它會建立一個新喜好項目清單, 其中含有出自所有現行喜好項目清單中的所有喜好項目。 原存在於輸出喜好項目清單中的項目將會被取代。
     http://host_name/webapp/wcs/stores/servlet/InterestItemListCopy?
     inListId=.&catEntryId=*&outListId=*&outListId=**&inListIdName=inlistId
     &outListIdName=outlistId&URL=/demomall/basemall.htm

規則

異常狀況
如果指定給 AuthIIListAccessCmd 作業指令的作業指令執行失敗, 則函數會設定 AuthIIListAccessErr 異常作業,以處理此錯誤。

相關概念

相關參照

IBM copyright