To change how your shipping groups are displayed, you must modify the displayPageFragment
property page fragment file. Each shipping group type defines three display values that appear on various pages. A display value consists of a title and content and is configured in the display page fragment JSP file, where the three display values are identified in the file as value1
, value2
and status
.
You can customize the default display values for the existing shipping group types. However, if you create new shipping group types, each new shipping group type must have a defined set of display values.
The following display values are configured for the hard good shipping type:
Value | Title | Content | Example |
---|---|---|---|
| Shipping Address |
| Bob Smith |
| Shipping Method |
| Ground |
| Status |
| Ready to Ship |
The following display details are configured for the electronic shipping group type:
Value | Title | Content | Example |
---|---|---|---|
| Electronic Address |
| bsmith@company.com |
| Blank |
| Blank |
| Status |
| Emailed |
The following display values are configured for the in-store pickup shipping group type:
Value | Title | Content | Example |
---|---|---|---|
| Store Address |
| The Big Store |
| Blank |
| Blank |
| Status |
| The goods are ready for pickup. |
Display details are used on the following pages for all shipping group types, unless otherwise indicated:
Display Location | Value1 | Value2 | Status |
---|---|---|---|
Shipping Addresses Page | X | ||
Order Review Page | X | X | |
Order View Page | X | X | X |
The /DCS-CSR-UI/atg/commerce/custsvc/ui/HardGoodShippingGroupConfiguration.
,
propertiesElectronicGoodShippingGroupConfiguration.properties
and InStorePickupShippingGroupConfiguration.properties
files hold all of the properties of the page fragments. The following is an example of the HardGoodShippingGroupConfiguration.properties
file:
$class=atg.commerce.csr.order.CommerceTypeConfiguration addPageFragment=/atg/commerce/custsvc/ui/fragments/order/ AddHardgoodShippingGroup editPageFragment=/atg/commerce/custsvc/ui/fragments/order/ EditHardgoodShippingGroup displayPageFragment=/atg/commerce/custsvc/ui/fragments/order/ DisplayHardgoodShippingGroup imagePageFragment=/atg/commerce/custsvc/ui/fragments/order/ HardgoodShippingGroupImage type=hardgoodShippingGroup addPageFragmentTitleKey=addHardgoodShippingGroupTitle editPageFragmentTitleKey=editHardgoodShippingGroupTitle imageHoverTextKey=hardgoodShippingGroupImageHoverText resourceBundle=atg.commerce.csr.order.WebAppResources
The DisplayHardgoodShippingGroupConfiguration.properties
file identifies the location of your page fragment JSP file and the servletContext
. For example:
$class=atg.web.PageFragment URL=/include/order/displayHardgoodShippingGroup.jsp servletContext=DCS-CSR
The displayHardgoodShippingGroup.jsp
file contains the values for the display details, including the title and the content. You must modify the value1
, value2
and status
properties with your custom information. The combination of these parameters defines one display value, such as value1
:
displayValue
– This optional parameter is used to display the value of the desired fielddisplayHeading
– This optional parameter is used to display the heading of the desired field
Example: Shipping Group Display Page Fragment Components
The following is a portion of the default configuration of the displayhardgoodShippingGroup.jsp
file. In this example, the displayHeading
parameter, which defines the display value1
title, is set to use the Shipping Address header. The displayValue
parameter, which defines the display value1
content, is set to use the addressView.jsp
fragment:
<c: if test="${propertyName == 'value1'}"> <c: if test="${displayHeading == true}"> <fmt: message key="shipping.address.header"/> </c: if> <c: if test="${displayValue == true}"> <dsp: include src="/include/addresses/addressView.jsp" otherContext="${csrConfigurator.contextRoot}"> <dsp: param name="address" value="${address}"/> </dsp: include> </c: if>
To display your customized shipping group title and content, modify the displayHeading
and displayValues
accordingly. For example, in the displayElectronicShippingGroup.jsp
file, the value1
title has been modified to define the displayHeading
as Electronic Address and the displayValue
as emailAddress
:
<c: if test="${propertyName == 'value1'}"> <c: if test="${displayHeading == true}"> <fmt: message key='shippingSummary.electronicAddress.header'/> </c: if> <c: if test="${displayValue == true}"> <li> <c: out value="${shippingGroup.emailAddress}"/> </li> </c: if> </c: if>
As noted above, the title and content for value1
is shown on the Shipping Addresses, Shipping Method (hard good only), Order Review, Return Items, Order View, Scheduled Orders pages and on confirmation e-mails. You may also modify the value2
property as needed. Note that electronic shipping groups do not use the value2
property by default, so it is left blank. You may add the displayHeading
and displayvalues
to the property as required.
Other components that can be customized within the display page fragment include the status
property. This property is used to identify the status of the group object and displayed only on the Order View and the Scheduled Order pages. The default title for both the hard good and electronic shipping group is Status, and the content defaults to shippingGroup.stateAsString
. Modify the heading of the display value to point to your customized information as needed:
<c: if test="${propertyName == 'status'}"> <c: if test="${displayHeading == true}"> <fmt: message key='shippingSummary.shippingStatus.header'/> </c: if> <c: if test="${displayValue == true}"> <dsp: droplet name="ShippingGroupStateDescriptions"> <dsp: param name="state" value="${shippingGroup.stateAsString}"/> <dsp: param name="elementName" value="stateDescription"/> <dsp: oparam name="output"> <dsp: droplet name="IsHighlightedState"> <dsp: param name="obj" value="${shippingGroup}"/> <dsp: oparam name="true"> <span class="atg_commerce_csr_dataHighlight"><dsp: valueof param="stateDescription"></dsp: valueof></span> </dsp: oparam> <dsp: oparam name="false"> <dsp: valueof param="stateDescription"></dsp: valueof> </dsp: oparam> </dsp: droplet> </dsp: oparam> </dsp: droplet> </c: if> </c: if>
The selectOptionText
property is used to identify the information that is presented in the address drop down on the Ship to Multiple Addresses and Split Quantity pages. By setting the displayValue
, you configure what address information is presented in the drop down. For example, the default configuration for the hard good shipping group contains the following:
<c: if test="${propertyName == 'selectOptionText'}"> <c: if test="${displayValue == true}"> ${fn: escapeXml(address.address1)}${!empty address.address2 ? ' ' : '' }${!empty address.address2 ? fn: escapeXml(address.address2) : '' } </c: if> </c: if>
The electronic shipping group selectOptionText
property has been modified to include the following:
<c: if test="${propertyName == 'selectOptionText'}"> <c: if test="${displayValue == true}"> ${fn: escapeXml (shippingGroup.emailAddress)} </c: if> </c: if>
Modify the display value with your customized page fragment.