addressMap Element
For the latest version of Commerce Server 2007 Help, see the Microsoft Web site.
The addressMap element in the Web.config file identifies how Commerce Server maps the properties of an address in the Profiles System to the properties of an OrderAddress object in the Orders System.
The addressMap element is a child of the orders Element, and is required.
The addressMap element contains two child elements: the profileDefinition element and the property element.
profileDefinition Element
The profileDefinition element specifies the name of the profile definition whose properties will be used to populate an OrderAddress object. This element is optional.
The following table lists the attributes of the profileDefinition element.
Attribute |
Data Type |
Description |
---|---|---|
name |
String |
The name of the profile that contains the address information. The default value is "Address". This attribute is required. |
property Element
The property element specifies a mapping from a property of an address in the Profiles System to a property of an OrderAddress in the Orders System. There can be more than one property element within the addressMap element. This element is optional.
The following table lists the attributes of the property element.
Attribute |
Data Type |
Description |
---|---|---|
from |
String |
The name of the property in the Profiles System. This attribute is required. |
to |
String |
The name of the member variable of the OrderAddress object that the property maps to.
Note:
If the OrderAddress object does not have a member variable with this name, then a new weakly typed indexer property is added.
This attribute is required. |
If you omit the orders element, the default values for the addressMap element will be used to map the properties of an address in the Profiles System to the properties of an OrderAddress object in the Orders System. However, if you include the orders element but omit the addressMap element within the orders element, then no address profile properties will be mapped to an OrderAddress object.
Commerce Server provides the following default mappings from the Address profile.
From |
To |
---|---|
GeneralInfo.address_id |
OrderAddressId |
GeneralInfo.first_name |
FirstName |
GeneralInfo.last_name |
LastName |
GeneralInfo.address_line1 |
Line1 |
GeneralInfo.address_line2 |
Line2 |
GeneralInfo.city |
City |
GeneralInfo.region_code |
RegionCode |
GeneralInfo.postal_code |
PostalCode |
GeneralInfo.country_name |
CountryName |
GeneralInfo.region_name |
State |
GeneralInfo.tel_number |
DaytimePhoneNumber |
Example
<addressMap>
<profileDefinition name="Address"/>
<property from="GeneralInfo.address_id" to="OrderAddressId"/>
<property from="GeneralInfo.first_name" to="FirstName"/>
<property from="GeneralInfo.last_name" to="LastName"/>
<property from="GeneralInfo.address_line1" to="Line1"/>
<property from="GeneralInfo.address_line2" to="Line2"/>
<property from="GeneralInfo.city" to="City"/>
<property from="GeneralInfo.region_code" to="RegionCode"/>
<property from="GeneralInfo.postal_code" to="PostalCode"/>
<property from="GeneralInfo.country_name" to="CountryName"/>
<property from="GeneralInfo.region_name" to="State"/>
<property from="GeneralInfo.tel_number" to="DaytimePhoneNumber"/>
</addressMap>