SetInterestItemList URL

This site level command sets or resets interest item lists as current. Invoking this URL is the only way to set or reset an interest item list as "current". This command can be run for a registered user, but cannot be run for a guest user.

URL structure

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

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 URL 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 URL, 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

  • Calls the GetCurrentIIListsCmd task command when the listId parameter is specified as "." to determine which interest item lists are current.
  • Calls the SetCurrentIIListsCmd task command to set the specified interest item lists as current.

Exception conditions

None.