Reference > Shop flow URLs > Catalog subsystem URLs > Interest lists
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".
URL structure
- http:// host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path.
name-value pair with the &
character. For a detailed description of the parameters and their values, see 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 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.
- 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.
- 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.
Related concepts
Related reference