A manual test script is a set of testing instructions that are run by a human tester. A manual test script can consist of steps and verification points that you type into a manual test script using Rational ManualTest. After you create a manual test script and associate it with a test case, creating a manual implementation, you can run the test case from a Web browser.
With the ManualTest Web Execution component of Rational TestManager, you can:
- Run a test case with a manual implementation from a Web browser without requiring any installed Rational components on the client.
- Record results and add your observations in a comment as you perform each task in a manual test script. These results appear in a test log.
- Include your test case results in a TestManager report.
When you run a test case, you view and record the results of performing the manual steps and verification points in the manual test script.
Note: You can run a test case from a Web browser only if it has a manual implementation; you cannot run a test case with an automated test script implementation from a Web browser. If a test case has both a manual test script and an automated test script implementation, only the manual test script runs from a Web browser.
To run a test case with a manual implementation, you or an administrator install and configure a Web server with ManualTest Web Execution software and configure a Web browser on each client that will access a Rational project. To run a test case using a Web browser, you type the machinename, the network name of the Web server, and the alias, the name of an alias for the directory where you or your administrator installed the ManualTest Web Execution software on the Web server in the Address bar of your Web browser.
For example:
http://Webserver1/ManTestdir
The main page consists of the following sections: The title bar, the test case tree, the Standard toolbar on the left, the Work area in the center, and the Results toolbar at the bottom of the main page.
After you log into a Rational project, the Test Case tree appears in the main page.
Note: Only test cases with a manual implementation appear in the Test Case tree.
When you select a test case from the Test Case tree, the manual test script appears in the Work area. You can record results and add your observations in a comment as you perform each task in a manual test script. (For information about creating a manual test script, see the Rational TestManager Help.)
Title Bar
WWW.RATIONAL.COM - Click this link to the Rational Software Web site to learn more about Rational, the software development company, and Rational software products.
TESTMANAGER HOME - Click this link to the Rational Software Web site to learn more about the Rational TestManager product.
Help - Click to display the Help. You can view Help whenever you need assistance. Complete online information is available to help you perform tasks, understand concepts, and work with the user interface.
About - Click to display the copyright notice and the version of Rational ManualTest Web Execution.
Project name, name of test case, and name of manual test script - Appear in the Title bar after you log into a project.
Test Case Tree
The test case tree appears after you log into a Rational project. The test case tree displays test plans, test case folders, test cases, and manual test scripts. Click + to expand the tree and navigate to the test case that you want to run.
Note: Only test cases with a manual implementation appear in the Test Case tree.
Standard Toolbar
After you select a test case to run, the Standard toolbar appears on the left side of the Rational ManualTest Web Execution main page. Click any of the following buttons to work with a manual test script:Options - Opens the Options dialog box.
Select Test Case - Displays the Test Case tree in the main page so that you can select and run a different test case.
Log Off - Click to log out of a project.
Work Area
After you select a test case to run, the work area displays the manual implementation for that test case.
Manual Test Script - A manual implementation of a test case that will be run. When you select a test case from the Test Case tree, the manual implementation of that test case opens and appears in the Work area. You can then record results and add your observations in a comment as you perform each task in a manual test script.
When you run a manual test script, the following areas appear:
- Type - A footprint in this column indicates a step to be performed. A check mark indicates a verification point that can pass or fail (or have no value).
- Note - A Note icon in this column indicates that a note exists for a step or verification point. Click the icon to open the note. You cannot edit notes.
- Description - Displays each step (user actions) or verification point. Steps are in black type, and verification points are in blue type.
- Tip: The first 64 characters of the step or verification point description are included in the Event Type column of the test log. We suggest you include a brief synopsis of the step or verification point as the first few characters of the Description. For example, "Start Microsoft Word. Click Start > Programs > Microsoft Word."
- Result - For a step, displays the Result check box. Select the check box to indicate that you have completed the step. When you view the test log, Completed appears in the Result column of each step that you checked.
- For a verification point, displays the Result cell. Click the Result cell, and then click None, Pass, or Fail to indicate the result of a verification point. When you view the test log, the result appears in the Result column of the Test Log window of TestManager.
- Expected Results - In the Expected Result column, a description of the expected result. To view a file, such as a bitmap screen capture, associated with the step, verification point, or expected result, click the icon in the Expected Result File column. ManualTest displays the file in the appropriate application.
- Result Details - To type a comment or associate a results file, click the Result Details cell. You can optionally, add your observations as you perform each step. Type the text or click Select to choose a file to associate with the results. The Result Details icon appears in the cell. Click OK. To view or edit the comment, or to view or edit the associated file, click the Result Details icon. When you view the test log, the text of your comment appears in the Log Event window of TestManager next to Additional Information.
Results Toolbar
Use to set the results for all steps and verification points, reset verification, step results and result details, submit results for a manual test script, and view Help.
Submit Results - Opens the Specify Log Information dialog box.
Pass Results - Sets the default result to Pass for all verification points, and to Complete for all steps.
Reset Results - Click to clear all results that you entered. This option resets all verification points to None, all steps to unchecked, and clears the Result Detail icon and information.
Help - Click to display the Help. Complete online information is available to help you perform tasks, understand concepts, and work with the user interface.
The following table lists the tasks that you perform to run a test case with a manual implementation from a Web browser and where you can find information about each task.
Rational TestManager User's Guide manual or the TestManager Help Setting Up a Web Browser How to Run a Test Case from a Web Browser
- View the results in the Test Log window of TestManager.
Viewing Test Log Results
We recommend that when you create a project, you make it a shared project so others can access your manual test scripts from a Web browser. To share a project, create the project in a shared directory and use the Uniform Naming Convention (UNC) for the directory name. (For more information about creating a shared directory, see the Rational Suite Administrator's Guide or the Rational Administrator Help.)
You can use Netscape Navigator 4.0 (or later) or Microsoft Internet Explorer 4.0 (or later) as your Web browser to run a test case. You can use your Web browser on a system running any operating system software.
Netscape Navigator
To set up a Netscape Navigator browser to run a test case:
- Start Netscape Navigator.
- Click Edit > Preferences.
- Click Advanced.
- Under Advanced, click Cache to display the Cache panel.
- In the Cache panel, click Every time.
- Click OK.
Microsoft Internet Explorer
To set up a Microsoft Internet Explorer browser to run a test case:
- Start Internet Explorer.
- For Internet Explorer 5.0, click Tools > Internet Options.
For Internet Explorer 4.0, click View > Internet Options.- Click the General tab.
- Under Temporary Internet files, click Settings.
- Under Check for newer versions of stored pages, click Every visit to the page.
- Click OK.
- Click OK.
All options that you set apply to the session you are in and all future sessions.
To set the options to run a test case from a Web browser:
- Click Options in Rational ManualTest Web Execution.
- Click the options that you want.
- Click OK.
You can run a test case with a manual implementation from a Web browser with the Rational ManualTest Web Execution component of TestManager. You can record results and add your observations in a comment as you perform each task in a manual test script.
To run a test case with a manual implementation from a Web browser:
- Log into a Rational project.
- Type your user name and password for the project that contains the test cases that you want to run. If you do not know the user name and password, see your project administrator.
- Select a project from the list of projects. You need privileges to access a shared project. (For information about creating a shared project, see the Rational Suite Administrator's Guide or the Rational Administrator Help.)
- Click OK. The Test Case tree appears.
Note: Only test cases with a manual implementation appear in the Test Case tree.
- Navigate through the Test Case tree and click a test case with a manual implementation that you want to run.
- To change the options for running a test case, click Options, select the options, and then click OK. The options are:
Show script without graphics - Improves the display speed of the manual test script Web page. Displays only text on the Web page.
Show only verification points - Shows verification points and hides all steps.
Log unchecked steps as warnings - Unchecked steps appear as warnings in the test log.
Timeout interval in minutes (20-1440) - Sets the length of time, in minutes, before the Web browser session times out. You can set the time from 20 to 1440 minutes. The default time is set to 120 minutes.
Note: You must submit your results before the Web browser session times out or you will lose all results and comments that you enter in Step 6.
- To view a note for a row, click the Note icon. You cannot edit notes.
- Perform the steps and verification points indicated in the manual test script.
- For a step, select the Result check box to indicate that you have performed the step. When you view the test log, Completed appears in the Result column of each step that you checked.
- For a verification point, click the Result cell, and then click None, Pass, or Fail. When you view the test log, the result appears in the Result column for each verification point.
To pass all verification points and steps, click Pass Results.
To clear all results, click Reset Results.
- To type a comment or associate a results file, click the Result Details cell. Type the text or click Select to choose a file to associate with the results. The Result Details icon appears in the cell. Click OK. To view or edit the comment, or to view or edit the associated file, click the Result Details icon.
When you view the test log, the text of your comment appears in the Log Event window of TestManager next to Additional Information.
- When finished, click Submit Results.
- Fill in the Specify Log Information dialog box and click OK.
- Click Select test case to run another test case, or click Log Off if finished.
To view the results, see Viewing Test Log Results.
- Select a build from the list.
- Select a log folder from the list.
- Accept the default log name, which is the same as the test case name, or type a new name.
- Click OK to continue.
- If a prompt appears asking if you want to overwrite the test log, do one of the following:
- Click Yes to overwrite the test log.
Click No to return to the Specify Log Information dialog box to change the build, log folder, and/or test log information.- Click Cancel to cancel saving the results.
To view the results of running a test case:
- Start Rational TestManager.
- Click File > Open Test Log.
- Navigate to the test log folder for the appropriate build and click OK.
- Under Display Builds, select how you want to display the builds in the Test Log window.
- Click the Details tab in the Test Log window.
- To view a comment for a manual test script right-click an event in the Event Type column, and then select Properties.
The General tab of the Log Event window displays the type of event, the date and time the event was recorded, the script name, the expected result, result details, and any other information about a log event. Any comment you write for a manual test script appears next to Additional Information.
- Click X to close the Test Log window of TestManager.
This section lists some problems that you may experience when running a test case from a Web browser and how to correct each problem.
Note: The error messages in this troubleshooting section are ManualTest Web Execution error messages, not Web browser error messages.
If you have problems with your Web server, check to make sure that your Web server meets the software requirements. For information, see Software Requirements.
Problem – Your Rational projects do not appear when you log into a Rational project. (You type http://machinename/alias and log into a Rational project.)
Error message – None.
Solution – All web clients use the same user account to access a Rational project either on a Web server (if the project is on the Web server) or on the domain (to access shared projects on other systems in the domain). There are two things to check:
- Check to make sure that the user account on the Web server or on the domain (for shared projects) has privileges to read and write into a Rational project. (Ask your administrator to check the privileges of the user account that the administrator sets up on the Web server.)
- To allow Web clients access, you must also log into this account when you create a new Rational project or register an existing Rational project using the Rational Administrator.
Problem - You cannot connect from a Web browser to a Web server running the Microsoft Personal Web Server (PWS).
Error message - None.
Solution - If you restart a Web server running PWS, PWS may not start automatically when the server restarts. This is an intermittent problem. To fix the problem, restart PWS.
- Click Start > Programs > Windows NT 4.0 Option Pack > Microsoft Personal Web Server > Personal Web Manager.
- Under Publishing, click Start.
- Click Properties > Exit.
Problem - When you log into a project from a Web browser, you get the following error message.
Error message - Unable to connect to project.
Solution - Make sure that the Web server privileges are set correctly. For information, see the Rational Server Products Installation Guide.Problem - You get an error message when you select a test case.
Error message - Error message that includesServer.ObjectCreate
in the message.
Solution - Make sure that you or the Web server administrator installs Microsoft Internet Explorer 5.0 or later on the Web server.Problem - When you type text in a dialog box and submit it, you get erratic behavior. Alternatively, when you open a manual test script, results and comments are already filled in from the last session.
Error message - None.
Solution - Disable caching on your Web browser by setting up your Web browser to run a test case. For information, see Setting Up a Web Browser.Problem - After you connect to the Web server, a Login dialog box appears. In the Login dialog box, the project select list is empty.
Error message - None.
Solution - In TestManager, create a project and test cases with manual implementations, or register an existing project that contains test cases with manual implementations.To create a project or register an existing project:
- Do one of the following:
- For IIS, log into the user account of the virtual directory that you configured to run a test case. For information, see the Rational Server Products Installation Guide.
- For PWS, log into the user account that the Web server runs under. For information, see the Rational Server Products Installation Guide.
- Start the Rational Administrator and create a new project, or register an existing project. For information about creating or registering a project, see the Rational Suite Administrator's Guide or the Rational Administrator Help.
- If you create or register a shared project, make sure that the privileges for the project directory are set for the virtual directory user account for IIS, or for the user account that the Web server runs under for PWS.
- Restart the Web server.
Make sure that your Web server and Web browsers conform to the following minimum requirements:
Web Server Requirements
Make sure that your Web server conforms to the following minimum requirements:
- Windows 2000 Professional, Windows 2000 Server, Windows 2000 Advanced Server, Windows 98, Windows NT 4.0 Workstation, or Windows NT 4.0 Server.
- Microsoft Internet Explorer 5.0 or later.
The following table lists the operating systems that you can use for a Web server and the appropriate Web server software that you must install for each operating system.
Note: We recommend that you use Windows 2000 Server, Windows 2000 Advanced Server, or Windows NT 4.0 Server, as the Web server platform. You cannot use a shared or networked project with the Windows 2000 Professional or Windows NT 4.0 Workstation.
Web Browser Requirements
To access the Web server as a client, use one of the following Web browsers:
Rational Test Login dialog box
User Name - Type your user name. If you do not know this, see your administrator.
Password - Type your password. If you do not know this, see your administrator.
Project - Click the arrow to select a project.
Note: If your project does not appear in the list of projects, be sure to use the Rational Administrator to register your project. For information about registering an existing project, see the Rational Suite Administrator's Guide or the Rational Administrator Help.Specify Log Information dialog box
Use to enter the build, log folder, and log for the results of running a test case.
Build - Select a build from the list.
Log Folder - Select a log folder from the list.
Log - Accept the default log name, which is the same as the manual test script name, or type a new name.
To learn how to fill in the Specify Log Information dialog box, see Specifying Log Information.
Options dialog box
Show test script without graphics - Select to improve the display speed of the manual test script Web page. Displays only text on the Web page. When selected, displays S for a step, VP for a verification point, and a check mark for a note or result.
Show only verification points - Select to show only verification points and hide all steps.
Log unchecked steps as warnings - Use this check box to indicate how you want unchecked steps to be marked in the log. When you open a test case with a manual implementation, you indicate that you have completed a step by selecting the Result check box. In the test log, each unchecked step can be marked as Warning or can be left blank. (Completed always appears for each checked step.)
If selected, Warning appears in the Result column of the test log for each unchecked step.
If cleared, the Result column is blank for each unchecked step.
Timeout interval in minutes (20-1440) - Sets the length of time, in minutes, before the Web browser session times out. You can set the time from 20 to 1440 minutes. The default time is set to 120 minutes.
To learn how to fill in the Options dialog box, see Setting Options.
Index
B - D - H - M - N - O - P - R - S - T - U - V - WB
- browsers
- requirements for running a test case
- setting up Microsoft Internet Explorer
- setting up Netscape Navigator
D
- dialog boxes
- Options
- Rational Test Login
- Specify Log Information
H
- Help, using
M
- main page
- manual test scripts
- about
- setting options for
- steps in
- verification points in
- Microsoft Internet Explorer
- setting up to run a test case
- Microsoft Personal Web Server
- troubleshooting
N
- Netscape Navigator
- setting up to run a test case
O
- options
- setting
- changing
P
- projects, shared
- PWS (Microsoft Personal Web Server)
- troubleshooting
R
- Results toolbar
- running test cases
S
- scripts, See test scripts.
- setting options for manual test scripts
- setting up Web browsers
- sharing projects
- software requirements
- specifying log information
- Standard toolbar
- steps in manual test scripts
T
- test cases
- overview of tasks
- running
- viewing results of run
- Web browsers for
- troubleshooting
- test logs
- specifying information for
- viewing results of
- Test Case tree
- test scripts, manual
- about
- setting options for
- steps in
- verification points in
- troubleshooting
U
- UNC (Uniform Naming Convention)
- and shared projects
V
- verification points in manual test scripts
W
- Web browsers
- setting up
- software requirements for
- Web servers
- software requirements for
- troubleshooting
- work area
Copyright Notice
Copyright © 2000-2003 Rational Software Corporation. All Rights Reserved. This documentation (the Rational TestManager Help system) is protected under the copyright laws of the United States and/or other jurisdictions, as well as various international treaties. Any reproduction or distribution of the Rational TestManager Help system is expressly prohibited without the prior written consent of Rational Software Corporation.
Legal Notices Information
Rational Software Corporation
http://www.rational.com
Voice: (800) 433-5444
Fax: (800) 863-4000
support@rational.com
sales@rational.com