You can customize CSC forms using configuration layering. Extend the functionality of forms within Commerce Service Center by modifying the fields within the form. CSC allows you to add or remove fields or to modify the behavior of fields. For example, you can identify required fields within a specific form, by mapping to your own JSP snippets that contain your customized layout. Once you have created your own customized JSP snippets, you can modify the appropriate configuration property for that form to render your customizations.
Using default or extended fragments, you can modify the default forms, and/or append your customizations. If these JSP snippets are not specified, the standard forms are rendered.
The following forms can be modified:
Page | Form/Page Area |
---|---|
Customer Information | Create New Customer |
Customer information | Edit/View Customer |
Customer Search | Customer Search or the Select Customer pop-up in the shopping cart |
Order Search | Order Search |
Product Catalog | Product Search |
Order View | Display values |
Scheduled Order | Display values |
Forms are customized by modifying the configuration properties files that define the JSP fragments that replace and/or append the field. The JSP fragment is integrated within your page layout to display the new or modified field. CSC uses a default JSP fragment that contains all of the standard fields displayed on a page, and an optional extended JSP fragment used for creating additional fields.
The default page fragment component is mapped to the default JSP snippet in CSC but may be redirected with a configuration property to your own JSP page. The page contains a dsp:include
tag that reads the associated configuration file and then includes the page defined by the page fragment component. For example, to change the default fragment to your own code, you would change the page fragment’s servletContext
and URL
properties to point to your page.
The extended page fragment component allows you to append content to the page without changing the default page fragment. The extended page fragment component contains the same functionality as, and is defined directly after, the default page fragment component.
The default and extended page fragment components are instances of atg.web.PageFragment
, which are used to define the location of the JSP file. The configuration files that define the page fragment components contain the following properties to identify the JSP:
servletContext
- Specifies the context root of the JSP fragment that will be incorporated into the pageURL
- Specifies the URL of the JSP fragment to be incorporated into the page
Both the default and extended property files are instances of PageFragment
, allowing a servletContext
and URL
to be specified for the JSP snippet. As such, the servletContext
and URL
property descriptions can be applied for both fragment types.