758
Content Server Enterprise Edition Version: 5.5.1 Developer’s Guide Document Revision Date: May 5, 2004

Content Server Enterprise Edition_developer

Embed Size (px)

DESCRIPTION

man

Citation preview

  • Content Server Enterprise EditionVersion: 5.5.1

    Developers Guide

    Document Revision Date: May 5, 2004

  • FATWIRE, INC. PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. In no event shall FatWire be liable for any loss of profits, loss of business, loss of use of data, interruption of business, or for indirect, special, incidental, or consequential damages of any kind, even if FatWire has been advised of the possibility of such damages arising from this publication. FatWire may revise this publication from time to time without notice. Some states or jurisdictions do not allow disclaimer of express or implied warranties in certain transactions; therefore, this statement may not apply to you.

    Copyright 2003 FatWire, inc. All rights reserved.

    This product may be covered under one or more of the following U.S. patents: 4477698, 4540855, 4720853, 4742538, 4742539, 4782510, 4797911, 4894857, 5070525, RE36416, 5309505, 5511112, 5581602, 5594791, 5675637, 5708780, 5715314, 5724424, 5812776, 5828731, 5909492, 5924090, 5963635, 6012071, 6049785, 6055522, 6118763, 6195649, 6199051, 6205437, 6212634, 6279112 and 6314089. Additional patents pending.

    FatWire, Content Server, Content Server Bridge Enterprise, Content Server Bridge XML, Content Server COM Interfaces, Content Server Desktop, Content Server Direct, Content Server Direct Advantage, Content Server DocLink, Content Server Engage, Content Server InSite Editor, Content Server Satellite, and Transact are trademarks or registered trademarks of FatWire, inc. in the United States and other countries.

    iPlanet, Java, J2EE, Solaris, Sun, and other Sun products referenced herein are trademarks or registered trademarks of Sun Microsystems, Inc. AIX, IBM, WebSphere, and other IBM products referenced herein are trademarks or registered trademarks of IBM Corporation. WebLogic is a registered trademark of BEA Systems, Inc. Microsoft, Windows and other Microsoft products referenced herein are trademarks or registered trademarks of Microsoft Corporation. UNIX is a registered trademark of The Open Group. Any other trademarks and product names used herein may be the trademarks of their respective owners.

    This product includes software developed by the Apache Software Foundation (http://www.apache.org/) and software developed by Sun Microsystems, Inc. This product contains encryption technology from Phaos Technology Corporation.

    You may not download or otherwise export or reexport this Program, its Documentation, or any underlying information or technology except in full compliance with all United States and other applicable laws and regulations, including without limitations the United States Export Administration Act, the Trading with the Enemy Act, the International Emergency Economic Powers Act and any regulations thereunder. Any transfer of technical data outside the United States by any means, including the Internet, is an export control requirement under U.S. law. In particular, but without limitation, none of the Program, its Documentation, or underlying information of technology may be downloaded or otherwise exported or reexported (i) into (or to a national or resident, wherever located, of) Cuba, Libya, North Korea, Iran, Iraq, Sudan, Syria, or any other country to which the U.S. prohibits exports of goods or technical data; or (ii) to anyone on the U.S. Treasury Departments Specially Designated Nationals List or the Table of Denial Orders issued by the Department of Commerce. By downloading or using the Program or its Documentation, you are agreeing to the foregoing and you are representing and warranting that you are not located in, under the control of, or a national or resident of any such country or on any such list or table. In addition, if the Program or Documentation is identified as Domestic Only or Not-for-Export (for example, on the box, media, in the installation process, during the download process, or in the Documentation), then except for export to Canada for use in Canada by Canadian citizens, the Program, Documentation, and any underlying information or technology may not be exported outside the United States or to any foreign entity or foreign person as defined by U.S. Government regulations, including without limitation, anyone who is not a citizen, national, or lawful permanent resident of the United States. By using this Program and Documentation, you are agreeing to the foregoing and you are representing and warranting that you are not a foreign person or under the control of a foreign person.

    CSEE Developers GuideDocument Revision Date: May 5, 2004Product Version: 5.5.1

    FatWire Technical SupportWeb: http://www.fatwire.com/Support

    FatWire HeadquartersFatWire, inc.330 Old Country RoadSuite 207Mineola, NY 11501Web: www.fatwire.com

    http://www.fatwire.com/Support/index.htmlwww.fatwire.com

  • Table of

    ContentsSection 1: Overview

    1 Overview of Content Server Enterprise Edition . . . . . . . . . . . . . . . . . . . . . . .25Content Server Enterprise Edition (CSEE). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

    CSEE Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Additional Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27J2EE Standard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27CSEE Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

    Content Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Servlets and Java APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Modular Page Design and Page Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Content Server Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Resultset Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Sessions and Cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Security and User Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Content Server Enterprise Edition and Publishing. . . . . . . . . . . . . . . . . . . . . . . . 33Search Engines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Content Server Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Revision Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

    CS-Satellite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Handling the HTTP Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34CS-Satellite Servlets and APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

    CS-Direct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Basic Asset Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Sites and the Site Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

  • CSEE Developers Guide The Burlington Financial Sample Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37The HelloAssetWorld Sample Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Template, CSElement, and SiteEnty Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Custom CS-Direct XML and JSP Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Approval and Publishing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37CS-Direct and Revision Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Additional Interfaces for Working with Assets . . . . . . . . . . . . . . . . . . . . . . . . . . 39Searching and Search Engines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

    CS-Direct Advantage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Flex Asset Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Assetsets and Searchstates: Searching the Online Site. . . . . . . . . . . . . . . . . . . . . 41Shopping Carts and Commerce Context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41The GE Sample Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Custom CS-Direct Advantage XML and JSP tags . . . . . . . . . . . . . . . . . . . . . . . . 42

    Commerce Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42CS-Engage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

    Visitor Data and Segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Promotions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Persistent, Linked Visitor Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Custom CS-Engage XML and JSP tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    Analysis Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

    2 CSEE Development Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47Step 1: Set Up the Team . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Step 2: Create Functional and Design Specifications . . . . . . . . . . . . . . . . . . . . . . . . . 49

    Functional Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Page Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Caching Strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Security Strategy (Access Control) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Separate Format from Content (Elements from Assets). . . . . . . . . . . . . . . . . . . . 50Data Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

    Step 3: Set Management System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Step 4: Implement the Data Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Step 5: Build the Online Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Step 6: Set Up the Management System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    Import Content as Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Import Catalog Data and Flex Asset Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Instruct the Editorial Team About Site Design . . . . . . . . . . . . . . . . . . . . . . . . . . 54

    Step 7: Set Up the Delivery System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Step 8: Publish to the Delivery System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554

  • Table of ContentsSection 2: Programming Basics

    3 Programming with CSEE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59Choosing a Coding Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60The Content Server Context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

    The ICS Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60The FTCS tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

    CSEE JSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61CSEE Standard Beginning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61JSP Implicit Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Declarations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Scriptlets and Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65JSP Directives. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65CSEE Tag Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

    CSEE XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68CSEE Standard Beginning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68XML Entities and Reserved Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69XML Parsing Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

    CSEE Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Tags That Create the Content Server Context . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Tags That Handle Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Tags That Call Pages and Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Tags That Create URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Tags That Control Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Tags That Set Cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Programming Construct Tags. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76Tags That Manage Compositional and Approval Dependancies . . . . . . . . . . . . . 76Tags That Retrieve Information About Basic Assets . . . . . . . . . . . . . . . . . . . . . . 77Tags That Create Assetsets (Flex Assets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Tags That Create Searchstates (Flex Assets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

    Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Reserved Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83PageCriteria Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Setting Regular Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Setting Session Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Working With Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Variables and Precedence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Best Practices with Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

    Other CSEE Storage Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Built-ins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

    Values for Special Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 935

  • CSEE Developers Guide 4 Page Design and Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95Modular Page Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95CSEE Caching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

    Content Server Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97BlobServer and Caching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97CS-Satellite Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

    Viewing the Contents of the CS-Satellite Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . 102CacheManager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103The SiteCatalog Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104The Cache Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Caching Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105CS-Satellite Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

    Double-Buffered Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Implementing Double-Buffered Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Setting cacheinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Coding for Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Caching and Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

    5 CSEE Tools and Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117Content Server Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117

    Connecting to a Content Server Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118CatalogMover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119

    Starting CatalogMover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Connecting to CSEE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120CatalogMover Menu Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Exporting Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Importing Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

    Property Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Starting the Property Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Setting Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Merging Property Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

    Page Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128XMLPost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129

    6 Sessions and Cookies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131What Is a Session? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Session Lifetime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

    Session Variables Maintained by Content Server . . . . . . . . . . . . . . . . . . . . . . . 132Logging In and Logging Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

    Sessions Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133FeelingsForm Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133SetFeeling Element. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Meat Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134

    What Is a Cookie? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1356

  • Table of ContentsCookieServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Cookie Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

    Cookie Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Start.xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136ColorForm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136CreateCookie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137DisplayWelcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Running the Cookie Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

    Tips and Tricks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138CS-Satellite Session Tracking. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

    Flushing Session Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

    7 Error Logging and Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

    Error Log File Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Additional Error Message Locations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146XML Syntax and Runtime Error Checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

    Debugging Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147Using Error Codes with Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

    Tag Examples Using Error Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Error Number Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

    Using the Page Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Invoking the Page Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151Page Debugger Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

    Debugging CSEE Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Debugging Content Server Engage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Error Logging on CS-Satellite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Startup Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Property Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159Error Logging on Analysis Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160

    Section 3: Data Design

    8 Data Design: The Asset Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163Asset Types and Asset Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

    Two Data Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Default (Core) Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

    The Basic Asset Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Basic Asset Types from the Burlington Financial Sample Site . . . . . . . . . . . . . 168Relationships Between Basic Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Category, Source, and Subtype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Basic Asset Types and the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172

    The Flex Asset Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1777

  • CSEE Developers Guide The Flex Family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Sample Site Flex Families . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179Flex Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Flex Parents and Flex Parent Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Flex Assets and Flex Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Flex Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Flex Families and the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186

    Assetsets and Searchstates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Search Engines and the Two Asset Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Tags and the Two Asset Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Summary: Basic and Flex Asset Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

    Where the Asset Models Intersect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Where the Asset Models Differ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

    Summary: Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193

    9 The CSEE Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195Sites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

    Developers and the CSEE Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Sites and the Site Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Sites and the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

    10 The Content Server Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201Types of Database Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

    Object Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Tree Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Foreign Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204System Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Identifying a Tables Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206

    Types of Columns (Fields) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Generic Field Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207Database-Specific Field Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Indirect Data Storage with the Content Server URL Field. . . . . . . . . . . . . . . . . 209

    Creating Database Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Creating Object Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210Creating Tree Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212Creating Content Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Registering a Foreign Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

    How Information Is Added to the System Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . 216Property Files and Remote Databases. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

    Property Files for Remote Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218Accessing the Property File for a Remote Database . . . . . . . . . . . . . . . . . . . . . 218

    11 Managing Data in Non-Asset Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219Methods and Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220

    Writing and Retrieving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2208

  • Table of ContentsQuerying for Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222Lists and Listing Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222

    Coding Data Entry Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Adding a Row. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224Deleting a Row. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227Querying a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230Querying a Table with an Embedded SQL Statement . . . . . . . . . . . . . . . . . . . . 238

    Managing the Data Manually . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243Deleting Non-Asset Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243

    12 Resultset Caching and Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

    Database Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246How Resultset Caching Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246Reducing the Load on the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

    How Content Server Identifies a Resultset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247Specifying the Table Name. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

    SELECTTO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248EXECSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248CALLSQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Search Forms in the Content Server Interface . . . . . . . . . . . . . . . . . . . . . . . . . . 249Query Asset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249SEARCHSTATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

    Flushing the Resultset Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Enabling Resultset Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

    Table-Specific Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Planning Your Resultset Caching Strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

    Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251

    13 Designing Basic Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253The AssetMaker Utility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

    How AssetMaker Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254Asset Descriptor Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Columns in the Asset Types Database Table . . . . . . . . . . . . . . . . . . . . . . . . . . 257Elements and SQL Statements for the Asset Type. . . . . . . . . . . . . . . . . . . . . . . 260

    Creating Basic Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265Step 1: Code the Asset Descriptor File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266Step 2: Upload the Asset Descriptor File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274Step 3: Configure the Asset Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276Step 4: Enable the Asset Type on Your Site . . . . . . . . . . . . . . . . . . . . . . . . . . . 277Step 5: Fine-Tune the Asset Descriptor File . . . . . . . . . . . . . . . . . . . . . . . . . . . 278Step 6: (Optional) Customize the Asset Type Elements . . . . . . . . . . . . . . . . . . 278Step 7: (Optional) Configure Subtypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2809

  • CSEE Developers Guide Step 8: (Optional) Configure Association Fields . . . . . . . . . . . . . . . . . . . . . . . . 281Step 9: (Optional) Configure Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Step 10: (Optional) Configure Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284Step 11: (Optional) Add Mimetypes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Step 12: (Optional) Edit Search Elements to Enable Indexed Search . . . . . . . . 286Step 13: Code Templates for the Asset Type . . . . . . . . . . . . . . . . . . . . . . . . . . . 286Step 14: Move the Asset Types to Other Systems . . . . . . . . . . . . . . . . . . . . . . . 286

    Deleting Basic Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287Images and eWebEditPro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

    14 Designing Flex Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289Design Tips for Flex Families. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290

    Visitors on the Delivery System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Users on the Management System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290How Many Attribute Types Should You Create? . . . . . . . . . . . . . . . . . . . . . . . 291Designing Flex Attributes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291How Many Definition Types Should You Create? . . . . . . . . . . . . . . . . . . . . . . 293Designing Parent Definition and Flex Definition Assets . . . . . . . . . . . . . . . . . . 293Summary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

    The Flex Family Maker Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295The Flex Asset Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295

    Creating a Flex Asset Family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Step 1: Create a Flex Family or a New Flex Family Member . . . . . . . . . . . . . . 297Step 2: Enable the New Flex Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299Step 3: Create Flex Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300Step 4: (optional) Create Flex Filter Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304Step 5: Create Parent Definition Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307Step 5: Create Flex Definition Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309Step 6: Create Flex Parent Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311Step 8: Code Templates for the Flex Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . 313Step 9: Test Your Design (Create Test Flex Assets) . . . . . . . . . . . . . . . . . . . . . 313Step 10 (optional): Create Flex Asset Associations . . . . . . . . . . . . . . . . . . . . . . 313Step 11: Move the Asset Types to Other Systems . . . . . . . . . . . . . . . . . . . . . . . 314

    Editing Flex Attributes, Parents, and Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Editing Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Editing Parent Definitions and Flex Definitions . . . . . . . . . . . . . . . . . . . . . . . . 315Editing Parents and Flex Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315

    Using Product Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316What Is a Product Set? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316Creating Product Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316

    Custom Filter Classes or Transformation Engines . . . . . . . . . . . . . . . . . . . . . . . . . . 317Registering a New Filter Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Registering a New Transformation Engine . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31710

  • Table of Contents15 Designing Attribute Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320

    The presentationobject.dtd File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321The Attribute Editor Asset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323The Attribute Editor Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330

    Creating Attribute Editors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Customizing Attribute Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335

    Example: Customized Attribute Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335Editing Attribute Editors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

    16 Importing Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341The XMLPost Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

    Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342XMLPost Configuration Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

    Configuration Properties for XMLPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344Configuration Properties for the Posting Element . . . . . . . . . . . . . . . . . . . . . . . 347Configuration Properties for the Source Files . . . . . . . . . . . . . . . . . . . . . . . . . . 350Action Variable Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354Sample XMLPost Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354

    XMLPost Source Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356Sample XMLPost Source File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356XMLPost and File Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

    Using the XMLPost Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358Running XMLPost from the Command Line. . . . . . . . . . . . . . . . . . . . . . . . . . . 358Running XMLPost as a Batch Process. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360Running XMLPost Programmatically . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360

    Customizing RemoteContentPost and PreUpdate. . . . . . . . . . . . . . . . . . . . . . . . . . . 361Setting a Field Value Programmatically. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Setting an Asset Association . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362

    Troubleshooting XMLPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363Debugging the Posting Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

    17 Importing Flex Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .365Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

    Importing the Data Structure Flex Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . 366Importing the Flex Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366Importing Flex Assets: The Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366

    XMLPost and the Flex Asset Model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Internal Names vs. External Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368

    Importing the Structural Asset Types in the Flex Model . . . . . . . . . . . . . . . . . . . . . 369Attribute Editors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369Flex Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371Flex Definitions and Flex Parent Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . 375Flex Parents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37911

  • CSEE Developers Guide Importing Flex Assets with XMLPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380Configuration File Properties and Source File Tags for Flex Assets . . . . . . . . . 381Sample Flex Asset Configuration File for addData . . . . . . . . . . . . . . . . . . . . . . 384Sample Flex Asset Source File for addData. . . . . . . . . . . . . . . . . . . . . . . . . . . . 386Sample Flex Asset Configuration File for RemoteContentPost. . . . . . . . . . . . . 389Sample Flex Asset Source File for RemoteContentPost . . . . . . . . . . . . . . . . . . 390

    Editing Flex Assets with XMLPost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Configuration Files for Editing Flex Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . 392Source Files for Editing Flex Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392

    Deleting Assets with XMLPost. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Configuration Files for Deleting Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Source Files for Deleting Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395

    18 Importing Flex Assets with the BulkLoader Utility . . . . . . . . . . . . . . . . . . . .397Overview of BulkLoader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

    BulkLoader Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397How BulkLoader Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398Using the BulkLoader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399

    Importing Flex Assets from Flat Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399Step 1: Use XMLPost to Import Structural Assets. . . . . . . . . . . . . . . . . . . . . . . 400Step 2: Create the Input Table (Data Source). . . . . . . . . . . . . . . . . . . . . . . . . . . 401Step 3: Create the Mapping Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Step 4: Create the BulkLoader Configuration File. . . . . . . . . . . . . . . . . . . . . . . 404Step 5: Run the BulkLoader Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411Step 6: Review Feedback Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412Step 7: Approve and Publish the Assets to the Delivery System. . . . . . . . . . . . 412

    Importing Flex Assets Using a Custom Extraction Mechanism. . . . . . . . . . . . . . . . 412IDataExtract Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413IPopulateDataSlice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417IFeedback Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

    Approving Flex Assets with the BulkApprover Utility . . . . . . . . . . . . . . . . . . . . . . 422Creating a Configuration File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422Using BulkApprover . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

    Section 4: Site Development

    19 Creating Template, CSElement, and SiteEntry Assets. . . . . . . . . . . . . . . . .427Pages, Pagelets, and Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

    Elements, Pagelets, and Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Calling Pages and Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Page vs. Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429

    CSElement, Template, and SiteEntry Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430Template Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43112

  • Table of ContentsCSElement Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432SiteEntry Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432What About Non-Asset Elements?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

    Creating CSElement Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433Step 1: Name and Describe the CSElement Asset . . . . . . . . . . . . . . . . . . . . . . . 433Step 2: Configure the Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435Step 3: Save and Inspect the CSElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

    Creating SiteEntry Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438Creating Template Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441

    Step 1: Name and Describe the Template Asset . . . . . . . . . . . . . . . . . . . . . . . . 441Step 2: Configure the Page Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443Step 3: Configure the Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444Step 4: Save and Inspect the Template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445

    Managing Template, CSElement, and SiteEntry Assets. . . . . . . . . . . . . . . . . . . . . . 447Designating Default Approval Templates (Export to Disk Only) . . . . . . . . . . . 447Editing Template, CSElement, and SiteEntry Assets. . . . . . . . . . . . . . . . . . . . . 448Sharing Template, CSElement, and SiteEntry Assets . . . . . . . . . . . . . . . . . . . . 448Deleting Template, CSElement, and SiteEntry Assets. . . . . . . . . . . . . . . . . . . . 448Previewing Template, CSElement, and SiteEntry Assets . . . . . . . . . . . . . . . . . 449

    20 Creating Collection, Query, Stylesheet, and Page Assets . . . . . . . . . . . . . .451Previewing Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452Approving Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452Sharing Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Deleting Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Collection Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

    Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454Creating Collection Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 455Sharing Collection Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456

    Query Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Query Assets and Other Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456How the Query Is Stored . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456Commonly Used Fields for Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457Before You Begin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459Creating Query Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459Sharing Query Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Previewing and Approving Query Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461

    Stylesheet Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Creating Stylesheet Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462Sharing Stylesheet Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463

    Page Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463Creating a Page Asset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Placing Page Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466Moving Page Assets in the Site Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46713

  • CSEE Developers Guide Placing Page Assets and Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468Editing Page Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468Deleting Page Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468

    21 Coding Elements for Templates and CSElements . . . . . . . . . . . . . . . . . . . .469About Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470

    The Publishing System and Approval Dependencies. . . . . . . . . . . . . . . . . . . . . 470Page Generation and Compositional Dependencies. . . . . . . . . . . . . . . . . . . . . . 474

    About Coding to Log Dependencies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475ASSET.LOAD and asset:load . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475The ASSETSET (assetset) Tag Family . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476RENDER.GETPAGEURL and render:getpageurl . . . . . . . . . . . . . . . . . . . . . . . 477RENDER.LOGDEP (render:logdep) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477RENDER.FILTER and render:filter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478RENDER.UNKNOWNDEPS and render:unknowndeps. . . . . . . . . . . . . . . . . . 479

    Calling CSElement and SiteEntry Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479Coding Elements that Display Basic Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480

    Assets That Represent Simple Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482ImageFile Assets or Other Blob Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483Basic Assets That Can Have Embedded Links . . . . . . . . . . . . . . . . . . . . . . . . . 483Collections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483Query Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485Page Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487

    About Coding Elements that Display Flex Assets . . . . . . . . . . . . . . . . . . . . . . . . . . 489Assetsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489Searchstates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490Assetsets, Searchstates, and Flex Attribute Types . . . . . . . . . . . . . . . . . . . . . . . 491Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491

    Coding Templates That Display Flex Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492Example Data Set for the Examples in This Section . . . . . . . . . . . . . . . . . . . . . 492Examples of Assetsets with One Product (Flex Asset) . . . . . . . . . . . . . . . . . . . 493Special Cases: Flex Attributes of Type Text, Blob, and URL . . . . . . . . . . . . . . 495Examples of Assetsets with More Than One Product (Flex Asset) . . . . . . . . . . 498

    Creating URLs for Hyperlinks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503RENDER.GETPAGEURL (render:getpageurl) . . . . . . . . . . . . . . . . . . . . . . . . . 503RENDER.SATELLITEBLOB (render:satelliteblob). . . . . . . . . . . . . . . . . . . . . 504RENDER.GETBLOBURL (render:getbloburl) . . . . . . . . . . . . . . . . . . . . . . . . . 505Using the referURL Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505

    Handling Error Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506Using the Errno Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 506Ensuring that Incorrect Pages Are Not Cached . . . . . . . . . . . . . . . . . . . . . . . . . 507

    22 Template Element Examples for Basic Assets . . . . . . . . . . . . . . . . . . . . . . .509Example 1: Basic Modular Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51014

  • Table of ContentsFirst Element: Home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 511Second Element: MainStoryList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512Third Element: LeadSummary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Fourth Element: TeaserSummary. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Back to LeadSummary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514Back to MainStoryList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514Back to Home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515

    Example 2: Coding Links to the Article Assets in a Collection Asset . . . . . . . . . . . 515First element: SectionFront . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515Second element: PlainList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516

    Example 3: Using the ct Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518First Element: SectionFront . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519Second Element: TextOnlyLink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519ColumnistFront. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520

    Example 4: Coding Templates for Query Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . 521First Element: Home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521Second Element: WireFeedBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Third Element: ExecuteQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Back to WireFeedBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523

    Example 5: Displaying an Article Asset Without a Template . . . . . . . . . . . . . . . . . 524First Element: Full . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Second Element: AltVersionBlock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Third Element: EmailFront. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525

    Example 6: Displaying Site Plan Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526First Element: Home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Second Element: SiteBanner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Third Element: TopSiteBar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Back to SiteBanner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

    Example 7: Displaying Non-Asset Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529First Element: Home. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Second Element: ShowMainDate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

    23 User Management on the Delivery System . . . . . . . . . . . . . . . . . . . . . . . . . .531The Directory Services API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531

    Entries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532Directory Services Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532Directory Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536Troubleshooting Directory Services Applications . . . . . . . . . . . . . . . . . . . . . . . 536

    Controlling Visitor Access to Your Online Sites . . . . . . . . . . . . . . . . . . . . . . . . . . . 537ACL Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538User Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538Content Server and Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53915

  • CSEE Developers Guide Creating Login Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Prompt for Login (PromptForLogin.xml) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Root Element for the Login Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540

    Creating User Account Creation Forms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541PromptForNewAccount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541Root Element for the CreateAccount Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542

    Visitor Access in the Burlington Financial Sample Site. . . . . . . . . . . . . . . . . . . . . . 545Membership Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Users and Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Member Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545Membership Processing Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545

    Visitor Management and Commerce Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . 547Using an SSL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547Visitor Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547Secure Session Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547Single Sign-on for Visitors. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548

    24 Commerce Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .553What Is an Online Store? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553What Is Transact? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554What Is Commerce Connector? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554

    Installing Commerce Connector and Configuring a Store . . . . . . . . . . . . . . . . . 555Using Content Server with an SSL Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

    What Is a Shopping Cart? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556What Does a Shopping Cart Do? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556What Is the Commerce Context? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556Working with Shopping Carts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557

    Visitor Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560Secure Session Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560

    Troubleshooting Shopping Carts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561Checking the .jar File and Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561Verifying TRANSACT.INI Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561

    25 The HelloAssetWorld Sample Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .565Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566

    HelloAssetWorld Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566HelloAssetWorld Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

    Modified Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567The HelloArticle Asset Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567The HelloImage Asset Type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568

    HelloAssetWorld Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570The HelloArticle Template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570The HelloCollection Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573The HelloPage Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

    The HelloQuery Asset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57816

  • Table of Contents26 The Portal Sample Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .579Portal Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579Portal Namespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581Caching Strategy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582Portal Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582

    The main.xml Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583Populating the Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584The Other Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585

    The CacheManager Samples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586Logging Cache Dependancies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586Logging Into the CacheManager Sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586Editing An Article . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586Viewing the Contents of the Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590

    27 The Burlington Financial Sample Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .593Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594Navigation Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595

    Breadcrumbs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596Best Practices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

    Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597Hot Topics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597Topic Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598Related Stories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599Text-Only Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600Plain Text Parallel Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600E-mail This Story . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600AssetMaker Asset Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601Mimetype . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601Collections of Collections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601Membership . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602Wire Feed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602Featured Funds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602Fund Finder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603Page Cache Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603

    Section 5: Management System Features

    28 Customizing the User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .607Overview of theTree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

    Loading the Tree Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608Refreshing the Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615

    Trees and Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61617

  • CSEE Developers Guide Tree Error Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616

    29 Coding for the InSite Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .617Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618The INSITE.EDIT Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620

    Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621Supported Data Types and Input Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622

    Template Element Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622Example for Basic Asset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623Example for Flex Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624Example for an Attribute of Type Blob . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625

    30 Customizing Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .627Workflow Step Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627Workflow Actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629

    Step Action Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630Timed Action Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632Deadlock Action Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634Group Deadlock Action Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637Delegation Action Elements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639

    Section 6: CS-Bridge XML

    31 Overview of CS-Bridge XML . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .643Software Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644Document Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645Configuration Steps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647

    32 Processing XML Documents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .649Authenticating Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

    Passing User Name and Password in a Query String . . . . . . . . . . . . . . . . . . . . . 650Passing User Name and Password via Basic Authentication . . . . . . . . . . . . . . . 651

    Posting to the Inbound Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653Posting to the Inbound Queue Using Query String Authentication . . . . . . . . . . 653Posting to the Inbound Queue Using Basic Authentication . . . . . . . . . . . . . . . . 654Inbound Queue Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655

    Configuring the Partner Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655Controlling DTD Validation and Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657

    Controlling DTD Validation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657Controlling DTD Caching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657

    Creating a Document Handler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658Example: Document Handler Element. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65918

  • Table of ContentsPosting to the Outbound Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660Passing Parameters to the Outbound Queue. . . . . . . . . . . . . . . . . . . . . . . . . . . . 662Outbound Queue Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663

    Configuring the Event Handler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663Using the XML Parser and XSLT Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666

    Section 7: Web Services

    33 Overview of Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .669What Are Web Services? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669SOAP and Web Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670Supported SOAP Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670Supported WSDL Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670Related Programming Technologies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670

    34 Creating and Consuming Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . .673Using Predefined Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674

    Accessible Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674WSDL File Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674Process Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Consider Your Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Generating the Client Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675Writing Client Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675

    Creating Custom Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676Process Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676Consider Your Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676Creating a Content Server Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 677Writing a Content Server Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678Creating a WSDL File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679

    Consuming Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681Locating the Web Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681Gathering Information from the Remote WSDL File . . . . . . . . . . . . . . . . . . . . 681Providing Information to Content Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681

    Section 8: CS-Engage

    35 Creating Visitor Data Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .685About Visitor Data Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685

    Visitor Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686History Attributes and History Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686Segments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68619

  • CSEE Developers Guide Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687Transact Visitor Data Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687Developing Visitor Data Assets: Process Overview . . . . . . . . . . . . . . . . . . . . . 687

    Creating Visitor Data Assets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688Creating Visitor Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688Creating History Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691Creating History Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694

    Verifying Your Visitor Data Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696Approving Visitor Data Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696

    36 Recommendation Assets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .697Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697

    Development Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698Creating a Dynamic List Element. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699

    37 Coding CS-Engage Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .701Commerce Context and Visitor Context . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702Identifying Visitors and Linking Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702

    About Commerce and Access IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703Example: Session Linking with Cookies and Transact IDs . . . . . . . . . . . . . . . . 703Coding Site Pages That Identify Visitors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705

    Collecting Visitor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707About the Transact Visitor Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708Coding Site Pages That Collect Visitor Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 709

    Templates and Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711Creating Templates for Recommendations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712

    Shopping Carts and CS-Engage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713Debugging Site Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 713

    Session Links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Visitor Data Collection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714Recommendations and Promotions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714

    Section 9: Analysis Connector

    38 Overview of Analysis Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .719What Is Analysis Connector? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719

    Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720How It Works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720

    Planning for Analysis Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720Implementing Analysis Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721

    39 Using Analysis Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .723The Default Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72320

  • Table of ContentsThe cart_event Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724The orders Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724The order_item Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725The shopper Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725The shopper_map Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 726

    Creating Data Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727Storing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727Retrieving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728DatabaseLoader. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

    40 Analysis Connector Pages and Elements . . . . . . . . . . . . . . . . . . . . . . . . . . .731Analysis Connector Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731

    The OpenMarket/CommerceData/ACCreateTables Page Entry . . . . . . . . . . . . 732The OpenMarket/CommerceData/GetCommerceData Page Entry . . . . . . . . . . 732The OpenMarket/CommerceData/ACUpgradeTables Page Entry. . . . . . . . . . . 733

    Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733Retrieval Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 734OpenMarket/CommerceData/WriteExampleData . . . . . . . . . . . . . . . . . . . . . . . 735

    Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73921

  • CSEE Developers Guide 22

  • Sec t ion 1

    OverviewThis section provides an overview of the Content Server Enterprise Edition (CSEE) products, and the development process. It contains the following chapters:

    Chapter 1, Overview of Content Server Enterprise Edition

    Chapter 2, CSEE Development Process23

  • CSEE Developers Guide 24

  • Chapter 1

    Overview of Content Server Enterprise EditionThe Content Server Enterprise Edition (CSEE) product family is a high-performance, large-scale content management and delivery system. You and your development team use CSEE to cre