E-Tester for WAP User Guide

USER GUIDE

e-Tester User Guide Version 5.1

Empirix, Inc.

CopyCopyCopyCopyright Noticeright Noticeright Noticeright Notice Copyright 1997-2001 Empirix Inc. All rights reserved. The contents of this document and the associated e-TEST suite software are the property of Empirix Inc. and are copyrighted. No part of this document may be copied or distributed, transmitted, transcribed, stored in a retrieval system, or translated into any human or computer language, in any form, or by any means, electronic, mechanical, magnetic, manual, or otherwise, or disclosed to third parties without the express written permission of Empirix Inc.

Printed in the United States of America

TrademarksTrademarksTrademarksTrademarks Data Bank Wizard, e-Manager, e-Reporter, e-Spider, e-TEST, e-Tester, d-Tracker, ServerStats, TrueLoad, and Visual Scripts, are all trademarks or service marks and e-Load and e-Monitor, are registered trademarks of Empirix Inc in the United Stats and other countries. Microsoft is a registered trademark and Windows, Visual C++, Visual J++, and Visual Basic are trademarks of Microsoft Corporation. Java is a trademark of Sun Microsystems. Pentium is a registered trademark of the Intel Corporation. All other names are used for identification purposes only and may be trademarks of their respective owners. Empirix Inc. 1430 Main St. Waltham, MA 02451 Ph: 781-993-8500 Fax: 781-993-8600 Web: http://www.empirix.com Email: [email protected]

USA, Japan, Singapore, UK/Europe To contact a local Empirix office, visit our Web site at www.empirix.com

Contents

Contents iiiiiiiiiiii

Contents

Preface About This Guide ............................................................................................v Related Documentation...................................................................................vi

e-TEST Suite Printed Manuals ..............................................................vi Other Printed Manuals ..........................................................................vii Electronic Documentation......................................................................vii

Using Help ...................................................................................................viii Conventions.....................................................................................................ix Obtaining Technical Support .........................................................................ix

C h a p t e r 1 C h a p t e r 1 C h a p t e r 1 C h a p t e r 1

Introduction Recording WAP Applications .........................................................................2 Playing Back Visual Scripts for Wireless Applications ...................................2

Contents

iviviviv ```` e-Tester for WAP User Guide

C h a p t e r 2C h a p t e r 2C h a p t e r 2C h a p t e r 2 Using the Openwave Browser

Installing the Openwave Browser ....................................................................3 Installing from the CDROM...................................................................3 Downloading and Installing .....................................................................3

Setting the Home URL...................................................................................4 Selecting the WAP Browser Emulation ..........................................................6 Recording Using the Openwave Browser .......................................................7

Viewing Page Source and Properties......................................................10 C h a p t e r 3C h a p t e r 3C h a p t e r 3C h a p t e r 3 Using the Nokia Browser

Installing the Openwave Browser ....................................................................3 Downloading and Installing .....................................................................3

Selecting the WAP Browser Emulation ..........................................................4 Recording Using the Nokia Browser ..............................................................5

Viewing Page Source and Properties........................................................7

vvvv

Preface Welcome to the e-Tester for WAP User Guide. This guide explains how to use the features and options of e-Tester for testing Wireless applications.

This guide is intended for Web test engineers who will be developing e-Tester Visual Scripts for regression and performance (load and scalability) testing of a Wireless Application Protocol (WAP) Web site or application. This guide is a supplement to the e-Tester User Guide, which you should refer to for detailed information about using e-Tester features.

About This Guide

This guide contains the following chapters:

Chapter 1 Chapter 1 Chapter 1 Chapter 1 Introduction Introduction Introduction Introduction: provides an overview of the major features of e-Tester for WAP.

Chapter 2 Chapter 2 Chapter 2 Chapter 2 Using the Openwave BrowserUsing the Openwave BrowserUsing the Openwave BrowserUsing the Openwave Browser: explains how to install and setup the WAP application browsers from Openwave.com.

Chapter 2 Chapter 2 Chapter 2 Chapter 2 Using the Nokia BrowserUsing the Nokia BrowserUsing the Nokia BrowserUsing the Nokia Browser: explains how to install and setup the WAP application browsers from Nokia.

Preface

vivivivi e-Tester for WAP User Guide

Related Documentation

The e-TEST suite includes a complete set of printed manuals, electronic manuals, and online help.

e-TEST Suite Printed Manuals

The e-TEST suite includes the following printed manuals:

Getting Started with e-TEST suite introduces the software tools in the e-TEST suite and provides step-by-step tutorials for e-Tester, e-Manager, e-Monitor, and e-Load (which includes ServerStats and e-Reporter).

e-Tester User Guide explains how to use the features and options of e-Tester to create Visual Scripts for regression/performance testing and monitoring of Web sites or applications. This guide also includes reference information for using the e-Tester Programming Interface for expanding Visual Script capabilities using Visual Basic for Applications (VBA).

e-Tester for WAP User Guide explains how to use the Wireless Application Protocol recording features of e-Tester. This manual is a supplement to the e-Tester User Guide and is included only if you have the WAP enabled version of e-Tester.

e-Manager User Guide explains how to use the features and options of e-Manager to schedule and play back multiple Visual Scripts for regression testing of Web sites or applications. e-Manager uses the Visual Scripts developed by e-Tester.

e-Monitor User Guide explains how to use the features and options of e-Monitor to perform periodic or continuous monitoring of Web sites and related servers. e-Monitor uses the Visual Scripts developed by e-Tester.

e-Load User Guide explains how to use the features and options of e-Load to simulate multiple users accessing a Web site or application for performance testing. e-Load uses the Visual Scripts developed by e-Tester.

Preface

Preface viiviiviivii

ServerStats User Guide explains how to use the features and options of ServerStats to monitor operational performance of a variety of application servers, Web servers, database servers and systems.

e-Reporter User Guide explains how to use the features and options of e-Reporter and WebReporter to generate graphs and reports for e-Load, e-Monitor, and ServerStats performance data.

Other Printed Manuals

In addition to the e-TEST suite documentation set, the following printed manuals are available with the d-Tracker product:

d-Tracker User Guide explains how to use the features and options of d-Tracker for issue/defect tracking and management.

d-Tracker Administrator Guide explains how to use the administrative features and options of d-Tracker for customizing the terminology and appearance of d-Tracker for your organizations requirements.

Electronic Documentation

The e-TEST suite download from our Web site automatically installs an Adobe Portable Document Format (PDF) version of the Getting Started with e-TEST suite manual and an e-Spider Tutorial. These documents require the Adobe Acrobat Reader, version 4.x, to open and view the .PDF files. You can download the free Acrobat Reader from the Adobe Web site: http://www.adobe.com/products/acrobat/readstep2.html.

The Getting Started with e-TEST suite PDF file is an option on the e-TEST suite StartStartStartStart menu. The e-Spider Tutorial PDF file is copied to the e-TEST suite installation directory (C:\Empirix\eTEST is the default).

The installation also includes a readme.doc file that contains release notes and the latest updates to the product documentation. The readme.doc file opens in Microsoft Wordpad when you select the Release NotesRelease NotesRelease NotesRelease Notes option on the e-TEST suite StartStartStartStart menu. Also included is an e-Monitor v5.0 to v5.1 conversion documentation (Wm50-51Conv.pdf) file that explains how to migrate existing 5.0 Shell Scripts to 5.1 jobs and schedules.

The full e-TEST suite documentation set is provided on the product CD-ROM in Adobe Portable Document Format (PDF). You can use the

Preface

viiiviiiviiiviii e-Tester for WAP User Guide

Acrobat Reader, version 4.x, to view, search, and print the documentation set. The e-TEST suite CD-ROM includes the Acrobat Reader application. You can install Acrobat Reader using the e-TEST suite CD-ROM setup program or by selecting ar40eng.exe in the Acrobat Reader directory. See the Adobe Web site, http://www.adobe.com, for additional information about Acrobat Reader.

The full documentation set includes the following files: e-Test Suite Getting Started.pdf e-Tester User Guide.pdf e-Tester for WAP User Guide.pdf e-Manager User Guide.pdf e-Monitor User Guide.pdf e-Load User Guide.pdf

WebReporter User Guide.pdf e-Spider Tutorial.pdf d-Tracker User Guide.pdf d-Tracker Administrator Guide.pdf readme.doc Wm50-51Conv.pdf

All of the .PDF files are in the Documentation directory of the product CD-ROM. The e-Test Suite Getting Started.pdf, e-Spider Tutorial.pdf, WM50-51Conv.pdf, and readme.doc files are installed during the e-TEST suite setup procedure. You can copy the user guide .PDF files to a local drive or open them in Acrobat Reader from the CD-ROM.

If you downloaded the product from the our Web site and wish to receive electronic versions of the User Guides in .PDF format, please send an email message to [email protected]. Youll need the Acrobat Reader v4 to open and view the documents.

The e-TEST suite CD-ROM also includes the Microsoft Visual Basic Scripting Edition (VBScript) Language Reference documentation. You can install the files using the e-TEST suite CD-ROM setup program or by selecting vbsdoc.exe in the MS VB Script Documentation directory.

Using Help

e-Tester provides a comprehensive on-line help system. The help topics include step-by-step how to instructions for common tasks and a complete reference.

You can press the F1 key at any open dialog box for an explanation of the options. You can select Help Help Help Help Contents Contents Contents Contents to open the on-line help contents and index.

Preface

Preface ixixixix

Conventions

This guide uses the following typographical conventions to identify specific items:

ConventionConventionConventionConvention DescriptionDescriptionDescriptionDescription

Bold Sans SerifBold Sans SerifBold Sans SerifBold Sans Serif Menu options and dialog box selections.

Sans Serif Underlined Web page hyperlinks.

Sans Serif File names and Visual Script nodes.

Fixed-Pitch type Program code.

Arrow between menu options. Select each option in sequence.

Obtaining Technical Support

If you have questions about e-TEST suite, first look in this guide, the online Help, and the release notes delivered with the software.

You can also check our Web site for the latest information about upgrades and other issues at http://www.empirix.com.

If you wish to contact Empirix Web Test + Monitoring Support, please use the following contact numbers and email addresses:

Tel. North AmericaNorth AmericaNorth AmericaNorth America: (781) 993-8562 (8 a.m. to 8 p.m. EST) EuropeEuropeEuropeEurope: +44(0) 1344 725801 (8:30 - 18:00 GMT) JapanJapanJapanJapan: (03) 3791-2336

Fax. North AmericaNorth AmericaNorth AmericaNorth America: (781) 993-8600

Email North AmericaNorth AmericaNorth AmericaNorth America: [email protected] EuropeEuropeEuropeEurope: [email protected]

Key RequestsKey RequestsKey RequestsKey Requests: To request a software license key, please call (781) 993-8500 or send your request via email to [email protected].

Preface

xxxx e-Tester for WAP User Guide

[This page intentionally left blank]

1111

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 1111

Introduction e-Tester can record and play back applications designed for wireless devices using the Wireless Application Protocol (WAP). e-Tester monitors HTTP socket activity to record the XML-based Wireless Markup Language (WML) used to create the cards and decks of a wireless application.

e-Tester records the WML cards and decks as nodes in the Visual Script. Once a Visual Script is recorded for a WML wireless application, the Visual Script can be played back against the application in e-Tester, e-Load, and e-Monitor.

Recording WML wireless applications in e-Tester differs somewhat from recording HTML applications. e-Tester provides an option for opening a WAP application browser before recording the application. After you start recording, you navigate the WML wireless application using the WAP application browser. e-Tester records actions in the WAP application browser to a Visual Script in the e-Tester window.

This document explains how to set up the WAP application browser and use e-Tester to record and play back Visual Scripts against WML wireless applications.

Introduction

2222 e-Tester for WAP User Guide

Recording WAP Applications

The procedure for recording WAP applications depends upon which WAP browser emulator you are using. e-Tester supports the following WAP browser emulators:

Phone.com 4.0

Openwave 4.1

Nokia 2.0 or Nokia 2.1

The following chapters of this guide explain the procedures for installing the browser emulator, specifying the browser emulator in e-Tester, and how to recording WAP applications with the specific browsers.

The Openwave 4.1 browser emulator is an updated version of the Phone.com 4.0 browser emulator. The procedure for recording WAP applications with either the Phone.com or Openwave emulator is the same and is explained in Chapter 2.

The Nokia 2.1 browser emulator is and updated version of the Nokia 2.0 browser emulator. Nokia 2.1 requires version 1.3 of the Java Runtime Environment. Nokia 2.0 requires version 1.2 of the Java Runtime Environment. The procedure for recording WAP applications is the same and is explained in Chapter 3.

Playing Back Visual Scripts for Wireless Applications

Once you have recorded a WAP application to a Visual Script, you can play back the Visual Script using e-Tester, e-Load, and e-Monitor. No special steps are required.

3333

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 2222 Using the Openwave Browser

e-Tester can use the Phone.com 4.0 or Openwave 4.1 WAP application browsers available from Openwave.com. Before you can record WAP applications using e-Tester, the WAP browser you plan to use must be installed on the system. The following sections explain how to install and use the Openwave browser.

Installing the Openwave Browser

The e-TEST suite CDROM includes the setup files for the Openwave UP.Simulator browser. You can install the UP.Simulator browser from the CDROM or download the setup files from Openwave.com. The following sections explain the procedures:

Installing from the CDROM

To install the UP.Simulator browser from the e-TEST suite CDROM:

1. Copy the Openwave.com UP.SDK package from the openwave directory on the CDROM to a temporary directory on a local drive.

2. Run upsdkw41e.exe to start the setup program.

Downloading and Installing

To download and install the UP.Simulator browser:

3. Download the UP.SDK package from:

http://www.openwave.com/

4. Save the file to a temporary directory on a local drive.

5. Run the setup program to install the SDK.

Setting the Home URL



Before using the UP.Simulator browser with e-Tester, you should set the default home URL setting. The default home URL is the location of the WML application that will be automatically started when you open the WAP application browser.

To set the home URL:

1. Select Start Start Start Start Programs Programs Programs Programs UP.SDK 4.1 UP.SDK 4.1 UP.SDK 4.1 UP.SDK 4.1 UP.Simulator UP.Simulator UP.Simulator UP.Simulator. The UP.Simulator browser window opens and connects to the default link location.


Chapter 2: Using the Openwave Browser 5555

2. Select Settings Settings Settings Settings UP.Link Settings UP.Link Settings UP.Link Settings UP.Link Settings.

3. Verify that HTTP DirectHTTP DirectHTTP DirectHTTP Direct is selected.

4. Change the Home URLHome URLHome URLHome URL setting to the location of the .wml file of your WML wireless application.

5. Click OKOKOKOK.

6. Select File File File File Exit Exit Exit Exit to close the UP.Simulator browser. When you test your WAP application, you will use the features of e-Tester to re-launch the UP.Simulator browser.

Selecting the WAP Browser Emulation



e-Tester uses an HTTP spy to monitor and record socket activity between a Wireless Application Protocol (WAP) browser and a Web Server. You must have the appropriate Empirix WAP license before e-Tester enables WAP features.

To select the WAP application browser emulation:

1.1.1.1. Select Start Start Start Start Programs Programs Programs Programs e e e e----TEST suite TEST suite TEST suite TEST suite e e e e----Tester.Tester.Tester.Tester.

2.2.2.2. Select Options Options Options Options WAP Options WAP Options WAP Options WAP Options.

3.3.3.3. Select the Openwave browser.

4.4.4.4. Click OKOKOKOK.

Recording Using the Openwave Browser



Once you have installed the WAP browser and selected the e-Tester WAP option, you can record actions in the WAP browser to a Visual Script.

1.1.1.1. Start e-Tester

2.2.2.2. Select File File File File New Script New Script New Script New Script.

3.3.3.3. Select Tools Tools Tools Tools WAP Script Recorder WAP Script Recorder WAP Script Recorder WAP Script Recorder or click the toolbar button. e-Tester automatically opens the WAP browser emulator.

4.4.4.4. Press F12 or select Edit Edit Edit Edit Clear Cache Clear Cache Clear Cache Clear Cache in the WAP application browser to clear the browser cache. The browser loads the home URL specified in UP Link settings.

5.5.5.5. Click the e-Tester Record toolbar button.



6.6.6.6. Navigate the WML application using the WAP application browser. The following illustration shows the basic features and controls of the Openwave browser.

Left Select

Browser PaneSelected Item

URL or File Location

Right Select

Browser Back

Scroll Selector

Browser Home

See the Using the UP.Browser (PDF) in the UP.SDK documentation for additional information about the phone browser features and options.



As you navigate the WML application, e-Tester records your actions to a Visual Script in the e-Tester window. The e-Tester browser pane shows the XML structure of the WML decks as they are recorded.

XML/WML Source Hierarchy

The XML structure of the WML deck is stored in a temporary temp.xml file in the C:\Empirix\eTEST\Temp directory. The e-Tester browser pane shows the structure of the last recorded deck.

You can click the plus (+) and minus (-) nodes to expand and collapse the XML nodes.



The pages in the Visual Script include an xmls node with subnodes that show the WML card structure of the deck.

WML Page Structurein Visual Script

e-Tester records a new page to the Visual Script when the WAP application navigates to a new deck.

7.7.7.7. Save the Visual Script.

Viewing Page Source and Properties

You can view the deck source using the HTML node in the Visual Script. Select the HTML node of a Visual Script page, click the right mouse button, and select PropertiesPropertiesPropertiesProperties.

You can view the attributes and values of cards and other nodes of a WML deck in the Visual Script. Select the node, click the right mouse button and select PropertiesPropertiesPropertiesProperties.

You can view the WML application deck in the e-Tester browser pane. Double-click the HTML node. However, navigation of the WML application is not supported in the e-Tester browser.

11111111

C h a p t e r C h a p t e r C h a p t e r C h a p t e r 3333 Using the Nokia Browser

e-Tester can use WAP application browsers available from Nokia. Before you can record WAP applications using e-Tester, the WAP browser you plan to use must be installed on the system. The following sections explain how to install and use the Nokia browser.

Installing the Nokia Browser

The Nokia browser emulator is included with the Nokia WAP Toolkit. You need to download the toolkit from the Nokia Web site and install it on the e-Tester workstation before e-Tester can record using the Nokia browser emulator.

NoteNoteNoteNote: Nokia Toolkit 2.1 requires version 1.3 of the Java Runtime Environment. Nokia Toolkit 2.0 requires version 1.2 of the Java Runtime Environment.

Downloading and Installing

To download and install the Nokia WAP Toolkit:

1. Download the Nokia WAP Toolkit package from:

http://forum.nokia.com/

2. Save the file to a temporary directory on a local drive.

3. Run the setup program to install the toolkit.




e-Tester uses an HTTP spy to monitor and record socket activity between a Wireless Application Protocol (WAP) browser and a Web Server. You must have the appropriate Empirix WAP license before e-Tester enables WAP features.

To select the WAP application browser emulation:

1.1.1.1. Select Start Start Start Start Programs Programs Programs Programs e e e e----TEST suite TEST suite TEST suite TEST suite e e e e----Tester.Tester.Tester.Tester.

2.2.2.2. Select Options Options Options Options WAP Options WAP Options WAP Options WAP Options.

3.3.3.3. Select the Nokia 2.0 or 2.1browser.

4.4.4.4. Click OKOKOKOK.

Recording Using the Nokia Browser

Chapter 3: Using the Nokia Browser 13131313


Once you have installed the WAP browser and selected the e-Tester WAP option, you can record actions in the WAP browser to a Visual Script.

1.1.1.1. Start e-Tester

2.2.2.2. Select File File File File New Script New Script New Script New Script.

3.3.3.3. Select Tools Tools Tools Tools WAP Script Recorder WAP Script Recorder WAP Script Recorder WAP Script Recorder or click the toolbar button.

4.4.4.4. Enter the URL where you wan to start recording in the LocationLocationLocationLocation field of the Nokia WAP Toolkit window and press Enter.

Enter WAP URL

5.5.5.5. Click the e-Tester Record toolbar button.



6.6.6.6. Navigate the WML application using the WAP application browser.

See the User Guide in the Nokia documentation for additional information about the phone browser features and options.

As you navigate the WML application, e-Tester records your actions to a Visual Script in the e-Tester window. The e-Tester browser pane shows the XML structure of the WML decks as they are recorded.

XML/WML Source Hierarchy

The XML structure of the WML deck is stored in a temporary temp.xml file in the C:\RSW\Temp directory. The e-Tester browser pane shows the structure of the last recorded deck.

You can click the plus (+) and minus (-) nodes to expand and collapse the XML nodes.


Chapter 3: Using the Nokia Browser 15151515

The pages in the Visual Script include an xmls node with subnodes that show the WML card structure of the deck.

WML Page Structurein Visual Script

e-Tester records a new page to the Visual Script when the WAP application navigates to a new deck.

7.7.7.7. Save the Visual Script.

Viewing Page Source and Properties

You can view the deck source using the HTML node in the Visual Script. Select the HTML node of a Visual Script page, click the right mouse button, and select PropertiesPropertiesPropertiesProperties.

You can view the attributes and values of cards and other nodes of a WML deck in the Visual Script. Select the node, click the right mouse button and select PropertiesPropertiesPropertiesProperties.

You can view the WML application deck in the e-Tester browser pane. Double-click the HTML node. However, navigation of the WML application is not supported in the e-Tester browser.



[This page intentionally left blank]

Documents

E-Tester for WAP User Guide