BEA WebLogic Portal. JSP Commerce and Campaign Tour

Transcription

1 BEA WebLogic Portal JSP Commerce ad Campaig Tour Versio 4.0 Documet Date: October 2001

2 Copyright Copyright 2001 BEA Systems, Ic. All Rights Reserved. Restricted Rights Leged This software ad documetatio is subject to ad made available oly pursuat to the terms of the BEA Systems Licese Agreemet ad may be used or copied oly i accordace with the terms of that agreemet. It is agaist the law to copy the software except as specifically allowed i the agreemet. This documet may ot, i whole or i part, be copied, photocopied, reproduced, traslated, or reduced to ay electroic medium or machie readable form without prior coset, i writig, from BEA Systems, Ic. Use, duplicatio or disclosure by the U.S. Govermet is subject to restrictios set forth i the BEA Systems Licese Agreemet ad i subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR ; subparagraph (c)(1)(ii) of the Rights i Techical Data ad Computer Software clause at DFARS , subparagraph (d) of the Commercial Computer Software--Licesig clause at NASA FAR supplemet ; or their equivalet. Iformatio i this documet is subject to chage without otice ad does ot represet a commitmet o the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, WebLogic, Tuxedo, ad Jolt are registered trademarks of BEA Systems, Ic. How Busiess Becomes E-Busiess, BEA WebLogic E-Busiess Platform, BEA Builder, BEA Campaig Maager for WebLogic, BEA E-Busiess Cotrol Ceter, BEA Maager, BEA elik, BEA WebLogic Commerce Server, BEA WebLogic Persoalizatio Server, BEA WebLogic Process Itegrator, BEA WebLogic Portal, BEA WebLogic Collaborate, BEA WebLogic Eterprise, ad BEA WebLogic Server are trademarks of BEA Systems, Ic. All other product ames may be trademarks of the respective compaies with which they are associated. Tour of the WebLogic Commerce Server JSP Templates Documet Editio Date Software Versios 4.0 October 2001 BEA WebLogic Portal 4.0

3 Cotets About This Documet What You Need to Kow... viii e-docs Web Site... viii How to Prit the Documet... viii Related Iformatio... ix Cotact Us!... ix Documetatio Covetios...x 1. What Is the JSP Commerce ad Campaig Tour? About the Product Liceses ad This Tour About JSP About the Database Schemas About the Sample Database About Tax Calculatio About Paymet Processig Startig the Tour Prerequisite for Netscape 4.7x Users Access the Home Page from UNIX Access the Home Page from Widows Overview of the Home Page Features of mai.jsp for Aoymous Users (Part 1 of 2) Techical Note: Importig Tag Libraries ad Java Packages More Features of mai.jsp for Aoymous Users (Part 2 of 2) Techical Note: The Product Catalog JSP Commerce ad Campaig Tour iii

4 3. New User Buys a Product New User Roadmap Step 1: Search for Products Step 2: Select a Item Features of searchresults.jsp Step 3: View the Shoppig Cart Features of shoppigcart.jsp Techical Note: Pipelie Compoets, Pipelie Sessios, ad Webflow 3-8 Step 4: Create a New User Profile Features of logi.jsp Features of ewuser.jsp (Part 1 of 3) Techical Note: Iput Processors Demographics i ewuser.jsp (Part 2 of 3) More Features of ewuser.jsp (Part 3 of 3) Step 5: Log I as a Registered User Features of logi.jsp Step 6: Choose Shippig Optios Features of shippig.jsp Features of selectaddress.jsp Step 7: Eter Paymet Iformatio Features of paymet.jsp Features of paymetewcc.jsp Techical Note: Templates Icluded Withi Templates Step 8: Select a Credit Card More Features of paymet.jsp Step 9: Purchase the Item Features of checkout.jsp Step 10: Review the Order Cofirmatio Features of cofirmorder.jsp Registered User Buys a Product Registered User Roadmap Step 1: Browse the Catalog ad Select a Item Features of browse.jsp (Part 1 of 2) iv JSP Commerce ad Campaig Tour

5 More Features of browse.jsp (Part 2 of 2) Features of details.jsp Step 2: Review the Shoppig Cart ad Check Out Techical Note: The Security Model Detour: Review the Home Page for Autheticated Users Features of mai.jsp for Autheticated Users Step 3: Choose Shippig Optios Step 4: Eter ad Select a New Shippig Address Features of selecttaxaddress.jsp Step 5: Select a Credit Card Step 6: Purchase the Items Step 7: Review Order Cofirmatio Registered User Adds a Credit Card User Profile Roadmap Step 1: Access Your User Profile Step 2: Review Your User Profile Features of viewprofile.jsp Techical Note: The Database for Commerce Services Step 3: Add a Credit Card Features of profileewcc.jsp Step 4: View Your Order History ad Status Features of orderhistory.jsp Features of orderstatus.jsp Step 5: Log Out Example of Customizig the Templates Step 1: Uderstad the Add to Cart Lik How the Lik Achor Ivokes Webflow How Webflow Resolves the Lik Step 2: Modify Add to Cart Directig the Output of the gettopcategoriesip Iput Processor Step 3: Verify the Modificatio What s Next? JSP Commerce ad Campaig Tour v

6 7. A Sample Campaig Idex Itroductio ad Prerequisites Step 1: Startig the E-Busiess Cotrol Ceter Step 2: Coectig from the Cliet Tool to a Ruig Server Step 3: Examiig TourCampaig1: Simple Baer Ad What s Next? vi JSP Commerce ad Campaig Tour

7 About This Documet BEA WebLogic Portal icludes a campaig service, a graphical cliet tool called the BEA E-Busiess Cotrol Ceter, plus commerce services ad BEA WebLogic Persoalizatio Server. Amog the campaig ad commerce features is a extesive set of templates that you ca use to quickly set up your e-commerce Web site. This documet ad a sample database that is istalled with the product provide a tour through the templates to demostrate their scope ad desig. The templates cosist of JavaServer Page (JSP) files ad image files, ad rely o WebLogic Portal to reder them viewable i a Web browser. This documet cotais two parts ad icludes the followig topics: Chapter 1, What Is the JSP Commerce ad Campaig Tour?, which itroduces the goals of the tour ad describes some basic JSP ad product cocepts. Chapter 2, Startig the Tour, which describes the JSP templates Home page. Chapter 3, New User Buys a Product, which presets a sceario ad illustrates how the JSP templates guide ew users through the site. Chapter 4, Registered User Buys a Product, which presets a sceario ad illustrates how the JSP templates chage for a user who has created a user profile (registered) with the site. Chapter 5, Registered User Adds a Credit Card, which illustrates the JSPs for maagig a user profile. Chapter 6, Example of Customizig the Templates, which provides a example of modifyig the JSP templates. Chapter 7, A Sample Campaig, summarizes how the campaig features that are defied i the E-Busiess Cotrol Ceter cliet tool determie what users see o the redered JSPs. JSP Commerce ad Campaig Tour vii

8 What You Need to Kow This documet is iteded for product evaluators, project maagers, applicatio developers, Web site developers, busiess aalysts, ad marketig professioals who are researchig or settig up a e-commerce Web site with Campaig services ad Commerce services. It assumes a basic familiarity with BEA WebLogic Server, which serves as the E-Busiess platform for Campaig services, Commerce services, ad WebLogic Persoalizatio Server. e-docs Web Site BEA product documetatio is available o the BEA corporate Web site. From the BEA Home page, click o Product Documetatio or go directly to the e-docs Product Documetatio page at How to Prit the Documet You ca prit a copy of this documet from a Web browser, oe file at a time, by usig the File >Prit optio o your Web browser. A PDF versio of this documet is available o the WebLogic Portal documetatio Home page o the e-docs Web site. A PDF versio of this documet is also available i the documetatio kit o the product CD. Or you ca dowload the documetatio kit from the WebLogic Portal portio of the BEA Dowload site. You ca ope the PDF i Adobe Acrobat Reader ad prit the etire documet (or a portio of it) i book format. To access the PDFs, ope the WebLogic Portal documetatio Home page, click the PDF files butto ad select the documet you wat to prit. If you do ot have the Adobe Acrobat Reader, you ca get it for free from the Adobe Web site at viii JSP Commerce ad Campaig Tour

9 Related Iformatio The followig product documets cotai additioal iformatio that is relevat to JavaServer Pages (JSP). Guide to Maagig Purchases ad Processig Orders Guide to Registerig Customers ad Maagig Customer Services Guide to Buildig a Product Catalog Guide to Developig Campaig Ifrastructure Guide to Evets ad Behavior Trackig For more iformatio i geeral about JSPs, refer to the followig source: The Su Microsystems, Ic. JSP site at Cotact Us! Your feedback o the Commerce services documetatio is importat to us. Sed us at docsupport@bea.com if you have questios or commets. Your commets will be reviewed directly by the BEA professioals who create ad update the Commerce services documetatio. I your message, please idicate that you are usig the documetatio for the WebLogic Portal 4.0 release. If you have ay questios about this versio of WebLogic Portal, or if you have problems istallig ad ruig WebLogic Portal, cotact BEA Customer Support through BEA WebSUPPORT at You ca also cotact Customer Support by usig the cotact iformatio provided o the Customer Support Card, which is icluded i the product package. Whe cotactig Customer Support, be prepared to provide the followig iformatio: JSP Commerce ad Campaig Tour ix

10 Your ame, address, phoe umber, ad fax umber Your compay ame ad compay address Your machie type ad authorizatio codes The ame ad versio of the product you are usig A descriptio of the problem ad the cotet of pertiet error messages Documetatio Covetios The followig documetatio covetios are used throughout this documet. Covetio boldface text Ctrl+Tab italics moospace text moospace boldface text Item Idicates terms defied i the glossary. Idicates that you must press two or more keys simultaeously. Idicates emphasis or book titles. Idicates code samples, commads ad their optios, data structures ad their members, data types, directories, ad fileames ad their extesios. Moospace text also idicates text that you must eter from the keyboard. Examples: #iclude <iostream.h> void mai ( ) the poiter psz chmod u+w * \tux\data\ap.doc tux.doc BITMAP float Idetifies sigificat words i code. Example: void commit ( ) x JSP Commerce ad Campaig Tour

11 Covetio moospace italic text UPPERCASE TEXT Item Idetifies variables i code. Example: Strig expr Idicates device ames, eviromet variables, ad logical operators. Examples: LPT1 SIGNON OR { } Idicates a set of choices i a sytax lie. The braces themselves should ever be typed. [ ] Idicates optioal items i a sytax lie. The brackets themselves should ever be typed. Example: buildobjcliet [-v] [-o ame ] [-f file-list]... [-l file-list]... Separates mutually exclusive choices i a sytax lie. The symbol itself should ever be typed.... Idicates oe of the followig i a commad lie: That a argumet ca be repeated several times i a commad lie That the statemet omits additioal optioal argumets That you ca eter additioal parameters, values, or other iformatio The ellipsis itself should ever be typed. Example: buildobjcliet [-v] [-o ame ] [-f file-list]... [-l file-list] Idicates the omissio of items from a code example or from a sytax lie. The vertical ellipsis itself should ever be typed. JSP Commerce ad Campaig Tour xi

12 xii JSP Commerce ad Campaig Tour

13 CHAPTER 1 What Is the JSP Commerce ad Campaig Tour? BEA WebLogic Portal icludes a set of commerce templates that you ca use to set up your e-commerce Web site quickly. This tour leads you through may of the templates to demostrate their scope ad desig. The tour makes use of sample data that simulates a e-commerce Web site. A easy way to get started is to follow alog with this tour documet, workig through the suggested steps to get familiar with the templates. The templates cosist of JavaServer Pages (JSP) ad image files. You ca modify the template layout ad the order i which the product presets pages without requirig Java programmig skills. Other lower-level modificatios, such as chagig the default busiess logic, require Java programmig skills. If you are ot familiar with JSP or the basic product cocepts, we recommed that you read the remaiig topics i this sectio: About the Product Liceses ad This Tour About JSP About the Database Schemas JSP Commerce ad Campaig Tour 1-1

14 1 What Is the JSP Commerce ad Campaig Tour? About the Product Liceses ad This Tour Three types of product liceses are available that affect which features of the Campaig services, Commerce services, ad WebLogic Persoalizatio Server software you ca use: The Campaig services licese is a full licese that icludes all features. That is, all the services related to the developmet of Web-based campaigs, plus all the Commerce services ad WebLogic Persoalizatio Server features. The Commerce services licese, which also icludes the WebLogic Persoalizatio Server features. The WebLogic Persoalizatio Server oly licese. Durig the product software istallatio, all compoets are istalled. However, your licese file is checked at ru-time to determie which features you ca use. This tour documetatio shows a sample Web applicatio that was executig while usig the full Campaig services licese. Importat: If you are licesed for Commerce services oly, you will see almost all of the features show i chapters 2 through 6 of this tour. The exceptio is that you will ot see the campaig-related features, such as the Experiece a Campaig! top ad baer ad the "Register Now ad save $10..." side baer. These ads are associated with sample campaigs. I chapters 2 through 6 of this documet, the focus of the descriptios is o the commerce features. The campaig features, how they were defied i the E-Busiess Cotrol Ceter cliet tool, ad what was added i the JSP templates, are described i Chapter 7, A Sample Campaig. The sample Web applicatio show i this tour caot be ru if you have the WebLogic Persoalizatio Server oly licese. There is a separate tour documet for WebLogic Persoalizatio Server users; see the "Persoalizatio Server Tour." For iformatio about how the licese file is cofigured o your system, see the Post-Istallatio Cosideratios chapter of the Istallatio Guide. 1-2 JSP Commerce ad Campaig Tour

15 About JSP About JSP JavaServer Pages (JSP) are text files that cotai well-formed HTML ad special tags (JSP tags) that, whe served by a Java-eabled Web server, exted the capabilities of HTML. With Campaig services ad Commerce services, you use JSP tags to provide dyamic cotet i specific areas of a Web page ad to create a iterface for exchagig data with your customers. For a descriptio of JSPs ad the JSP tags that the product provides, refer to the followig documets: Guide to Buildig a Product Catalog Guide to Registerig Customers ad Maagig Customer Services Guide to Maagig Purchases ad Processig Orders For more iformatio about JSPs, refer to ad About the Database Schemas Commerce services iclude schemas for both Cloudscape ad Oracle databases. The schemas support all trasactios that are available from the Commerce services JSP templates. For more iformatio, refer to the followig topics: Product Catalog Database Schema i the Guide to Buildig a Product Catalog Order Processig Database Schema i the Guide to Maagig Purchases ad Processig Orders Overview of the Registratio ad User Processig Package i the Guide to Registerig Customers ad Maagig Customer Services JSP Commerce ad Campaig Tour 1-3

16 1 What Is the JSP Commerce ad Campaig Tour? Note: Whe you istall WebLogic Server, it sets up a evaluatio copy of the Cloudscape DBMS. If you wat to use a Cloudscape database for your productio Web site, you must purchase your ow copy of the Cloudscape DBMS. If you wat to use a Oracle database, you must purchase ad istall a Oracle platform that WebLogic Portal supports. For more iformatio, see the Istallatio Guide ad the Deploymet Guide. About the Sample Database By default, WebLogic Portal is cofigured to use the Cloudscape DBMS. Whe you istall WebLogic Portal, it creates ad populates a sample Cloudscape database. The sample data simulates a e-commerce Web site that sells tools ad miscellaeous hardware. If you wat to cofigure WebLogic Portal to use a Oracle platform ad create ad populate a sample Oracle database, see the istructios i the Deploymet Guide. About Tax Calculatio To calculate the amout of sales tax due, WebLogic Portal provides a API that lets you itegrate with a tax service vedor. If you wat to use the tax API for your productio Web site, you must also set up your ow accout with a tax service vedor. With the accout you ca dowload updated data files, which cotai iformatio about tax requiremets for all tax jurisdictios i the Uited States ad selected other coutries. For more iformatio, see Taxatio Services i Guide to Maagig Purchases ad Processig Orders. 1-4 JSP Commerce ad Campaig Tour

17 About Paymet Processig About Paymet Processig To verify ad post credit card trasactios, WebLogic Portal provides a paymet API that lets you itegrate with a paymet vedor. If you wat to use the paymet API for your productio Web site, you must also set up your ow accout with a paymet vedor. By default, the itegratio with a paymet vedor is disabled. You ca complete purchases with the itegratio disabled, but WebLogic Portal does ot sed data to a paymet vedor. For more iformatio about the paymet API, see "Paymet Services" i Guide to Maagig Purchases ad Processig Orders. JSP Commerce ad Campaig Tour 1-5

18 1 What Is the JSP Commerce ad Campaig Tour? 1-6 JSP Commerce ad Campaig Tour

19 CHAPTER 2 Startig the Tour Before you ca start the tour, you or your system admiistrator must istall WebLogic Portal. For istallatio iformatio, see the Istallatio Guide. To see the templates ad sample data from a Web browser, do oe of the followig tasks depedig o the type of operatig system you use: Prerequisite for Netscape 4.7x Users Access the Home Page from UNIX Access the Home Page from Widows The go to the last topic i this sectio: Overview of the Home Page Note: I this chapter, the product ame is referred to as WebLogic Portal. If you are licesed for BEA Campaig services, this product package icludes Commerce services. For a licesig ad packagig overview, see the sectio About the Product Liceses ad This Tour o page 1-2. Prerequisite for Netscape 4.7x Users The miimum required Netscape browser versio is If you are goig to ru the tour i the Netscape 4.7x browser, read this sectio. There are a few prerequisite steps. These steps do ot apply if you are usig the Microsoft Iteret Explorer browser. This sectio also does ot apply if you are usig Netscape 6.0 ad later versios. JSP Commerce ad Campaig Tour 2-1

20 2 Startig the Tour The sample JSP templates do ot work with cookies eabled for Netscape i the default cofiguratio for the product. Before startig the tour, you must set the CookieDomai value i the Web applicatio s weblogic.xml file ad ucommet it. The applicatio s weblogic.xml file icludes the followig: <!-- <sessio-param> <param-ame>cookiedomai</param-ame> <param-value>.mycompay.com</param-value> </sessio-param> --> Before usig the Web applicatio i Netscape, remove the begi ad ed commet characters ad chage the CookieDomai parameter value i weblogic.xml from.mycompay.com to the domai ame i which the applicatio will be ru. The weblogic.xml file resides i the followig directory: PORTAL_HOME/applicatios/wlcsApp/wlcs/WEB-INF/ (UNIX) PORTAL_HOME\applicatios\wlcsApp\wlcs\WEB-INF\ (Widows) Importat: After you make the chage, you must restart the server if it is already ruig. For more iformatio about startig the server ad the opeig the iitial page of the sample applicatio, see the ext sectio. Notes: Aother optio, of course, is disablig cookies i Netscape 4.77 or later i order to ru the tour. However this approach is ot practical i a live Web productio eviromet because you caot predict which browser the Web site s customers will use, or whether they will have cookies eabled or disabled. Therefore i productio you must make the CookieDomai chage i your Web applicatio s weblogic.xml file. I this chapter ad i all of the product documetatio, the variable BEA_HOME is used to represet the paret directory ito which you istall BEA products. The variable PORTAL_HOME is used to represet the top-level of the product istallatio directory. By default, the PORTAL_HOME locatio is <BEA_HOME>\wlportal4.0 o Widows, ad bea/wlportal4.0 o UNIX. Hereafter, the tour uses UNIX sytax for pathames. If you use WebLogic Portal from a Widows machie, substitute the sytax that Widows requires for pathames (forward slashes separatig pathame elemets ad percet sigs before ad after variable ames). 2-2 JSP Commerce ad Campaig Tour

21 Access the Home Page from UNIX Access the Home Page from UNIX To access the Home page from UNIX, do the followig: 1. If WebLogic Portal is ot already ruig, eter the followig commad from a WebLogic Portal host: PORTAL_HOME/StartPortal.sh 2. From your workstatio, ope a Web browser ad eter the followig URL: For example, if the WebLogic Portal host is a workstatio amed spectacle, eter the followig URL i your Web browser: Note: By default, the WebLogic Portal host ame is sufficiet for the WLCS-host:7501 parameter of the URL. However, if your system admiistrator chages the cofig.xml file to require fully qualified domai ames, you must supply oe. I this case, the URL i step 2 would chage to For example, if the WebLogic Portal host is a workstatio amed spectacle ad the domai ame is sprockets.com, eter the followig URL i your Web browser: Access the Home Page from Widows To access the Home page from Widows, do the followig: 1. If WebLogic Portal is ot already ruig, o a WebLogic Portal host do oe of the followig: l l l Click Start Programs BEA WebLogic E-Busiess Platform BEA WebLogic Portal 4.0 Start BEA WebLogic Portal. Click the desktop ico titled Start BEA WebLogic Portal. From a commad prompt, eter the followig commad: PORTAL_HOME\StartPortal.bat JSP Commerce ad Campaig Tour 2-3

22 2 Startig the Tour 2. From your computer, ope a Web browser ad eter the followig URL: For example, if the WebLogic Portal host is a workstatio amed spectacle, eter the followig URL i your Web browser: Note: By default, the WebLogic Portal host ame is sufficiet for the WLCS-host:7501 parameter of the URL. However, if your system admiistrator chages the system cofiguratio to require fully qualified domai ames, you must supply oe. I this case, the URL i step 2 would chage to For example, if the WebLogic Portal host is a workstatio amed spectacle ad the domai ame is sprockets.com, eter the followig URL i your Web browser: Overview of the Home Page Whe you access your browser displays mai.jsp, which is the Web site s Home page. Figure 2-1 illustrates the iformatio ad avigatio optios that are available to aoymous users. Chapter 4, Registered User Buys a Product, illustrates how mai.jsp chages for autheticated users. 2-4 JSP Commerce ad Campaig Tour

23 Overview of the Home Page Features of mai.jsp for Aoymous Users (Part 1 of 2) Figure 2-1 Home Page for Aoymous Users Notice the followig features of mai.jsp: The file s full pathae is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/mai.jsp The top baer, the avigatio header, ad the footer are defied i separate JSP iclude files. JSP tags specify that WebLogic Portal icludes these files whe your browser requests mai.jsp. JSP Commerce ad Campaig Tour 2-5

24 2 Startig the Tour I the admi.ic iclude file that appears at the top of mai.jsp: l l l l It displays the JSP fileame i the upper baer. This display comes from a icluded file, admi.ic. All templates show the JSP fileame i this locatio. It icludes olie help, which describes the purpose of the template, avigatio optios that are available i differet user cotexts, ad otes o customizig the template. Admiistratio liks to tools for settig up ad maitaiig WebLogic Portal ad WebLogic Persoalizatio Server features. This tour does ot describe the admiistratio tools; to access them, you eed the WebLogic Portal admiistrator userame ad password. For more iformatio, see Admiistratio Tasks i the Guide to Buildig a Product Catalog, ad the Guide to Maagig Purchases ad Processig Orders, ad the Guide to Buildig Persoalized Applicatios. Template Idex. Liks to templateidex.html, which briefly describes all JSP templates icluded i WebLogic Portal. The icluded header.ic files cotais a ad placeholder. I the mai.jsp file before it is redered by the browser, a JSP tag is used to reserve a place for the baer ad. For example: <td colspa="7" height="75" alig="ceter" valig="middle"> <ph:placeholder ame="<%= baer %>" /> </td> If you are licesed for BEA Campaig services, the ad placeholder ivites you to take a tour usig two sample user accouts. If you are ot licesed for Campaig services, a default ad is displayed. Iformatio about the campaig features is described i Chapter 7, A Sample Campaig. Header.ic also icludes buttos for avigatig to differet areas of the site: l l l Search liks to search.jsp, which supports searchig with Boolea expressios. View Cart liks to shoppigcart.jsp, which keeps a list of items purchased durig the curret sessio. Log i liks to logi.jsp, which allows either a existig user to log i, or gives the ew user a chace to register with the site. 2-6 JSP Commerce ad Campaig Tour

25 Overview of the Home Page Techical Note: Importig Tag Libraries ad Java Packages Each JSP template that uses JSP tags begis with a set of lies that import tag libraries. Listig 2-1 shows mai.jsp importig Pipelie, Catalog (cat), ad User Maagemet (um) tag libraries. Listig 2-1 Importig Tag Libraries <%@ taglib uri="webflow.tld" prefix="webflow" %> <%@ taglib uri="cat.tld" prefix="catalog" %> <%@ taglib uri="um.tld" prefix="um" %> <%@ taglib uri="pz.tld" prefix="pz" %> <%@ taglib uri="es.tld" prefix="es" %> <%@ taglib uri="cm.tld" prefix="cm" %> For a descriptio of JSP tags ad tag libraries that the JSP templates use, refer to the followig sectios: Webflow ad Pipelie JSP Tags i Webflow ad Pipelie Maagemet The Product Catalog JSP Templates i Guide to Buildig a Product Catalog JSP Tag Referece i the Guide to Buildig Persoalized Applicatios (for the User Maagemet tag library) Likewise, templates that use Java classes must import Java packages. Listig 2-2 shows mai.jsp importig Java packages. Listig 2-2 Importig Java Packages <%@ page import="com.beasys.commerce.webflow.httprequestcostats" %> <%@ page import="com.beasys.commerce.webflow.pipeliesessiocostats" %> <%@ page import="com.beasys.commerce.ebusiess.catalog.category" %> <%@ page import="com.beasys.commerce.ebusiess.catalog.viewiterator" %> <%--@ page import="com.beasys.commerce.axiom.cotact.*" --%> <%--@ page import="com.beasys.commerce.ebusiess.customer.*" --%> <%@ page import="com.bea.p13.cotet.cotethelper"%> <%--@ page import="java.util.collectio" --%> <%--@ page import="java.util.iterator" --%> JSP Commerce ad Campaig Tour 2-7

26 2 Startig the Tour More Features of mai.jsp for Aoymous Users (Part 2 of 2) Figure 2-2 Top Level of the Product Catalog mai.jsp is also the top level of the product catalog. Notice the followig features of the catalog s top level: JSP tags create a search mechaism i the left colum. The iformatio i the Store Catalog sectio is dyamically geerated, based o the iformatio i the product catalog ad the user s curret locatio i the catalog hierarchy. 2-8 JSP Commerce ad Campaig Tour

27 Overview of the Home Page Techical Note: The Product Catalog WebLogic Portal provides a database schema ad set of build scripts for implemetig a product catalog. The schema ad scripts defie commoly used features ad attributes foud o Web-based catalog sites. For example, the schema specifies metadata that you use to establish a hierarchy of product categories ad items. You ca use this hierarchy to display product data based o a user s curret locatio i the catalog. Figure 2-2 shows the cotet that WebLogic Portal geerates for the top level of the hierarchy. Listig 2-3 shows the JSP tags i mai.jsp that query the product catalog for categories ad display the query results. The listig also shows other HTML elemets for formattig ad displayig cotet. (If you are ot familiar with JSP sytax, look oly at the commet tags, which are surrouded by <%-- ad --%>.) Listig 2-3 JSP Tags that Query the Product Catalog <webflow:getproperty id="topcategory" property="<%=pipeliesessiocostats.catalog_category%>" type="com.beasys.commerce.ebusiess.catalog.category" scope="request" amespace="sampleapp_mai" /> <webflow:getproperty id="subcategories" property="<%=pipeliesessiocostats.catalog_categories%>" type="com.beasys.commerce.ebusiess.catalog.viewiterator" scope="request" amespace="sampleapp_mai" /> <p class="head1">store Catalog</p> <ul type="square"> <%-- Declare a Strig cotaiig commo browse parameters --%> <%! static fial Strig commoparameters = HttpRequestCostats.CATALOG_SOURCE_KEY + "=" + PipelieSessioCostats.CATALOG_CATEGORIES + "&" + HttpRequestCostats.CATALOG_DESTINATION_KEY + "=wlcs_sibligs&"; %> <catalog:iterateviewiterator iterator="<%= subcategories %>" id="curretcategory" returtype="com.beasys.commerce.ebusiess.catalog.category"> <% Strig browseparameters = commoparameters + HttpRequestCostats.CATALOG_CATEGORY_ID + "=" + java.et.urlecoder.ecode(curretcategory.getkey().getidetifier()); %> <li> <a href="<webflow:createwebflowurl evet="lik.browse" amespace="sampleapp_mai" extraparams="<%=browseparameters%>"/>"> <b><catalog:getproperty object="<%= curretcategory %>" propertyname="name"/></b> JSP Commerce ad Campaig Tour 2-9

28 2 Startig the Tour </a> <br> </catalog:iterateviewiterator> To cotiue the tour... WebLogic Portal also icludes a utility for importig data from a existig product catalog database, or you ca use other utilities to import data. If you already use a catalog system that you prefer to the WebLogic Portal database, you ca modify the JSP templates to use your existig catalog system. (However, this low-level modificatio requires Java programmig skills.) For more iformatio about usig existig data with WebLogic Portal, see Usig the Product Catalog Database Loader i the Guide to Buildig a Product Catalog. Leave mai.jsp ope i your browser ad go to Chapter 3, New User Buys a Product. This sectio shows the JSP templates that ew users are likely to ecouter. Other sectios of the tour, Chapter 4, Registered User Buys a Product, ad Chapter 5, Registered User Adds a Credit Card, show additioal scearios for usig the Commerce services JSP templates JSP Commerce ad Campaig Tour

29 CHAPTER 3 New User Buys a Product I this sectio of the tour, assume that you wat to buy a hammer for a home improvemet project. You have heard of a ew e-commerce Web site with a huge selectio ad low prices, so you decide to visit it. Your trek through the site takes you alog the followig path: New User Roadmap Step 1: Search for Products Step 2: Select a Item Step 3: View the Shoppig Cart Step 4: Create a New User Profile Step 5: Log I as a Registered User Step 6: Choose Shippig Optios Step 7: Eter Paymet Iformatio Step 8: Select a Credit Card Step 9: Purchase the Item Step 10: Review the Order Cofirmatio Note: I this chapter, the product ame is referred to as WebLogic Portal. If you are licesed for BEA Campaig services, this product package icludes Commerce services. For a licesig ad packagig overview, see the sectio About the Product Liceses ad This Tour o page 1-2. JSP Commerce ad Campaig Tour 3-1

30 3 New User Buys a Product New User Roadmap Before startig this sectio of the tour, review the followig maps of the JSP templates (Figure 3-1, Figure 3-2, ad Figure 3-3). The arrows i the maps represet avigatio optios o the site; the darker arrows show the path that this sectio of the tour describes. Figure 3-1 JSPs for Fidig ad Selectig a Item 3-2 JSP Commerce ad Campaig Tour

31 New User Roadmap Figure 3-2 JSPs for the Shoppig Cart ad New User Registratio JSP Commerce ad Campaig Tour 3-3

32 3 New User Buys a Product Figure 3-3 JSPs for Completig the Order 3-4 JSP Commerce ad Campaig Tour

33 Step 1: Search for Products Step 1: Search for Products Whe you first access the site s Home page, you otice that you could either browse or search through the product catalog. Because you are lookig specifically for a hammer, ad because you are ufamiliar with the scope of this ew Web site, you decide to use the Quick Look-up box (see Figure 3-4). Figure 3-4 Searchig i mai.jsp To cotiue the tour... O the Home page, eter hammer i the Quick Look-up box. The click Fid. Step 2: Select a Item Whe you click Fid, the WebLogic Portal search egie queries the product catalog for items with keywords that match hammer ad displays the results i searchresults.jsp (see Figure 3-5). JSP Commerce ad Campaig Tour 3-5

34 3 New User Buys a Product Features of searchresults.jsp Figure 3-5 Search Results i searchresults.jsp Notice the followig features of searchresults.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/catalog/searchre sults.jsp (UNIX) All of the cotet is dyamically geerated. The item s descriptio, price, availability, ad URL to its related image come from the item record i the product catalog. To cotiue the tour... Choose a hammer ad click Add to Cart. 3-6 JSP Commerce ad Campaig Tour

35 Step 3: View the Shoppig Cart Step 3: View the Shoppig Cart Whe you click Add to Cart, WebLogic Portal lists all items you have selected durig the curret visit to the site i shoppigcart.jsp (see Figure 3-6). Features of shoppigcart.jsp Figure 3-6 Shoppig Cart Notice the followig features of shoppigcart.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/shoppigcart.jsp (UNIX) It cotais a sectio of static text that is formatted as HTML. JSP Commerce ad Campaig Tour 3-7

36 3 New User Buys a Product The list of items, prices, the subtotal, ad all cart-related buttos are dyamically geerated based o iformatio i the curret Pipelie sessio (the ext topic i this sectio, Techical Note: Pipelie Compoets, Pipelie Sessios, ad Webflow, describes Pipelie sessios). For details o the shoppig cart, see Shoppig Cart Maagemet Services i the Guide to Maagig Purchases ad Processig Orders. Techical Note: Pipelie Compoets, Pipelie Sessios, ad Webflow So far this tour has focused o HTML elemets ad JSP tags, which WebLogic Portal uses to preset iformatio i a format that Web browsers ca display. Behid this presetatio layer, Pipelie compoets, Pipelie sessios, ad Webflow exchage data with users, apply busiess logic ad process data, maitai state i idividual shoppig sessios, ad direct your users through the site based o a set of cotext-specific rules. The followig list describes each of the mechaisms: Pipelie compoets: Discrete uits of server-side busiess logic, such as logic for calculatig tax or committig a order. A successio of Pipelie compoets, i which oe compoet feeds data to aother compoet, is called a Pipelie. The amespace.pl file cotrols the order of Pipelie compoets i the Pipelie. Pipelie sessios: Storage locatios for iformatio about the curret sessio (such as the curret shoppig cart) or more trasiet data (such as error messages about a customer s most recet iput). Webflow: Cotrols the order of JSPs that WebLogic Portal presets to users based o the curret state of the Pipelie sessio. WebLogic Portal uses a amespace.wf file to determie the sequece of pages o your site. Webflow cetralizes cotrol of site avigatio, makig it easy for you to maitai ad update the site. For example, Listig 3-1 shows JSP tags from shoppigcart.jsp that retrieve the cotets of the shoppig cart from the curret Pipelie sessio. Listig 3-1 JSP Tags for Retrievig Shoppig Cart Cotet <webflow:getproperty id="shoppigcart" property="<%=pipeliesessiocostats.shopping_cart%>" 3-8 JSP Commerce ad Campaig Tour

37 Step 4: Create a New User Profile type="com.beasys.commerce.ebusiess.shoppigcart.shoppigcart" scope="sessio" amespace="sampleapp_mai" /> <webflow:getproperty id="savedshoppigcart" property="<%=pipeliesessiocostats.saved_shopping_cart%>" type="com.beasys.commerce.ebusiess.shoppigcart.shoppigcart" scope="sessio" amespace="sampleapp_mai" /> To cotiue the tour... For more iformatio o Pipelies ad Webflow, see the Guide to Maagig Presetatio ad Busiess Logic: Usig Webflow ad Pipelie. Click Check Out. Step 4: Create a New User Profile Whe you click Check Out from the shoppig cart, WebLogic Portal prompts you to log i from logi.jsp. Because you are a ew user, you must first create a user profile (see Figure 3-7). JSP Commerce ad Campaig Tour 3-9

38 3 New User Buys a Product Features of logi.jsp Figure 3-7 New User Loggig I The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/logi.jsp (UNIX) It uses a ad placeholder to display ads i the header. A Busiess Aalyst ca specify which types of ads display to specific types of customers i a give ad placeholder. For more iformatio about ad placeholders, refer to "Displayig Ads" i Usig the E-Busiess Cotrol Ceter. To facilitate browsig the sample templates, it specifies default values i the Userame ad Password boxes. The sample database icludes a user profile for the democustomer userame JSP Commerce ad Campaig Tour

39 Step 4: Create a New User Profile To cotiue the tour... Click Create to see the templates for creatig a ew user profile. Whe you click Create o the Log I page, WebLogic Portal prompts you to provide iformatio for your user profile i ewuser.jsp (see Figure 3-8 ad Figure 3-10). Features of ewuser.jsp (Part 1 of 3) Figure 3-8 Eterig Address Iformatio Notice the followig features of the first half of ewuser.jsp: JSP Commerce ad Campaig Tour 3-11

40 3 New User Buys a Product The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/register/ ewuser.jsp (UNIX) It uses a iput processor to determie if the user completed all required fields (the ext topic i this sectio, Techical Note: Iput Processors, describes iput processors). It cotais fields for eterig a cotact address ad a shippig address. Users ca eter additioal shippig addresses from selectaddress.jsp (see Figure 4-12) or from viewprofile.jsp (see Figure 5-3). It icludes the followig files to provide values for the State ad Coutry lists: PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/icludes/ states.ic ad PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/icludes/ coutries.ic The State ad Coutry lists are defied i separate iclude files because they are used by several JSP templates. It icludes a check box for which a customer ca specify a preferece for receivig . If you use Campaig services, you ca create sceario actios that use JSPs to geerate persoalized . Techical Note: Iput Processors Iput processors are Java classes that hadle form submissio. Some may perform validatio of customer data, but the primary role of a iput processor is to store customer data ito the Pipelie sessio for subsequet use by a Pipelie compoet. Webflow determies whether user iput is directed to a iput processor ad where the iput processor directs its output. For example, Listig 3-2 is a excerpt from ewuser.jsp specifyig that whe a user clicks the Save butto, the browser posts data to the Webflow. Listig 3-2 Form that Seds Data to a Iput Processor <!-- begi form to iput customer data. This form posts to the Webflow Advisor a "butto(save)" evet from origi "ewuser.jsp" --> 3-12 JSP Commerce ad Campaig Tour

41 Step 4: Create a New User Profile <form method="post" actio="<webflow:createwebflowurl evet="butto.save" httpsid="calculate" amespace="sampleapp_user" />"> <iput type=hidde ame=origi value="ewuser.jsp"> <iput type=hidde ame=evet value="butto.save"> <iput type=hidde ame=httpsid value="calculate"> <iput type=hidde ame=amespace value="sampleapp_user"> For a descriptio of iput processors that WebLogic Portal provides, refer to the followig documets: Guide to Buildig a Product Catalog Guide to Registerig Customers ad Maagig Customer Services Guide to Maagig Purchases ad Processig Orders Demographics i ewuser.jsp (Part 2 of 3) ewuser.jsp collects demographic iformatio about your customers. (See Figure 3-9.) You ca use this iformatio to create customer segmets, which are used by scearios ad cotet selectors. A sceario idetifies patters of evets, system states, ad customer segmets ad carries out specific actios. Cotet selectors to display persoalized iformatio to a customer or customer segmet. For iformatio, refer to the followig topics i Usig the BEA E-Busiess Cotrol Ceter: Usig Customer Segmets to Target High-Value Markets Roadmap for Creatig Promotioal Campaigs Retrievig Documets with Cotet Selectors JSP Commerce ad Campaig Tour 3-13

42 3 New User Buys a Product Figure 3-9 Eterig Demographics Iformatio 3-14 JSP Commerce ad Campaig Tour

43 Step 4: Create a New User Profile More Features of ewuser.jsp (Part 3 of 3) Figure 3-10 Eterig userame ad Password Notice the followig features of the secod half of ewuser.jsp: It icludes ewcctemplate.ic, which cotais fields for ew credit card iformatio. The values for the Credit Card Type ad Expiratio Date lists are defied i ewcctemplate.ic because ewcctemplate.ic is the oly template that uses them. The values for the State ad Coutry lists are defied i separate JSP files because they are used by several JSP templates. It does ot require you to eter paymet iformatio to set up your user profile. JSP Commerce ad Campaig Tour 3-15

44 3 New User Buys a Product The maximum umber of characters allowed for userames ad passwords is set i the JSP file as 50. The sample JSP templates do ot impose other restrictios, such as required character types or disallowed character types. If you wat to impose such restrictios, you must set up your ow field validator, possibly i the form of a iput processor. To cotiue the tour... Complete the required fields ad click Save. Step 5: Log I as a Registered User Whe you click Save, WebLogic Portal prompts you to log i from logi.jsp (see Figure 3-11). Features of logi.jsp Figure 3-11 Loggig I For a descriptio of logi.jsp, see Features of logi.jsp o page JSP Commerce ad Campaig Tour

45 Step 6: Choose Shippig Optios To cotiue the tour... Type the userame ad password you etered with your ew user profile. The click Log I. Click the Checkout butto. Step 6: Choose Shippig Optios Whe you click Checkout, WebLogic Portal starts the checkout process by displayig shippig optios i shippig.jsp (see Figure 3-12). Features of shippig.jsp Figure 3-12 Choose Shippig Optios Notice the followig features of shippig.jsp: JSP Commerce ad Campaig Tour 3-17

46 3 New User Buys a Product The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/shippig.j sp (UNIX) It uses Pipelies JSP tags to display the shippig methods that are defied i your database. To ehace performace, WebLogic Portal caches the list of methods istead of accessig the database each time the JSP tags request the data. It uses HTML to implemet the Ship All At Oce or As Available? radio buttos ad the Special Istructios iput box. To cotiue the tour Select shippig optios. You may also eter a commet i the Special Istructios box. 2. Click Cotiue. Whe you click Cotiue, WebLogic Portal displays your shippig addresses i selectaddress.jsp (see Figure 3-13) JSP Commerce ad Campaig Tour

47 Step 6: Choose Shippig Optios Features of selectaddress.jsp Figure 3-13 Select Shippig Address Notice the followig features of selectaddress.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/selectaddr ess.jsp (UNIX) It uses Java scriptlets to iterate through the list of shippig addresses i the user profile (see Listig 3-3). It ivokes a Taxatio Service, a WebLogic Portal implemetatio of busiess logic ad presetatio logic. For iformatio, see About Tax Calculatio o page 1-4 ad "Taxatio Services" i the Guide to Maagig Purchases ad Processig Orders. Listig 3-3 Java Scriptlets i selectaddress.jsp <um:getproperty propertyset="customerproperties" propertyname="shippigaddressmap" id="shippigaddressmap" /> <% JSP Commerce ad Campaig Tour 3-19

48 3 New User Buys a Product if(shippigaddressmap == ull) shippigaddressmap = ew HashMap(); %> <p><fot color="red"><webflow:getexceptio/></fot></p> <!-- Iterate through all addresses --> <% Iterator iterator =((Map)shippigAddressMap).keySet().iterator(); while(iterator.hasnext()) { Strig addresskey = (Strig)iterator.ext(); Address shippigaddress = (Address)((Map)shippigAddressMap).get(addressKey); %> <table width="90%" border="0" cellpaddig="6" cellspacig="0"> <tr> <td alig="left" valig="top" width="40%" owrap> <p><%= shippigaddress.getstreet1() %><br> %><br> </td> <% if( shippigaddress.getstreet2().legth()!= 0) {%> <%= shippigaddress.getstreet2() %><br> <% } %> <%= shippigaddress.getcity() %><br> <%= shippigaddress.getstate() %> <%= shippigaddress.getpostalcode() <%= shippigaddress.getcoutry() %> <td alig="left" valig="top" width="5%" > <% Strig extraparams = HttpRequestCostats.ADDRESS_KEY + "=" + addresskey; %> To cotiue the tour... Click Use JSP Commerce ad Campaig Tour

49 Step 7: Eter Paymet Iformatio Step 7: Eter Paymet Iformatio Whe you click Use, WebLogic Portal displays paymet.jsp, which lists ay credit cards that are i your user profile (see Figure 3-14). Features of paymet.jsp Figure 3-14 Select Add Credit Card Notice the followig features of paymet.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/ paymet.jsp (UNIX) Because you did ot add paymet iformatio whe you set up your user profile, your oly optio o this page is to add credit card iformatio. To cotiue the tour... Click Add Card. JSP Commerce ad Campaig Tour 3-21

50 3 New User Buys a Product Features of paymetewcc.jsp Whe you click Add Card, WebLogic Portal prompts you to eter paymet iformatio i paymetewcc.jsp (see Figure 3-15). Figure 3-15 Eter Credit Card Iformatio Notice the followig features of paymetewcc.jsp: 3-22 JSP Commerce ad Campaig Tour

51 Step 7: Eter Paymet Iformatio The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/ paymetewcc.jsp (UNIX) This page is similar to PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/user/ profileewcc.jsp ad PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/register/ ewuser.jsp. All three JSP files use a iclude file, PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/icludes/ ewcctemplate.ic, to defie the credit card iput fields. For more iformatio about template iclude files, see the ext topic i this sectio, Techical Note: Templates Icluded Withi Templates. Clickig Save updates the user profile. Techical Note: Templates Icluded Withi Templates Rather tha repeatig iput fields ad other iformatio across several files, the WebLogic Portal JSP templates assig re-used JSP tags ad HTML elemets to a set of iclude files, which are, i tur, JSP templates that you ca use to develop your site. For example, paymetewcc.jsp (described i the previous sectio), profileewcc.jsp, ad ewuser.jsp are paret JSP pages that iclude ewcctemplate.jsp as a child page to provide cosistet iput fields for credit card iformatio. You ca iclude ewcctemplate.jsp i other JSP files that you create. Why does t Webflow specify ewcctemplate.ic i all locatios that request credit card iformatio istead of usig three files, paymetewcc.jsp, profileewcc.jsp, ad ewuser.jsp? Webflow uses the three paret JSP pages to determie a user s cotext ad to determie which pages to display after a user eters ew credit card iformatio. For example, Figure 3-16 shows that after a user completes paymetewcc.jsp, Webflow displays paymet.jsp; after a user completes profileewcc.jsp, Webflow displays viewprofile.jsp, ad after a user completes ewuser.jsp, logi.jsp is displayed. JSP Commerce ad Campaig Tour 3-23

52 3 New User Buys a Product Figure 3-16 Template Iclude Files To cotiue the tour... For a list of iclude files ad the JSP templates that use them, see the Guide to Buildig a Product Catalog ad the Guide to Maagig Purchases ad Processig Orders. 1. Eter iformatio for a credit card. 2. Complete the remaiig required fields ad click Save JSP Commerce ad Campaig Tour

53 Step 8: Select a Credit Card Step 8: Select a Credit Card Whe you click Save i paymetewcc.jsp, WebLogic Portal displays your ewly added credit card iformatio i paymet.jsp (see Figure 3-17). More Features of paymet.jsp Figure 3-17 Select Credit Card Notice the followig features of paymet.jsp: User Maagemet JSP tags geerate the credit card list based o your user profile. Earlier i the tour whe you accessed paymet.jsp for the first time (see Figure 3-14), the User Maagemet JSP tags retured zero credit card defiitios from your user profile. JSP Commerce ad Campaig Tour 3-25

54 3 New User Buys a Product To cotiue the tour... Click Use. Step 9: Purchase the Item Whe you click Use i paymet.jsp, WebLogic Portal displays checkout.jsp, from which you review the tax iformatio ad complete the purchase JSP Commerce ad Campaig Tour

55 Step 9: Purchase the Item Features of checkout.jsp Figure 3-18 Purchase the Item Notice the followig features of checkout.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/ checkout.jsp (UNIX) JSP Commerce ad Campaig Tour 3-27

56 3 New User Buys a Product It uses JSP tags to gather ad display iformatio from the Pipelie, icludig the tax iformatio that a Taxatio Service calculates. Clickig Complete Purchase ivokes a Paymet Service, a WebLogic Portal implemetatio of busiess logic that processes paymets. For more iformatio about the Paymet Service, see "Paymet Services" i Guide to Maagig Purchases ad Processig Orders. To cotiue the tour... Click Complete Purchase. Step 10: Review the Order Cofirmatio Whe you click Complete Purchase, WebLogic Portal completes the purchase ad displays the cofirmatio umber i cofirmorder.jsp (see Figure 3-19) JSP Commerce ad Campaig Tour

57 Step 10: Review the Order Cofirmatio Features of cofirmorder.jsp Figure 3-19 Review the Order Cofirmatio Notice the followig features of cofirmorder.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/ cofirmorder.jsp (UNIX) JSP Commerce ad Campaig Tour 3-29

58 3 New User Buys a Product The Pipelie mechaism geerates the cofirmatio umber. Pipelie JSP tags gather ad display the iformatio o this page. To cotiue the tour... This cocludes the tour for ew users. To cotiue the tour of the JSP templates, click Home i the avigatio bar ad go to the ext sectio, Chapter 4, Registered User Buys a Product JSP Commerce ad Campaig Tour

59 CHAPTER 4 Registered User Buys a Product Because you were impressed by the large selectio ad low prices (ot to metio the ease of use!) whe you visited the e-commerce Web site, you decide to retur ad buy a drill for a fried who is startig a home improvemet project. Your retur trip to the Web site takes you alog the followig path: Registered User Roadmap Step 1: Browse the Catalog ad Select a Item Step 2: Review the Shoppig Cart ad Check Out Detour: Review the Home Page for Autheticated Users Step 3: Choose Shippig Optios Step 4: Eter ad Select a New Shippig Address Step 5: Select a Credit Card Step 6: Purchase the Items Step 7: Review Order Cofirmatio Note: I this chapter, the product ame is referred to as WebLogic Portal. If you are licesed for BEA Campaig services, this product package icludes Commerce services. For a licesig ad packagig overview, see the sectio About the Product Liceses ad This Tour o page 1-2. JSP Commerce ad Campaig Tour 4-1

60 4 Registered User Buys a Product Registered User Roadmap Before startig this sectio of the tour, review the followig maps of the JSP templates (Figure 4-1, Figure 4-2, ad Figure 4-3). The arrows i the maps represet avigatio optios that Webflow provides; the darker arrows show the path that this sectio of the tour describes. Figure 4-1 JSPs for Browsig the Catalog 4-2 JSP Commerce ad Campaig Tour

61 Registered User Roadmap Figure 4-2 JSPs for the Shoppig Cart ad User Logi JSP Commerce ad Campaig Tour 4-3

62 4 Registered User Buys a Product Figure 4-3 JSPs for Completig the Order 4-4 JSP Commerce ad Campaig Tour

63 Step 1: Browse the Catalog ad Select a Item Step 1: Browse the Catalog ad Select a Item Whe you arrive at the Home page for your retur shoppig trip, you decide to browse for drills i the catalog. Figure 4-4 Home Page: Top Level of the Catalog To cotiue the tour... Click Power Tools. Whe you click Power Tools, WebLogic Portal displays the cotets of the Power Tools category i browse.jsp (see Figure 4-5). JSP Commerce ad Campaig Tour 4-5

64 4 Registered User Buys a Product Features of browse.jsp (Part 1 of 2) Figure 4-5 Secod Level of the Catalog Notice the followig features of browse.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/ commerce/catalog/browse.jsp (UNIX) Pipelie JSP tags query the product catalog for a list of siblig categories. The ame of the curret category ad liks to its sibligs are displayed above the category ame. A JSP tag i the ceter colum costructs a tree view from the curret category to the top level of the catalog: <jsp:iclude page="/commerce/catalog/icludes/avigatio.jsp" flush="true"/> Listig 4-1 shows that browse.jsp icludes a JSP file that the Catalog geerates to describe the cotets of the curret category. 4-6 JSP Commerce ad Campaig Tour

65 Step 1: Browse the Catalog ad Select a Item Listig 4-1 Catalog Tags to Display Curret Category <!-- mai cotet --> <%-- Get the summary JSP from the curret category --%> <catalog:getproperty object="<%= category %>" propertyname="jsp" id="displayjsp" returtype="com.beasys.commerce.ebusiess.catalog.jspifo"/> <%-- Iclude the catagory layout JSP for this category --%> <jsp:iclude page="<%= displayjsp.geturl() %>" flush="true"/> To cotiue the tour... Click Drills. Whe you click Drills, WebLogic Portal displays the cotets of the Drills category i browse.jsp (see Figure 4-6). JSP Commerce ad Campaig Tour 4-7

66 4 Registered User Buys a Product More Features of browse.jsp (Part 2 of 2) Figure 4-6 Third Level of the Catalog Notice the followig additioal features of browse.jsp: It is the same source file that Figure 4-5 illustrates, but the cotet is differet because the user s cotext is differet. The Pipelie JSP tags query the product catalog for the list of siblig categories. Because the page ow displays a category differet from the category illustrated i Figure 4-5, the list chages. I the ceter colum, the JSP tags modify the tree view to reflect the curret category. I the secod row of the ceter colum, the Catalog geerates a differet JSP file tha i Figure 4-5, hece the cotets ad layout i Figure 4-6 chages. 4-8 JSP Commerce ad Campaig Tour

67 Step 1: Browse the Catalog ad Select a Item All the items i the drill category are displayed usig category ad summary JSPs. Each drill icludes a lik to detailed product iformatio. To cotiue the tour... Click the ame of a drill. Whe you click the ame of a drill, WebLogic Portal displays a product descriptio i details.jsp (see Figure 4-7). Features of details.jsp Figure 4-7 Item Details Notice the followig features of details.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/ commerce/catalog/details.jsp (UNIX) JSP Commerce ad Campaig Tour 4-9

68 4 Registered User Buys a Product It ca be accessed from either browse.jsp or searchresults.jsp (see Figure 4-1). It icludes a JSP file (avigatio2.jsp) that costructs a tree view oly if users access the page from browse.jsp. If the Pipelie mechaism determies that a user accessed the page from searchresults.jsp, the JSP file does ot costruct the tree view. It icludes a summary JSP file for the item beig displayed. The product catalog geerates this summary JSP file based o the iformatio it stores about the item. To cotiue the tour... Click Add to Cart. Step 2: Review the Shoppig Cart ad Check Out Whe you click Add to Cart, WebLogic Portal displays your selectios i shoppigcart.jsp (see Figure 4-8) JSP Commerce ad Campaig Tour

69 Step 2: Review the Shoppig Cart ad Check Out Figure 4-8 Shoppig Cart To cotiue the tour... For a descriptio of shoppigcart.jsp, see Features of shoppigcart.jsp o page 3-7. Click Check Out. Whe you click Check Out, WebLogic Portal prompts you to log i (see Figure 4-9). Because you created a user profile i Chapter 3, New User Buys a Product, you are ow a registered user. JSP Commerce ad Campaig Tour 4-11

70 4 Registered User Buys a Product Figure 4-9 Log I For a descriptio of logi.jsp, see Features of logi.jsp o page Techical Note: The Security Model How does WebLogic Portal determie if users must log i whe they click a lik? Istead of usig Webflow to implemet security, WebLogic Portal follows the J2EE specificatio for security. With this specificatio, the site admiistrator determies which set of files ca be accessed oly by autheticated users. By default, all JSP templates below the order ad user directories ca be accessed oly by autheticated users. Whe a aoymous user tries to access oe of these files, WebLogic Portal displays logi.jsp, from which the user ca either log i or create a ew user accout. After autheticatio, Webflow determies the remaiig successio of pages JSP Commerce ad Campaig Tour

71 Step 2: Review the Shoppig Cart ad Check Out To cotiue the tour... Eter the userame ad password you set up i Step 4: Create a New User Profile o page 3-9. The click Log I. Whe you click Log I, WebLogic Portal displays shippig optios i shippig.jsp (see Figure 4-10). Figure 4-10 Shippig Page Detour Takig a detour... For a descriptio of shippig.jsp, see Features of shippig.jsp o page Before cotiuig the tour, take a miute to review the Home page. Now that you have logged i (autheticated), the Home page shows optios that are available oly to autheticated users. To take the detour, click Home (see Figure 4-10). JSP Commerce ad Campaig Tour 4-13

72 4 Registered User Buys a Product Detour: Review the Home Page for Autheticated Users Whe you click Home, WebLogic Portal displays mai.jsp (see Figure 4-11). Features of mai.jsp for Autheticated Users Figure 4-11 Home Page for Autheticated Users Notice the followig features of mai.jsp: Now that you are autheticated, mai.jsp displays your userame alog with liks to your order ad paymet history. If a ame is associated with the Pipelie sessio, User Maagemet JSP tags i the leftside.ic file query the database for your userame ad display the results JSP Commerce ad Campaig Tour

73 Step 3: Choose Shippig Optios To cotiue the tour Click View Cart. 2. I the shoppig cart, click Check Out. Step 3: Choose Shippig Optios To cotiue the tour... Whe you click Check Out from shoppigcart.jsp, WebLogic Portal displays shippig optios i shippig.jsp (see Figure 4-10). For a descriptio of shippig.jsp, see Features of shippig.jsp o page From shippig.jsp, click Cotiue. Step 4: Eter ad Select a New Shippig Address Whe you click Cotiue i shippig.jsp, WebLogic Portal displays shippig addresses i selectaddress.jsp (see Figure 4-12). To ship the item to someoe other tha yourself, you must eter a ew address. JSP Commerce ad Campaig Tour 4-15

74 4 Registered User Buys a Product Figure 4-12 Select Add Address To cotiue the tour... For a descriptio of selectaddress.jsp, see Features of selectaddress.jsp o page Click Add Address. Whe you click Add Address, WebLogic Portal prompts you to eter a ew shippig address i addaddress.jsp (see Figure 4-13) JSP Commerce ad Campaig Tour

75 Step 4: Eter ad Select a New Shippig Address Figure 4-13 Eter the New Address To cotiue the tour... Eter a address that cotais the followig iformatio: City: Dever Zip Code: Coutry: Uited States The click Save. This particular zip code spas multiple tax jurisdictios. Later i this step of the tour, you must select which tax jurisdictio applies. Whe you click Save, WebLogic Portal displays the addresses from your user profile i selectaddress.jsp (see Figure 4-14). JSP Commerce ad Campaig Tour 4-17

76 4 Registered User Buys a Product Figure 4-14 Select the New Address To cotiue the tour... For a descriptio of selectaddress.jsp, see Features of selectaddress.jsp o page Click Use ext to the Dever, CO address that you created. Whe you click Use, the Pipelie seds data to a Taxatio Service. Because the zip code covers differet tax jurisdictios, WebLogic Portal prompts you to choose a specific area withi the zip code from selecttaxcaddress.jsp (see Figure 4-15) JSP Commerce ad Campaig Tour

77 Step 4: Eter ad Select a New Shippig Address Features of selecttaxaddress.jsp Figure 4-15 Select Tax Jurisdictio Note the followig features of selecttaxaddress.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/ commerce/order/selecttaxaddress.jsp (UNIX) It uses a Pipelie JSP tag to collect the tax jurisdictio data from the Pipelie sessio. It uses Java scriptlets ad HTML to display ad format the data. JSP Commerce ad Campaig Tour 4-19

78 4 Registered User Buys a Product Clickig Use seds data to the WebLogic Portal Taxatio Service for tax calculatio. To cotiue the tour... Click Use ext to a address. Step 5: Select a Credit Card Whe you click Use, WebLogic Portal displays paymet.jsp, which lists the credit cards i your user profile (see Figure 4-16). Figure 4-16 Select a Credit Card To cotiue the tour... For a descriptio of paymet.jsp, see Features of paymet.jsp o page Click Use JSP Commerce ad Campaig Tour

79 Step 6: Purchase the Items Step 6: Purchase the Items Whe you click Use i paymet.jsp, WebLogic Portal displays the fial purchase iformatio i checkout.jsp (see Figure 4-17). Figure 4-17 Purchase the Items For a descriptio of checkout.jsp, see Features of checkout.jsp o page JSP Commerce ad Campaig Tour 4-21

80 4 Registered User Buys a Product To cotiue the tour... Click Complete Purchase. Step 7: Review Order Cofirmatio Whe you click Complete Purchase, WebLogic Portal completes the purchase ad displays the cofirmatio umber i cofirmorder.jsp (see Figure 4-18). Figure 4-18 Review the Order Cofirmatio For a descriptio of cofirmorder.jsp, see Features of cofirmorder.jsp o page JSP Commerce ad Campaig Tour

81 Step 7: Review Order Cofirmatio To cotiue the tour... This cocludes the tour for a registered user buyig a product. To cotiue the tour of the JSP templates, click View Profile i the header ad go to the ext sectio, Chapter 5, Registered User Adds a Credit Card. JSP Commerce ad Campaig Tour 4-23

82 4 Registered User Buys a Product 4-24 JSP Commerce ad Campaig Tour

83 CHAPTER 5 Registered User Adds a Credit Card I this sectio of the tour, assume that you wat to access the Web site to add credit card iformatio to your user profile ad to see the status of your last order. (This probably is ot a realistic sceario for your customers, but it highlights additioal features that are available i the JSP templates.) This sectio of the tour takes you alog the followig path: User Profile Roadmap Step 1: Access Your User Profile Step 2: Review Your User Profile Step 3: Add a Credit Card Step 4: View Your Order History ad Status Step 5: Log Out Note: I this chapter, the product ame is referred to as WebLogic Portal. If you are licesed for BEA Campaig services, this product package icludes Commerce services. For a licesig ad packagig overview, see the sectio About the Product Liceses ad This Tour o page 1-2. JSP Commerce ad Campaig Tour 5-1

84 5 Registered User Adds a Credit Card User Profile Roadmap Before startig this sectio of the tour, review Figure 5-1, which is a map of the user profile JSP templates. The arrows i the map represet avigatio optios that Webflow provides; the darker arrows show the path that this sectio of the tour describes. Figure 5-1 JSPs for Modifyig the User Profile 5-2 JSP Commerce ad Campaig Tour

85 Step 1: Access Your User Profile Step 1: Access Your User Profile You ca access your user profile from ay page o the Web site by clickig View Profile i the left side of the display (see Figure 5-2). This portio of each page comes from the leftside.ic iclude file. If you are accessig the site aoymously WebLogic Portal prompts you to log i before it displays your profile. Figure 5-2 Click View Profile To cotiue the tour... From ay page o the site, click View Profile i the header. Log i if WebLogic Portal prompts you. For iformatio about WebLogic Portal security, see Techical Note: The Security Model o page Step 2: Review Your User Profile Whe you click View Profile as a autheticated user, or whe you click Log I from logi.jsp, WebLogic Portal displays viewprofile.jsp (see Figure 5-3). JSP Commerce ad Campaig Tour 5-3

86 5 Registered User Adds a Credit Card Features of viewprofile.jsp Figure 5-3 Your User Profile 5-4 JSP Commerce ad Campaig Tour

87 Step 3: Add a Credit Card Notice the followig features of viewprofile.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/user/viewprofile.jsp (UNIX) It creates a HTTPS sessio o port 7502 to sed ecrypted data through SSL. It displays the shippig addresses you added i previous shoppig sessios. The first address was added by default whe you idicated that the shippig address was the same as your cotact address (see Step 4: Create a New User Profile o page 3-9). It displays the credit card iformatio you etered i your first shoppig sessio. Techical Note: The Database for Commerce Services Commerce services ad WebLogic Persoalizatio Server store their data i a sigle Cloudscape or Oracle database. For a descriptio of the database schema ad tables, refer to the followig topics: The Product Catalog Schema i the Guide to Buildig a Product Catalog Overview of the Registratio ad User Processig Package i the Guide to Registerig Customers ad Maagig Customer Services WebLogic Persoalizatio Server Schema i the Guide to Buildig Persoalized Applicatios To cotiue the tour... Click Add Card. Step 3: Add a Credit Card Whe you click Add Card, WebLogic Portal prompts you to eter credit card iformatio i profileewcc.jsp (see Figure 5-4). JSP Commerce ad Campaig Tour 5-5

88 5 Registered User Adds a Credit Card Features of profileewcc.jsp Figure 5-4 Addig a Credit Card 5-6 JSP Commerce ad Campaig Tour

89 Step 4: View Your Order History ad Status Notice the followig features of profileewcc.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/user/ profileewcc.jsp (UNIX) A JSP tag icludes the file that defies the data-etry fields: <%@ iclude file="/commerce/icludes/ewcctemplate.jsp" %> For iformatio about template iclude files, see Techical Note: Templates Icluded Withi Templates o page To cotiue the tour Eter iformatio for a credit card. 2. Complete the remaiig required fields. The click Save. The ext part of the tour shows your order history ad status, which you access from the Home page for autheticated users. 3. Click Home i the header. Step 4: View Your Order History ad Status Whe you click Home, WebLogic Portal displays mai.jsp, which is the site s Home page (see Figure 5-5). Notice that mai.jsp uses the HTTP protocol through port 7501; WebLogic Portal does ot use SSL for the Home page. JSP Commerce ad Campaig Tour 5-7

90 5 Registered User Adds a Credit Card Figure 5-5 Click View Order History To cotiue the tour... For details about mai.jsp for autheticated users, see Features of mai.jsp for Autheticated Users o page Click View Order History, WebLogic Portal displays orderhistory.jsp (see Figure 5-6). 5-8 JSP Commerce ad Campaig Tour

91 Step 4: View Your Order History ad Status Features of orderhistory.jsp Figure 5-6 Order History Notice the followig features of orderhistory.jsp: The file s full pathame is $PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/ orderhistory.jsp (UNIX) A Pipelie JSP tag retrieves the history. <!-- Extract the scrollable model --> <webflow:getproperty id="orderhistory" property="<%=pipeliesessiocostats.scrollable_model%>" type="com.beasys.commerce.ebusiess.util.scrollablemodel" scope="sessio" amespace="sampleapp_mai" /> WebLogic Portal stores this history i the WLCS_ORDER database table util the database admiistrator archives the data. For more iformatio about the WLCS_ORDER table, see The Order Processig Database Schema i the Guide to Maagig Purchases ad Processig Orders. To cotiue the tour... Click View to see the order status. JSP Commerce ad Campaig Tour 5-9

92 5 Registered User Adds a Credit Card Whe you click View, WebLogic Portal displays orderstatus.jsp (see Figure 5-7). Features of orderstatus.jsp Figure 5-7 Order Status Notice the followig features of orderhistory.jsp: The file s full pathame is PORTAL_HOME/applicatios/wlcsApp/wlcs/commerce/order/ orderstatus.jsp (UNIX) A Pipelie JSP tag collects properties of the order: <!-- defie bea to retrieve the CustomerValue --> <webflow:getproperty id="ordervalue" property="<%=pipeliesessiocostats.selected_order%>" type="com.beasys.commerce.ebusiess.order.ordervalue" scope="sessio" amespace="sampleapp_mai" /> <% 5-10 JSP Commerce ad Campaig Tour

93 Step 5: Log Out The order properties, which are stored i the order database table, iclude the order status. Note: The Pipelie assigs oly the New or Submitted state to a order. If you wat to add states, you must modify the Pipelie. To cotiue the tour... Click Home. Step 5: Log Out What s ext? To ed your autheticated sessio, click Logout. Loggig out eds the Pipelie sessio, clearig your shoppig cart ad disassociatig your userame from subsequet evets o the site (util you log i agai). To see a example of how to modify the JSP templates ad the Webflow, see Chapter 6, Example of Customizig the Templates. JSP Commerce ad Campaig Tour 5-11

94 5 Registered User Adds a Credit Card 5-12 JSP Commerce ad Campaig Tour

95 CHAPTER 6 Example of Customizig the Templates I previous sectios of the tour, whe you clicked the Add to Cart lik i the commerce templates, WebLogic Portal displayed shoppigcart.jsp to prompt you to check out. However, your busiess model may wat to ecourage customers to cotiue shoppig by returig them to the product catalog after they click Add to Cart. You ca chage the behavior of the Add to Cart lik by modifyig the Webflow associated with the wlcs Web applicatio. Before you modify the Webflow, however, you eed some backgroud iformatio. This sectio of the tour takes you alog the followig path: Step 1: Uderstad the Add to Cart Lik Step 2: Modify Add to Cart Step 3: Verify the Modificatio JSP Commerce ad Campaig Tour 6-1

96 6 Example of Customizig the Templates Step 1: Uderstad the Add to Cart Lik Istead of specifyig a static fileame as a URL, lik achors i WebLogic Portal ivoke the Webflow mechaism to determie the destiatio resource. The lik achor for the Add to Cart lik (illustrated i Listig 6-1) is i the iclude file PORTAL_HOME/applicatios/wlcsApps/wlcs/commerce/catalog/icludes/ itemdetails.jsp. For more iformatio o itemdetails.jsp, see The Product Catalog JSP Templates i the Guide to Buildig a Product Catalog. Listig 6-1 Add to Cart Achor <%-- Add the Put i Cart lik --%> <% allparams = HttpRequestCostats.CATALOG_ITEM_SKU + "=" + productitem.getkey().getidetifier(); %> <td alig="right" valig="top" width="5%"><a href="<webflow:createwebflowurl evet="lik.add" amespace="sampleapp_order" extraparams="<%= allparams %>" />"> <img src="<webflow:createresourceurl resource="/commerce/images/bt_addcart.gif" />" border="0" alt="add to Shoppig Cart"></a> </td> This step of the tour describes the followig actios: How the Lik Achor Ivokes Webflow How Webflow Resolves the Lik 6-2 JSP Commerce ad Campaig Tour

97 Step 1: Uderstad the Add to Cart Lik How the Lik Achor Ivokes Webflow The achor uses the <webflow:createwebflowurl> JSP tag to pass data to Webflow. Note the followig three data items that the <webflow:createwebflowurl> JSP tag passes to Webflow: The evet type ad ame. For the Add to Cart lik, the evet type is lik ad the ame is add. The amespace ame i which the file that cotais the lik source resides. For the Add to Cart lik, the amespace ame is sampleapp_order. Ay extra parameters that should be icluded. For more iformatio about the <webflow:createwebflowurl> JSP tag, see Webflow JSP Tag Library Referece i the Guide to Maagig Presetatio ad Busiess Logic: Usig Webflow ad Pipelie documetatio. After sedig this data through oe or more Pipelies, Webflow returs a URL that resolves the lik. How Webflow Resolves the Lik Warig: All modificatios to the.wf ad.pl files (a few of which are show i the followig code listigs) should be doe usig the Webflow ad Pipelie Editors. These editors are used i the E-Busiess Cotrol Ceter. For more iformatio, see Usig the Webflow ad Pipelie Editors i the Guide to Maagig Presetatio ad Busiess Logic: Usig Webflow ad Pipelie documetatio. Failure to do so may cause uexpected results. Whe the <webflow:createwebflowurl> JSP tag seds data to Webflow, Webflow searches the sampleapp_order.wf for the lik.add evet i the evet list of the wild card presetatio ode, as show i Listig 6-3. JSP Commerce ad Campaig Tour 6-3

98 6 Example of Customizig the Templates Listig 6-2 The Add to Cart Lik i sampleapp_order.wf <wildcard-presetatio-origi ode-type="jsp"> <evet-list>... <evet evet-ame="lik.add"> <destiatio amespace="sampleapp_order" ode-ame="addproductitemtoshoppigcartip" ode-type="iputprocessor"/> </evet>... </evet-list> </wildcard-presetatio-origi> The destiatio show for the lik.add evet for this case is to ivoke the addproductitemtoshoppigcartip Iput Processor, which is i sampleapp_order. Therefore, Webflow locates the addproductitemtoshoppigcartip Iput Processor i the list of processor ode origis, as show i Listig 6-3. Listig 6-3 The addproductitemtoshoppigcartip Iput Processor i sampleapp_order.wf <processor-origi ode-ame="addproductitemtoshoppigcartip" ode-type="iputprocessor"> <ode-processor-ifo class-ame="examples.wlcs.sampleapp.catalog.webflow.getproductitemip"/> <evet-list> <evet evet-ame="success"> <destiatio amespace="sampleapp_order" ode-ame="addproductitemtoshoppigcart" ode-type="pipelie"/> </evet> </evet-list>... </processor-origi> 6-4 JSP Commerce ad Campaig Tour

99 Step 2: Modify Add to Cart If the addproductitemtoshoppigcartip Iput Processor executes successfully, the Webflow ivokes the addproductitemtoshoppigcart Pipelie. Webflow searches sampleapp_order ad locates the addproductitemtoshoppigcart Pipelie, as show i Listig 6-4. Listig 6-4 The addproductitemtoshoppigcart Pipelie i sampleapp_order.wf <processor-origi ode-ame="addproductitemtoshoppigcart" ode-type="pipelie"> <ode-processor-ifo pipelie-ame="addproductitemtoshoppigcart"/> <evet-list> <evet evet-ame="success"> <destiatio amespace="sampleapp_order" ode-ame="addproductitemtoshoppigcarttracker" ode-type="pipelie"/> </evet> </evet-list>... </processor-origi> Similarly, if the addproductitemtoshoppigcart Pipelie executes successfully, it seds data to aother Pipelie amed addproductitemtoshoppigcarttracker. If the addproductitemtoshoppigcarttracker Pipelie is successful, the Webflow ivokes the refreshsavedlist Pipelie. Whe the refreshsavedlist Pipelie executes successfully, it reloads the shoppigcart.jsp. Step 2: Modify Add to Cart After uderstadig how the Webflow determies the user-visible behavior of the Add to Cart lik, you ca modify it to direct customers to the top level of the catalog. Recall from Chapter 3, New User Buys a Product, that the top level of the product catalog is displayed i mai.jsp. However, chagig the refreshsavedlist Pipelie s success evet to load mai.jsp as a destiatio (rather tha shoppigcart.jsp) would ot produce desirable results. This is because mai.jsp does ot cotai the stadard HTML tags that Web browsers ca reder. Istead, the JSP Commerce ad Campaig Tour 6-5

100 6 Example of Customizig the Templates file cotais JSP tags. If you were to chage the output of the refreshsavedlist Pipelie s success evet to display mai.jsp directly, the Web browser would display a empty page. Istead, you must ivoke a Iput Processor amed gettopcategoriesip, which resides i the sampleapp_mai amespace. This Iput Processor gathers data about categories i the product catalog ad displays it i mai.jsp. For more iformatio o how WebLogic Portal populates mai.jsp with data, see The Product Catalog JSP Templates i the Guide to Buildig a Product Catalog. Directig the Output of the gettopcategoriesip Iput Processor You ca direct output from the refreshsavedlist Pipelie to the gettopcategoriesip Iput Processor usig the Webflow ad Pipelie Editors. Ope the sampleapp_order.wf file usig the Editor, the move the destiatio of the refreshsavedlist Pipelie Node s success evet by draggig the ed coector from the shoppigcart.jsp Presetatio Node to the sampleapp_mai_gettopcategoriesip Proxy Node. This will poit the evet destiatio to the correct amespace. For more iformatio about the Webflow ad Pipelie Editors, see Usig the Webflow ad Pipelie Editors i the Guide to Maagig Presetatio ad Busiess Logic: Usig Webflow ad Pipelie documetatio. Step 3: Verify the Modificatio After you save your modificatios to sampleapp_order.wf, you must sychroize the modificatios to the WebLogic Portal server usig the E-Busiess Cotrol Ceter by choosig Tools Sychroize i the meu. If you eed istructios for coectig to the server for sychroizatio, see Coectig to the Server i the Guide to Usig the E-Busiess Cotrol Ceter. After you have sychroized, you ca see the results by clickig the Add to Cart lik from details.jsp (see Figure 6-1). You do ot eed to restart the WebLogic Portal server. 6-6 JSP Commerce ad Campaig Tour

101 Step 3: Verify the Modificatio Figure 6-1 Click Add to Cart i details.jsp Whe you click Add to Cart, WebLogic Portal displays the top level of the product catalog i mai.jsp. However, to verify that WebLogic Portal added your item to the shoppig cart, do the followig from mai.jsp: 1. Click View Cart i the header. 2. If WebLogic Portal prompts you to log i, eter the userame ad password you set up i the previous sectios of the tour. Whe you click View Cart, WebLogic Portal displays shoppigcart.jsp, which cotais the item you added to the cart. JSP Commerce ad Campaig Tour 6-7

102 6 Example of Customizig the Templates What s Next? To cotiue the tour ad lear about the campaig features that are used i the JSP templates, ad how they were defied i the E-Busiess Cotrol Ceter, see Chapter 7, A Sample Campaig. To lear more about the WebLogic Portal commere services JSP templates, the Webflow ad Pipelie mechaisms, the Product Catalog, ad the other cocepts itroduced i the tour, Commerce Egieers should see the followig documets: Guide to Maagig Presetatio ad Busiess Logic: Usig Webflow ad Pipelie Guide to Buildig a Product Catalog Guide to Registerig Customers ad Maagig Customer Services Guide to Maagig Purchases ad Processig Orders 6-8 JSP Commerce ad Campaig Tour

103 CHAPTER 7 A Sample Campaig I previous sectios of the tour, the focus was o the commerce features of the sample Web applicatio. The descriptios were primarily iteded as a overview for the Java developers or Commerce Busiess Egieers (CBEs) who will use the JSP templates ad tags to build applicatios. This fial chapter of the tour switches the focus to the campaig features, especially from the perspective of the busiess aalysts ad marketig professioals who will use the graphical cliet tool called the BEA E-Busiess Cotrol Ceter. The followig topics are discussed: Itroductio ad Prerequisites Step 1: Startig the E-Busiess Cotrol Ceter Step 2: Coectig from the Cliet Tool to a Ruig Server Step 3: Examiig TourCampaig1: Simple Baer Ad What s Next? Itroductio ad Prerequisites This tour takes you through a basic sample campaig, ad shows you the simple JSP tags that have bee iserted i the sample JSP templates. These JSP tags do thigs like provide placeholders o the Web pages for cotet that it either associated with a campaig, or operates idepedetly of a campaig. The characteristics of that cotet is determied by the perso who defies the campaigs i the E-Busiess Cotrol Ceter, the profiles of people usig the Web site, ad the evets that occur while people are usig the Web site. First, a few basic facts about the BEA E-Busiess Cotrol Ceter ad campaigs: JSP Commerce ad Campaig Tour 7-1

104 7 A Sample Campaig A broad rage of users, icludig busiess aalysts, marketig professioals, ad busiess egieers ca use the E-Busiess Cotrol Ceter to defie ad maage promotioal campaigs, campaig discouts, stad-aloe discouts, customer segmets, cotet selectors, ad placeholders, ad custom evets. Although the E-Busiess Cotrol Ceter has a separate istallatio program, it is ot a separate product. You ca use this cliet tool for a variety of purposes with the portal, campaig, commerce, ad persoalizatio features i WebLogic Portal. A ru-time licese check determies which features of the E-Busiess Cotrol Ceter you ca use. There are two stadard liceses. A abbreviated versio of the fuctioality per licese type is as follows: l l If you are usig the WebLogic Persoalizatio Server oly licese, you ca keep track of customer behavior (evets), create placeholders for cotet display, defie customer segmets, ad target customers with persoalized cotet. If you are usig the full WebLogic Portal licese, you ca perform all the previously listed fuctios, plus you ca defie the characteristics of portals, portlets, grat access to visitors so they ca view ad cofigure portals ad portlets, defie stadaloe discouts or campaig discouts, ad develop promotioal campaigs. For more iformatio about the product features accordig to licese, see the Guide to Usig the E-Busiess Cotrol Ceter. This documet is a copy of the olie Help that is itegrated ito the cliet tool. The E-Busiess Cotrol Ceter cliet ca be istalled either stadaloe or o the same system as the server software if the platform supports both. A campaig is a amed group of scearios that work together to achieve strategic busiess goals. A campaig coordiates several WebLogic Portal services to create ad track marketig goals o a e-commerce Web site. A sceario is the primary buildig-block of campaigs. A sceario is composed of oe or more sceario actios, all of which take place if their criteria are met: If a particular evet occurs or if a customer is part of a specified customer segmet. 7-2 JSP Commerce ad Campaig Tour

105 Step 1: Startig the E-Busiess Cotrol Ceter Step 1: Startig the E-Busiess Cotrol Ceter The E-Busiess Cotrol Ceter is a cliet that coects locally or remotely to files or a server ruig a server ruig WebLogic Portal applicatios. If the E-Busiess Cotrol Ceter is ot istalled yet, you or your system admiistrator should see Istallig the E-Busiess Cotrol Ceter i the Istallatio Guide. After the istallatio, you or your system admiistrator must set up the product licese. If that step has ot happeed yet, see Post-Istallatio Cosideratios i the Istallatio Guide. Before you start the E-Busiess Cotrol Ceter, the server must be ruig. The Web applicatio does ot have to be ruig, but for the purposes of this tour we suggest that you have it ruig too. For iformatio about startig the server ad opeig the Web applicatio, see Chapter 2, Startig the Tour. O a supported cliet Widows system, use the Start meu to start the E-Busiess Cotrol Ceter. For example: Start Programs BEA WebLogic E-Busiess Platform BEA E-Busiess Cotrol Ceter 4.0 E-Busiess Cotrol Ceter The E-Busiess Cotrol Ceter cliet displays a splash scree with a umber of Iitializig... messages, ad the opes its screes o the desktop. Step 2: Coectig from the Cliet Tool to a Ruig Server Although the majority of E-Busiess Cotrol Ceter fuctioality does ot require users to log i to a ruig WebLogic Portal server, some areas of the E-Busiess Cotrol Ceter require you to log i to the server to view or use certai data. JSP Commerce ad Campaig Tour 7-3

106 7 A Sample Campaig 1. I the E-Busiess Cotrol Ceter, choose Tools Coectio Settigs i the meu. The Coectio Settigs widow appears, as show i Figure 7-1. Figure 7-1 Settig up a Coectio to the Server 2. I the Coectios tab, click New. The Coectio Details widow appears, as show i Figure 7-2. Figure 7-2 Addig a Coectio 3. I the Coectio Details widow, do the followig: l l I the Display Name field, eter a ame for the coectio. For example: Sample Tour. I the Applicatio Name drop-dow list, select wlcsapp. This is the sample e-commerce applicatio that ships with WebLogic Portal. 7-4 JSP Commerce ad Campaig Tour

107 Step 3: Examiig TourCampaig1: Simple Baer Ad l I the Server field, eter where <server> is the ame of the server that WebLogic Portal is istalled o, ad <port> is the port umber o the server where WebLogic Portal is located. For example, If your are ruig the E-Busiess Cotrol Ceter o the same server as WebLogic Portal, you ca use the ame localhost for the server ame. The default istallatio port is If you are ot sure of the port umber, please check with your system admiistrator. 4. Click OK. The ew coectio is displayed i the Coectios tab of the Coectio Settigs widow. 5. I the Associatios tab of the Coectio Settigs widow, select the ew coectio i the All-Purpose Coectio drop-dow list. 6. Click OK. Durig the rest of this tour, you will be prompted for a userame ad password. Try the followig: Userame: system Password: weblogic This assumes that the perso who did the istallatio etered weblogic as the password for the system accout whe WebLogic Server was istalled. If you are ot sure, please check with your system admiistrator. Step 3: Examiig TourCampaig1: Simple Baer Ad Oce the coectio from the cliet tool to the server is established, we ca start explorig some of the sample campaig data that ships with WebLogic Portal. To see the sample data, you must load a applicatio i the E-Busiess Cotrol Ceter. To do this: 1. Choose File Ope Applicatio i the meu. JSP Commerce ad Campaig Tour 7-5

108 7 A Sample Campaig 2. I the Ope Applicatio widow, expad the EBCC_HOME\applicatios folder. (The istallatio default for EBCC_HOME is ebcc4.0.) 3. Sigle-click the wlcsapp subfolder, ad click Ope. The wlcsapp sample applicatio loads i the E-Busiess Cotrol Ceter, though it may seem like othig happes. But you will see Applicatio: wlcsapp just below the Explorer widow s toolbar. This applicatio is a sample eterprise applicatio that ships with WebLogic Portal. You are ot loadig the eterprise applicatio itself. Rather, you are loadig a groupig of XML files that are associated with each tool i the E-Busiess Cotrol Ceter. These files, whe sychroized to the WebLogic Portal server, will help cotrol the behavior of the eterprise applicatio. 4. Click the Campaigs ico i the Explorer widow. The E-Busiess Cotrol Ceter displays a Explorer widow, as show i Figure 7-3. Figure 7-3 Explorer Widow 7-6 JSP Commerce ad Campaig Tour

109 Step 3: Examiig TourCampaig1: Simple Baer Ad 5. Sigle-click TourCampaig1 file. The descriptio explais that i the Web applicatio, a baer ad will be displayed if a customer belogig to the Affluet Mr/Ms Fix-It or Cotractor customer segmets has logged i. We will try the logi accouts o the sample JSP templates later. For ow, though, let s look at the defiitios related to TourCampaig1. 6. Double-click o TourCampaig1. I a few secods, a editor widow is displayed, as show i Figure 7-4. Figure 7-4 Campaig Editor Widow 7. Click the Start/Stop bar. I the Start/Stop pae, otice the existig start ad stop dates for the campaig. The Ed Criteria sectio of the pae is where you ca set goals that, whe met, will stop the campaig prior to its ed date. Goals are either based o ad impressios (whe a visitor simply views a ad o a Web page) or ad clickthroughs (whe a visitor actually clicks a displayed ad). You determie the umber of impressios or clickthroughs required to meet the goal ad ed the campaig. I TourCampaig1, this goal is set to 25 ad impressios. 8. To get a closer look at the goal setup, click Edit. The Goal Detail widow is displayed, as show i Figure 7-5. JSP Commerce ad Campaig Tour 7-7

110 7 A Sample Campaig Figure 7-5 Ed Criteria Detail Widow Notice how this particular campaig is specifyig two baer ad graphics that will be displayed. O this scree, the busiess aalyst or marketig professioal ca set the target umber ad characteristics for the campaig, the goal scope, ad the goal type. 9. Click the OK or Cacel butto o the Ed Criteria Detail widow. Back o the Editor widow for TourCampaig1, click the Start/Stop bar agai to miimize it. 10. Click the Scearios bar to expad its pae. The Ad Sceario for Campaig is listed i the pae. 11. Click the magifyig glass ext to the ame of the sceario to show the sceario details, as show i Figure JSP Commerce ad Campaig Tour

111 Step 3: Examiig TourCampaig1: Simple Baer Ad Figure 7-6 Details Display for Ad Sceario for Campaig Agai, a sceario is the primary buildig-block of campaigs. A sceario is composed of oe or more sceario actios, all of which take place if their criteria are met: if a particular evet occurs or if a customer is part of a specified customer segmet As you ca see, two actios are defied for this sceario. The sceario occurs if: The Web site visitor who has just logged i is part of the Affluet Mr/Ms Fixit customer segmet. Or if the Web site visitor who has just logged i is part of the Cotractor customer segmet As you will recall from a earlier chapter i the tour, the ewuser.jsp template icludes a ewdemographictemplate.ic file. It cotais form fields that allow the perso registerig with the Web site to characterize themselves i oe of several categories. Figure 7-7 shows a portio of the Demographic Optios o the ewuser.jsp: JSP Commerce ad Campaig Tour 7-9

112 7 A Sample Campaig Figure 7-7 Demographic Optios from ewuser.jsp Template For the sample campaigs, there are two registered customers you eed to kow about: Sue Carpeter: userame is suecarpeter; password is password. Whe she registered with the site, Sue s demographic characteristics icluded Professioal ad the salary rage off $125,000 ad above. This puts Sue i the Cotractor customer segmet that is defied i the E-Busiess Cotrol Ceter. Bob Smith: userame is bobsmith; password is password. Whe he registered with the site, Bob s demographic characteristics icluded Do It Yourselfer ad the salary rage of $100,000 to $149,999. This puts Bob i the Affluet Mr/Ms Fixup customer segmet that is defied i the E-Busiess Cotrol Ceter. Notice how o the iitial mai.jsp template for the ruig Web applicatio, before loggig i as ay user, the default baer graphics are: tourbaer1.gif (top baer that icludes the text Experiece Campaigs! tourside01.gif (side baer that icludes the text Register Now... ) Figure 7-8 shows the iitial display for the sample Web applicatio: 7-10 JSP Commerce ad Campaig Tour

113 Step 3: Examiig TourCampaig1: Simple Baer Ad Figure 7-8 Iitial Display for the Web Applicatio The tourbaer1.gif ad tourside01.gif images are default images. The placeholder JSP tag is simply: <ph:placeholder ame="<%= baer %>" /> To experiece the first sample campaig ad see what the Web visitor will see, let s access the Web applicatio i a browser: (if the server is ruig locally) Or: (substitute the machie ame o which the server is ruig i the <wl-host> parameter). For example: Click the Log I lik i the horizotal avigatio sectio of mai.jsp. JSP Commerce ad Campaig Tour 7-11

114 7 A Sample Campaig Whe you arrive o the logi.jsp template, log i as: Userame: suecarpeter Password: password If you etered Sue s userame ad password correctly, otice the chages whe you arrive back o the mai.jsp template. Figure 7-9 shows the sample display. Figure 7-9 Mai.jsp Display for Logged-i User Sue Carpeter Sue is i the Cotractor customer segmet. Notice the targeted Cotractor s Joural ad is ow used i the baer. The image file ame is tourbaerjoural.gif. Let s go back to the E-Busiess Cotrol Ceter. 1. O the Editor widow for TourCampaig1, i the Scearios sectio, click i the secod actio that refereces the Cotractor customer segmet, as show i Figure JSP Commerce ad Campaig Tour

115 Step 3: Examiig TourCampaig1: Simple Baer Ad Figure 7-10 Actio that Refereces Cotractor Customer Segmet 2. With that actio highlighted, click the Edit butto. O the Ad Actio widow, click the ad search lik show i Figure JSP Commerce ad Campaig Tour 7-13

116 7 A Sample Campaig Figure 7-11 Notice the ad search lik o the Ad Actio Widow 3. Click the ad search lik. Figure 7-12 shows the Ad Search widow. 4. If you are prompted to log o, eter the followig: Userame: system Password: weblogic The password is set whe WebLogic Server is istalled. Ask your system admiistrator for the proper password. You ca also have your system admiistrator add you to the Admiistrators group i the WebLogic Portal Admiistratio Tools. The you ca use your ormal userame ad password JSP Commerce ad Campaig Tour

117 Step 3: Examiig TourCampaig1: Simple Baer Ad Figure 7-12 Ad Search Widow Of course, you ca ow see the tourbaerjoural.gif image that is associated with customers i the Cotractor customer segmet, as defied i the TourCampaig1. If you wat, you ca highlight the item i the Descriptors row to see how the Preview fuctio works. O the Web applicatio, you ca log out as Sue Carpeter ad the log i as Bob Smith. (The userame is bobsmith ad the password is password.) Bob is i the Affluet Mr/Ms Fixup customer segmet. Figure 7-13 shows the mai.jsp display for the logged i Bob Smith. JSP Commerce ad Campaig Tour 7-15

118 7 A Sample Campaig Figure 7-13 Mai.jsp Display for Logged I User Bob Smith As you ca see, the targeted baer ad for Bob Smith is usig the tourbaerfixup.gif image. You ca cofirm this i the E-Busiess Cotrol Ceter by followig the sceario actio that refereces the Affluet Mr/Ms Fixup customer segmet. After you create a ew placeholder i the E-Busiess Cotrol Ceter, a CBE must use a special tag (the <ph:placeholder> JSP tag) i the locatio that you wat to display ads. For example, if you create a placeholder to display ads i the top baer, a CBE must add a <ph:placeholder> tag to the top baer JSP Commerce ad Campaig Tour