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.
