Simple Customization

Simple customization involves writing custom JSPs and configuring Nucleus components to refer to that JSP. For example, to replace the area of the Product View panel that displays product SKUS and allows agents to enter quantities for each SKU, you would modify the /atg/commerce/custsvc/ui/
renderers/ProductSkuRenderer component.

Because renderer components are globally scoped, you can temporarily change the page though the Dynamo HTML admin. All renderer components exist in the Nucleus configuration path at /atg/commerce/custsvc/ui/renderers/. So if you are using JBoss, the SKU rendering component may be located at:

http://localhost:8080/dyn/admin/nucleus/atg/commerce/custsvc/ui/
renderers/ProductSkuRenderer/

Changing the url property of this component to point to the new JSP temporarily implements the customization. To make this configuration persistent, you must use a configuration file.

All components live under the Nucleus path /atg/commerce/custsvc/ui/renderers/. There are four components for each renderer:

Pages that use renderers reference them using the path and the base name, for example:

<csr:renderer name="/atg/commerce/custsvc/renderers/ProductInformation">

There are optional RenderInfo properties, which include:

There is also a subclass RenderInfo for additional custom properties. A contextRoot property is available in the atg.commerce.csr.rendering.RenderInfo class, allowing you to identify a web-app within CSC. The web-app is executed when a user’s web browser references a URL that contains the web module’s context root.

For example, if you were to modify a renderer component such as /atg/commerce/custsvc/ui/
renderers/ProductInformationRenderer to identify the contextRoot property of:

contextRoot=/web-app
url=/web-app/test.html

This replaces the contents of the product information panel with whatever would be rendered by visiting http://machine:port/web-app/test.html.

 
loading table of contents...