MACROMEDIA DRUMBEAT 2000 ECOMMERCE EDITION User manual

Users Guide

macromedia®

DRUMBEAT™2000

eCOMMERCE

EDITION

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.

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

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: Conﬁrming 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

CHAPTER 3

Adding and Updating the Shopping Cart . . . . . . . . 1

Conﬁguring 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 Ofﬂine Transactions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134

Contents

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

Conﬁguring 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

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

speciﬁcations, you will be applying those requirements and ﬁguring out how

you will meet them using Drumbeat

. If you come with ideas and notions of an

e-Commerce site, you will, most likely, be investigating how the features of eStore

ﬁt 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 signiﬁcant 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 ﬁt into this spectrum, eStore will help you complete the

project rapidly.

Introduction

Paths to e-Commerce Development

For clarity’s sake, think of the development path as having four main aspects:



Identity



Delivery



Development



Maintenance

Identity deﬁnes the theme, colors, and conventions. Delivery deﬁnes the target

browser, server platform, security requirements, and, speciﬁcally 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 ﬁles

directory. If you installed Drumbeat in the default location, you’ll ﬁnd 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

ﬁrst 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 ﬁrst section of this book. (This tutorial is

much shorter than Quick Start).

Developing an e-Commerce Site

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 ﬂow. However, you can create

any ﬂow you want. As e-commerce matures, there will be better ﬂows discovered

and planned. Bear in mind that eStore is as ﬂexible as you make it.

The site visitor enters the site and browses or searches for product items.

The shopper sees a desired product and adds the item to the shopping cart.

When ﬁnished 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.

On one of the check-out pages, the shopper is given the opportunity to change

the shopping cart contents and then conﬁrms the order.

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.

The order is processed using an online or ofﬂine payment mechanism. The

order detail is entered into the database. At this point, the product items can be

deducted from inventory.

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 ﬂow 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 ﬁle). 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



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 ﬁles 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 ﬁrst 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.

Table of contents

Other MACROMEDIA Software manuals

MACROMEDIA

MACROMEDIA COLDFUSION STUDIO 4.5-USING COLDFUSION... Mounting instructions

MACROMEDIA

MACROMEDIA BREEZE 5 Quick setup guide

MACROMEDIA

MACROMEDIA FLASH 8-GETTING STARTED WITH FLASH User manual

MACROMEDIA

MACROMEDIA COLDFUSION 4.5-ADMINISTRING COLDFUSION... User manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA FIREWORKS 8-USING FIREWORKS Mounting instructions

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX-LINGO DICTIONARY User manual

MACROMEDIA

MACROMEDIA FLASH 8-FLASH Operation instructions

MACROMEDIA

MACROMEDIA COLFUSION MX 7-MIGRATING APPLICATIONS TO COLDFUSION MX... User manual

MACROMEDIA

MACROMEDIA FIREWORKS 2-USING FIREWORKS Mounting instructions

MACROMEDIA

MACROMEDIA FLASH MX 2004-FLASH JAVASCRIPT DICTIONARY User manual

MACROMEDIA

MACROMEDIA 38000382 - Macromedia JRun - Mac User manual

MACROMEDIA

MACROMEDIA FIREWORKS 8-EXTENDING FIREWORKS User manual

MACROMEDIA

MACROMEDIA COLFUSION MX 7-CFML Service manual

MACROMEDIA

MACROMEDIA BREEZE PRESENTER User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-GETTING STARTED WITH... User manual

MACROMEDIA

MACROMEDIA FLASH 8-GETTING STARTED WITH FLASH LITE User manual

MACROMEDIA

MACROMEDIA FLASH MX 2004-LEARNING FLASH User manual

MACROMEDIA

MACROMEDIA FLASH 8-LEARNING ACTIONSCRIPT 2.0 IN FLASH User manual

MACROMEDIA

MACROMEDIA STUDIO 8-EXPLORING STUDIO 8 User manual

MACROMEDIA

MACROMEDIA BREEZE 5 User manual

MACROMEDIA

MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Mounting instructions

MACROMEDIA

MACROMEDIA FREEHAND MX 11 Mounting instructions

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual