Deprecated feature

SetCurrencyPreference URL

This URL sets the currency preference for the user running this URL. For a generic user (one for whom there is no information stored) the preference applies for the duration of the session only. For all other users the currency preference is saved with the user's profile.

URL structure

http://host_name/path/
The fully qualified name of your Transaction server and the configuration path

Parameter values

forUser
The logon ID of the user on whose behalf the command will be run; only a person with a security role of Customer Service Representative (or those roles that include the CSR tasks) can specify this parameter
forUserId
Same as forUser, but identifying the user by the internal user ID, as found in the USERS table
langId
The preferred language for the duration of the session; the supported languages for a store are found in the STORELANG table
URL
Required: The URL to be called when the command completes successfully
currency
Required: The three-letter ISO code for the currency that will become the preferred currency for this customer

Example

This example changes a customer's preferred currency to Canadian dollars (CAD). If the command is successful, FVTestSite.jsp is displayed.


   
http://myhostname/webapp/wcs/stores/servlet/SetCurrencyPreference?currency=CAD
    &URL=FVTestSite.jsp

Behavior

  • For all non-generic users, this command sets a currency preference in the user's profile. The group of non-generic users includes both registered members and non-registered members for whom there is some profile information stored.
  • If there are any pending orders, this command changes the currency of those orders to the shopping currency and recalculates the prices.
  • This command then calls the SetCurrencyPrefCmd task command to change the order prices.
  • See Shopping currency for more details.

Exception Conditions

If no price could be found for any of the products or items in a pending order, the command throws the ECApplicationException exception specifying the RetrievePriceError error view command.