QTP Framework
QTP Framework
QTP Framework
5386598.doc
QTP
Frame Work
Table of Contents
1. Automation Architecture.......................................................3
1.1 Design........................................................................................................................3
1.2 Approach for Test Automation...................................................................................4
2. Introduction to QTP........................................................12
2.1 QTP Environment Compatibility.............................................................................12
2.2 Versions of QTP.......................................................................................................13
3. Add-Ins...............................................................................21
3.1 Types of Add-Ins......................................................................................................21
3.2 Conditions for Add-ins.............................................................................................22
4. Conventions.........................................................................23
4.1 Test Case Naming Conventions:..............................................................................23
4.2 Script and Action Naming Conventions:................................................................23
4.3 Variables and Constants:..........................................................................................25
4.4 DataSheet Naming and Parameter Naming Conventions:.......................................26
4.5 Function Naming Conventions................................................................................27
5. Settings...............................................................................28
5.1 QTP Test Settings.....................................................................................................28
5.2 Record and Run Settings..........................................................................................29
5.3 Active Screen Capture Level...................................................................................29
5.4 Object Repository....................................................................................................30
5.5 Expert View.............................................................................................................32
5.6 Setting related to the Application Used:..................................................................35
6. Objects...............................................................................38
6.1 Objects....................................................................................................................38
7. Data Table..........................................................................40
7.1 Datatable Object and related Functions:.................................................................40
7.2 Organizing Data Sheets for Global & Local variables............................................41
7.3 Parameterizing using Data driven Wizard.............................................................42
7.4 Importing and Exporting Datasheets:...................................................................46
8. Actions................................................................................49
8.1 Actions Settings.......................................................................................................49
8.2 Iterations using rows................................................................................................50
8.3 Action Template.......................................................................................................51
8.4 Script Startup...........................................................................................................51
8.5 Splitting Actions, Re-usable Actions, Internal/External Actions.............................52
9. Object Repository................................................................54
9.1 Per Action/Shared Object Repository:.....................................................................54
9.2 Merging of two object repositories:.........................................................................56
9.3 Limitations:..............................................................................................................57
10. Variables...........................................................................59
10.1 Action Parameters................................................................................................59
1. Automation Architecture
1.1 Design
Description
Approach for Test Automation is used for building a strategy for automation starting from
the Requirement phase till the deployment phase. Approach for automation begins with
finding out the conditions and business rules given by the client and grouping similar
conditions, business rules together as Test cases or Test Scenarios.
Since it is Project for Automation of SAP, Team was divided into two,
SAP Consultants.
Testing Team.
Requirement gathering from the client included knowledge transfer at onsite, where all
the transactions including the customized transactions where explained to the SAP
Consultants of satyam, Under standing of requirements was done at the client side,
Depending on the flow of transactions, all the transactions where grouped together as
different scenarios. While SAP Consultants where onsite for gathering Requirements,
Work done at the offshore was to analyze on the appropriate version of the QTP Tool to
be used and to get licenses for QTP, user accounts for SAP access, Installation of QTP
and SAP.
All the Identified Scenarios which consists of different transactions where explained to
Testing Team. Then common functionalities where identified, and grouped together as
different Test cases.
After defining different Test cases, design for automation of scripts was done, where
Reusability was one of the main aspects, where all the transactions, which are common in
the scenarios, are identified as Reusable transactions.
Automation Framework:
Coding Structure used is that there will a main Action for all the scripts which is named
as corresponding Test case name, This Action intern will call all the other actions (Each
Transaction used in the script would be an action) in the script. Importing and
Exporting of sheets is also done in this main action. Importing of sheets is done at the
beginning before calling other actions and exporting of sheets is done at the last. Sheets
corresponding to all the actions in the scripts are imported, so that the data in the fields of
the imported sheets are used as input data to the script, output data from the script is also
collected and exported to the corresponding sheet.
There are many transactions which are reused in the scripts, similar transactions
(Actions) are made as reusable so that its not required to record those transactions again
and again, which ever transaction was common among scripts, were recorded in one
script and is reused in all the scripts where the transaction is required.
Error handling in the unilever automation is done by using Recovery Scenario where
each Recovery scenario calls a function which handles the recovery by exiting all the
other transactions (actions) when recovery fires. Major types of Recovery used in this
project where Popup Window, Object state and on Error Recoveries. In Error handling
using Recovery, all the common types of exceptions or errors are given common
Recovery scenarios using regular expressions, which minimized the number of
Recovery scenarios and Functions used.
Coding Standards & Naming Conventions like ‘The file name as per
convention - Scenario name’, ‘The Action named as per transaction ID’
Note: The phase in blue color indicates where more efforts are required in analyzing and
recording to generate a script.
Test Results
Test Data SAP Script for
Reporting
Handling and Application Business
and
Data Sheet Session Transaction/
Application
Importing Login Test Case
Closing.
Re-Usable Library:
Generic Library calls for handling data, date, string etc
Error handling Library
Recovery Scenario
Actions
• Tests that need to run once and those that need frequent human
intervention are usually not worth the investment to automate and have not
been considered for automation.
• Mission critical processes like core activities like sales order processing
are prime candidates for automated testing and have been considered for
automation.
• Repetitive Testing
2. Introduction to QTP
QTP (version) supports a wide range of working environments and thereby can be used
for practically any application.
Enterprise Applications:
- SAP
- Siebel
- PeopleSoft
- Oracle
Web Technologies:
- HTML
- DHTML
- JavaScript
Browsers:
- Internet Explorer
- Netscape
- AOL
Emerging Technologies:
Terminal Emulators:
- 3270
- 5250
- VT100
Server Technologies:
- Oracle
- Microsoft
- IBM
- BEA
- ODBC
- COM / COM+
Multimedia:
- Flash
- RealAudio / RealVideo
- Windows Media Player
Operating Environment
QTP 6.5:
Supported Environments
QuickTest Professional supports creating, recording, and running tests in the
environments described below.
1. Win32 API
2. MFC
Browsers
Name ProgId
FarPoint Spreadsheet 2.5 FPSpread.Spread.1
FarPoint Spreadsheet 3.0 FPSpread.Spread.2
FarPoint Spreadsheet 3.5 FPSpread.Spread.3
FarPoint Spreadsheet 6.0 FPSpread.Spread.4
FarPoint Spreadsheet 3.0 (OLEDB) FPSpreadADO.fpSpread.2
FarPoint Spreadsheet 3.5 (OLEDB) FPSpreadADO.fpSpread.3
FarPoint Spreadsheet 6 (OLEDB) FPSpreadADO.fpSpread.4
Microsoft Grid 1.0 MSGrid.Grid
Microsoft DataBound Grid 5.0 MSDBGrid.DBGrid
Microsoft Flex Grid 6.0 MSFlexGridLib.MSFlexGrid.1
Sheridan Data Grid 2.0 SSDataWidgets.SSDBGridCtrlApt.1
Sheridan Data Grid 3.1 SSDataWidgets.SSDBGridCtrlApt.3
Apex True DataBound Grid 5.0 TrueDBGrid50.TDBGrid
Apex True DataBound Grid 6.0 TrueDBGrid60.TDBGrid
Apex True OLE DB Grid 6.0 TrueOleDBGrid60.TDBGrid
Name ProgId
Microsoft Date and Time Picker Control 6.0 (SP4) MSComCtl2.DTPicker.2
Microsoft MonthView Control 6.0 (SP4) MSComCtl2.MonthView.2
Multimedia Applications
Additional Environments
QTP 8.0:
System Requirements
Supported Add-ins
The following external QuickTest 6.5.x add-ins are supported for use
with QuickTest Professional 8.0:
Note: Siebel Add-in 6.5, the .NET Add-in 6.5, the Add-in for SAP
solutions 6.5, or any 6.0 add-ins,cannot be used with QuickTest
Professional 8.0.1
1.Win32 API
2.MFC
Browsers
• Microsoft Internet Explorer 5.5 Service Pack 2-6.0
(required)
• Netscape 6.1, Netscape 6.22, Netscape 6.23, Netscape 7.02,
and Netscape 7.1 (optional)
• AOL 8.0 and 9.0 (optional)
Name ProgId
FarPoint Spreadsheet 2.5 FPSpread.Spread.1
FarPoint Spreadsheet 3.0 FPSpread.Spread.2
FarPoint Spreadsheet 3.5 FPSpread.Spread.3
FarPoint Spreadsheet 6.0 FPSpread.Spread.4
FarPoint Spreadsheet 3.0 (OLEDB) FPSpreadADO.fpSpread.2
FarPoint Spreadsheet 3.5 (OLEDB) FPSpreadADO.fpSpread.3
FarPoint Spreadsheet 6 (OLEDB) FPSpreadADO.fpSpread.4
Microsoft Grid 1.0 MSGrid.Grid
Microsoft DataBound Grid 5.0 MSDBGrid.DBGrid
Microsoft Flex Grid 6.0 MSFlexGridLib.MSFlexGrid.1
Sheridan Data Grid 2.0 SSDataWidgets.SSDBGridCtrlApt.1
Sheridan Data Grid 3.1 SSDataWidgets.SSDBGridCtrlApt.3
Apex True DataBound Grid 5.0 TrueDBGrid50.TDBGrid
Apex True DataBound Grid 6.0 TrueDBGrid60.TDBGrid
Apex True OLE DB Grid 6.0 TrueOleDBGrid60.TDBGrid
Name ProgId
Microsoft Date and Time Picker Control 6.0 (SP4) MSComCtl2.DTPicker.2
Microsoft MonthView Control 6.0 (SP4) MSComCtl2.MonthView.2
Microsoft Excel
Microsoft Query
Additional Environments
3. Add-Ins
6.5 . Net
Web
Java
XML
Default Add-Ins: Active X controls,
Multimedia, Visual Basic, Web
Note: Quick Test Professional Siebel add-in 6.5 and Web services add-in 6.0 cannot be
used with Quick Test 8.0.
• The add-ins for Quick Test Professional 6.0 cannot be used with Quick Test
Professional 6.5. If you are using Quick Test Professional 6.5, you will need to get
the 6.5 version of your add-in.
When testing Java applets in a Web browser, you must load the Web add-in as well as the
Java Add-in, and use the Web tab of the Record and Run Settings
Dialog box to specify your record and run preferences. To test Java applets or
applications running on Netscape 4.x’s built-in JVM (not Java Plug-ins), confirm that the
Netscape 4.x browser is already installed before installing the Quick Test Professional
Java Add-in. When testing Java applets in a Web browser web Add-in as well as java add-
in must be loaded .To create a checkpoint, parameterize a step, or to add a method from
individual java applets, the Java Add-in must be loaded.
The .Net add-in is required to support objects developed in .Net .In some cases, even
though the application has been developed using .Net, when the page is sent to the
browser, it is a plain HTML page. Quick Test Professional can recognize HTML controls
like edit fields, buttons etc. without the .Net add-in. However, if a Web application
contains complex controls like ActiveX or other controls developed in .Net like ASP.Net
server controls, it is required to use the .Net add-in to achieve object recognition.
The Sap add-in is required for all SAP applications. In SAP application Grid Tables,
Status Bar messages, Labels can be identified only if SAP Add-in is installed.
4. Conventions
The Conventions for Naming for test cases, Scripts and Actions vary from Project to
Project depending upon the Client.
Test cases should be named in a manner that enables easy identification of the
corresponding Use case (or the Scenario) for which the Test Case is written. The
Onlooker should be able to trace the test case back to the use cane name or Scenario
name by the name of the Test Case. Consistency should be maintained in following the
hierarchy of naming.
Use Case
Or Test Case
Scenario
For example:
Example 1: Considering that Each Use case is associated with one Test case. If the name
of the Use Case were UC_001 then the Test case name would be TC_001.
Example 2: In the Unilever Automation Project, SAP transactions are divided into
different modules, in those modules different transactions are grouped together as a
scenario, so for writing the test case for a particular scenario naming convention used is
module name followed by scenario name.
For Module IMWM, if S014_01 is the scenario name, so name of the test case
for the S014_01 scenario was given as IMWM_S014_01.
Similar to the Test case naming, Script naming should be done consistently with clarity
and traceability. Typically each Test Script is prepared corresponding to each Test Case.
Every Test Case contains one or more Conditions. Each Condition can be represented by
an action in the script.
Use Case
Test Case
Condition 1 Action1
Condition2 Action2
Therefore for a Test Script corresponding to a Test Case named TC_001 would be
QTS_001.The hierarchy should be maintained in case the use cases or test cases are
nested.
Action Naming:
Each Test Script can contain one or more Actions, with one or more actions representing
a test Condition.
Actions can be named in 2 ways:
1. Functionality of the Action
2. Hierarchy of the Action in the Test Script.
For E.g.: An Action written or recorded for logging the user should be named as
Login or Authentication for easy understandability.
An Action for booking tickets should be named as Book_Tickets
An Action for exiting the application named as Exit.
This also adds a huge advantage when the Actions are made
reusable. Reusable Actions can be used between various scripts. When an Action
is to be made reusable the action should be named as REUSE_(Action name).
Example: REUSE_Login.
Since Actions are a part of the Test Script, for purpose of Clarity and tracking,
Actions can be named as per Hierarchy.
QTP Scripts are in VB Script. Therefore, the naming conventions for variables can be
followed alike VB Script Naming Conventions.
By using data type prefixes, your variables always indicate what they are designed for.
I'm using just six prefixes:
Constants Prefix:
Usually there are only a handful of constants in any scripts. Indicating the data type
therefore is less important for constants. Prefix letter c for all constants can be used.
e.g. Const cTitle = "Welcome!"
UDocument.title = cTitle
The Global data sheet, which is a common sheet for all the actions of the script, is
named by default as dt_globalsheet. This can be renamed as Global for all the Scripts for
consistency.
Typically, Each Action in the Script contains one data sheet, which is local to the
Action. This is by default, named after the Action to which it belongs. Therefore the
name of the datasheet follows directly the name of the Action, which when named
following its naming conventions, can be used efficiently for the data sheet too.
Parameter Naming:
1) Test Parameters
b) Test Output Parameters: On the similar lines of Input Parameters, these should be
named as OUT_(relevant variable name). OUT representing that it’s an output
parameter.
Example: OUT_sStatus.
2) Action Parameters
a) Action Input Parameters: These are local to Action of a Test. These can be named as
ACTIN_(variable name). ACTIN denoting that it’s an Action Input Parameter.
Example: ACTIN_iResult
3) Environment Variables:
Environment variables are either built-in or User defined. Built-in variables cannot be
declared named by the user, so their naming convention is not discussed.
Functions should be named as Func_(name). This can provide clarity and difference
between a Reusable Action and a Function that can be used within Actions.
Example: Func_Save , Func_Add
5. Settings
5.1 QTP Test Settings
Before Running or Recording any test on QTP, the QTP Test settings need to be set as per
the requirements of the Test. Setting these Test Settings before starting a Test plays a
crucial part in the behavior of the test.
These can be found at the path Test>Settings. A dialog box pops up, in which various
tabs are present which allow one to set
• Properties of the test like Add-Ins used
• Run time Preferences
• Resources like files, data tables, and repository to be used.
• Parameters required in the Test.
• Environment variables used
• Web navigation
• Recovery Scenarios
Note: For further details about the use of each tab, refer to QTP Test Settings
After Setting the Test Settings at Test>Settings, the next important settings for actually
recording the application and running it for Testing are to be set at the Test>Record and
Run Settings. This dialog box opens automatically, when recording a test for the first
time. The details of which application to record are set in this dialog box.
For further details about these settings refer to Record and Run Settings.
One of the most useful fetaures of QTP is the various views it provides, out of which
Active view is the most unique.The selection of the appropriate Active Screen Capture
level influences the storage space, properties stored and the view of the Active screen.
The selection can be made by going to Tools>Options>Active Screen.
The Active screen settings can also set at the Test>Record and Run Settings.
The active screen capture level can be set to any of the 4 levels i.e. Complete, Partial,
Minimum and None.
For details about each capture level, refer to ActiveScreen Capture Level.
When a test is recorded, QTP adds each object on which an operation is performed, to
the Tools>object repository. Objects can be added to the repository while editing the
tests too.While recording, Objects are added to the repository in either of the two ways:
In the Per-Action mode, objects are identified and separated on the basis of each
action and the corresponding object repository for the test is created in the test
folder.In the Shared mode, the user may choose a location to save the shared
object repository files for all the tests.
All the Objects recorded during a test,and their properties can be seen and
manipulated in the Tools>Object Repository.There are provisions in this Object
Repository Dialog box to add new objects,spy objects, find and replace property
values etc.
The second section of the dialog box contains provision to Find, Replace, Add, and
Remove the properties of an object in the Repository also set any default values for the
properties.
While recording Tests in QTP, there are 3 important views that enable us to understand
clearly, the various representations of the Script. They are
a. Expert View
b. Keyword View: Hierarchical Representation of Actions
c. Active Screen View: Pictorial view of the currently active Screen.
In the Expert View, QTP displays each operation performed on the application in the
form of a script. The script is comprised of VBScript statements and the view is a script
editor with many script editing capabilities. For each object and method in an Expert
View statement, a corresponding row exists in the Keyword View and a corresponding
Active Screen in the Active Screen view, which enables easy traceability.
Fig: Keyword view and Active Screen view corresponding to one expert view statement
If the user is familiar with VBScript, the user can add and update statements and enhance
the tests and components with programming. After the test or an Action is recorded, its
power and flexibility can be increased by adding recordable and non-recordable VBScript
statements as required for tasks like Check Points,Datatables etc.,.These additional steps
can be added either manually or using Insert>Step >Step Generator .whenever a step is
added to a script, then any Syntax errors of the step can be Identified in its Keyword
view.
The Step Generator enables you to add steps quickly and easily, by selecting from a range
of context-sensitive options and entering the required values.The generated step gets
added at the position of cursor in the expert view.
The Step Generator enables you to add steps quickly and easily, by selecting from a range
of context-sensitive options and entering the required values. In the Step Generator dialog
box you can define steps that use:
• test object methods and properties
• utility object methods and properties
• calls to library functions, VBScript functions, and internal script functions
The different kind of Applications that can be tested using QTP are windows
applications,web based(java and .Net),SAP,Oracle etc.Apart from the windows
applications using MFC and simple web applications(which can be run with default add-
ins), rest all applications require a special Add-in to be purchased to do the testing.Each
Add-in which is bought and installed, results in a new tab in all the setting dialog boxes ,
using which various setting options can be chosen.It purely depends on the type of
application , how to choose a particular setting option.
6. Objects
6.1 Objects
Objects are the things which contains different properties and methods.
Property:
Property describes about the object defined, each object has different properties,
which is necessary to describe the object, which differentiates the given object
with other objects.
For example: If we take a window object, we first have to define to which class it
belongs to which is one of the property, it belongs to a window class. Exist is a
property which is common to many objects which returns true if that object exists.
Methods:
Methods are functions, which are used for changing the properties of the object
that is in order to manipulate with the object properties we use.
Method for
“WinEdit”
Object
“Dialog” Object
Child Object
for “Dialog”
Object
In the above sample of code, there are two main Objects, one is Dialog and
the other is Window object. This objects contain child objects, For Dialog
object which is named as “Login” has WinEdit object with name as “Agent
Name:” as childobject, here Set is the method used to set a text into the
WinEdit object.
Dialog
Parent Object
named as “Login”
Child Object
WinEdit named as “Agent
Confidential . Credence systems Page 39 of 100
Name:”
QTP Frame Work
5386598.doc
7. Data Table
In QTP scripting there are many objects that are used, One of the Objects used in QTP
scripting is DataTable Object.
Description
Basic use of Datatable object is to create an object for adding, deleting, updating data
of an excel sheet used.
• Importsheet : This function is used to Import sheet into the script, so that all
the data in the imported sheet can be used in the script.
Syntax:
Datatable.Importsheet(“nameofExcelfilewithpath”,
“nameofthesourcesheet”, “nameofthedestinationsheet”)
• Exportsheet : This function is used to Export sheet from the script, all the
data including output values are stored in the default sheet for the action, this
sheet is exported and stored in a specified location using this function.
Syntax:
Datatable.Exportsheet(“nameofExcelfilewithpath”,
“Nameofthesheet”)
Syntax:
Datatable.AddSheet(“Sheetname”).GetRowCount
When an action is run by using run setting as “run on all rows”, that action
will run as many times as the number of rows in the excel sheet of the action,
in order to find the row for which action is running currently we use
GetCurrentRow function.
Syntax:
Datatable.GetSheet(“Sheetname”).GetCurrentRow
Description
There are two types of sheets in any QTP Script, they are
Globalsheet
Localsheet
For storing a value in the global sheet we use the following function:
Datatable.Value(“Fieldname”,”Global”) = Value
For using the values from the global sheet we use the following function:
Value = Datatable.Value(“Fieldname”,”Global”)
Localsheet: Each and every action in the script will have its own Localsheet, name of the
Localsheet of a particular action is same as the action name.
For using the data from the Local sheet we use following function:
Datatable.Value(“Fieldname”,dtlocalsheet)
Or
Datatable.Value(“Fieldname”,”Sheetname”)
Organization of Global and Local sheets with the actions used in the script are shown
below:
Action name:
“Login”
Global
Sheet
Description
The Data Driver enables you to quickly parameterize several (or all) property
values for test objects, checkpoints, and/or method arguments containing the same
constant value within a given action.
You can choose to replace all occurrences of a selected constant value with a
parameter, in the same way that you can use a Find and Replace All operation
instead of a step-by-step Find and Replace process. QuickTest can also show you
each occurrence of the constant so that you can decide whether or not to
parameterize the value.
If any property of an object is taken, that property can be parameterized using Data
driven Wizard,
For example consider script for entering Login name which is as follows
Dialog("Login").WinEdit("Agent Name:").Set "name"
The Set property of WinEdit Object appears in the list of Datadriver with “name” as
Value representing the Set property of “Agent Name” Editbox, which is as given below:
Step-by-step Parameterization: Enables you to view the current values of each step
containing the selected value. For each step, you can choose whether or not to
parameterize the value, and if so, which parameterization options you want to use, the
Next button is enabled when you select this option, this will enable us to select an other
instance of the constant selected and parameterize that instant, it will continue the same
process till all the instances of the given value are done.
Parameterize all: Enables you to parameterize all occurrences of the selected value
throughout the action.
When you select this option the Parameter details area is enabled. The Finish button is
enabled when you select this option.
Here Parameter tab can be selected using the button given at the “Parameter” radio
button, and in the next screen select the datatable Field from where the property for
which the value belongs is parametererized, click on “Finish” button thus all the instances
of the value selected for parameterization will be parameterized.
Description
Importing and Exporting of Datasheets are used for reading, writing and manipulating the
data in an excel sheet.
Importing Datasheet:
Description
Imports a sheet of a specified file to a specified sheet in the run-time Data Table. The data
in the imported sheet replaces the data in the destination sheet (see SheetDest argument).
Note: All the fields in the imported sheets should match with the data used in the script.
There are two functions for Importing, Importing the whole excel file and Importing the
sheets in the file.
Imports the file into the script with all the sheets which are there in the excel file.
Note: Sheets in the excel file should match with the Actions in the script to use the data
efficiently, since action name and corresponding sheet name should be same.
Syntax:
Import “filenamewithpath”
Syntax:
Importsheet “filenamewithpath”,”sourcesheetname”,
”destinationsheetname”
Exporting Datasheet:
Description
Exports a specified sheet of the run-time Data Table to the specified file.
• If the specified file does not exist, a new file is created and the specified sheet is
saved.
• If the current file exists, but the file does not contain a sheet with the specified
sheet name, the sheet is inserted as the last sheet of the file.
• If the current file exists and the file contains the specified sheet, the exported
sheet overwrites the existing sheet.
Same as Importing, There are two functions for Exporting, Exporting the whole excel file
and Exporting the sheets in the file.
Exports the file into the script with all the sheets which are there in the excel file.
Syntax:
Export “filenamewithpath”
Syntax:
Exportsheet “filenamewithpath”,”sourcesheetname”,
”destinationsheetname”
8. Actions
You can use the Run tab of the Action Call Properties dialog box to instruct QuickTest to
run only one iteration on the called action, to run iterations on all rows in the Data Table,
or to run iterations only for certain rows in the Data Table.
Option Description
Runs the called action only once, using the row in the action's data
sheet that corresponds to the current global iteration number. If the
action's data sheet contains fewer rows than the global sheet, the last
row of the action's data sheet is used for each subsequent test
iteration.
For example, suppose an action's data sheet has two rows and the
global sheet has four rows. If you choose to run one iteration only
for the action and you choose to run iterations on all rows of the
Run one
global data sheet, then during each iteration of the test, this action
iteration
will run only one iteration. The data that the action parameters use
only
during each repetition of the test are based on the iteration number
for the test.
During the first iteration of the test, Data Table parameters in the
action take data from the first row of the action's data sheet. In the
second iteration of the test, Data Table parameters in the action take
data from the second row of the action's data sheet. In the third and
subsequent iterations of the test, the Data Table parameters in the
action continue to take data from the second i.e. the last row of the
action's data sheet.
Run on all Runs the called action with the number of iterations according to the
rows number of rows in the action's Data Table.
Run from
Runs the called action with the number of iterations according to the
row __ to
specified row range.
row __
The Run tab of the Action Call Properties dialog box applies to individual action calls
and refers to the rows in the action's data sheet.
If you want to include one or more statements in every new action in your test, you can
create an action template. For example, if you always enter your name as the author of an
action, you can add this comment line to your action template. An action template applies
only to actions created on your computer.
To create an action template:
1. Create a text file containing the comments, function calls, and other statements
that you want to include in your action template. The text file must be in the
structure and format used in the Expert View.
ActionTemplate.mst
To view the Action template refer to
Example:
The Resources tab of the Test Settings dialog box can be used to associate specific files
with the test, such as Data Table files.
The option area Other location instructs Quick Test to use data stored in the specified
Data Table location. The Data Table can be any Microsoft Excel (.xls) file.
• Check for the “Data table iterations” under the test settings for which the test has
to be run.
Actions help divide your test into logical units, specific activities that you perform
in your application.
A test is made up of calls to actions. When you create a new test, it contains a call to a
single action or create tests that call multiple actions by inserting calls to them, to make
the design more modular and efficient tests.
9. Object Repository
To set only one test to use the Shared Object Repository option:
1. Click the "New" button or go to File -> New to open a new test.
2. Go to Test -> Settings.
3. Select the Resources tab.
4. In the Object repository type box, select one of the options:
• Select "Per-action" to set the Object Repository mode for your test to the Object
Repository per action mode.
Below are some of the factors based on which Per Action option is selected
• Select "Shared" to set the Object Repository mode for your test to the Shared
Object Repository mode.
Below are some of the factors based on which Shared Action option is selected
5. If you selected Shared in step 4, specify the Shared Object Repository file you want to
use as the test's Object Repository file. To specify a file, enter the Object Repository file
name or click the "Browse" button and select a resource file (*.tsr) from the Open dialog
box. To create a new Shared Object Repository file, enter a new file name in the Shared
box.
Note: These steps need to be done in a new script. Once you have modified the script,
you will not be able to change the option.
General:
The Object Repository File Merge Utility allows users to merge object repository files
into a single file. This utility is intended for an advanced user that builds powerful tests.
The Merge Utility allows you to merge the content of one Object Repository to another
one thus giving you the flexibility and the power in controlling the content of the Object
Repository and the ability to dynamically change this content.
Conflicts:
The implementation of the merge algorithm is quite simple when the object repository
files have different objects in them, or if all objects had only exact replicas in other files.
Due to the nature of the operation it is often not the case. For example, if we try to merge
two object repositories from tests that were recorded at different time points, between
which some test objects properties have changed (e.g. whether a button is enabled) then
the same object exists in the two repositories with different properties. We call this a
description conflict as the two objects have the same name, but different descriptive
properties. It can also be that the user has decided to modify the automatically assigned
logical name of an object (for example, in order to create a shorter name) in one
repository but not in the other. In this case, two objects will exist with different logical
names, but with the same descriptive properties. We call this a name conflict.
Resolving Conflicts:
It is not trivial to identify and handle conflicting objects. The user might want to merge
two objects that were not initially the same, or decide to keep two objects that for the
inexperienced eye would seem identical. For example, recording on web browsers would
likely generate identical logical names for browsers that have nothing in common. It is
also likely that if the text on a button has changed, new tests would record a new logical
name for it, even though the object behavior has not changed. It is therefore possible to
either keep the two objects (and their subtrees) separated, to assume that the two objects
are actually the same object, or to ignore one of the conflicting object. We will discuss
these choices later in detail.
Note: The Merge Utility works only on machines where QTP8.0 is installed.
Main Window:
This utility is designed to supply simple access to the functionality implemented by the
ObjectRepositoryMgr COM component. As the operation is not trivial, the UI has many
options to select, so we will discuss the different options in detail.
9.3 Limitations:
1. Mercury Interactive recommends that you keep the Object Repository under 1 MB and
perform regular backups. If the size crosses more than 1MB loading of object repository
takes lot of time .
2. The limitation on the number of Actions is 255. The reason is that each Action has a
data table sheet. The Formula 1 control has a limitation of 255 sheets so the limitation is
255 Actions per test. You may be able to add additional Actions after reaching the 255
"limit", however those Actions will not be able to access a local data sheet.
Note: If you are calling reusable Actions, you may be able to have more than 255 Actions
within the script. This can be accomplished if you are calling the same Action more than
one time within the script. The data sheet for the Action will only be loaded once. This
applies to "call to" Actions only.
Example:
In a new script, insert a "call to" a reusable Action. When the Action is added to the
script, you will see the data sheet added to the data table. Insert another "call to" to the
same Action. The data sheet will not be added again.
10. Variables
In QTP scripting there are mainly 3 types of variable that we use. They are:
• Action Parameters.
• Environment Variables.
• VB Variables, which we declare in the script.
Action parameters enable you to transfer values between actions and their nested
actions in your test, from your test to a top-level action, or from a step in a top-
level action back to the script or action that ran (called) your test. For example,
you can output a value from a step in a nested action and store it in an output
action parameter, and then use that value as input in a later step in the calling
parent action.
You define the parameters that an action can receive and the output values that it can
return in the Parameters tab of the Action Properties dialog box. You specify the actual
values that are provided to these parameters and the locations in which the output values
are stored in the Parameter Values tab in the Action Call Properties dialog box.
You can specify input parameters for an action so it can receive input values from
elsewhere in the test. Input values for an action can be retrieved from the test (for a top-
level action) or from the parameters of the action that calls it (for a nested action). You
can also specify output parameters for an action, so that it can output values for use later
in the test, or pass values back to the application that ran (called) the test.
You can specify input parameters for an action so that steps in the action can use values
supplied from elsewhere in the test. Input values for an action parameter can be retrieved
from the test (for a top-level action) or from the parameters of the action that calls it (for
a nested action). You can specify output parameters for an action, so that it can return
values for use later in the test. For each input or output action parameter, you define a
name and a type. You can also specify a default value for each action input parameter, or
you can use the default value that QuickTest provides for the parameter value type that
you choose. The default value is saved with the action and is used by the action if a value
is not defined for a parameter in the action call. You can define, modify, and delete input
and output parameters in the Parameters tab of the Action Properties dialog box.
1. Select the parameter you want to modify from the Input parameters or
Output parameters list.
2. Modify the values as necessary in the edit boxes of the parameter row.
1. Select the parameter you want to delete from the Input parameters or
Output parameters list.
2. Click the Delete button . The parameter is removed from the list.
In the Parameters tab of Test Settings, you can define input parameters that pass values
into your test or component and output parameters that pass values from your test or
component to external sources. You can also use the Parameters tab to modify or delete
existing test or component parameters
You can edit an existing parameter by selecting it in the appropriate list and
modifying its details.
You can add and delete input and output parameters for your test or component
using the parameter control buttons:
Option Description
Adds a parameter to the appropriate parameter list. Enter a name for the
new parameter and select the parameter type. You can enter a description
for the parameter, for example, the purpose of the parameter in the
component. If you are defining an input parameter, enter a default value
for the parameter in the Default Value column.
You define test or component parameters in the same way you define
action parameters.
When the test or component runs, QuickTest uses the default value for each
defined input parameter if a specific value has not been defined for the parameter
in either QuickTest or Quality Center.
When you run a test or business component from QuickTest, input parameter
values for tests and components are taken from in the Input Parameters tab of the
Run dialog box.
Once you have defined test or component parameters, you insert them in your test
or component by specifying the test or component parameter name with the
Parameter reserved object, in the format: Parameter("ParameterName").
QuickTest can insert a value from the Environment variable list, which is a list of
variables and corresponding values that can be accessed from your test. Throughout the
test run, the value of an environment variable remains the same, regardless of the number
of iterations, unless you change the value of the variable programmatically in your script.
QuickTest enables you to retrieve values in your test or component and to store them as
output values. You can subsequently retrieve these values and use them as input at a
different stage in the run session. You can pass variables from one action to another by
setting Action Call Parameter Values. You use the Parameter Values tab of the Action Call
Properties dialog box to specify the values of input action parameters used by the called
action and to specify the locations in which you want to store output action parameter
values. You can also parameterize the value used for a particular input action parameter
using any available parameter type.
The actual input and output action parameters that an action can receive or return, and
their types, are defined in the Action Properties dialog box. If you do not set a value for
an input action parameter in the Action Call Properties dialog box, the default value that
is specified in the Action Properties dialog box is used.
You can specify a location in which to store the output action parameter values, which
can be used in the called action.
1. In the Output parameters area, click in the Store In box for the
parameter and enter a variable name.
If we choose variable to store the value, then the value is stored in a run-
time variable for the duration of the run session. You can accept the
default name assigned to the variable or enter a different variable name.
Alternatively, you can click the output storage button in the Store In
box to open the Storage Location Options dialog box in which you can
specify a location for storing the output value. You can select to store the
value in a test or action parameter, a Data Table parameter, or an
environment parameter.
2. Repeat this procedure for each output action parameter value in the list.
Mainly there are two types of variables: action parameters and environment variables.
An action's parameters are stored with the action and are the same for all calls to that
action. If you change the action parameters defined for an action, and then view the
action properties for a call to that same action in a different part of the test, you can see
the action parameters have changed. However, the actual values specified for input action
parameters and the locations specified for action output parameters can be different for
each call to the action. When you insert a call to a copy of an action, the copy of the
action is inserted with the action parameters and action call parameter values that were
defined for the action you copied. When you split an action, the action parameters are
copied to both actions. The action call values for the second action are taken from the
default values of that action's parameters.
Environment variables can be accessed from your test. Throughout the test run,
the value of an environment variable remains the same, regardless of the number
of iterations, unless you change the value of the variable programmatically in
your script.
In QTP the following types of checkpoints can be inserted to check various objects in a
Web site or application.
• Image Checkpoint checks the value of an image in the application or Web page.
For example, we can check that a selected image's source file is correct.
Table checkpoints are supported for Web and ActiveX environments & for many
other external add-in environments.
• Text Area Checkpoint checks that a text string is displayed within a defined
area in a Windows application, according to specified criteria. For example,
suppose your Visual Basic application has a button that says View Doc <Num>,
where <Num> is replaced by the four digit code entered in a form elsewhere in
the application. You can create a text area checkpoint to confirm that the number
displayed on the button is the same as the number entered in the form.
Text area checkpoints are supported for Standard Windows, Visual Basic, and
ActiveX add-in environments Text area checkpoints are also supported for some
external add-in environments.
• Accessibility Checkpoint identifies areas of your Web site that may not
conform to the World Wide Web Consortium (W3C) Web Content Accessibility
Guidelines. For example, guideline 1.1 of the W3C Web Content Accessibility
Guidelines requires you to provide a text equivalent for every non-text element.
You can add an Alt property check to check whether objects that require the Alt
property under this guideline, do in fact have this tag.
• Page Checkpoint checks the characteristics of a Web page. For example, you can
check how long a Web page takes to load or whether a Web page contains broken
links.
• XML Checkpoint checks the data content of XML documents in XML files
or XML documents in Web pages and frames. XML checkpoints (Web
page/frame) are supported for the Web environment; XML checkpoints (file) are
supported by all environments
The following are the categories of output values that can be created:
The Output Value Properties dialog box enables you to choose which property values to
output and to define the settings for each value that you select.
Note: If you insert an output value on a Web page, the Page Output Value
Properties dialog box opens. This dialog except that it contains two additional
option areas, HTML verification and All objects in page. These options are
relevant only for checkpoints and are disabled when defining output values.
• Global\Local Sheet
• Environment variables
• Action\Test Parameter.
When forming a new product the traditional engineer can take advantage of ready-made
subassemblies. To the test engineer, reusable software components offer the same
possibilities; the same components can be incorporated into many whole new systems,
thus saving the considerable time and effort it can take to generate new software.
Starting with an introduction to software reuse and a discussion of its feasibility, the
authors go on to consider how the components that may be found could be used. The
reusable library was designed with reuse very much in mind, making it essentially a
small, but invaluable, library.
12.1 Introduction
In QTP we can create VBScript library files containing VBScript functions, subroutines,
classes, modules, etc., and then associate the files with our test. We can call any VBScript
function, subroutine, etc., contained within any library file that is associated with our test.
Any text file written in standard VBScript syntax can act as a library file.
a) Functions
i. Built-In
We can specify the default library files for all new tests in the Test Settings
dialog box (Test > Settings > Resources tab). We can also edit the list of
associated library files for an existing test in the Test Settings dialog box.
Note that once a test is created, the list of files specified in the Test
Settings dialog box is independent of the files set as default in the Test
Settings dialog box. Changes to the default library files list in the Test.
We can use the Resources tab of the Test Settings dialog box to associate specific files
with your test, such as VBScript library files and Data Table files, and to specify the
object repository mode and file to use for our test. We can also set the currently
associated library files and object repository settings as the default settings for all new
tests.
When we run our test, the ExecuteFile statement executes all global code in the specified
file in order to make all definitions in the file available from the global scope of the
action's (or library file's) script.
ExecuteFile FileName
where FileName is the absolute or relative path of our VBScript file.
13.1 Description
While creating checkpoints we have an option only to search or check for a specific text
string or a specific value of a property. To increase the flexibility and adaptability
of the tests we use regular expressions.
Regular Expressions enable Quick Test to identify objects and text strings with varying
values.
A regular expression is a string that specifies a complex search phrase. By using special
characters we define the conditions of the search.
The most common expressions that can be used to create regular expressions are:
A backslash (\) instructs Quick Test to treat the next character as a literal
character, if it is otherwise a special character. The backslash (\) can also instruct
Quick Test to recognize certain ordinary characters as special characters.
mercurytours.mercuryinteractive.com
mercurytours\.mercuryinteractive\.com
A period (.) instructs Quick Test to search for any single character (except for \n).
For example:
welcome.
matches welcomes, welcomed, or welcome followed by a space or any other
single character. A series of periods indicates the same number of unspecified
characters.
To match any single character including \n, enter: (.|\n)
Square brackets instruct QuickTest to search for any single character within a list of
characters. For example, to search for the date 1967, 1968, or 1969, write: 196[789]
When a caret (^) is the first character inside square brackets, it instructs QuickTest to
match any character in the list except for the ones specified in the string. For example:
[^ab]
matches any character except a or b.
In order to match a single character within a range, you can use square brackets ([ ]) with
the hyphen (-) character. For instance, to match any year in the 1960s, write: 196[0-9]
A hyphen does not signify a range if it is displayed as the first or last character within
brackets, or after a caret (^).
For example, [-a-z] matches a hyphen or any lowercase letter.
An asterisk (*) instructs QuickTest to match zero or more occurrences of the preceding
character. For example:
ca*r matches car, caaaaaar, and cr.
A plus sign (+) instructs QuickTest to match one or more occurrences of the
preceding character. For example:
ca+r matches car and caaaaaar, but not cr.
8. Matching Zero or One Specific Character
A question mark (?) instructs Quick Test to match zero or one occurrences of the
preceding character. For example:
ca?r matches car and cr, but nothing else.
Parentheses (()) instruct Quick Test to treat the contained sequence as a unit, just
as in mathematics and programming languages.
Using groups is especially useful for delimiting the argument(s) to an alternation
operator ( | ) or a repetition operator ( * , + , ? , { } ).
A vertical line (|) instructs QuickTest to match one of a choice of expressions. For
example: foo|bar
causes QuickTest to match either foo or bar.
fo(o|b)ar
causes Quick Test to match either fooar or fobar.
11. Matching the Beginning of a Line
A caret (^) instructs QuickTest to match the expression only at the start of a line,
or after a newline character.
For example: book
matches book within the lines—book, my book, and book list, while
^book
Matches book only in the lines—book and book list
12. Matching the End of a Line
A dollar sign ($) instructs Quick Test to match the expression only at the end of a
line, or before a new line character. For example: book
Matches book within the lines—my book, and book list, while a string that is
followed by ($), matches only lines ending in that string. For example: book$
Matches book only in the line—my book.
The checkpoint passed because the text was displayed in the format specified by
the regular expression.
Recovery scenarios are saved in recovery scenario files. A recovery scenario file is a
logical collection of recovery scenarios, grouped according to your own specific
requirements.
To instruct Quick Test to perform a recovery scenario during a test run, you must first
associate it with that test. A test can have any number of recovery scenarios associated
with it. You can prioritize the scenarios associated with your test to ensure that trigger
events are recognized and handled in the required order.
When you run a test for which you have defined recovery scenarios and an error occurs,
Quick Test looks for the defined trigger event(s) that caused the error. If a trigger event
has occurred, Quick Test performs the corresponding recovery and post-recovery
operations.
You can also control and activate your recovery scenarios during the test run by inserting
Recovery statements into your test.
Note: If you choose On error in the Activate recovery scenarios box in the Recovery
tab of the Test Settings dialog box, the recovery mechanism does not handle triggers that
occur in the last step of a test. If you chose this option and need to recover from an
unexpected event or error that may occur in the last step, you of a test can do this by
adding an extra step to the end of your test.
The Recovery Scenario Manager dialog box enables you to create recovery scenarios and
save them in recovery files. You create recovery scenarios using the Recovery Scenario
Wizard, which leads you through the process of defining each of the stages of the
recovery scenario. You then save the recovery scenarios in a recovery file, and associate
them with a specific test or tests.
You save your recovery scenarios in a recovery file. A recovery file is a convenient way
to organize and store multiple recovery scenarios together. You can create a new recovery
file or edit an existing one.
For more information on creating a Recovery File refer to Creating a Recovery File
After you create or modify a recovery scenario in a recovery file using the Recovery
Scenario Wizard, you need to save the recovery file.
Tip: You can also click the arrow to the right of the Save button and select Save
As to save the recovery file under a different name.
3. Type a name for the file in the File name box. The recovery file is saved in the
specified location with the file extension .qrs.
Tip: If you have not yet saved the recovery file, and you click the Close button in the
Recovery Scenario Manager dialog box, Quick Test prompts you to save the recovery
file. Click Yes, and proceed with step 2 above. If you added or modified scenarios in an
existing recovery file, and you click Yes to the message prompt, the recovery file and its
scenarios are saved.
Once you have created recovery scenarios, you can use the Recovery Scenario Manager
to manage them.
The Recovery Scenario Manager contains the following recovery scenario icons:
Icon Description
Indicates that the recovery scenario is triggered when a window pops up
in an open application during the test run.
Indicates that the recovery scenario is triggered when the property values
The Recovery Scenario Manager enables you to manage existing scenarios by:
Viewing Recovery Scenario Properties
Modifying Recovery Scenarios
Deleting Recovery Scenarios
Copying Recovery Scenarios between Recovery Scenario Files
The Recovery Scenario Properties dialog box displays the following read-only
information about the selected scenario:
General tab—Displays the name and description defined for the recovery
scenario, plus the name and path of the recovery file in which the scenario is
saved.
Trigger Event tab—Displays the settings for the trigger event defined for the
recovery scenario.
Recovery operation tab—Displays the recovery operation(s) defined for the
recovery scenario.
Post-Recovery Operation tab—Displays the post-recovery operation defined for
the recovery scenario.
Note: If a deleted recovery scenario is associated with a test, Quick Test ignores it
during the test run.
You can copy recovery scenarios from one recovery scenario file to another.
3 Click the Open button and select the recovery scenario file to which you want
to copy the scenario, or click the New button to create a new recovery scenario
file in which to copy the scenario.
4 Click the Paste button . The scenario is copied to the new recovery scenario file.
Note: If a scenario with the same name already exists in the recovery scenario file, you
can choose whether you want to replace it with the new scenario you have just copied.
After you have created recovery scenarios, you associate them with selected tests so that
Quick Test will perform the appropriate scenario(s) during the test runs if a trigger event
occurs. You can prioritize the scenarios and set the order in which Quick Test applies the
scenarios during the test run. You can also choose to disable specific scenarios, or all
scenarios, that are associated with a test. You can also define which recovery scenarios
will be used as the default scenarios for all new tests.
After you have created recovery scenarios, you can associate one or more scenarios with
a test in order to instruct Quick Test to perform the recovery scenario(s) during the test
run if a trigger event occurs. The Recovery tab of the Test Settings dialog box lists all the
recovery scenarios associated with the current test.
Tip: When a trigger event occurs, Quick Test checks for applicable recovery scenarios in
the order in which they are displayed in the Recovery tab. You can change this order as
described in “Setting Recovery Scenario Priorities”
For more information on “adding a recovery scenario to a test” refer to Adding Recovery
Scenario to a Test
You can view properties for any recovery scenario associated with your test.
You can specify the order in which Quick Test performs associated scenarios during a test
run. When a trigger event occurs, Quick Test checks for applicable recovery scenarios in
the order in which they are displayed in the Recovery tab of the Test Settings dialog box.
You can remove the association between a specific scenario and a test using the Recovery
tab of the Test Settings dialog box. After you remove a scenario from a test, the scenario
itself still exists, but Quick Test will no longer perform the scenario during a test run.
You can enable or disable specific scenarios and determine when Quick Test activates the
recovery scenario mechanism in the Recovery tab of the Test Settings dialog box. When
you disable a specific scenario, it remains associated with the test, but is not performed
by Quick Test during the test run. You can enable the scenario at a later time.
Note that the step that returns an error is often not the same as the step that causes
the exception event to occur.
For example, a step that selects a check box may cause a pop-up dialog box to
open. Although the pop-up dialog box is defined as a trigger event, Quick Test
moves to the next step because it successfully performed the check box selection
step. The next several steps could potentially perform checkpoints, functions or
other conditional or looping statements that do not require performing operations
on your application. It may only be ten statements later that a step instructs Quick
Test to perform an operation on the application that it cannot perform due to the
pop-up dialog box. In this case, it is this tenth step that returns an error and
triggers the recovery mechanism to close the dialog box. After the recovery
operation is completed, the current step is this tenth step, and not the step that
caused the trigger event.
Never—The recovery mechanism is disabled.
You can click the Set as Default button in the Recovery tab of the Test Settings dialog
box to set the current list of recovery scenarios to be the default scenarios for all new
tests. Any future changes you make to the current recovery scenario list only affect the
current test, and do not change the default list that you defined.
In Flight Application, when we give wrong password in the login dialog box then we get
the following popup window:
In order to handle this, take a new recovery scenario, in the “Select Trigger Event” screen
of Recovery Scenario Wizard, select “pop-up window” Radio button as shown below,
In the next screen, we can specify Pop-up window condition, by spying the popup
window, then details of the pop-up window appears as follows:
then in the next step, In the recovery operation screen select “keyboard or mouse
operation” radio button, then in the next step select “Press ENTER Key” radio button,
In the next screen select “Add another recovery operation” check box as given below:
then in the next step, In the recovery operation screen select “function call” radio button
Specify the path and name of the library file which has the appropriate function for
entering the password and clicking “ok” button of “Login” dialog box.
In the “Post-Recovery Test Run Options” screen select “Repeat current step and
Continue” radio button, give a name to the recovery scenario, thus the recovery will be
created.
1. We can add the Recovery Scenario to our test while we create a new Recovery
Scenario by checking the “add Scenario to current test” check box in “Completing
the Recovery Scenario Wizard” screen of Recovery Scenario Wizard.
2. The other way to add Recovery Scenario to our test is by adding the required
scenario file in the recovery tab of Test Settings Dialog box.
When running a test, if a step does not succeed in opening a dialog box,
QuickTest does not necessarily abort the test run. It bypasses any step
designated "optional" and continues running the test. By default,
QuickTest automatically marks as optional steps that open certain dialog
boxes. You can manually designate additional steps as optional.
If a dialog box may or may not appear at a particular instanse then that
dialog box actions performed can be set as optional, so that it proceeds to
the next step, if the screen or dialog box doesn’t appear or will continue
the normal flow.
There are some default objects, which QTP recognizes as optional, for
those objects QTP by default sets as optional, those objects are as follows:
Auto Complete
File Download
Internet Explorer
Netscape
Enter Network Password
Error
Security Alert
Security Information
Security Warning
Username and Password Required
Example:
OptionalStep.Browser("browser_name").Page("page_n
ame").Link("link_name")
16. Reporting
The process of reporting is to customize the test results, and add the appropriate
comments and reports to the test results to increase the readability of it. Reporting can be
done in various formats.
There are 3 options for screen capture the screens to the results:
• Always – adds screen shots to the results for every step.
• On Errors – adds screen shots only on occurrence of error
• On Errors and Warnings – adds on both errors and warnings.
• Never
Note: If “Always” option is selected then the result file will occupy lots of memory, thus
selection of “Always” option should be done only if the client wants to view all the
screen shots for reference during review.
1. ReportEvent Method
Example
The following example uses the Report Event method to report that the checkpoint on
this window has passed.
Reporter.ReportEvent 0,"Fax Order No. 12","The check point for this window has
passed "
2. Filter Property
Retrieves or sets the current mode for displaying events in the Test Results. You can use
this method to completely disable or enable reporting of steps following the statement, or
you can indicate that you only want subsequent failed or failed and warning steps to be
included in the report.
Syntax:
Mode Description
0 or Default. All reported events are displayed in the
rfEnableAll Test Results.
1 or Only event with a warning or fail status are
rfEnableErrorsAndWarnings displayed in the Test Results.
2 or Only events with a fail status are displayed in the
rfEnableErrorsOnly Test Results.
3 or
No events are displayed in the Test Results.
rfDisableAll
Example
The following example uses the Filter method to report the following events in the Test
Results: 1, 2, 5, and 6.
Reporter.ReportEvent micGeneral, "1", ""
Reporter.ReportEvent micGeneral, "2", ""
Reporter.Filter = rfDisableAll
Reporter.ReportEvent micGeneral, "3", ""
Reporter.ReportEvent micGeneral, "4", ""
Reporter.Filter = rfEnableAll
Reporter.ReportEvent micGeneral, "5", ""
Reporter.ReportEvent micGeneral, "6", "
3. ReportPath Property
Retrieves the folder path in which the current test's Test Results are stored.
Syntax
Path = Reporter.ReportPath
Example
The following example uses the ReportPath method to retrieve the folder in which the
test's Test Results are stored and displays the folder in a message box.
dim Path
Path = Reporter.ReportPath
MsgBox (Path)
The results of the QTP runs are stored in the Results folder, which must be specified
before starting the test run. The results are stored in 2 types of formats:
• QTP format – this is the format in which the results are displayed in the test
window, opens with QTP
• XML format – the results are also stored in XML file, in which all the objects are
stored in a hierarchy in .xml format. This is useful in transfer of the results
information across platforms, since it is based on simple Unicode format.