SetInterestItemList command

This site level command sets or resets interest item lists as current. Invoking this command is the only way to set or reset an interest item list as "current". 

Command structure

http://host_name/path/
The fully qualified name of your WebSphere Commerce Server and the configuration path.

Diagram of the command structure: the command starts with the fully qualified name of your WebSphere Commerce Server and the configuration path, followed by the command name, SetInterestItemList  and the ? character. End the command with a list of parameters in the form of name value pairs. Separate each name value pair with the & character. For a detailed description of the parameters and their values, refer to the list entitled Parameter values.

Parameter values

langId
Sets or resets the preferred language for the duration of the session; the supported languages for a store are found in the STORELANG table.
forUser
The logon ID of the user on whose behalf the command will be run; only a person with the authority to process orders can specify this parameter.
forUserId
Same as forUser, but identifying the user by the internal user ID, as found in the USERS table.
URL
(Required) The URL to be called when the command completes successfully.
storeId
The store reference number under which this command is run; if the value for this parameter is carried from the previous command, storeId is not required, otherwise, specify storeId.
listId
Specifies zero or more shopping carts to be set current; abbreviations may be used
  • If "." is specified, the GetCurrentIIlistsCmd process task is invoked to obtain the current interest item lists, and the command behaves as if the current interest item lists were specified. If there are none, the most recently updated interest item list is used.
  • If  "*" is specified, the command behaves as if all customer's interest item lists were specified
  • If a specified interest item list no longer exists, it is not set current
  • If nothing is specified for this parameter, then any interest item lists that are current will be reset, leaving no lists as current
This parameter can be repeated.
listIdName
Upon completion of this command, if redirection is used to cause a second command to run, then listIdName specifies the parameter name of the second command that will use the value of the listId parameter in this first command. Most often, the second command also has a listId parameter and thus &listIdName=listId. This parameter can be repeated.

Example 1

The following example sets interest item list 1 and 2 as current, in addition to those which are already current:

http://host_name/webapp/wcs/stores/servlet/SetInterestItemList?
listId=.&listId=1&listId=2&URL=/

Example 2

The following example resets all the interest item lists, leaving the customer with none of them current:

http://host_name/webapp/wcs/stores/servlet/SetInterestItemList?URL=/

Behavior

Exception conditions

None.