Miteuftuserguide
Miteuftuserguide
August 2013
Copyright Notice
Copyright © 1995-2013 Keynote Systems, Inc. All rights reserved.
The content of this document is considered by Keynote to be proprietary and confidential. The contents
may only be disclosed to Keynote customers or other parties who are bound by current, valid, non-
disclosure agreements. Disclosure to third parties not actively covered by non-disclosure agreements is
strictly prohibited.
Keynote Systems, Inc.
777 Mariners Island Blvd.
San Mateo, CA 94404
ii Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Contents
1 Introduction ...................................................................................................4
1.1 Document Outline ............................................................................................................... 4
1.2 Requirements ...................................................................................................................... 4
1.2.1 Minimum System Requirements ............................................................................ 4
1.3 Documentation and Support ............................................................................................... 5
2 Installation ....................................................................................................6
2.1 UFT Configurator ................................................................................................................ 6
2.2 File Locations ...................................................................................................................... 9
4 Browsing .................................................................................................... 13
4.1 How to Browse .................................................................................................................. 13
4.2 Performance Waterfall and Object View ........................................................................... 14
4.3 DOM Tree View................................................................................................................. 16
4.4 MITE Score ....................................................................................................................... 18
1 Introduction
This document describes the installation and use of Keynote’s MITE (Mobile Internet Testing
Environment) Enterprise for UFT (HP Unified Functional Testing, which includes HP QTP—HP QuickTest
Pro).
MITE Enterprise for UFT provides access to over 2100 emulated devices and 12000 device profiles within
HP QTP. Users can test and verify mobile web content availing of Keynote’s design and performance
metrics. Users can also record test scripts on real WebKit browsers for on-demand playback.
Mobile web site interaction, test script recording and playback all take place within HP QTP. Test scripts
and results are stored within HP QTP.
1.2 Requirements
To deploy MITE Enterprise for UFT, you need to install:
HP QTP or HP UFT software 11.00—refer to the HP QuickTest Professional Installation Guide for
system requirements.
Keynote MITE 4.0
When you install and launch MITE, it automatically detects if HP QTP is installed on your machine
and prompts you to start the UFT Configurator.
This guide assumes that you familiar with HP QTP as well as browsing websites, recording and playing
scripts, and reviewing results in MITE.
4 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Video Running HP QTP with MITE Add-in Graphics card with 64 MB video memory
High Color (16 bit) color setting
Network Running HP QTP with MITE Add-in Internet connection required for logging in and
navigating web sites.
Keynote Confidential 5
MITE Enterprise for UFT Installation and User Guide
2 Installation
The high-level process of installing the MITE Enterprise for UFT testing environment involves:
1. Installing HP QTP
2. Installing MITE
3. Launching MITE at least once (covered below)
4. Stepping through the UFT Configurator to install the MITE Add-in (covered below)
5. Launching HP QTP and selecting the MITE Add-in
Or you can launch it from Start > All Programs > Keynote Systems > UFT Configurator.
6 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Keynote Confidential 7
MITE Enterprise for UFT Installation and User Guide
5. You can click Next when your credentials have been authenticated.
6. The next screen shows you instructions for what to do after you click Finish to exit the wizard.
8 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
7. Launch HP QTP and verify that you can see the MITE Add-in listed.
Keynote Confidential 9
MITE Enterprise for UFT Installation and User Guide
10 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
2. Enter your MITE credentials in the Keynote MITE window and click Login.
NOTE You can be simultaneously be logged in to a standalone instance of MITE as well as MITE
Enterprise for UFT using the same credentials.
To exit a MITE for UFT session simply exit HP QTP (File > Exit).
If HP QTP quits unexpectedly, the MITE Add-in is not terminated. You need to terminate the following
processes manually from the Windows Task Manager:
MITEPlug.exe
MWPRunnerForm.exe
BrowserRunnerForm.exe
Keynote Confidential 11
MITE Enterprise for UFT Installation and User Guide
You can dock the window in any quadrant of the HP QTP window:
1. Click the title bar of the window and drag it.
2. Dragging the window, mouse over any of the docking arrows that appear. The corresponding
quadrant is highlighted.
3. Release your mouse button. The Keynote MITE window is docked in the chosen quadrant.
12 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
4 Browsing
This chapter covers how to browse and interpreting MITE data in the performance waterfall, captured
DOM tree, and the MITE score.
As in MITE, you can choose from a large database emulated devices and device profiles to browse live
mobile web content in MITE Enterprise for UFT.
A device profile is a unique combination of device model, OS version, and browser. For a given device,
profiles can vary with respect to Internet properties such as the HTTP header set or the number of
simultaneous TCP connections.
The image below shows the device models available for a manufacturer as well as the profiles available
for a selected device model.
Figure 4-1 Device Models and Profiles
Selected device
model
Device properties
Select a device or device profile from the device library, then click the Browse button to specify a
website, or
Keynote Confidential 13
MITE Enterprise for UFT Installation and User Guide
Click the Browse button and select a device as well as URL to navigate to.
Figure 4-2 Browse Dialog Box
Advanced settings allow you to emulate a specific location, specify caching information, change device
orientation, and enter credentials to access a website.
Figure 4-3 Advanced Browse Settings
You can click, scroll, and enter data just as you would on a real device in the MITE Browser window that
opens up. Simply close the MITE Browser window to stop browsing.
14 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Elements are listed in the order in which they are downloaded. The blue bar for an element in the
waterfall represents an HTTP request. The width of the bar represents the time taken to process the
request; the green bar represents object size.
Figure 4-5 Interpreting the Waterfall
HTTP
Object
request
size
Note Waterfall charts with a green background (as in Figure 4-5 above) depict the most recent HTTP
requests.
Select an element in the waterfall and switch to the Object view to see its details.
Keynote Confidential 15
MITE Enterprise for UFT Installation and User Guide
Element selected in
waterfall
Element (image)
displayed in
Object view
Selected node
In addition to searching the DOM tree by XPath and a text string, you can also enter a CSS query. Select
Search CSS and click the DOM search button .
16 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
All nodes that match the query are displayed in bold. Use the next/previous buttons to select each
search result in turn. The corresponding area of the device screen is highlighted.
Figure 4-8 CSS Search Results
The spy button at the top-right of the DOM tree view is another search tool. When you select the spy
button , navigation is effectively frozen and any element you click on the device screen is highlighted
in the DOM.
Keynote Confidential 17
MITE Enterprise for UFT Installation and User Guide
Highlighted
in DOM
Selected element
Description of indicator
Selected performance
indicator from list of
factors
Details of
selected
indicator
Performance
score
The MITE score tab has panes for the assigned score, a list of performance indicators from which you
can select an indicator, a description of the indicator, and its details.
18 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Keynote Confidential 19
MITE Enterprise for UFT Installation and User Guide
20 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
5. Select a device and a URL to navigate to in the dialog box that appears and click OK. The options
selected in this dialog box are recorded as properties of the MITE Browser object created.
6. In the MITE Browser window, click, make selections, and enter data to interact with web content.
As you perform the following actions, corresponding HP QTP test steps are inserted (see Figure 5-1
below):
Clicking on links
Selecting a value using a drop-down list, radio button, or check box
Entering a value into a field
Generally, one test step is inserted per click or field entry.
7. Click Stop to finish recording. Closing the browser window will not stop recording.
Figure 5-1 Script Recording in Progress
Recorded
test steps
Browser
window
Keynote Confidential 21
MITE Enterprise for UFT Installation and User Guide
Field Description
uasuffix User agent suffix for each HTTP request—this can help filter MITE
traffic from your web server logs. The string is appended to the user
agent string.
22 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Field Description
uastring User agent string that identifies browser, device OS and version,
browser platform; one of the headers sent to the server
saverun If set to True, stores MITE run results in HP QTP. If set to False,
MITE results do not persist after the session ends.
openurl Based on a setting in the browse dialog box—URL to navigate to
longitude Used to identify the emulated location from which the web server
request is sent
latitude
kdaobjectid Unique object identifier used by HP QTP
eop_onurlcount_urlcount URL count to download before a page is considered complete
eop_onurlcount_endonurl If set to True, a certain number of URLs downloaded signify the end of
count the page (this number is specified in eop_onurlcount_urlcount).
eop_onurl_urlval URL to be detected; signifies the end of page.
eop_onurl_endonurl If set to True, the end of a specific HTTP request to a URL signifies
the end of a page. The URL is specified in eop_onurl_urlval.
eop_oncontent_waitcontent If True, waits for text defined in eop_oncontent_text to appear; if
todisappear False, waits for the text to disappear for page completion.
eop_oncontent_text If the text string specified appears/disappears, MITE considers the
page complete.
eop_oncontent_locationindom Searches for eop_oncontent_text in the specified element in the
DOM.
eop_oncontent_endonspecific If True, waits for specified content to appear/disappear in order to
content consider a page complete.
eop_httpinactivity_timeout Time in milliseconds after which, if there is no HTTP activity, the page
is considered complete—this value is set to 2000 by default.
eop_httpinactivity_endon If set to True, calculates page completion based on
httpinactivity eop_httpinactivity_timeout. This is the default page
completion criterion.
eop_endonloadevent Considers the end of the page to be reached when the browser notifies
the completion of download (set by default to True).
deviceid Internal ID in the MITE device database of the emulated device
clearlocalstorage Based on a setting in the browse dialog box—clears browser local
storage (recent searches, etc.) before a test run or browse session
begins.
clearcache Based on a setting in the browse dialog box—clears browser cache
before test run or browse session begins.
NOTE When using end of page criteria, all must be met to signify page completion. For example, by
default, both eop_httpinactivity_endonhttpinactivity and eop_endonloadevent are set to
True, implying that both conditions must be met for page completion.
Keynote Confidential 23
MITE Enterprise for UFT Installation and User Guide
In addition to kdaobjectid, the page object, gmail.google.com in Figure 5-3 below, has page
completion properties, in case the Back() or Forward() methods are invoked when editing a script in
Keyword or Expert mode. These properties are defined in Table 5-1 above.
Figure 5-3 Page Object in Repository
24 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Table 5-2 below describes object properties that identify the element selected. MITE for UFT navigates to
an element using the name, URL, access key, or position (elt_position), in that order. The name can
also use the extended syntax to point to an element using map.select:{XPath of the element}.
Other properties for the end of page are described in Table 5-1 above.
Keynote Confidential 25
MITE Enterprise for UFT Installation and User Guide
Field Description
elt_xpath Path expression identifying the selected element in the DOM
elt_width Width of the element in pixels
elt_url URL, if any, of the link clicked
elt_top Ordinate coordinate in pixels of the element clicked
elt_text Text of the selected element
elt_tagname Tag name of the element selected
elt_style
elt_position Number indicating position of the link with regard to other clickable
links—clickable links are counted from the top left of the device screen.
elt_parent_url URL of the parent element
elt_parent_tag Tag name of the parent element
elt_parent_id id attribute of the parent element
elt_parent_class class selector of the parent element
elt_name Name of the link/element clicked
elt_left Abscissa coordinate in pixels of the element clicked
elt_id id attribute of the selected element
elt_height Height of the element in pixels
elt_class class selector of the element selected
elt_accesskey accesskey attribute of the link clicked
Field Description
select_value Value chosen—if a radio button or check box, 1 = select, 0 = unselect
2 in the example above
select_option Option that the value corresponds to (Adults: 2 Travelers in the example above)
This object has the same end of page and element identifying properties described in Table 5-1 and
Table 5-2, respectively.
26 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Keynote Confidential 27
MITE Enterprise for UFT Installation and User Guide
Field Description
input_value Value entered—if encrypted, the value is not displayed as entered to ensure that it
is not readable.
input_isencrypted Indicates whether the value is encrypted; 0 = not encrypted, -1 = encrypted
This object has the same end of page and element identifying properties described in Table 5-1 and
Table 5-2, respectively.
28 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
5.3 Checkpoints
MITE for UFT supports standard HP QTP checkpoints for script verification.
To insert a checkpoint, while still in record mode:
1. Select Insert > Checkpoint > Standard Checkpoint.
The main HP QTP window is minimized while the MITE Browser window becomes the active window.
2. Click anywhere on the device screen to select the corresponding element as a checkpoint for the
page.
3. If there is a valid element where you have clicked, HP QTP translates it into a child object(s) of the
browser and page objects. Select the correct object from the dialog box that appears and click OK.
4. In the Checkpoint Properties dialog box, check the properties you want to use to identify the element
at run time.
5. Be sure to specify a timeout (in seconds) within which the checkpoint must be found. Click OK.
A test step referencing the object created (WebElement TagName: A in the example below) is
inserted into your script.
Keynote Confidential 29
MITE Enterprise for UFT Installation and User Guide
The object is listed in the Checkpoint and Output Objects section of the object repository. Properties
identifying the selected element are described in Table 5-2.
Figure 5-7 Checkpoint Object in Repository
30 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
MITE results are then accessible at any time after the run by accessing the test list and run
results layouts.
3. Run the script by selecting Automation > Run or clicking the Run icon . This executes the
script on the device it was recorded on.
NOTE If you need to, insert a wait time of a few seconds, e.g., Wait 15, before the first execution of
your script so you can position the HP QTP window. You can delete the line for subsequent runs as
the window position is automatically remembered.
Keynote Confidential 31
MITE Enterprise for UFT Installation and User Guide
While the test is running, the yellow arrow indicates the test step currently being executed. A
notification at the base of the HP QTP window indicates that the script is running.
Execution
notification
32 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Results for all MITE for UFT objects contain snapshots if you have set up Active Screen capture when
recording the script. The node for a successful checkpoint displays a check mark.
Figure 6-2 Checkpoint Results
Checkpoint
object in
results tree
Highlighted element
selected as
checkpoint
Keynote Confidential 33
MITE Enterprise for UFT Installation and User Guide
34 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
Button clicked
Value selected in
drop-down list
Keynote Confidential 35
MITE Enterprise for UFT Installation and User Guide
Value entered
(encrypted)
A list of MITE runs is available in the MITE test list layout in HP QTP. For the runs listed here to
persist after the current HP QTP session, set the saverun property of a script’s MITE Browser object to
True.
Expand the tree for a run and select the bottom node: summary run results are displayed to the right.
Figure 6-8 Test List with Summary Results for Selected Run
36 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
You can select one of several result indicators from the drop-down list in the Test results pane:
Figure 6-9 Choosing a Result Indicator
The images below show the number of pages visited (2) and the MITE grade (A):
Figure 6-10 Viewing Different Result Indicators
Keynote Confidential 37
MITE Enterprise for UFT Installation and User Guide
2. Enter a new run name in the dialog box that appears and click OK.
To view detailed results, with a run selected from the test list, switch to the run results layout .
Figure 6-11 Detailed Run Results with Page Snapshot
Waterfall of downloaded
objects on all pages
For a selected page, you can also view the DOM tree (shown below). You can search for any string in the
DOM.
38 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
For any object selected in the waterfall, you can see the sent and received headers in the HTTP headers
tab to the right.
Figure 6-13 HTTP Headers Sent and Received
Selected page
Keynote Confidential 39
MITE Enterprise for UFT Installation and User Guide
40 Keynote Confidential
Installation and User Guide MITE Enterprise for UFT
1. Open the script you want to execute. Ensure that the data table is visible: View > Data Table.
2. From the device library, select the first device profile you want to execute on.
3. Right-click and select Copy device details.
4. Paste (Ctrl+V) the device details in a data table row.
5. Repeat these steps for as many devices as you want to add to the device list.
NOTE You can also filter the device library by any string, e.g., Android, and then Ctrl-click to select
multiple devices. You can copy and paste all device details together.
6. In the object repository, select the deviceid property of the MITE Browser object.
7. Click in the Value column and then click the button to configure the value.
8. Make the following selections in the dialog box that appears and click OK:
a. Select the Parameter radio button (ensure that Data Table is selected as the value).
b. Choose F from the Name drop-down list. This sets the value of deviceid to column F of the
data table.
c. Select Global sheet.
9. Run your script; it will now be executed sequentially on each selected device.
HP QTP results for a multi-device script show execution on each device as an iteration.
Keynote Confidential 41
MITE Enterprise for UFT Installation and User Guide
# iterations
=3
Three main branches
for a 3-device
execution
MITE summary results in the test list show the outcome on each device.
Figure 6-15 MITE Summary Results for Multi-Device Execution
Summary results on
Selected multi-device each device
run
42 Keynote Confidential