Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Search   |   PDF Files   |   Contact   |   Glossary
WLCS Doc Home   |   JSP Commerce and Campaign Tour   |   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 a 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

  Note: In this chapter, the product name is referred to as WebLogic Commerce Server. If you are licensed for BEA Campaign Manager for WebLogic, this product package includes WebLogic Commerce Server. For a licensing and packaging overview, see the section About the Product Licenses and This Tour.

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 Power Tools.

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

Notice the following features of browse.jsp:

• The file's full pathname is
  WL_COMMERCE_HOME/config/wlcsDomain/applications/wlcsApp/wlcs/ commerce/catalog/browse.jsp (UNIX)

• Pipeline JSP tags query the product catalog for a list of sibling categories. The name of the current category and links to its siblings are displayed above the category name.

• 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.

• 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.

• All the items in the drill category are displayed using category and summary JSPs. 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-7).

Notice the following features of details.jsp:

• The file's full pathname is
  WL_COMMERCE_HOME/config/wlcsDomain/applications/wlcsApp/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-8).

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-9). 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 username 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-10).

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-10).

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

Notice the following features of main.jsp:

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

  Listing 4-2 Conditional Display of Information

  From the header.inc file

  <%-- Get the username --%>

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

  <%-- if the user is not null, get the customer's profile --%>

  <% if(userName != null) { %>

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

  <% } %>

  From the leftside.inc file

  <%-- Get the username. The customer 's profile should have already been loaded --%>
  <%-- obtained from the um:getProfile tag in the header.inc --%>

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

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

  <p><b>Welcome<br>

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

  <p>&nbsp;&nbsp;<a href="<%=

  WebflowJSPHelper.createWebflowURL(pageContext, pageContext.getAttribute("AboutFileName") + ".jsp", "link(viewCustomerProfile)", true) %>">View Profile</a></p>

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

  <div class="mid" align="center">
  <img src="<%=WebflowJSPHelper.createGIFURL(request, response, "/commerce/images/left_rule.gif")%>" width="120" height="14" align="absmiddle"></div>

  <p><b>View History</b></p>

  <p>&nbsp;&nbsp;<a href="<%= WebflowJSPHelper.createWebflowURL(pageContext, "main.jsp", "link(viewOrderHistory)", true)%>">Orders</a></p>

  <p>&nbsp;&nbsp;<a href="<%= WebflowJSPHelper.createWebflowURL(pageContext, "main.jsp", "link(viewPaymentHistory)", true) %>">Payments</a></p>

  <div class="mid" align="center">
  <img src="<%=WebflowJSPHelper.createGIFURL(request, response, "/commerce/images/left_rule.gif")%>" width="120" height="14" align="absmiddle"></div>

  <% } %>

  <%-- End of log-in conditional links. --%>

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-10).

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-12).

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-13).

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-14).

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-15).

Note the following features of selecttaxaddress.jsp:

• The file's full pathname is
  WL_COMMERCE_HOME/config/wlcsDomain/applications/wlcsApp/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-16).

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-17).

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-18).

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.