bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

JavaServer Page Guide

JSP Templates

WebLogic Portal provides a set of perdefined JSP templates that you can use in your applications. You can either use the templates exactly as BEA provides them or you can modify them to meet your specific needs; for example by applying your own skins and layouts. This section lists the templates available.

This section includes information on the following subjects:

- Template Location

- Commerce Templates

- Campaign Templates

- Catalog Templates

- Catalog and Campaign Includes

- Order Templates

- Registration Templates

- User Templates

Template Location

All templates are located in the following directory:

<BEA_HOME>\weblogic700\portal\samples\portal\wlcsDomain\
beaApps\wlcsApp\wlcs\commerce

Commerce Templates

Table A-1 lists the templates used for developing commerce services.

Table A-1 /commerce Templates

main.jsp | Anonymous main home - start page.
login.jsp | Provides form-based submission of username and password to gain access to account, and a link to create a new user.
badlogin.jsp | Similar to login.jsp, displays an error message (includes login.jsp).
configurationerror.jsp | Used when there is an error in the webflow configuration or pipeline.
newuserforward.jsp | Redirects to the user/newusercreation.jsp.
servererror.jsp | All-purpose 403, 404, 405, 500 server error page.
sessiontimeout.jsp | Session timeout page.
shoppingcart.jsp | Presents the items ordered; user may change quantities, delete, continue.

Campaign Templates

Table A-2 lists the JSP templates available for setting up Campaign services.

Table A-2 /commerce/campaignTemplates

contractor_journal.jsp

Sample offsite page associated with a campaign example.

fixup_channel.jsp

Sample offsite page associated with a campaign example.

Catalog Templates

Table A-3 Describes the JSP templates available for setting up a Catalog service

.

Table A-3 /CatalogTemplates

browse.jsp | Successive drill-downs via browse of the catalog. Same template applied for subcategories and sub-sub-categories.
details.jsp | Displays all the selected metadata for a single item; includes backtrack nav to parent category.
search.jsp | Power search page; includes power search results.
searchresults.jsp | Results from a quick keyword search conducted anywhere in the site.

Catalog and Campaign Includes

Table A-4 describes the JSP include templates available for setting up a Catalog or Campaign service.

Table A-4 Catalog and Campaign include Templates

category.jsp | Creates the list of subcategories, and presents the item summary of any items at the parent (current) category level. If there are more than x-number, the list is continued with "next" and "previous" pages.
itemdetails.jsp | An include module that contains the item details presentation.
itemsummary.jsp | An include module that allows the repeat of multiple items on a search or browse page.
navigation.jsp | An include module providing "back-track" ("breadcrumbs") navigation in the browse interface.
navigation2.jsp | An include module providing "back-track" ("breadcrumbs") navigation in the browse interface.
admin.inc | Used on all pages and presents the top red-and-black banner with links to the main Administration screen, to this template index, and to a *.jsp.html file for the current template.
header.inc | Used on all pages and presents a Home link. Depending on the page that included header.inc, also presents links for Search, View Cart, Log In (for users who have not logged in yet), or Log Out (for authenticated users).
footer.inc | Used on all pages.
leftside.inc | Presents quick look-up and a promotional ad; for authenticated users, also presents a personalized message to the user, customer profile link, order history link, and payment history link.
stylesheet.inc | Used in all pages, this is a cascading stylesheet that defines global paragraph and text styles for the site.
states.inc | Used in all forms where US states are listed as options in an input pop-up.
countries.inc | Used in all forms where countries are listed as options in an input pop-up.
editaddresstemplate.inc | Used in profile and order forms where the user can edit an existing shipping address.
editcctemplate.inc | Used in profile and order forms where the user can edit an existing credit card.
newaddresstemplate.inc | Used in profile and order forms where the user can supply a new shipping destination address.
newcctemplate.inc | Used in profile and order forms where the user can supply a new credit card for payment.
newdemographictemplate.inc | Included into register/newuser.jsp and user/editdemographics.jsp; presents a form that allows user to enter or update demographic information. The demographic details provided can then be used by campaign-related features.

Order Templates

Table A-5 decribes the templates available for setting up an Order service.

Table A-5 /Order Templates

selectaddress.jsp

Existing destination address(es) presented; user may choose, edit, add new.

addaddress.jsp

If user does not find the desired shipping address in selectaddress.jsp - includes newaddresstemplate.jsp.

shipping.jsp

Choices for express, airmail, ups, etc., presented; user may also add special shipping instructions.

selecttaxaddress.jsp

Conditional upon certain jurisdictions; user may select a county, etc.; then continue with checkout.

payment.jsp

Choices for which (credit card) account to use for this transaction; user may choose, edit, add new.

paymentnewcc.jsp

User may supply new credit account info - includes newcctemplate.inc.

paymenteditcc.jsp

User may change the credit account info as selected in payment.jsp - includes editcctemplate.inc.

checkout.jsp

Entire transaction with items, address, shipping choice, account, tax and totals presented for final charge authorization.

confirmorder.jsp

After successful checkout, summary printed to confirm receipt of order.

orderhistory.jsp

User may view a summary of past or pending orders; may select one to view its contents, shipping dates, and other details.

paymenthistory.jsp

User may view a summary of past orders organized by payment.

orderstatus.jsp

Individual orders are displayed with their items, costs, status, shipping address and other details.

systemerror.jsp

Displays an error due to service system failure in the transaction components.

Registration Templates

Table A-6 describes the JSP Templates available for setting up a Registration service.

Table A-6 Register Templates

newuser.jsp | Empty profile fields for all personal information. Also includes a demographic survey to record user profile information. If you are using the full WebLogic Portal license (which includes campaign services) this data can be used by campaigns.

User Templates

Table A-7 describes the JSP templates available for setting up a user.

Table A-7 User Templates

viewprofile.jsp

Presents the known personal information for the logged-in user, with buttons for modifying and adding information.

editdemographics.jsp

Allows registered user to change demographic information that was entered previously.

editprofile.jsp

Change personal info (name, billing address, phones, email).

changepassword.jsp

User may change their password.

profilenewcc.jsp

User may supply new credit account info - includes newcctemplate.inc.

profileeditcc.jsp

User may change the credit account info as selected in payment.jsp - includes editcctemplate.inc.

profilenewaddress.jsp

User may supply an additional new shipping address - includes newaddresstemplate.inc.

profileeditaddress.jsp

User may modify an existing shipping address in profile - includes editaddresstemplate.inc.

newusercreation.jsp

Displayed after the user registers successfully - provides links to view cart, check out, and return home.

secureMain.jsp

A secure page that simply forwards the successfully logged-in user back to main.jsp.

usercreationforward.jsp

Used to redirect the newusercreation.jsp page after creating the user. This is done because the request does not contain the user information unless you do a redirect via the response object to the proper URL. This usercreationforward.jsp creates a new request that has the authenticated user's information, which allows the campaigns to start.