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 WebSphere Commerce 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.

Related concepts

Shopping currency
Dual display and counter values
Currency
Order Management subsystem

Related reference

Order Management subsystem URLs
Currency data model