Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary   |   What's New
WebLogic Commerce Server Doc Home   |   Tour of the JSP Templates   |   Previous Topic   |   Next Topic   |   Contents   |   Index

Because you were impressed by the large selection and low prices (not to mention the ease of use!) when you visited the e-commerce Web site, you decide to return and buy a drill for a friend who is starting her own home-improvement project. Your return trip to the Web site takes you along the following path:

• Registered User Roadmap

  Note: Consider opening the Registered User Roadmap link in a separate browser window; you may want to refer to it frequently during the tour.

• Step 1: Browse the Catalog and Select an Item

• Step 2: Review the Shopping Cart and Check Out

• Detour: Review the Home Page for Authenticated Users

• Step 3: Choose Shipping Options

• Step 4: Enter and Select a New Shipping Address

• Step 5: Select a Credit Card

• Step 6: Purchase the Items

• Step 7: Review Order Confirmation

Before starting this section of the tour, review the following maps of the JSP templates (Figure 4-1, Figure 4-2, and Figure 4-3). The arrows in the maps represent navigation options that Webflow provides; the darker arrows show the path that this section of the tour describes.

Figure 4-2 JSPs for the Shopping Cart and User Login

Figure 4-3 JSPs for Completing the Order

When you arrive at the home page for your return shopping trip, you decide to browse for drills in the catalog.

To continue the tour...

Click D.

When you click D, WebLogic Commerce Server displays the contents of the D category in browse.jsp (see Figure 4-5).

Notice the following features of browse.jsp:

• The file's full pathname is
  $WL_COMMERCE_HOME/server/webapps/wlcs/commerce/catalog/browse.jsp
  (UNIX)

• Pipeline JSP tags in the left column query the product catalog for a list of sibling categories. The left column then displays the name of the current category and links to its siblings.

• A JSP tag in the center column constructs a tree view from the current category to the top level of the catalog:

  <jsp:include page="/commerce/catalog/includes/navigation.jsp" flush="true"/>

• Listing 4-1 shows that browse.jsp includes a JSP file that the Catalog generates to describe the contents of the current category.

  Listing 4-1 Catalog Tags to Display Current Category

  ---

  <%-- Get the summary JSP from the current category --%>

  <catalog:getProperty object="<%= category %>" 
  propertyName="Jsp" 
  id="displayJsp"
  returnType="com.beasys.commerce.ebusiness.catalog.JspInfo"/>

  <%-- Include the category layout JSP for this category--%>
  <jsp:include page="<%= displayJsp.getUrl() %>" flush="true"/>

  ---

To continue the tour...

Click Drills.

When you click Drills, WebLogic Commerce Server displays the contents of the Drills category in browse.jsp (see Figure 4-6).

Notice the following additional features of browse.jsp:

• It is the same source file that Figure 4-5 illustrates, but the content is different because the user's context is different.

• In the left column, the Pipeline JSP tags query the product catalog for the list of sibling categories. Because the page now displays a category different from the category illustrated in Figure 4-5, the list changes.

• In the center column, the JSP tags modify the tree view to reflect the current category.

• In the second row of the center column, the Catalog generates a different JSP file than in Figure 4-5, hence the contents and layout in Figure 4-6 changes.

To continue the tour...

Click Power.

When you click Power, WebLogic Commerce Server displays a selection of power drills in browse.jsp. (see Figure 4-7). Each drill includes a link to detailed product information.

To continue the tour...

Click the name of a drill.

When you click the name of a drill, WebLogic Commerce Server displays a product description in details.jsp (see Figure 4-8).

Notice the following features of details.jsp:

• The file's full pathname is
  $WL_COMMERCE_HOME/server/webapps/wlcs/commerce/catalog/details.jsp (UNIX)

• It can be accessed from either browse.jsp or searchresults.jsp (see Figure 4-1).

• It includes a JSP file (navigation2.jsp) that constructs a tree view only if users access the page from browse.jsp. If the Pipeline mechanism determines that a user accessed the page from searchresults.jsp, the JSP file does not construct the tree view.

• It includes a summary JSP file for the item being displayed. The product catalog generates this summary JSP file based on the information it stores about the item.

To continue the tour...

Click Add to Cart.

When you click Add to Cart, WebLogic Commerce Server displays your selections in shoppingcart.jsp (see Figure 4-9).

For a description of shoppingcart.jsp, see Features of shoppingcart.jsp.

Click Check Out.

When you click Check Out, WebLogic Commerce Server prompts you to log in (see Figure 4-10). Because you created a user profile in New User Buys a Product, you are now a registered user.

For a description of login.jsp, see Features of login.jsp.

How does WebLogic Commerce Server determine if users must log in when they click a link? Instead of using Webflow to implement security, WebLogic Commerce Server follows the J2EE specification for security. With this specification, the site administrator determines which set of files can be accessed only by authenticated users. By default, all JSP templates below the order and user directories can be accessed only by authenticated users.

When an anonymous user tries to access one of these files, WebLogic Commerce Server displays login.jsp, from which the user can either log in or create a new user account. After authentication, Webflow determines the remaining succession of pages.

Enter the user name and password you set up in Step 4: Create a New User Profile. Then click Log In.

When you click Log In, WebLogic Commerce Server displays shipping options in shipping.jsp (see Figure 4-11).

For a description of shipping.jsp, see Features of shipping.jsp.

Before continuing the tour, take a minute to review the home page. Now that you have logged in (authenticated), the home page shows options that are available only to authenticated users.

To take the detour, click Home (see Figure 4-11).

When you click Home, WebLogic Commerce Server displays main.jsp (see Figure 4-12).

Notice the following features of main.jsp:

• Now that you are authenticated, main.jsp displays your user name along with links to your order and payment history. Listing 4-2 shows that a Pipeline tag and a Java scriptlet determines whether a user name is associated with the current Pipeline session. If a name is associated with the Pipeline session, User Management JSP tags query the database for your user name and display the results.

  Listing 4-2 Conditional Display of Information

  ---

  <%-- Get the username --%>

  <pipeline:getPipelineProperty propertyName="<%= PipelineSessionConstants.USER_NAME %>"
  	returnName="userName"
  	returnType="String"
  />

  <% if (userName != null && userName.length() != 0) { %>

  <!-- Tag to get customer profile --> 

  <um:getProfile profileKey="<%=request.getRemoteUser()%>  "profileType="WLCS_Customer" />

  <p><font color="#567856"><b>Welcome<br>

  <um:getPropertyAsString propertyName="firstName" /> <um:getPropertyAsString propertyName="lastName" />:</b></font></p>

  <p>This is BEA WebLogic Commerce Server</p>

  <p class="commentary"><a href="<%= WebflowJSPHelper.createWebflowURL(pageContext, "main.jsp", "link(logout)", true) %>">Logout</a></p>

  ---

To continue the tour...

1. Click View Cart.

2. In the shopping cart, click Check Out.

When you click Check Out from shoppingcart.jsp, WebLogic Commerce Server displays shipping options in shipping.jsp (see Figure 4-11).

For a description of shipping.jsp, see Features of shipping.jsp.

From shipping.jsp, click Continue.

When you click Continue in shipping.jsp, WebLogic Commerce Server displays shipping addresses in selectaddress.jsp (see Figure 4-13).

To ship the item to someone other than yourself, you must enter a new address.

For a description of selectaddress.jsp, see Features of selectaddress.jsp.

Click Add Address.

When you click Add Address, WebLogic Commerce Server prompts you to enter a new shipping address in addaddress.jsp (see Figure 4-14).

To continue the tour...

Enter an address that contains the following information:

• City: Denver

• Zip Code: 80212

• Country: United States

Then click Save.

This particular zip code spans multiple tax jurisdictions. Later in this step of the tour, you must select which tax jurisdiction applies.

When you click Save, WebLogic Commerce Server displays the addresses from your user profile in selectaddress.jsp (see Figure 4-15).

For a description of selectaddress.jsp, see Features of selectaddress.jsp.

Click Use next to the Denver, CO address that you created.

When you click Use, the Pipeline sends data to the Taxation Service, which uses TAXWARE to determine the tax jurisdiction and amount, based on the shipping address. Because the zip code 80212 covers different tax jurisdictions, WebLogic Commerce Server prompts you to choose a specific area within the zip code from selecttaxcaddress.jsp (see Figure 4-16).

Note the following features of selecttaxaddress.jsp:

• The file's full pathname is
  $WL_COMMERCE_HOME/server/webapps/wlcs/commerce/order/selecttaxaddress.jsp (UNIX)

• It uses a Pipeline JSP tag to collect the tax jurisdiction data from the Pipeline session (which contains information from TAXWARE data files).

• It uses Java scriptlets and HTML to display and format the data.

• Clicking Use sends data to the WebLogic Commerce Server Taxation Service for tax calculation.

To continue the tour...

Click Use next to an address.

When you click Use, WebLogic Commerce Server displays payment.jsp, which lists the credit cards in your user profile (see Figure 4-17).

For a description of payment.jsp, see Features of payment.jsp.

Click Use.

When you click Use in payment.jsp, WebLogic Commerce Server displays the final purchase information in checkout.jsp (see Figure 4-18).

For a description of checkout.jsp, see Features of checkout.jsp.

Click Complete Purchase.

When you click Complete Purchase, WebLogic Commerce Server completes the purchase and displays the confirmation number in confirmorder.jsp (see Figure 4-19).

For a description of confirmorder.jsp, see Features of confirmorder.jsp.

This concludes the tour for a registered user buying a product.

To continue the tour of the JSP templates, click View Profile in the header and go to the next section, Registered User Adds a Credit Card.