Rational Testing Products Release Notes
Release 2001.03.00
Copyright © 2000 Rational Software and its subsidiaries. All rights reserved.
November 2000About These Release Notes
Scope--Product Definition
Getting Started
- Installation Information and System Requirements
- Installation Issues
- Installing on German Windows 98
- Uninstallation Requirements
- Installing Rational TeamTest and Rational Robot
- Minimal Installation
- Evaluation Artifacts
- TeamTest and EnterpriseStudio Installation
- Internationalization
New and Changed Features
- Rational Administrator
- New Project Functionality Replaces Repositories
- Unified Change Management
- Configuring Projects and Datastores
- Rational TestManager
- Rational LoadTest
- Rational Robot
- Inprise Delphi Support
- Oracle Forms 6.0 Support
- Netscape Record
- Netscape Playback
- New Protocol Support: DCOM
- Protocol Upgrades
- SQABasic Path
- New SQABasic Commands
- StartAppUnderCoverage
- StartAppUnderNone
- StartAppUnderPnC
- StartAppUnderPurify
- StartAppUnderQuantify
- Rational PerformanceArchitect
- Rational SiteCheck
- Customized Reports
- New Advanced Options Wizard
- Expanded Link Parsing
- New Path View
- New Verification Point
- Replace Links Feature
- Silent Robot Test Script Playback
- Smart Rescan
- SiteMonitor Warning Messages
Late Changes to Documentation
- Rational TestFactory
- General
- Running Pilots With Code Coverage on Win9X/ME
Guidelines and Restrictions on Using Rational Test Products
- Rational Robot
- Playback Under Purify, Quantify, or PureCoverage
- Displaying the Euro Symbol
- Session Recording and Test Script Generation
- Rational Administrator
- Rational TestFactory
- Changing the System Font Size between Mapping Sessions
- Moving a TestFactory Project for a Visual Basic Application to a Different Operating System
- Recommended Java Virtual Machine
- Mapping and Testing Java Applications Developed Using the Java Development Kit 1.1.8 or an Earlier JDK Release
- Installing the Rational Test Java Enabler before Mapping a Java Application
- Inprise Delphi Not Supported
- Rational SiteCheck
- ActiveScan View
- Charset
- Customizing Files Added by Rational SiteCheck
- External Links
- Previously-Saved Site Maps
- Scanning Large Sites
- Scanning Subdirectories
- Simultaneous Connections
- Site Comparison
- SQL Anywhere Database Server
- Hardware and Software Requirements for SQL Anywhere Server
- Other Information about SQL Anywhere Server
Defects/Change Requests
- Rational SiteCheck
- Multiple Instances of SiteCheck
- ActiveX Controls
- Assertions
- External Links
- HTML Reports
- Microsoft Word Files
- Rational Robot
- Renaming Files
- Right-click Defects
- Site Map Properties
- Smart Rescan
- Stop Commands
- URL Mining
- Other
- Site Monitor Issues
- Path to Sample Web Site
- Windows Millennium Edition
- Rational Robot
- Pop-up Menu in Robot Script Window
- Selecting Verification Points in the Script Window
- Rational Robot -- General and Miscellaneous
- Rational Robot - PowerBuilder and Japanese Operating Systems
- Rational Robot--Timeout Problem with Windows 2000
- Rational Robot--Java Support
- Rational Robot--HTML Support
- Rational Robot--Visual Basic 4.0 Support
- Rational Robot--DCOM Support
- Rational Robot--Oracle Forms Support
- Rational Robot--PowerBuilder Support
- Rational TestFactory
- Working with Third-Party Controls
- Running Test Scripts Generated for a Java AUT from Robot without Running TestFactory
- Testing a Java Application that Runs on the Sun Java Virtual Machine
- SQABasic
Contacting Rational Technical Support
About These Release Notes
These Release Notes provide information that is not available in the printed documentation or the Help for Rational Robot, TestManager, SiteCheck, TeamTest, and TestFactory.
Scope--Product Definition
This release incorporates major changes and additions to the Rational Test product line.
- TestStudio now supports functional, distributed functional, and performance testing.The distributed functional and performance testing capabilities that Rational Suite PerformanceStudio contained have been moved to Rational Suite TestStudio.
- Rational TestManager has been expanded. It now contains the Test Log window and incorporates the functions that were previously found in Rational LoadTest.
- TestManager is now the one place in the Suites to manage all testing activities--planning, design, development, execution, and analysis. TestManager ties together testing with the rest of the development effort, joining your testing assets and tools to provide a single point from which to understand the exact state of your project. TestManager can be purchased as part of any Suite, part of Robot or TeamTest, or as a stand-alone product.
- For more last minute information on Rational TestManager, see the Rational TestManager Release Notes.
- Rational has introduced Rational QualityArchitect for testing Enterprise JavaBeans and COM components. Rational QualityArchitect is included in Rational Suite DevelopmentStudio, Rational Suite Enterprise, and Rational Rose Enterprise.
Getting Started
Installation Information and System Requirements
You will find complete installation instructions and system requirements in the Installing Rational Testing Products manual, which is available as a printed book andelectronically as a PDF file on the Rational Solutions for Windows Online Documentation CD, which also includes a version of the Acrobat Reader.
Installation Issues
Installing on German Windows 98
If you install Rational Suite Enterprise on German Windows 98, you may see the following error message prior to rebooting:
A system error occurred while copying <CD-ROM Drive>:\coverage98\win98\testfactory.mkr to <Destination Drive>:\coverage98\testfactory.mkr: Zugriff wurde verweigert.
You can ignore this message since the file in question, testfactory.mkr, is not needed to run Rational applications and does not corrupt the install.
Uninstallation Requirements
Before you install the current Rational testing product(s), you must uninstall any earlier versions of the following products:
- Rational Suite TestStudio
- Rational Suite Enterprise
- Rational Suite PerformanceStudio
- Rational Robot
- Rational TeamTest
- Rational LoadTest
Note: Rational LoadTest functionality is now included within Rational TestManager. Previous versions of Rational LoadTest will not work in conjunction with any testing products from the current release and must be uninstalled before installing this release.
Installing Rational TeamTest and Rational Robot
You can find complete installation instructions and system requirements in the Installing Rational Testing Products manual. This manual is available as a printed book and electronically as a PDF file on the Rational Solutions for Windows Online Documentation CD.
Minimal Installation
The Minimal Install functionality of Rational products is not supported in this release. You must choose the Typical or Custom/Full options to install your Rational product(s). For additional information about installing Rational products, see your product's Installation manual.
Note that the installation manuals may include information on minimal installations. That information is no longer valid.
Evaluation Artifacts
Evaluation artifacts are not included as a part of this installation procedure. As a result, when you select the Evaluator option on the Software Use page of the Rational Software Setup program, sample data will not be installed.
To obtain the sample data, download the Rational Suite Tutorial from http://www.rational.com/documentation.
TeamTest and EnterpriseStudio Installation
Certain DLL stubs are not being updated correctly in the installation procedure for Rational TeamTest and Rational EnterpriseStudio. This affects generation of VU test scripts from sessions in Rational Robot. To update the DLL files, run the rtfxdlx utility:
- From a DOS prompt, move to the Rational Test install directory. The default location is C:\Program Files\Rational\Rational Test.
- Type rtfxdlx and press Enter.
Internationalization
- The Web Site verification points in Robot do not support Kanji or any other Asian character sets at higher than Rational Internationalization Level 1 - that is, software that can be installed and used on U.S. English and all specified international operating systems. All displays, menus, controls, wizards, reports and user documentation are in U.S. English. You must enter all data using U.S. English.
- OCR in the Image verification points in Robot does not support Kanji as a character set or Japanese as a language. It also does not support the other Asian character sets, including Katakana, Hiragana, Traditional Chinese and Simplified Chinese.
New and Changed Features
Rational Administrator
New Project Functionality Replaces Repositories
A Rational project is an entity that manages the association of Rational Test datastores, RequisitePro projects, ClearQuest databases, and Rose models. Repositories are no longer created by the Administrator or used by any Rational Suite tools.
You can migrate repositories from Rational Suite version 1.0, 1.1, 1.5, 2000, or from any test products marked as 7.x, such as Rational Robot 7.x, to projects. In addition, a special Rational v. 2000 CD is available that converts your 6.x repositories to v. 2000. This converted repository can then be migrated to v. 2001.
Note: Back up your current repository before upgrading. The upgraded project will most likely not be reusable in the final release of this product.
Unified Change Management
The Rational Administrator provides access to many of the features of Rational Unified Change Management (UCM). UCM is the Rational Software approach to managing change to requirements, design models, documentation, components, test cases, source code, and so on.
UCM is unique because it links the activities used to plan and track project progress to the artifacts undergoing change. UCM is based on two key concepts: activity-based Configuration Management (CM) and parallel development.
You can place the information in a Rational project under configuration management using Rational Administrator by associating a Rational project with a UCM project. Use Rational ClearCase to create a UCM project first, and then create a Rational project and UCM-enable it. A version of ClearCase ships with the Rational Suites.
Configuring Projects and Datastores
When you create a project, you must also configure it. Configuring a project associates Rational Test datastores, RequisitePro projects, ClearQuest databases, and Rose models with the project and optionally brings them under configuration management.
A Rational Test datastore contains all test assets (test scripts, suites, datapools, logs, reports, test plans, build information, and more) except users and groups, which are themselves contained in a separate datastore.
As part of the UCM support in Rational Suite, both the Rational Test datastore and the RequisitePro project may be UCM-enabled. Once UCM-enabled, they can be integrated with ClearCase so that baselines of the test assets and requirements may be created and then associated with a new Rational Administrator project.
Rational TestManager
Rational TestManager has been redesigned with a much broader scope. TestManager now contains the Test Log window and incorporates the functions that were previously in Rational LoadTest. For last minute information regarding TestManager, see the Rational TestManager Release Notes.
Rational LoadTest
Rational LoadTest functionality is now part of Rational TestManager. TestManager also contains the TestLog window (formerly called LogViewer) and other new testing features. For information on performance testing changes, see the Rational TestManager Release Notes.
Rational Robot
Inprise Delphi Support
Robot now supports the testing of applications built with Inprise Delphi. It supports Delphi versions 3.0, 4.0, and 5.0. To test Delphi applications, you must install the Rational Object Testing Library for Delphi and the Rational Test Delphi Enabler. You then need to run the Enabler and recompile your project in Delphi to make it Robot-testable. For information on installing and using the Delphi Enabler, see the Robot Help.
Oracle Forms 6.0 Support
Robot now supports the testing of applications built with Oracle Forms version 6.0. (You can also test applications built with versions 4.5 and 5.0.) This includes support of a new Oracle object, the Oracle Tree (Tree-view). To test Oracle applications, you must run the Rational Test Oracle Forms Enabler. For more information on testing Oracle Forms applications, see the Robot Help.
Netscape Record
Robot can now record against Netscape Navigator.
Netscape Playback
Playback on Netscape Navigator has been enhanced. Whether you record on Internet Explorer or on Netscape, playing back HTML tests on Netscape has been improved. In order to work with controls that do not present an adequate object model, this new feature uses a form of pattern recognition that retrieves data from rendered pixels.
New Protocol Support: DCOM
Robot supports the DCOM protocol. When you record a DCOM session, a test script in the Visual Basic language is generated.
Protocol Upgrades
- Microsoft SQL Server 2000
- Oracle 8.1 (API recording only)
- DB-LIB and ODBC API capture for SQL Server 7 and SQL Server 2000
You can now record test scripts that access SQL Server 2000 and Oracle 8.1. For recording test scripts against the SQL Server, the DB-LIB and ODBC APIs are now supported.
SQABasic Path
Robot now has a user-definable SQABasic path for library and header files.
SQABasic library and header files that are in the SQABasic path are available to test scripts in multiple projects. To set the SQABasic path:
- Click Tools > General Options.
- Click the Preferences tab.
- Set the path in the box under SQABasic path.
New SQABasic Commands
StartAppUnderCoverage
Starts the specified application from within the currently running test script under Rational PureCoverage.
StartAppUnderNone
Starts the specified application from within the currently running test script under none of the Rational diagnostic tools (Rational PureCoverage, Rational Purify, or Rational Quantify).
StartAppUnderPnC
Starts the specified application from within the currently running test script under Rational Purify with code-coverage data.
StartAppUnderPurify
Starts the specified application from within the currently running test script under Rational Purify.
StartAppUnderQuantify
Starts the specified application from within the currently running test script under Rational Quantify.
Rational PerformanceArchitect
The functionality provided by the existing Rational PerformanceArchitect product has been incorporated into the new Rational QualityArchitect product, which is available as part of Rational Suite Enterprise, Rational Suite DevelopmentStudio, and Rose Enterprise.
Rational SiteCheck
Customized Reports
You can now create your own List View reports and customize standard reports using the new Report Editor dialog box. Click List View > Report Editor.
New Advanced Options Wizard
You can now set more comprehensive advanced options and scan preferences using the new Site Settings wizard. Click Settings on the Open Site dialog box.
Expanded Link Parsing
Rational SiteCheck can now parse links within JavaScript, such as those set using the Location object, provided the links don't use variables or calculations to determine the result. Select the Mine for URLs in JavaScript option on the first page of the Site Settings wizard.
New Path View
SiteCheck can now generate a set of hierarchical browse paths in which all pages of a site are visited at least once. Each path contains a unique group of links that represent how a user might drill-down into a site for information. You can run each path separately to simulate how a user browses to information. Click the Path tab of the File View.
New Verification Point
A third verification point is now available. A Web Page Scan verification point focuses on a single Web page to ensure that changes have not resulted in defects. This feature lets you target pages that are central to successful user transactions.
Replace Links Feature
When you drag a file from File View and drop it onto an internal link in Source View, the Replace Links dialog box opens. You can then replace that internal link with the new link throughout the Web site or replace just the current link.
Silent Robot Test Script Playback
When a Rational Robot test script is replayed for a Web Site Compare verification point, SiteCheck now runs silently in the background.
Smart Rescan
This feature compares pages on the active site with the last site map and then scans only those pages where the last-modified-date attribute is greater than the date of the site map. Select the Perform Smart Rescan option when you open a site map.
SiteMonitor Warning Messages
SiteMonitor now has a third type of message that can result from a scheduled event, Warning. It is indicated in the main window by a yellow "light". Warnings apply to events that execute completely while still finding defects.
Late Changes to Documentation
Rational SiteCheck
Help Button on the Export As Dialog Box
The Help button on the Export As dialog box is not functioning correctly. The Help topic for that dialog box is as follows:
Export As Dialog Box
You can export any List View report as a table for use in an HTML document, or as a comma-separated text file for use in a spreadsheet package or word-processing document.
Before exporting, ensure that List View contains all the columns you want, in the order that you want.
- Select a folder where your export will be saved.
- Enter a file name.
- Select a file type (Save as type).
- Click Save to proceed with the export.
Rational TestFactory
General
- The TestFactory documentation refers to a standalone source code instrumentor for VB apps called sqa7sci. This is now called rtsci.
- The documentation contains a reference to a Robot Scripts folder that is used for the storage of test scripts generated by or imported from Robot. This folder no longer exists. Robot test scripts can be created and directly placed in the application map.
Running Pilots With Code Coverage on Win9X/ME
The PATH environment variable is not updated with the location of the PureCoverage utilities during installation on Windows Me, Windows 98, or Windows 95. This prevents Pilots from being run on all instrumented Visual C++ applications, object code instrumented (OCI) Visual Basic applications, and all Java applications.
For the Pilot to function properly, the directories "Product_Install"\coverage95 and "Product_Install"\coverage95\cache must be added to the PATH manually, where "Product_Install" defaults to "DRIVE:\Program Files\Rational\".
Guidelines and Restrictions on Using Rational Test Products
Rational Robot
Playback Under Purify, Quantify, or PureCoverage
Keep the following in mind during Robot playback under Purify, Quantify, or PureCoverage (PQC):
- The PQC data file is not produced until the application-under-test terminates.
- PQC takes a small amount of time (seconds or less) for the PQC data file to become available after the application-under-test is terminated. Therefore, when displaying PQC informational messages in the LogViewer, it is possible that the PQC data file (.pfy, .cfy, or .qfy files) may not be available immediately.Any scripts recorded with Netscape Navigator must also be played back with Netscape.
Displaying the Euro Symbol
By default, the FixedSys font used by Robot does not display the Euro symbol. You can force Robot to display the Euro by changing the font to Courier or another font that supports the Euro symbol.
Session Recording and Test Script Generation
Session recording and generation of VU and VB test scripts is not supported for Windows ME, Windows 98, and Windows 95.
Rational Administrator
- Deleting a project containing an attached ClearQuest database leaves behind a file named TrackingCQ.Dat. To recreate the project under the same directory name you must first manually delete the old directory containing this file.
- In addition, the Rename Project function has been disabled.
- Use of the Rational Administrator under Windows NT and Windows 2000 systems requires system Administrator privileges. If you attempt to connect to a project without write access privileges to the project, Rational Administrator may crash.
Rational TestFactory
Changing the System Font Size between Mapping Sessions
If you change the size of the system font between mapping sessions, you also change the size of dialog boxes and the placement of controls within those dialog boxes. TestFactory recognizes previously mapped dialog box controls as new controls and maps them as such.
Work-around:
- Change back to the system font size used previously.
- Delete all objects (except the StartAUT object) in the application map, and then map the application-under-test from scratch.
If you change the size of the system font after you map the AUT, and you then try to run a Pilot, the Pilot run fails. TestFactory sees the controls that contain the changed text as unmapped controls.
Work-around:
- Change the system font size to the size used when you mapped the AUT.
- Delete all objects (except the StartAUT object) in the application map, map the AUT from scratch, and then proceed with testing.
Moving a TestFactory Project for a Visual Basic Application to a Different Operating System
If you map a Visual Basic application on the Windows 95 or Windows 98 operating system, and you then move the project to Windows NT or Windows 2000 and remap the application, any message box mapped previously is remapped as a duplicate window. This also occurs if you map the Visual Basic application first on either Windows NT or Windows 2000, and then remap the application on Windows 95 or Windows 98. This mapping inconsistency occurs because the size of button controls on a message box is not consistent between operating systems.
Work-around:
- Do not switch to a different operating system after mapping the Visual Basic application-under-test.
- If you must move the project to a computer with a different operating system, delete the message box object in the original application map, and then remap the area of the AUT that contains the message box.
Recommended Java Virtual Machine
This release of TestFactory supports the running of Java applications on the following virtual machines:
Mapping and Testing Java Applications Developed Using the Java Development Kit 1.1.8 or an Earlier JDK Release
If the application-under-test was developed using the Java Development Kit (JDK) 1.1.8 or an earlier release, you cannot use the Java virtual machine included with that JDK to run the application during mapping and testing from TestFactory. Instead, you must use the Jview virtual machine or the Java virtual machine included with the JDK 1.2 or later release.
Installing the Rational Test Java Enabler before Mapping a Java Application
If you map a Java AUT without first installing the Rational Test Java Enabler, the resulting application map contains only a top-level window object and an exit transition object. To correct the problem, install the Rational Test Java Enabler, delete the top-level window and exit transition objects, and then remap the Java application.
You can install the Rational Test Java Enabler from the Rational Software Setup program. For information about how to run the Rational Test Enablers, see the following manuals: Installing Rational Suite or Installing Rational Testing Products.
To install the Rational Test Java Enabler, click Start > Programs > Rational Product Name > Rational Test > Java Enabler, and then follow the instructions provided on the install wizard.
Inprise Delphi Not Supported
TestFactory does not support Inprise Delphi applications.
Rational SiteCheck
ActiveScan View
ActiveScan View requires that Microsoft Internet Explorer 4.0 or later is installed. ActiveScan View does not work with Netscape Navigator because this browser cannot be embedded into an application at this time. You can use any Web browser in the Browser View.
Charset
SiteCheck does not support the 'charset' attribute of the 'Content-Type' META tag - e.g., <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-2022-jp">.
Customizing Files Added by Rational SiteCheck
In Rational SiteCheck, you can add an HTML file to your site by choosing Edit > Create a New HTML File. To customize the file that is added by this command, just modify or replace the template file rtnew.htm located in the Rational SiteCheck Template subdirectory.
Similarly, to customize the message page that LinkWizard generates for moved or deleted pages, modify the template files rtmoved.htm and rtdel.htm. However, in the rtmoved.htm template, do not change any reference to %new_URL%. LinkWizard replaces this text with the URL for the moved file.
External Links
All external links that do not refer to a specific HTML file are displayed in Page View and List View using the default page name for the file name (from the Open Site dialog box). For example, an external link to http://www.rational.com is displayed as http://www.rational.com/index.html. This does not affect any functionality. The actual HTTP requests for this link do not include the default page name.
(See also External Links under "Defects and Limitations" later in these notes.)
Previously-Saved Site Maps
Site maps are closely associated with the original site. So, when a site map for a local site is reopened and edited, the changes are made to the actual local site.
Scanning Large Sites
The table below displays recommended system configurations for different sized sites:
Scanning large sites might require more memory than the minimums documented. A guideline for the memory requirement is 1.5 MB of available free memory for every 1,000 links. Therefore, a site with 10,000 links will require approximately 15 MB of available virtual memory.
SiteCheck may take several hours to completely scan a very large site. To reduce memory requirements during the scan, we suggest that you change to the Site Properties View.
We recommend using Rational SiteMonitor for scanning large (or busy) sites. In SiteMonitor, create an Analyze Site event and then schedule it to be run when the server is not busy (such as at 1:00 a.m.). For more information, see the Rational SiteMonitor Help.
Scanning Subdirectories
We recommend that you use a multiserver entry on sites where the server redirects the browser to a subdirectory of the site. Click the Servers button on the General dialog box of the Site Settings wizard to define the servers in your multiserver Web site.
Simultaneous Connections
If you are running SiteCheck on a workstation that is, relatively speaking, much faster than the Web server, reduce the simultaneous connections to 1.
- Click Tools > Preferences, and then click the Scan Options tab.
- Change the default setting for Simultaneous Connections.
The default setting is 4. By reducing the value to 1, you reduce the effects of the scan on other users of the Web site. Alternatively, you can set simultaneous connections for individual site scans on the first page of the Site Settings wizard.
Site Comparison
When SiteCheck performs a Web Site Comparison, it only examines the internal structure of two Web sites. Links to external pages are not checked. This may cause conflicting results if the baseline or comparison site is a previously saved site map file that checked external links.
SQL Anywhere Database Server
Hardware and Software Requirements for SQL Anywhere Server
- Your network server must be an Intel-based PC, a Windows NT 4.0 or Windows 2000 Server, or a Windows NT 4.0 or Windows 2000 Workstation.
Note: If you plan on making more than ten connections to a repository, we recommend that you use a Window NT Server as your database server. A Windows NT Workstation allows only ten network connections.
- Pentium processor
- 64 MB memory
- 100 MB disk space
- TCP/IP
- Novell NetWare software is NO LONGER supported for network servers.
Other Information about SQL Anywhere Server
- In this release, only Rational ClearQuest uses the SQLAnywhere server.
- During the installation of a SQL Anywhere Server, select Replace these files with English equivalents independent of the language environment in which you are working. Microsoft recommends this because selected files must be replaced with their English equivalents.
- SQL Anywhere database treats the \ (backslash) character as an escape character. This causes a translation of the backslash character and the subsequent character as they are added to the database. For example '\\' becomes '\', and '\n' becomes an unprintable character, etc.
Defects/Change Requests
Rational SiteCheck
Multiple Instances of SiteCheck
At present, you can have only one instance of SiteCheck running at a time. A second instance overwrites data used by the first. Avoid running more than one instance.
ActiveX Controls
Files with the .ocx file extension are not currently recognized in List View as ActiveX controls and do not appear in the report when your click List View > Files and Links > ActiveX Controls.
Assertions
It is possible to have both an assertion that tests for the absence of an HTML object and an assertion that tests for the presence of the very same HTML object. SiteCheck does not notify you of this conflict.
The Global Assertion feature and the Smart Rescan feature can cause some confusion in some cases. Smart Rescan scans only pages that were changed since the last scan. If you add or modify a global assertion between the original scan and the rescan, the assertion will be applied only to the rescanned pages, not the entire site. If you add or modify a global assertion, consider rescanning the entire site.
External Links
After you change the source of an HTML file (in Source View), a page reference to an external link that does not terminate with a slash (such as, http://www.asite.com/something), reverts to an unchecked state. If the link is properly terminated with a slash (such as, http://www.asite.com/something/), this problem does not occur. A simple workaround is to manually recheck the links.
When you execute the command Tools > Check Links to External Sites, do not click the Re-Check Link or Check Link commands for an external link until the first check is finished. If you do, the scan engine may become confused and indicate negative numbers of links remaining to check.
HTML Reports
The ability to automatically generate HTML reports at the end of a scan is not currently available. This option, when available, is on the Defects page of the new Site Settings wizard. You can generate your HTML reports manually. Do the following:
- Activate List View.
- Click List View > HTML Reports.
- Select the type of defects your want to report.
- Optionally, change the path where your reports should be saved.
- Click OK.
Microsoft Word Files
SiteCheck can parse and verify links embedded in Word files. Currently, if you attempt to parse a password-protected Word file, you are prompted to enter the password.
Do not attempt to fix a broken link in a parsed Word document using SiteCheck. Doing so can corrupt the Word document. Fix the link in Word.
Rational Robot
The baseline site for a Web Site Scan verification point is not correctly loaded when it is opened from the verification point frame of a Robot test script. To correctly open baseline site:
We recommended that you do not define a Wait State when recording a Web Site Scan or a Web Site Compare verification point. SiteCheck does not consider these setting during a site scan.
If your network has a Proxy Server and you have not configured the Proxy Server settings in SiteCheck, Robot test scripts that include Web Site Scan or Web Site Compare verification points will not play back properly. To configure the Proxy Server settings:
- Start SiteCheck.
- Click Tools > Preferences.
- Click the HTTP Options tab, and then click Proxy Settings.
- Do one of the following:
Renaming Files
If you have a Word document or Excel spreadsheet displayed in Browser View, you cannot rename it in File View. Switch to another view first. Renaming is available on local sites only.
Right-click Defects
Do not right-click the List View title bar. This action puts the view into pan mode, which is not effective in this view. To undo this action, first press F1. (This opens a help window, which you can close or leave open.) Next, switch to Page View and left-click anywhere in the view.
Occasionally, when a right-click menu and dialog box are visible at the same time, the interface appears to freeze. If this happens, press the ESC key several times.
Site Map Properties
Currently the Total Scan Time property shown for a site map in Site Properties View gives the incorrect value.
Smart Rescan
When Smart Rescan locates a Web page that does not return a last-modified-date value, it is supposed to issue a warning message. Currently, no message is issued.
When Smart Rescan is in operation, the Stop button and the File > Stop Reading Site command are currently not available.
(See also Assertions under "Defects and Limitations" earlier in these notes.)
Stop Commands
Currently, when you execute the command Tools > Check Links to External Sites, the Stop button and the Tools > Stop Checking External Links command do not work.
(Also see Smart Rescan above.)
URL Mining
The URL Mining feature, which is new for this version of SiteCheck, may fail in rare circumstances and cause a GPF. If this does occur, turn off this feature before you start a scan:
- Click File > Open Site or click the Open button.
- Click Settings.
- On the first page of the Site Settings wizard, clear the Mine for URLs in JavaScript option.
- When you have made all other wizard settings, click Finish.
If you choose to leave this feature on, please let us know which of your JavaScript-based URLs fail. Your contributions can provide us with circumstances that we cannot duplicate in our QA department.
Send your reports to support@coast.com.
Other
If you minimize the SiteCheck window while Source View is active, not all the maximizing and restoring options work in all versions of Windows. In some cases, you can maximize the window only by clicking SiteCheck on the task bar. In other cases, you need to right-click SiteCheck on the task bar and select Restore or Maximize.
Site Monitor Issues
A Check Server Response event may fail on certain types of Web servers if the server does not identify itself as an HTTP server. To fix this, change the type of event to an Analyze Site event and only scan one level of the site.
The Site Comparison feature is not currently available in SiteMonitor.
Path to Sample Web Site
When you start SiteCheck the Open site dialog box appears. In the Path list box, the path to the sample Web site that the SiteCheck TryIt uses is incorrect.
Windows Millennium Edition
The following are known limitations found when running under Windows Millennium Edition:
- When you open a manual test script using the Grid Editor in the manual test editor, part of the text disappears, word wrap does not work, and the backspace and delete buttons do not work. To restore the missing text, you must click another step or verification point and the text will display correctly.
- When you create an object data verification point on a grid or a data window using Rational Robot, the object data verification point window does not display row numbers or column names for the grid.
Rational Robot
Pop-up Menu in Robot Script Window
The pop-up menu is not working correctly in the left pane of the Robot script window. The pop-up menu is invoked by a right mouse click on certain items in the hierarchy, such as a verification point. To access the pop-up menu, right-click the item twice.
Selecting Verification Points in the Script Window
In Robot's script window, when you select a verification point in the tree hierarchy in the left pane, you have to right click the verification point twice to get the pop-up menu to appear. For example:
- Open a test script with verification points.
- Left-click a verification point to select it.
- Right-click it to twice to invoke the pop-up menu.
Note: If you already have a verification point selected, it will work correctly on one right-click. But if you left-click it and then right-click, you have to do it twice.
Rational Robot -- General and Miscellaneous
- Robot records the Property Name for a radio button as case-sensitive. Previous versions of Robot allowed you to manually code test scripts using the SQASetProperty function to be case insensitive. If you manually coded test scripts with the SQASetProperty function, and the Property Name was case independent, you must update the code to be case-sensitive or the object will not be recognized.
- The Start menu on Windows systems is a graphical object. Depending on the OS version and whether Active Desktop is installed, the Start menu can be implemented in the underlying software either as an owner-drawn menu whose text is not available via standard Windows mechanisms or as a Toolbar. Because of this, we strongly recommend that you do the following:
- Do not record against the Start menu. Instead, add a SQAShellExecute or StartApplication command to the test script.
- If you play back a test script immediately after a verification point is recorded, the verification point can fail. If this happens, Robot displays the following message: "Unable to read the verification point data file." This failure is due to the operating system not flushing the file cache. The verification point will succeed upon subsequent playbacks.
- Individual text values returned by the Object Properties verification point or by SQAGetProperty are limited to 1,000 characters in length.
- For certain controls, the Object Properties verification point always shows an empty value for the Text property. These controls may appear to have visible text on the screen, but do not make the property available. The HotKey common control is an example of this behavior.
- When you record an Object Properties verification point and check Automatically close dialog box after selection in the Select Object dialog box, the Object List dialog box sometimes remains open. To continue recording, you must manually close the Object List dialog box.
- In previous releases of Robot, the Toolbar Alignment property was recorded with a value of Bottom regardless of its location in the application-under-test. Robot now records the correct value. If you encounter a failure for this property in a previously-recorded Object Properties verification point, copy the actual data to the baseline.
- Some development environments, such as PowerBuilder, allow the creation of dynamic TreeViews. The Object Data verification point might not initially capture all tree levels for dynamically created TreeViews until each level has been selected. Once selected, these levels will appear in the Object Data verification point dialog box, by selecting it and using the Edit > Copy to Baseline menu command.
- The Alphanumeric verification point does not recognize "soft controls" such as Visual Basic labels. To test or capture the text of such controls, use the Object Properties verification point or a custom Object Data verification point, or the OCR feature of the Image verification points.
- The UserDefinedVP test function is no longer supported in Robot. For example, if you attempt to perform an Insert > Alphanumeric verification point and you choose Apply a User-Defined DLL test function, you will not be prompted for the name of the DLL and the function name. Instead, you will see the error message "Unable to write library and function name."
- We recommend that you declare your DLL in a Header file (*.SBH) as you would any other DLL. When you call the function later in your test script, log the result using SQALogMessage. For example:
'$Include "YourHeader.sbh" Sub Main Dim Result As integer Result = MyFunction(Parm1, Parm2) SQALogMessage Result, "MyFunction" , "Additional information about MyFunction" End Sub
- In some cases, passing a user-defined data type variable to a subprocedure causes Robot to crash. To avoid this problem:
- Declare a local variable as the same user-defined data type as the global variable.
- Pass the local variable to the subprocedure, where it is modified.
- Assign the local variable to the global variable. For example:
Dim MyGlobalVariable as UDT Dim MyLocalVariable as UDT Call MyProc(MyLocalVariable) MyGlobalVariable=MyLocalVariable- Some applications might change the state of certain menu items (such as Cut, Copy, Paste) based on items in the Clipboard, or on the current position of the cursor when moving from one window of the application to another. This can cause some Menu verification points and some Menus data tests that rely on the state of these menu choices to fail. If testing the state of a menu is not necessary, simply clear the Test Menu States option in the Menu verification point dialog box when capturing your data. You can also deselect those menu choices from any Menu verification points that consistently fail.
- Robot plays back incorrectly against a list box control that contains check boxes. The mouse click is played back in the center of the list box item instead of on the check box. The workaround is to use the space bar to check or clear the item.
- Robot drops ampersands from the recognition strings in a test script. This may cause problems on playback of actions on certain types of controls. The commands "ListView [Dbl]Click ..." and "TreeView [Dbl]Click ..." with the ampersand dropped from the "ItemText=..." line are the cases where playback problems usually occur. For example, if you record a click on a file called "a&b" in the ListView in Windows Explorer, you may get the following recognition string:
ListView Click, "ObjectIndex=1;ItemText=ab", "Coords=25,14"
- Instead of the correct recognition string:
ListView Click, "ObjectIndex=1;ItemText=a&b", "Coords=25,14"- Since the missing ampersand does not always cause playback problems, we recommend that you manually add the ampersand to a command in the test script only if Robot cannot play back the command properly.
- The MenuIDSelect command does not validate the menu ID or check that the menu item is enabled. This can cause the application-under-test to crash during playback.
- The installation of the ATIPLAY software that comes with many ATI video boards may cause Robot to fail in certain circumstances. This occurs because of incompatibility with a third-party component (LeadTools) installed by both Robot and the ATIPLAY software. The incompatibility manifests itself as a failure when recording and playing back Robot's "StartBrowser" command for Internet Explorer.
- To resolve this problem, copy the LeadTools DLLs from the "Rational\common" directory into the "Rational\Rational Test" directory to ensure that Robot loads only those DLLs which are redistributed. The files you must copy are:
- ltkrn62n.dll
- lfcmp62n.dll
- lfwmf62n.dll
- ltfil62n.dll
- ltimg62n.dll
- lfbmp62n.dll
- During printing, lines that are too long for the margin settings will be truncated. To fix this, adjust the margin setting or switch to a smaller font size.
- To enable Robot to capture data correctly from a data control in Visual Basic, set the data control's RecordSetType property value to Dynaset. Using Table as the RecordSetType property might give unexpected results.
- The toolbar Count property value includes toolbar buttons that are used as spaces or separators between other buttons. As a result, the count value may reflect a higher number than the number of visible toolbar buttons.
- Robot uses a fixed-size table to store information about object classes. If you exceed the size of the table, you will see the message "Object information (GUIOBJ.DAT) too large." In the unlikely event that this should occur, edit the GUIOBJ.DAT file found in your repository and remove classname entries that are not necessary in your test environment.
- Robot does not reliably record or play back mouse actions on a FarPoint Button Maker OCX.
- If you close applications with the ALT-F4 key sequence, you might notice a delay on the InputKeys statement during test script playback. Workarounds include using the mouse to close the window or modifying the test script by replacing the InputKeys statement with Window CloseWin, "", "".
- During recording, if you click the "What's This?" question mark in a dialog box and then click a control (so that a popup appears), your system will freeze for a few seconds if you click anywhere else without closing the popup. Either click the popup to close it before clicking anywhere else, or wait a few seconds until your system unfreezes.
- The WindowVP function silently accepts invalid values for the STATUS parameter.
- Failed Comparator files brought forward from SQA Robot version 6.x to Robot version 2000 cannot be viewed by the version 2001 Comparators.
- In the Object Properties Comparator, when you replace a baseline file with an actual file, and then view the Verification Point Properties, the file path names are not fully displayed.
- Robot has a known limitation when recording the action of holding down the primary mouse button on any of the arrow buttons in a scroll bar. Only one scroll line command will be recorded in this instance. To create a reliable test script for playback against a scroll bar, click the scroll bar arrow button the appropriate number of times for the desired scroll bar position. Robot will record a scroll line command for each click that is performed.
- Recording the Windows Start menu with Robot does not work if Active Desktop is installed.
- Robot does not support record and playback actions against AVI/VRML objects embedded in HTML via the following tag:
<IMG DYNSRC=>
- Clicks will be recorded as GenericObjects.
- When recording and playing back an HTML document that includes list box selections, make sure the text in any list box does not exceed 80 characters.
Rational Robot - PowerBuilder and Japanese Operating Systems
Certain configurations of PowerBuilder DropDownDataWindows will not record and play back correctly on Japanese operating system. When recording item selection on a drop down data window in PowerBuilder, Robot does not record or play back properly: it does not click on the drop down portion of the drop down data window correctly.
To fix this problem, make the following registry setting:
- Click Start > Run.
- Type
Regedit.- Double-click HKEY_CURRENT_USER > Software > Rational Software > Rational Test > Robot > PowerBuilder.
- Right-click, and then click New > String Value.
- Type
DropDownDWRecordOptionswith a value of 7.- Exit the Registry editor.
- Restart Robot.
Robot will record and play back correctly using the row number of the item selected in the DropDownDataWindow.
Rational Robot--Timeout Problem with Windows 2000
You may get a time out error when playing back a test script under Purify when running Windows 2000. To fix this problem, we recommend that you set the timeout multiplier option for the GUI Playback Options three times higher than the default setting.
To set the timeout multiplier option:
- Start Rational Robot.
- Before you start playback, click Tools > GUI Playback Options.
- Click the Diagnostic Tools tab.
- Click Rational Purify.
- Click Use timeout multiplier and type a value three times higher than the default setting.
- Click OK.
Rational Robot--Java Support
- When you use Robot to test a Java applet running in Internet Explorer 4, the Java extension does not unload. The problem is that the Microsoft JVM is not releasing Robot's Java extension DLL due to "native" references in Java support classes. All objects of this class have been released, but the DLL is still not released. The total overhead is actually quite minimal as just the MSJ and SYS DLLs are held in memory, both of which have very small footprints. Note, however, that when running with Active Desktop, you must reboot (or restart the desktop) to free up the loaded DLLs. The DLLs must be freed only when you are updating the Java support (i.e., running the Rational Test Enabler for Java).
- The Rational Test Enabler for Java will not work if you do a minimal install of Rational Suite. Installation of the Java Enabler customizes your computer and updates files that were installed on your computer. When you do a minimal install, the files that need to be updated are on your CD as read-only files and cannot be updated.
- If you run the Rational Test Enabler for Java under Windows 95 and you receive the message "Cannot Copy," it is probably because the repository you are connected to contains Java proxies that need to be installed.
- Under certain circumstances, the Next button appears to be grayed out when you click Rational Test > Java Enabler. Despite the appearance, you can still click on the Next button.
- When you use Robot on a system with Active Desktop, you may need to reboot the system before running the Rational Test Enabler for Java. The Test Enabler updates several files that Explorer may not have released yet. Explorer is connected to these files when Robot is used with Java applets running in Internet Explorer 4. Rebooting clears the connection between Explorer and Robot.
- The Java Extensibility API documentation is not expanded by the Java Enabler. A javaapi.zip file is placed in the "<rational_dir>\Rational Test\JavaEnabler" directory; however, none of the contained files are extracted as expected. To remedy this problem, you need to extract all of the files from this zip file into the same directory. Also, be sure to maintain the directory hierarchy specified in the zip file.
- When you double-click a Java AWT ComboListBox, the HWND disappears before the selected item can be properly recorded. Coordinates are improperly recorded and are not played back correctly. The workaround to this problem is to single-click instead of double-click the ComboListBox. The effect of single- vs. double-clicking is the same for AWT ComboListBoxes.
- Playback of Java commands does not always wait until the object is idle before performing the requested action. In particular, Java table actions may be performed before the table has been fully updated, which may affect the outcome of the operation. The suggested workaround to this problem is to insert appropriate delays into the test script at state transition points in the application-under-test.
- Object highlighting from the object browser may appear erratic. This occurs because objects are repainted by the Java process independent of the highlighting that Robot performs.
- When you view the object properties of a Java ComboBox, the highlighted rectangle for the ComboBox includes the rectangle for the ComboListBox, even though it is not being displayed. This is a cosmetic idiosyncrasy; Robot is not popping up an empty list.
- When running under the Netscape or Sun JVMs, when you record against Java objects of the java.awt.choice class, mouse actions will be recorded instead of scroll actions when you are manipulating the scrollbar on the object's popup window. The mouse action is recorded in the ComboListBox command along with appropriate coordinate information necessary to correctly play back the command. Due to the popup relative coordinates, this recording is less resilient than if a scroll action were recorded. Playback of scroll actions against objects of this class is not supported.
- Robot currently records scroll actions on the Java AWT list box control as coordinate-based clicks rather than as scroll actions. (This problem does not arise for non-AWT list box controls.) This behavior is due to what Java/AWT provides.
- Playback of commands against Java applications occasionally fails due to the Java command not waiting for the JVM to be completely ready before attempting to replay. This typically occurs on the first command against a particular Java window. The result is normally a command failure, but may cause the JVM (and the browser if in an applet) to hang or fail. The workaround for this problem is to insert a Browser NewPage command if in an applet, or an appropriate
DelayForcommand if in an application. Note that querying for the "showing" or other property does not help, because the applet state has already been updated, even if the applet has not been completely rendered.- Recognition methods for Java applications can be very long. When you attempt to use wildcards with JavaCaption prefixes, the wildcard needs to be applied to each command instead of to a higher level abstraction. When recording inside a browser, this problem is resolved by generating a
Browser SetAppletcommand to contain the applet context. Until the Java application context issue can be resolved, it is possible to trigger generation of theBrowser SetAppletfor Java applications. This can be done by setting the following registry value:HKEY_CURRENT_USER\Software\Rational Software\ Rational Test\8\Robot\JavaAlwaysUseBrowserSetApplet
- If this StringValue is set to 1,
Browser SetAppletcommands are generated whenever needed and not just when rendered inside a browser.
- When a Java application is running in debug mode, Robot is not able to talk with the JVM. Therefore, Robot cannot record or play back against a Java application that is running in debug mode.
- When recording against Java applets in Internet Explorer, click Internet Options > Advanced > Java VM > Java JIT Compiler Enabled Switch. This option should be checked in order to ensure correct Java object recognition.
- If you are using the Java Try It! sample applet with Netscape Navigator versions 4.06 or 4.5, there may be times when either you will not be able to capture data correctly or you get incorrect object recognition messages. If either problem occurs, do the following:
- In Netscape Navigator, select Edit > Preferences.
- Select Advanced.
- Clear Enable Java, and then select OK.
- Select Advanced again.
- Select Enable Java, and then select OK.
- Reload the applet.
Rational Robot--HTML Support
- When recording a test script with Internet Explorer, Robot does not record the action of pressing the Alt+key. (For example, Alt+F opens the File menu in many Windows applications.) Instead, it records the result of this action. The reason it records it as a popup menu is that the menu bar in Internet Explorer is actually a tool bar. So during playback Robot can not determine what popup menu to use. To fix this problem you can do either of the following:
- When you play back a test script using Internet Explorer 5.01, Robot does not identify a link if the anchor tag wraps to the next line.
- For HTML testing, you must either use the StartBrowser command or navigate to the rbtstart.htm page. See the Using Rational Robot manual for details.
- Due to a bug in Internet Explorer 4.x, Internet Explorer may crash when you are attempting to record against an HTML page that contains a test script that deletes some of the page's contents.
- There is a bug in Netscape Navigator that causes Navigator to occasionally hang during a Window Closewin,"" command. This may cause subsequent StartBrowsers to fail.
- Robot does not support Netscape record and playback over https.
- When you use the Robot Netscape extension (for playback under Netscape of Robot test scripts recorded under Internet Explorer), be sure that URLMON.DLL is installed. This component, which includes the Microsoft HTML parser, is installed as part of Microsoft Internet Explorer version 3.0 and higher.
- Robot test scripts recorded against HTML pages in Internet Explorer version 4.0 may not play back reliably in Internet Explorer version 4.01 and higher. We recommend that you record in Internet Explorer version 4.01 or later.
- When using Robot to record against an HTML page, you should allow the page to become fully loaded by the browser before performing/recording mouse and/or keyboard actions.
- When Robot is playing back commands containing coordinates, Robot can select the wrong object if the browser window used during recording has a different layout (font, size, etc.) from the browser window used during playback. To minimize this problem, ensure that the browser is configured the same way before you attempt to play back the test script.
- After recording a test script with Robot under Internet Explorer, be sure to completely release the right mouse button when selecting File > Close. Failing to do so will cause a Toolbar_Left_Drag to be recorded, and the test script will not play back as expected.
- Attempts to capture properties on HTML objects will fail after Robot plays back a test script that contains a
Browser StopLoadingcommand. You should reload the document by pressing the Browser Back button and then the Browser Forward button.- The HTML tag "Input Type=File" is not supported in this version of Robot.
- A Browser NewPage is not inserted during recording if the object selected for verification point capture is Window. If you need a workaround: First, record an innocuous click on the page, and then do the desired property capture. This will insert a Browser NewPage and perform the synchronization. Or, of course, the Browser NewPage may be manually coded to make the test script work as expected.
- Additional information for testing HTML applications:
To disable the cookie prompt in Internet Explorer 5.0:
- Click View > Internet Options.
- Click the Security tab.
- Click the Custom Level button.
- Under the "Cookies" section (stored and not stored), make sure that Enable is NOT selected.
- Click OK.
Rational Robot--Visual Basic 4.0 Support
- To test Visual Basic 4.0 applications, including ActiveX controls, you or someone on your development team must add the Rational ActiveX Test Control to each form in the VB application-under-test. The Rational Test Enabler can be used to help you with this process. For instructions, see the Robot Help.
- The Rational Test Enabler is not needed for testing Visual Basic 5.0 and later applications.
Rational Robot--DCOM Support
- If the application being recorded uses late-bound COM objects, and you notice that some expected method calls are not present in the generated test script, then make sure the recorded application calls
IDispatch > GetIDSsOfNamesbefore callingIDispatch > Invoke.- If the application being recorded makes calls to an object using
[out, retval]IDL attributes, Robot generates the VB code for this call incorrectly. To correct the misgenerated code in the test script, edit the test script using the following example as a guideline.
- Incorrect:
Chapter3_math.Multiply 1Op1, 1Op2, p1Result- Correct:
p1Result = Chapter3_math.Multiply (1Op1, 1Op2)
- If you run into memory problems when playing back large VB test scripts, we suggest that you create smaller test scripts during session recording. For information on splitting test scripts while recording sessions, see Using Rational Robot.
Rational Robot--Oracle Forms Support
- If you have an invalid TMP setting in your Autoexec.bat file (e.g., Set Tmp=C:\Temp), and the Temp directory does not exist, the Oracle Forms Enabler will not be able to add the Rational Test Object Testing Library to your Oracle Form file. You might receive the error "Internal error occurred. Oracle Form file unchanged." If you encounter this issue, correct the 'Set' statement in your Autoexec.bat file and reboot your system.
- Robot cannot record Oracle object names while a modal dialog box (such as a message box or LOV) is displayed over your Oracle Forms application. Instead, Robot records standard object recognition information. Once you close the modal dialog box, full Oracle support for object names is reactivated.
- During an Object Data capture of an Oracle LOV, Oracle might display the message "Error getting group cell." This can occur when there is an incorrect column definition for the LOV in the corresponding .SQA file. For example, the column definition in the .SQA file is specified as type 'CHAR', but in the Oracle RecordGroup object for the LOV, the column type is 'NUMBER'. This error might also occur if you are trying to capture data from an LOV that does not contain any data.
- When using the Object Data verification point against an Oracle application, set focus to the block that you are going to test before you insert the verification point into your test script. If you do not do this, Robot displays the error message "Unable to capture data from this object."
- You cannot use an Object Data verification point if there are any pending database changes. You will get Oracle Forms error messages if you attempt this. You must commit your changes before you use the Object Data verification point.
- Robot detects only the first record for multiple record items (such as Text items, Display items, and Check Boxes). Therefore, when you insert a verification point against an object containing more than one record, place the Object Finder tool over the first row or record within the object.
- Recording a Menu verification point against an Oracle application using Robot's recording toolbar may result in incorrect capture of the menu contents. The workaround is to record the Menu verification point using the Insert > Verification Point > Menu command.
- A Menu verification point or a
MenuSelectstatement can fail on playback if the application has not initialized its menu. The generated actual file may only capture the leftmost portion of the menu. If this occurs, you can fix your test script by inserting a recording of a mouse click on the caption of the window that contains the menu. Insert the mouse click immediately before the Menu verification point or MenuSelect statement. In rare cases, you might also need to insert aDelayForstatement between the mouse click and the Menu verification point orMenuSelectstatement.- On occasion, Robot might not fully capture the menus from an Oracle window. If this occurs while you are inserting a Menu verification point into your test script, click Recapture in the Menu Verification Point dialog box and reselect the Oracle menu to be tested.
- Oracle applications that require a working directory other than the directory where the Oracle runtime executable file is located will not start through the SQABasic command
StartApplication. Instead, use the SQABasic commandSQAShellExecute. For example, to start the Rational Oracle sample applet provided with Robot, use the following command. This assumes that Oracle is installed under C:\ORAWIN95:SQAShellExecute"C:\ORAWIN95\BIN\F50RUN32.EXE","C:\Windows\Rational\ RationalTest\SampleApplications\Oracle tryit","MODULE=ORAAPP32.FMX USERID=Rational/Rational@ODBC:RationalTest"- When you use an Object Properties verification point on the console window of an Oracle application, one of the properties returned by Robot is LastDisplayedText. Oracle applications that offer ToolTips Help when the pointer is placed over certain controls can cause the console text to change frequently. Object Property verification points may fail for LastDisplayedText because during playback, Robot uses object-oriented methods that may not reproduce the exact mouse movements that were recorded. If this occurs, remove the LastDisplayedText property from the Object Properties baseline file using the Edit > Edit Property List or the Edit > Remove Property menu commands.
- Robot's object properties handle recognizes all items in a canvas including items on other tab pages. To avoid problems, use the shift key when you move the hand over the object and click when you read the correct item name.
- The object data for the items on a tabpage are not always captured the first time that you populate the data. As a workaround, populate the data for the field you want to capture, and then click on another tabpage. Populate the fields on the second tabpage, and then go back to the first tabpage and perform the object data test case.
Rational Robot--PowerBuilder Support
- In PowerBuilder versions 5.0 and later, ActiveX controls embedded within DataWindows are treated as Generic.
- The Robot Alphanumeric verification point cannot capture the text of a PowerBuilder RichEdit control. To test the text in a PowerBuilder RichEdit control, use the Object Properties verification point and test the "Text" property.
- To capture information in a PowerBuilder grid, you must select the grid before you create a verification point.
- If you develop PowerBuilder application(s) which use ODBC to connect to Microsoft data sources (such as SQL Server 7 or Microsoft Access), read the following information before installing Rational Suite:
- The Rational Suite install may update shared components on your system with updated components provided by Microsoft. One of these shared components is MDAC (Microsoft Data Access Controls), which Rational Suite will update to version 2.1. There is a known incompatibility between MDAC v2.1 and PowerBuilder's ODBC connectivity to Microsoft data sources. After MDAC 2.1 is installed on a system, any PowerBuilder 5.0, 6.0, or 6.5 applications on that system which use ODBC to connect to a Microsoft Access or Microsoft SQL Server 7 database will be unable to retrieve data from those databases. Sybase is aware of this incompatibility, and the latest patch kits for the aforementioned PowerBuilder versions resolve these problems. If Rational Suite is the first product you have installed which updates your system to MDAC 2.1, and if you are a PowerBuilder developer, you may need to install one or more of these Sybase patches to fix this incompatibility after you have installed Rational Suite. Please contact Sybase support (http://support.sybase.com) for further information.
Object Data Verification Points
- If you record the selection of a range by dragging the mouse, you might find that the action does not play back reliably, especially if the grid auto-scrolls while you drag. We recommend that you record the actions as a sequence of mouse clicks. For example, click the top-left cell you want to select; then hold down the SHIFT key and click on the bottom-right cell.
- If you want to use the Object Data verification point to capture all of the data associated with an Apex Data Bound Grid OCX (that is, DBGrid), do the following:
- During the selection process, drag the pointer hand over the window that contains the grid, release the mouse button, and then press Browse to open the Object List dialog box.
- From the object list, you can select any hidden data control object associated with the grid. You can then select a test definition of All Data.
Rational Test Enabler for Java
- When you run the Rational Test Enablers and select the Rational Test Enabler for JavaTM, the Enabler will not run under certain conditions. (It silently exits the installation.) This occurs under the following conditions:
As long as the installation is run from a CD, or a Robot installation has been done (required for proper operation of the Rational Test Enabler for Java), the Enabler will run properly.
Rational Robot--VU Recording
For the beta release, VU recording is supported in LoadTest and TestStudio products only. It is not supported in Robot, TeamTest, and Enterprise.
Rational TestFactory
Working with Third-Party Controls
TestFactory does not support the mapping and testing of certain third-party controls. If the AUT contains a third-party control that TestFactory does not recognize, you can create a region object to represent the control and assign an interaction method to use on the control during mapping and testing. However, there is no guarantee that Pilots will test it correctly.
Running Test Scripts Generated for a Java AUT from Robot without Running TestFactory
If a Pilot generates a test script to test a Java AUT, and you play back the test script in Robot without running TestFactory at the same time, Robot cannot start the AUT. This is because Robot cannot determine the Java virtual machine that you specified in TestFactory to run the AUT. Without TestFactory running simultaneously, Robot also cannot determine what options, if any, that you specified in TestFactory to run the AUT.
To play back a Pilot-generated test script in Robot to test a Java application without running TestFactory, you must use the following:
- For .class files, use Jview.
- For .jar files, use Java with the -jar option.
- For .html files, use Jview with the -a option (equivalent to applet viewer).
- For .bat files, just execute.
Testing a Java Application that Runs on the Sun Java Virtual Machine
If you are running a Java application on the Sun Java virtual machine, Pilots will not be able to detect defects in the AUT or generate defect test scripts. However, your Pilots can create best test scripts and calculate code coverage for them.If you are running a Java application on the Sun Java virtual machine, TestFactory cannot start the application to run Pilots or scripts to test the application. The following workarounds let you run Pilots that generate best scripts. The Pilots cannot, however, generate defect scripts.
- Place the C:\Program Files\Rational\Coverage directory on your path.
- From TestFactory, click Tools > Options, and then click the Project tab.
- Under Java environment, click Other provider, and then, in the text box, type one of the following:
- To run a .jar file, type:
Javaw -jar -XrunPureJVMPI:coverage <path to .jar file>- For example:
Javaw -jar -XrunPureJVMPI:coverage E:\jdk1.2.2\demo\jfc\Notepad\Notepad.jar- To run a .class file, type:
javaw -classpath <path to class dir> -XrunPureJVMPI:coverage <path to .class file>- For example:
Javaw -classpath "E:\jdk1.2.2\demo\jfc\Notepad" -XrunPureJVMPI:coverage E:\jdk1.2.2\demo\jfc\Notepad\Notepad.classIf you use this workaround, your
If you want to run a .jar or .class file on a computer running Windows 95 or Windows 98 using the LaunchAUT button on the TestFactory toolbar, do the following:
- In the autoexec.bat file, enter the following environment variable:
set PURE_VPC_95=1- Restart your computer.
After you test, and before you map the AUT the next time, be sure to do the following:
- Click Tools > Options, and then click the Project tab.
- Under Known provider, click Virtual machine and Sun.
- Click OK.
Note: For optimum TestFactory performance during mapping and testing, we recommend that you use the Microsoft Jview virtual machine.
SQABasic
- One of the Trap options allows you to call your own error handling function written in SQABasic. Do not use a dialog box or message box (MsgBox) command from an error handling function, as this can cause the system to hang. Instead, have your function write to a file. For more information, see the SQABasic Language Reference Help.
- In SQABasic, trapable error 53 (File '<filename>' not found) is used when a BasicLib module is not found during playback. (See the Declare statement in the SQABasic Language Reference Help.) If an SQABasic file has not been compiled, you will get this error when you play back a test script that tries to call a function or sub in this module.
Contacting Rational Technical Support
If you have questions about installing, using, or maintaining this product, contact Rational Technical Support as follows:
Note: When you contact Rational Technical Support, please be prepared to supply the following information:
| Rational Software Corporation http://www.rational.com support@rational.com |