MACROMEDIA DRUMBEAT 2000 ECOMMERCE EDITION User manual

Users Guide
macromedia®
DRUMBEAT™2000
eCOMMERCE
EDITION

2
Trademarks
Macromedia, the Macromedia logo, the Made With Macromedia logo, Authorware, Backstage, Director, Extreme 3D, and Fontographer
are registered trademarks, and Afterburner, AppletAce, Authorware Interactive Studio, Backstage, Backstage Designer, Backstage Desktop
Studio, Backstage Enterprise Studio, Backstage Internet Studio, DECK II, Director Multimedia Studio, Doc Around the Clock,
Drumbeat, Extreme 3D, Flash, FreeHand, FreeHand Graphics Studio, Lingo, Macromedia xRes, MAGIC, Power Applets, Priority
Access, SoundEdit, ShockRave, Shockmachine, Shockwave, Showcase, Tools to Power Your Ideas and Xtra are trademarks of
Macromedia, Inc. Other product names, logos, designs, titles, words or phrases mentioned within this publication may be trademarks,
servicemarks, or tradenames of Macromedia, Inc. or other entities and may be registered in certain jurisdictions.
Apple Disclaimer
APPLE COMPUTER, INC. MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, REGARDING THE ENCLOSED
COMPUTER SOFTWARE PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY PARTICULAR PURPOSE.
THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY
NOT APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC LEGAL RIGHTS. THERE MAY BE OTHER
RIGHTS THAT YOU MAY HAVE WHICH VARY FROM STATE TO STATE.
Copyright © 1999 Macromedia, Inc. All rights reserved. This manual may not be copied, photocopied, reproduced, translated, or
converted to any electronic or machine-readable form in whole or in part without prior written approval of Macromedia, Inc.
Part Number ZBD10ES100
Acknowledgments
Writing: Natalie Calkins, Gayle Kidder, John Darwell, John Keller
First Edition: August 1999
Macromedia, Inc.
600 Townsend St.
San Francisco, CA 94103

3
CONTENTS
INTRODUCTION
Developing an e-Commerce Site. . . . . . . . . . . . . . . . . 7
Paths to e-Commerce Development . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
A Typical e-Commerce Flow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Up and Running Fast with eStore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Secure Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
How to Use This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
System Requirements for eStore Builder . . . . . . . . . . . . . . . . . . . . . . . .10
Installing Drumbeat 2000 eStore Builder . . . . . . . . . . . . . . . . . . . . . . .11
Drumbeat Support Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
CHAPTER 1
Quick Store Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
What You Need to Complete Quick Store. . . . . . . . . . . . . . . . . . . . . . .13
Getting Familiar with Quick Store Starting Point . . . . . . . . . . . . . . . . .14
Step 1: Adding A Shopping Cart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
Managing the Cart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
Step 2: Setting Up Login and Checkout . . . . . . . . . . . . . . . . . . . . . . . .47
Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Checking Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
Step 3: Confirming the Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
CHAPTER 2
Setting Up Product Pages . . . . . . . . . . . . . . . . . . . . . . 7
Setting Site Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
Setting Publishing Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
Setting up a Data Source Name to the Products Database. . . . . . . . . . .81
Creating a Query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
Creating Product Pages with DataForm Wizard . . . . . . . . . . . . . . . . . .83

Contents
4
CHAPTER 3
Adding and Updating the Shopping Cart . . . . . . . . 1
Configuring the Shopping Cart’s Content. . . . . . . . . . . . . . . . . . . . . . .92
Customizing the Data-Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
Adding the Shopping Cart SmartElement . . . . . . . . . . . . . . . . . . . . . .100
Adding an Add-to-Cart Button on the Shopping Page . . . . . . . . . . . .102
Displaying Shopping Cart Items on a Page . . . . . . . . . . . . . . . . . . . . .103
Updating the Shopping Cart. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
Testing and Trouble Shooting the Shopping Cart . . . . . . . . . . . . . . . .109
CHAPTER 4
Creating Checkout Pages . . . . . . . . . . . . . . . . . . . . . . 111
Creating Login Pages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
Creating New and Update User Pages . . . . . . . . . . . . . . . . . . . . . . . . .115
Creating the Check Out Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
CHAPTER 5
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
Linking Using HTTPS Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
Security and Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
Authentication and Log In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
ASP Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
Payment Processing SET. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
CHAPTER 6
Payment Processing . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Recommended Reading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
Online Transactions with CyberCash . . . . . . . . . . . . . . . . . . . . . . . . .126
Setting up CyberCash Test Account . . . . . . . . . . . . . . . . . . . . . . . . . .127
Adding the CyberCash SmartElement. . . . . . . . . . . . . . . . . . . . . . . . .128
Passing the OrderID to the CyberCash Object . . . . . . . . . . . . . . . . . .129
Setting Customer Credit Card Properties . . . . . . . . . . . . . . . . . . . . . .130
Submitting to CyberCash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
Storing the Transaction Results in Session Object . . . . . . . . . . . . . . . .132
Storing the Transaction Results in the Orders Recordset . . . . . . . . . . .133
Setting Up Offline Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134

Contents
5
CHAPTER 7
Merchandising . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Setting Up Shopping Cart Adjustments . . . . . . . . . . . . . . . . . . . . . . .136
Setting Up Adjustments for Total Weight, Quantity or Purchase. . . . .137
Ordering Page Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
Adjustment Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140
CHAPTER 8
Customizing Quick Store . . . . . . . . . . . . . . . . . . . . . . 143
Customizing Templates and Media Assets . . . . . . . . . . . . . . . . . . . . . .144
Customizing the Quick Store Content . . . . . . . . . . . . . . . . . . . . . . . .148
CHAPTER 9
Shopping Cart Reference . . . . . . . . . . . . . . . . . . . . . 153
Shopping Cart SmartElement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
Shopping Cart Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
Shopping Cart Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162
Configuring Shopping Cart Content: The Data Map . . . . . . . . . . . . .163
Modifying the Data Map Content Table . . . . . . . . . . . . . . . . . . . . . . .165
Specifying Shopping Cart Column Order . . . . . . . . . . . . . . . . . . . . . .166
Shopping Cart Display SmartElement. . . . . . . . . . . . . . . . . . . . . . . . .166
Shopping Cart Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
Shopping Cart Miscellaneous Interactions. . . . . . . . . . . . . . . . . . . . . .187
Shopping Cart Adjustments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
Shopping Cart Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194
Inventory Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
CHAPTER 10
CyberCash SmartElement Reference . . . . . . . . . . 215
CyberCash Features Supported . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
Shipping Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
Version 2.0 Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222
Version 1.0 Contracts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
Known Issues With Using UPS Shipping Contracts . . . . . . . . . . . . . .232
Sales Tax Interactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237

Contents
6

7
INTRODUCTION
.............................................................................................................
Developing an e-Commerce Site
The development cycle for each e-Commerce project is unique. If your
e-Commerce site has been completely thought out and documented in
specifications, you will be applying those requirements and figuring out how
you will meet them using Drumbeat
TM
. If you come with ideas and notions of an
e-Commerce site, you will, most likely, be investigating how the features of eStore
fit in with your vision. No matter what your starting point is, one aspect of
developing a site, any site, holds true. This aspect is that the more work and
time you spend on the project, the more intricate your site will become. The
natural progression is to start simple and then add more complex functionality
and usability.
Studies found that the most significant business goals in the decision to deploy e-
Commerce applications are to create or maintain a competitive edge, and to
improve customer satisfaction.
To create a competitive edge, the site must be functionally sophisticated, and to
improve customer satisfaction the site must be very user friendly. Luckily, these
two goals go hand and hand. As the complexity increases, the site developer, or
team, watches and carefully plans out the user experience.
If you are working with a corporate site, you most likely have guidelines that
include a corporate identity, conventions, and deployment systems. You are
probably working with a project team that includes a mix of people with different
talents. Together you complete the project using your knowledge and expertise,
ranging from Information Technology, writing, and graphic art skills.
On the other hand, you could be the cowboy out there all alone, trying to be
cross-functional and develop the site completely on your own. You might have
knowledge in some or all of the areas that are required to develop an e-Commerce
site, or you may want to out source the skills you lack.
No matter where you fit into this spectrum, eStore will help you complete the
project rapidly.

Introduction 8
Paths to e-Commerce Development
For clarity’s sake, think of the development path as having four main aspects:

Identity

Delivery

Development

Maintenance
Identity defines the theme, colors, and conventions. Delivery defines the target
browser, server platform, security requirements, and, specifically for e-Commerce,
the payment method. Maintenance is the upkeep of the site. Of course, never
forget your audience. These are the people you want to visit and use the site. The
target audience is a parameter which affects every aspect of the path.
How you satisfy each aspect varies depending on the environment in which you
are working. For example, if you are developing a site in a corporate environment,
you probably already have the Identity, Delivery, and Maintenance requirements
laid out for you. Plus, if you are really lucky, you might even have the necessary
resources in place. On the other side of the spectrum, if you are building a
storefront for a small mom-and-pop company, you might need to consult with
your clients and work out these issues.
The document “Navigating an e-Commerce Site” contains a discussion of the
delivery and maintenance aspects of developing an e-Commerce site, with a run-
down of questions you should answer before developing your site in Drumbeat.
The document is located in the Documents folder in the Drumbeat program files
directory. If you installed Drumbeat in the default location, you’ll find it at:
C:\Program Files\Drumbeat 2000\eStore Builder\Navigating.doc
There is so much to think about and do but so little time. So we want to give
you some advice on how to get up and running quickly with Drumbeat 2000
eStore Builder.
If you have never built a site in Drumbeat before, we strongly recommend that
you go through the Quick Start tutorial to become familiar with Drumbeat itself
first before attempting to build your e-Commerce site in Drumbeat.
Once you become familiar with Drumbeat, we recommend that you also go
through the Quick Store tutorial in the first section of this book. (This tutorial is
much shorter than Quick Start).

Developing an e-Commerce Site 9
A Typical e-Commerce Flow
The Quick Store tutorial and eStore instructional media, such as DrumNotes and
Starting Points follow this very typical e-commerce flow. However, you can create
any flow you want. As e-commerce matures, there will be better flows discovered
and planned. Bear in mind that eStore is as flexible as you make it.
1
The site visitor enters the site and browses or searches for product items.
2
The shopper sees a desired product and adds the item to the shopping cart.
3
When finished browsing and shopping, the customer decides to proceed to the
check-out pages. The check-out pages are on a secure server that uses Secure
Sockets Layer (SSL) protocol.
4
On one of the check-out pages, the shopper is given the opportunity to change
the shopping cart contents and then confirms the order.
5
Returning shoppers enter their user ID and password to retrieve their account
information: billing and shipping address, credit card numbers, email address,
etc. First-time customers are taken to a page where account information is
captured in an orders database.
6
The order is processed using an online or offline payment mechanism. The
order detail is entered into the database. At this point, the product items can be
deducted from inventory.
7
The customer is taken to a thank-you page which includes the order details and
delivery information.
Up and Running Fast with eStore
The easiest way to build an e-commerce site following this e-commerce flow and
one that is advisable if you are starting a new site from scratch, is to base the site
on the QuickStoreComplete Starting Point (pre-built site file). You can read how
to do this in the User’s Guide section of this book under Customizing the Quick
Store Starting Point. When you follow the Quick Store tutorial from beginning to
end, it guides you through the mechanics of the site and the set up of secure
transactions and other functions tailored to your unique development. No matter
if you are building a site from scratch or adding e-commerce capability to an
existing site and integrating it with an existing database schema, we recommend
going through Chapter 2 Adding and Updating the Shopping Cart where you
learn how to customize the Data-Map.
Secure Transactions
Security is very important to e-business. There are several ways you can ensure a
secure application.

Introduction 10

Encryption: Save the check-out pages on a secure server using Secure Sockets
Layer (SSL).

Database: Make sure the database is not saved in the wwwroot directory on the
server. Add a user name and password to the database.

Authentication: Protect individual files and folders on Windows NT servers
using the Challenge Response authentication.

ASP Security: Learn about the difference between server-side and client-side
code.
To learn about each of these points, see “Security” on page 121.
How to Use This Book
The Quick Store Tutorial (Chapter 1) is designed to be a basic starter guide for
new users of Drumbeat and eStore. Users who have never built a site in Drumbeat
before are strongly advised to complete the Drumbeat Quick Start tutorial first to
familiarize themselves with Drumbeat before starting this tutorial and attempting
to build an eStore site.
Chapters 2 through 8 assume you are already familiar with Drumbeat and the
basics of database-driven site design. It is assumed that you have completed the
tutorial or already built a simple eStore site on your own. These chapters include
goal-oriented instructions for using and adapting each eStore feature to your
particular project.
Chapters 9 and 10 are both a technical reference for experienced users or
programmers, and a quick reference for all users to the components in eStore.
These chapters explain how the components and contracts work together to create
e-Commerce functionality.
System Requirements for eStore Builder
The recommended system for eStore development machines:

200MHz Pentium

60MB free disk space

64MB RAM
 Microsoft Windows 95/98 or NT 4.0
The recommended system for deploying eStore applications:

Microsoft Internet Information Server (IIS) 4.0 for Windows NT, or Chili!ASP
by Chili!Soft or other ASP interpretive software for other servers to deploy
applications. IIS is included in Windows NT Server.

Developing an e-Commerce Site 11

Minimum: 166Mhz; 128 Megs RAM

ASP Enabled

SA or MS PostingAcceptor Installed

ODBC DSN Creation/Update Methodology
Installing Drumbeat 2000 eStore Builder
To install StoreBuilder from the CD:
1
Insert the Drumbeat 2000 with eStore Builder, or the eStore Builder CD. The
installation program starts automatically, and you will see the eStore Builder
Installation screen.
2
From the selections available, choose Install eStore Builder.
Note: If you are not installing a bundled licensed copy of eStore, you will need to
complete the licensing procedure before installing the package.
3
Follow the instructions on the Installation screen.
To install eStore Builder from the Drumbeat Web Site:
1
Download the eStore Builder self-extracting file from the Drumbeat web site.
In the WinZip Self Extractor, select a folder in which to unzip the eStore
Builder installation file. Click Unzip.
2
Click OK. Then close the WinZip Self-Extractor.
3
In Windows Explorer, navigate to the folder you extracted the installation file
to. Double click the Setup.exe.
4
Follow the instructions on the Installation screen.
The installer will add the eStore Builder files to your copy of Drumbeat, including
the Starting Point for Quick Store and the sample database. The DSN for the
database will automatically be created on your system. You will need to set up the
database and the DSN on the IIS server to which you will be publishing.
Drumbeat Support Center
The Drumbeat Support Center Web site is updated regularly with the latest
information on Drumbeat, plus advice from expert users, advanced topics,
examples, tips, and updates. Check the Web site often for the latest news on
Drumbeat and how to get the most out of the program at www.macromedia.com/
support/drumbeat.

Introduction 12

13
1
CHAPTER 1
.............................................................................................................
Quick Store Tutorial
The Quick Store tutorial walks you through the process of building an online
store using the eStore Builder components. In this tutorial, you will be building a
sample eStore site for an online computer book warehouse using the basic eStore
components. You will learn how to set up a shopping cart, capture customer
details, and calculate tax and shipping costs from tables in a database.
Once you build your online store you can customize it with additional features
available in the eStore package. The eStore User’s Guide following the tutorial
includes documentation for the features available for customizing your eStore.
On the Drumbeat web site you can find DrumNotes demonstrating how to add
various features to your eStore, such as order fulfillment and Store Manager
features. References to DrumNotes are found throughout this guide. To find these
samples, go to drumnotes.drumbeat.com. eStore specific DrumNotes are in the
500 series.
If you have never used Drumbeat before, it is strongly recommended that you go
through the Quick Start tutorial first to familiarize yourself with Drumbeat and
its many features for building database-driven web sites.
To preview the application built in the Quick Store tutorial, go to
quickstore.drumbeat.com.
What You Need to Complete Quick Store
To complete the Quick Store tutorial, you must have access to an ASP
compatible server.
Access Microsoft Internet Information Server 3.0 or above for Windows NT, or
Chili!ASP by Chili!Soft or other ASP compatible software on your network.

Chapter 1 14
Getting Familiar with Quick Store
Starting Point
A Drumbeat Starting Point is a project file that has all or part of a site already
developed. The Quick Store Starting Point has all the pages for the storefront as
well as most of the functionality set up. You will add the Shopping Cart and set up
the Login and Checkout areas.
Open the Quick Store Starting Point
To base a new site on the Quick Store Starting Point:
1
Launch Drumbeat from the Start menu.
2
From the Drumbeat Start-up dialog, select Create a New Site.
Uncheck the Use Wizard checkbox. Then, click OK.
3
In the New Site dialog, name the site QuickStore.
4
In the Site Origin field, select the Based on Starting Point radio button.
From the dropdown list, scroll down and select the QuickStoreStart file. Then
click OK.
Drumbeat will open with a new site based on the Quick Store Starting Point.

Quick Store Tutorial 15
Site Structure
In the Site tab you can see the site organization. Expand the site tree to expose all
the pages in the site.
The Home page is designed to present visitors with rotating book specials. If
a special catches their eye, they can order it immediately by clicking an order
button. Otherwise, visitors can choose to go to one of the three main areas of
the site.
The three links at the top of the page correspond to the three areas of the site as
shown by the main pages in the site tree:

Search and Browse Books: Initiate a search by various criteria, including
keyword, title, author and category. The Search For Books page in the site tree
is the main page in this section.

Checkout: Enter billing and shipping information and get an order summary.
The CheckoutArea page in the site tree is the main page in this section.

View Shopping Cart: Check the current contents of their shopping cart, to see
the books they have ordered already and the total. The Shopping Cart page in
the site tree is the main page in this section.
For information about the Site tab in Site Management Center, check the index of
the Drumbeat User’s Guide or Help for the words in bold.

Chapter 1 16
Templates
Templates speed up the development time by reducing repetitive design tasks.
Click the Templates tab and you’ll see that the site has three templates: a Master
Template and two section templates:

Master Template: This template contains only the link style information for the
site. (Select the Master Template in the site tree and then click the Attributes
tab to see the names of the assigned link styles.) All pages in the site inherit
these styles.

Books Template: This template is used for the pages that display book search
and detail information. The template contains a background, a logo, and four
linked images for navigation. All of the pages shown under this template in the
Templates tab site tree inherit these elements.

Quick Store Tutorial 17

Commerce Template: This template is used for the shopping cart and checkout
pages. It contains a background, logo and two linked images for navigation. All
of the pages shown under this template in the Templates tab site tree inherit
these elements.
For more information about templates check the index of the Drumbeat User’s
Guide or Help for the words in bold.
Content Tables
Content Tables organize media as well as give you a visual representation of
databases. Expose the Content Center (click the Content Center button). Click
the dropdown arrow and you’ll see that a number of Content Tables have already
been set up in the site.
All of these Content Tables, with one exception, are ODBC-driven, with the
content coming from queries to the database that drives the site. The exception is
the Shopping Cart Data-Map. This table, whose initial content comes from a
CSV file, provides a bridge to the database so that user selections can be retrieved
from and passed to the server-side shopping cart.
When using database content in Drumbeat, you must first create a query to the
database (using the Query Manager). Then you create an ODBC Content Table
based on that query. The ODBC Content Table provides a visual representation of
the database content so it can be used in design. To use the data on a page, a
Recordset is added to the page, which is then bound to the appropriate Content
Table. If you are new to Drumbeat, you can find an explanation of the process of
creating queries and ODBC Content Tables and using recordsets in Chapter 15 of
the Drumbeat User’s Guide.
Note: Not all of the databases have content, such as the Customers and Orders databases.
They are used to provide field references that are used when adding customer information
and placing orders when the site is deployed.

Chapter 1 18
The Recordsets used in the Quick Store tutorial have also been created for you.
You can view them by querying the Asset Center for site-level elements. Click the
Locate Assets button and choose Site Elements > Show all site-level elements.
The site-level elements on this site also include the DataForm and Cookies that
are used. Notice that each Recordset matches a Content Table in the Content
Center (although the names of the Recordsets may differ slightly from the
Content Table names).
You will see the recordsets used in the basement of the data-driven pages in the
Quick Store Starting Point.

Quick Store Tutorial 19
The description and purpose of each recordset is explained in the following table.
For answers about database-related questions, check the index of the Drumbeat
User’s Guide or Help for the words in bold.
eStore Builder SmartElements
In Drumbeat, a SmartElement is any type of element you put on a page, such as
text, images, video, etc. They include Applets, ActiveX objects, COM objects,
Scriptlets and a variety of custom elements. You drag and drop SmartElements
from the toolbar and/or Asset Center.
The eStore Builder package includes three custom eStore SmartElements, two
of which you will be using in this tutorial. The eStore SmartElements were
added to your Element Library collection when you installed eStore. They should
also appear on your SmartElements Toolbar. The CyberCash SmartElement,
which is not used in this tutorial, is discussed in the User’s Guide and Reference
Guide following.
Recordset Name Content Table Description
BookQuery BookQuery Used in the search, results, and details
product pages. From the detail page, the
product items are inserted into the Orders
table and then carried by the Orders detail
and Orders recordsets to the CheckOut pages.
CardTypes CreditCardTypes Used on the NewUser and Update User pages
to populate the Credit Cards supported.
Customers Customers Used to capture customer details.
CustOrderDetails CustOrderDetails Used to capture the order details and
customer ID. The customer ID links the
CustOrderDetails table to the Customer details
table.
Keywords Keywords Used for keyword search functionality.
OrderDetails OrderDetails Used for capturing shipping and freight
details.
Orders Orders Used for capturing customer-ordering
information.
OrderTotals OrderTotals Use for displaying order totals on the
Checkout page.
SalesTax SalesTax Used for adding the different sales tax
percentages to total cost.
Specials Specials Used for searching on books by publisher.

Chapter 1 20
The custom eStore SmartElements are:

Shopping Cart: This component is a server-side object which holds user
selections as they shop the store. It manages the data in an online shopping
session until they are ready for checkout.

Shopping Cart Display: This component is used to display the data contained
in the shopping cart, so that users can check the contents of their cart.
If the Shopping Cart and Shopping Cart Display elements are not on your
SmartElements toolbar, you should add them for this exercise. Click the Element
Library icon on the SmartElements toolbar and select the Custom tab. Place a
check next to each element, then close the Element Library and they will appear
on the toolbar.
Technical documentation on these Custom SmartElements can be found in the
Shopping Cart section of the Reference guide in this book, or see the following
documents in the Drumbeat 2000/eStore Builder directory:
ShoppingCartV2.doc
ShoppingCartAPIV2.doc
ShoppingCartDisplayV2.doc
For information about SmartElements, check the index of the Drumbeat User’s
Guide or Help for the words in bold.