Working With the Address Detail Web Part
The Address Detail Web Part lets shoppers create new addresses or edit existing addresses.
Web Part
.gif "Dd442331.vugaddressdetailscreen(en-US,CS.90).gif") |
The Address Detail Web Part has the following fields:
Address line 1 (mandatory)
Address line 2 (Optional)
City (mandatory)
Region presented as State or Province depending on locale (mandatory for US and Canada only)
Postal/Zip Code (mandatory for US and Canada only)
Telephone number (mandatory)
Country (mandatory)
The Address Detail Web Part also lets shoppers mark the address as a shipping address or billing address and to designate it as the primary (default) shipping or billing address.
All fields are validated on both the client side and server side of the application.
The field labels are dynamic based on the locale and culture of the page. For example, if you set up the Address Book Web Part to display text for a US English-speaking shopper, the Region field would be State and the Postal Code field would be Zip Code.
Property Sheet
The following figure shows the Address Detail Web Part property sheet. The Address Detail Web Part property sheet lets site designers control some aspects of the Web Part's behavior and appearance. The property sheet is displayed by selecting the edit option on the Web Page (in Edit Page mode) and then selecting Edit Shared Web Part. This displays the property sheet. Expand the sections to see the relevant properties.
.gif "Dd442331.Vug_Address_WP_Properties(en-US,CS.90).gif")
Properties
The following table lists and describes the properties for the Address Detail Web Part
Property |
Type |
Description |
Default |
|---|---|---|---|
"Action" URL parameter |
String |
This property sets the name of the URL query string parameter which is used to specify the action that this web part should perform. Default value is "act". This value should not be changed. If it is changed, all links to this page, in code or mark-up, will need to be modified accordingly. |
Blank |
"Address detail" section title text |
String |
Sets the text displayed above the address detail area. |
Blank |
"Address Id" URL parameter |
String |
This property sets the name of the URL query string parameter which is used to specify the id of the address to load. Default value is "address". This value should not be changed. If it is changed, all links to this page, in code or mark-up, will need to be modified accordingly. |
Blank |
"Is billing address" check box text |
String |
Sets the text displayed beside the "is billing address" check box. |
Blank |
"Cancel" button text |
String |
Sets the text displayed on the "cancel" button. |
Blank |
"Remove" button text |
String |
Sets the text displayed on the "remove" button. |
Blank |
"Save" button text |
String |
Sets the text displayed on the "save" button. |
Blank |
"City" label text |
String |
Sets the text displayed beside the "city" text box. |
Blank |
"City is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "city". |
Blank |
Use "delete confirmation" pop-up |
Boolean |
If checked, causes a pop-up to be displayed asking the user to confirm the deletion. You can configure the text displayed using the "Delete confirmation pop-up text" field. |
True |
"Country" label text |
String |
Sets the text displayed beside the "country" text box. |
Blank |
"Country is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "country". |
Blank |
CSS class |
String |
Sets the style sheet "class" name used when outputting the HTML markup of this web part. |
Blank |
"Default billing address" check box text |
String |
Sets the text displayed beside the "set as default billing address" check box. |
Blank |
"Default shipping address" check box text |
String |
Sets the text displayed beside the "set as default shipping address" check box. |
Blank |
"Delete confirmation" pop-up text |
String |
Sets the text displayed on the delete confirmation pop-up. |
Blank |
"First name" label text |
String |
"First name" label text |
Blank |
"First name is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "first name". |
Blank |
Instructional text |
String |
Sets the text block displayed above the address detail area. Can be used to provide instructions to end users. |
Blank |
"Last name" label text |
String |
Sets the text displayed beside the "last name" text box. |
Blank |
"Last name is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "last name". |
Blank |
"Line 1" label text |
String |
Sets the text displayed beside the "line 1" text box. |
Blank |
"Line 1 is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "line 1". |
Blank |
"Line 2" label text |
String |
Sets the text displayed beside beside the "line 2" text box. |
Blank |
"Phone number format is invalid" message |
String |
Sets the text displayed when the user submits an invalid value for "phone number". |
Blank |
"Phone number" label text |
String |
Sets the text displayed beside the "phone number" text box. |
Blank |
"Phone Number is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "phone number". |
Blank |
On completion, go to URL |
String |
Sets the page URL to redirect to once the operation has completed. |
Blank |
"Postal code" label text |
String |
Sets the text displayed beside the "postal code" text box. |
Blank |
"Postal code is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "postal code". |
Blank |
"Province" label text |
String |
Sets the text displayed beside the "province" text box. |
Blank |
"Postal code is invalid" message |
String |
Sets the text displayed when the user submits an invalid value for "postal code". |
Blank |
"Zip code is invalid" message |
String |
Sets the text displayed when the user submits an invalid value for "zip code". |
Blank |
"Is shipping address" check box text |
String |
Sets the text displayed beside the "is shipping address" check box. |
Blank |
"State" label text |
String |
Sets the text displayed beside the "state" drop-down. |
Blank |
"State is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "state". |
Blank |
Default Mode |
String |
Sets the mode that the web-part will be in when the page first displays. Valid values are "Create", "Edit", "Delete" or "View". |
Blank |
"Zip code" label text |
String |
Sets the text displayed beside the "zip code" text box. |
Blank |
"Zip code is required" message |
String |
Sets the text displayed when the user submits the form without supplying a value for "zip code". |
Blank |