InterestItemAdd コマンド
これはサイト・レベルのコマンドであり、1 つ以上の商品または SKU、あるいはその両方を、
1 つ以上の「興味のあるアイテム」リストに追加します。
このコマンドは、SSL (Secure Sockets Layer) を併せて使用し、顧客のログオン・パスワードと個人情報を確実に暗号化するようにしてださい。
これを行うには、コマンドを HTTPS セキュア・プロトコルで入力します。

パラメーター値
- http://host_name/path/
-
WebSphere Commerce サーバーおよび構成パスの完全修飾名。
- langId
- セッション期間中の優先言語を設定またはリセットします。
ストアでサポートされている言語は、STORELANG テーブルにあります。
- forUser
- このコマンドの実行対象のユーザーのログオン ID。
このパラメーターを指定できるのはオーダーを処理する権限がある人だけです。
- forUserId
- forUser と同様ですが、ユーザーは USERS テーブル中にある内部ユーザー ID によって識別されます。
- URL
- コマンドが正常に完了した時に呼び出される URL。
- storeId
- カタログ・エントリーに関連付けられ、このコマンドが実行されるストアの参照番号。
- catEntryId_i
-
「興味のあるアイテム」リストに追加するカタログ・エントリーの参照番号。
- attrName_i
-
カタログ・エントリーに対して ATTRVALUE テーブルで定義される任意の属性参照 ID。
- attrValue_i
-
カタログ・エントリーに対して ATTRVALUE テーブルに定義される、属性の STRINGVALUE または INTEGERVALUE 列。
- listId
-
「興味のあるアイテム」リストの参照番号。省略形を使用できます。
- 指定されたカタログ・エントリーが既に存在しない場合は、追加されません。
- このパラメーターが指定されていない場合、コマンドは "." が指定された場合と同様に振る舞います。
- これが、すでにリストにあるカタログ・エントリーをそのリストに追加するようなパラメーターの場合、
その結果は更新可能パラメーターの設定によって変わります。
- "." が指定された場合は、顧客の現行の「興味のあるアイテム」リストを入手するために GetCurrentIIListsCmd タスク・コマンドが呼び出されます。
このコマンドは、現行の「興味のあるアイテム」リストが指定された場合と同様に振る舞います。
GetCurrentIIListsCmd タスク・コマンドが、現行の「興味のあるアイテム」リストが存在しないと判別した場合は、最後に更新されたリストが使用されます。
リストがまったく存在しない場合には、タスクが新規リストを作成します。
- "*"が指定されると、コマンドは顧客の「興味のあるアイテム」リストがすべて指定された場合と同様に振る舞います。
- listIdName
- このコマンドの完了時に、2 度目のコマンドを実行させてリダイレクトを行う場合、listIdName で 2 度目のコマンドのパラメーター名を指定します。
2 度目のコマンドは、この最初のコマンドの listId パラメーター値を使用します。
ほとんどの場合、2 度目のコマンドにも listId パラメーターがあり、したがって、&listIdName=listId のような意味を持ちます。
- quantity_i
- アイテムの数量。 デフォルトは 1 です。
- UOM_i
- 計測単位。 デフォルトは、ストアに関連付けられます。
- field1_i, field2_i, field3_i
- 値は、 IITEM テーブルの
ストアに予約されている FIELD1、FIELD2、および FIELD3 列に保管されます。
- updateable_i
- コマンドがカタログ・エントリーをリストに追加することを要求し、
そのエントリーがすでにそのリストに存在している場合に行うべきこと。
- 1= 更新する
- 0= 例外を発生させる
- 指定なし= 1 をデフォルトとする
例
以下の例は、参照番号が 9 であり、参照番号 1 のストアで販売され、
参照番号 9 のカタログ・エントリーのデラックス・バージョンを顧客の現行・オーダーに追加してから、
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
動作
- listId パラメーターが "." で指定されているか、または省略されている場合は、
「興味のあるアイテム」リストがカタログ・エントリーへ追加されることを判別するために、
このコマンドは、 GetCurrentIIListsCmd
タスク・コマンドを呼び出す。
- AuthIIListAccessCmd
タスク・コマンドが呼び出され、
指定された「興味のあるアイテム」リストごとに書き込み許可を検査する。
- ResolveSkuCmd
タスク・コマンドを呼び出して、カタログ・エントリーの SKU を決定する。
- ユーザーの「興味のあるエントリー」リストに追加しようとしているカタログ・エントリーが、
ユーザーの契約から除外されている商品セットのメンバーでないことを確認してください。
- IITEM テーブルにカタログ・エントリーを追加する。
- 正常終了すると、指定した URL を呼び出す。
- 計測単位に従って数量を正規化して丸める。
例外条件
- AuthIIListAccessCmd
タスク・コマンドに割り当てられたエラー・コマンドが失敗した場合、
コマンドは AuthIIListAccesErr 例外タスクを設定して、エラーを処理します。
- ResolveSkuCmd
タスク・コマンドに割り当てられたエラー・コマンドは、必須の商品属性は欠落していることを判別して、
エラー処理をする ProductAttributeErrorView 例外タスクを設定します。
このコマンドが、指定された属性をもつ商品がデータベースに存在しないと判別した場合は、
タスクはエラー処理をする同じ ProductAttributeErrorView 例外タスクを設定します。