Keynote DeviceAnywhere/HP

Application Lifecycle Management

(HP ALM/QC)

Integration Guide
TCE Automation 5.2
KDA-HP QC Integration Guide

Copyright
Copyright 2012 Keynote DeviceAnywhere. All Rights Reserved.
August 2012.

Notice
2012 Keynote DeviceAnywhere. All rights reserved.
THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROVIDED AS IS WITHOUT ANY
EXPRESS REPRESENTATIONS OF WARRANTIES. IN ADDITION, KEYNOTE DEVICEANYWHERE,
DISCLAIMS ALL IMPLIED REPRESENTATIONS AND WARRANTIES, INCLUDING ANY
WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-
INFRINGEMENT OF THIRD PARTY INTELLECTURAL PROPERTY RIGHTS.
Test Center Enterprise Automation 5.2
All text and figures included in this publication are the exclusive property of Keynote DeviceAnywhere,
and may not be copied, reproduced, or used in any way without the express permission in writing of
Keynote DeviceAnywhere. Information in this document is subject to change without notice and does not
represent a commitment on the part of Keynote DeviceAnywhere. Keynote DeviceAnywhere may have
patents or pending patent applications covering subject matter in this document. The furnishing of this
document does not give you any license to these patents except as expressly provided in any written
license agreement from Keynote DeviceAnywhere.
Mobile Complete, the Keynote DeviceAnywhere logo, DeviceAnywhere, Direct-to-Device,
DeviceAnywhere Studio, Test Center Developer, Test Center Enterprise, Test Center Enterprise
Interactive, Test Center Enterprise Automation, Test Center Enterprise Monitoring, DemoAnywhere, and
DeviceAnywhere Portal are trademarks of Keynote DeviceAnywhere in the United States and/or other
countries.
This document also contains registered trademarks, and trademarks and service marks that are owned by
their respective owners. Keynote DeviceAnywhere disclaims any responsibility for specifying marks that
are owned by their respective companies or organizations. If you have any comments or suggestions
regarding this document, please send them by e-mail to kda-esupport@[Link].
Keynote DeviceAnywhere
777 Mariners Island Blvd.
San Mateo, CA 94404

ii Copyright 2012 Keynote DeviceAnywhere. All Rights Reserved.

Keynote DeviceAnywhere Confidential
KDA-HP QC Integration Guide

Contents
About This Document ...................................................................................................... 5
Document Outline ...................................................................................................................................... 5
Typographical Conventions...................................................................................................................... 5
Contacting Support .................................................................................................................................... 6
Additional Documentation ....................................................................................................................... 6

1 Prerequisites ........................................................................................................... 7
1.1 HP ALM Integration Requirements .......................................................................................... 7
1.2 System Requirements for Keynote DeviceAnywhere Studio ................................................ 7

2 Keynote DeviceAnywhere Add-In Installation ................................................ 9

3 Running a Keynote DeviceAnywhere - HP ALM Session ............................ 14

3.1 Keynote DeviceAnywhere Studio............................................................................................ 14
3.2 Launching HP ALM ................................................................................................................... 14
3.3 Creating a Mobile Test in HP ALM ......................................................................................... 16
3.4 Viewing Mobile Test Results .................................................................................................... 20

Copyright 2012 Keynote DeviceAnywhere. All Rights Reserved. iii

Keynote DeviceAnywhere Confidential
 KDA-HP QC Integration Guide

About This Document

This document describes the installation and use of Keynote DeviceAnywheres Add-In for HP
Application Lifecycle Management software (also called HP Quality Center). The Add-in integrates HP
ALM (HP QC) with Keynote DeviceAnywheres mobile application and device testing platform, enabling
users to run test scripts in HP ALM that run on real, live mobile devices attached to the Keynote
DeviceAnywhere platform.
From HP ALM, you can execute single-device as well as multi-device automated test cases that have been
created in the Keynote DeviceAnywhere Studio client application. To support test case execution from
HP ALM, you can:
Select an execution device(s) from HP ALM.
Pass values for test case parameters from HP ALM.
View proofs (device screenshots) in HP ALM after test case execution.

Document Outline
In this document:
Prerequisites lists the requirements for Keynote DeviceAnywhere HP ALM integration. It also lists
system requirements for the Keynote DeviceAnywhere Studio client application, required for creating
automated mobile tests. Studio must be installed on the HP ALM client machine.
Keynote DeviceAnywhere Add-In Installation describes the procedure for installing the Keynote
DeviceAnywhere Add-In for HP ALM.
Running a Keynote DeviceAnywhere HP ALM Session describes how to launch an HP ALM session
after integration, how to set up Keynote DeviceAnywhere mobile test execution from HP ALM, and how
to device screen proofs in run results.

Typographical Conventions
The table below describes the typographical conventions used in DeviceAnywhere documentation.
Style Element Examples
Blue Links and email addresses [Link]
The Document Outline section on this page
describes the structure of this manual.
Bold User interface elements such as menu items Select Scripting in the Test Automation view
of Studio.
Monospace Commands, code output, filenames, Right-click the projects actions directory.
directories
Monospace bold User input In a command window, type adb kill-
server.
Italic Document titles and emphasis Refer to the Keynote DeviceAnywhere Private
System Installation Guide for instructions on
setting up server infrastructure.

Keynote DeviceAnywhere Confidential 5

KDA-HP QC Integration Guide

Contacting Support
If you have any comments or suggestions regarding this document, contact the DeviceAnywhere support
organization for enterprise customers at kda-esupport@[Link]. You may also send your inquiries
about DeviceAnywhere product demonstrations and consulting services to this address.
Enterprise customers can find support information at [Link]
[Link].

Additional Documentation
You can find additional information in the following documents available at
[Link]
TCE Automation User Guide
TCE Automation Release Notes
TCE Interactive User Guide
Keynote DeviceAnywhere HP Functional Testing Integration Guide
You can also access documents from the Help menu in Studio.
HP ALM documentation, including the user and installation guides, is available at
[Link] (requires HP Passport login). Documentation is also
available from the HP ALM Help menu.

6 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

1 Prerequisites
To deploy and use the Keynote DeviceAnywhere - HP ALM integration, you require the following:

1.1 HP ALM Integration Requirements

The following software components are needed for the DeviceAnywhere HP Functional Testing
integration:
HP Application Lifecycle Management software (HP ALM, also called HP Quality Center) 11.00
refer to the HP Application Lifecycle Management Installation Guide for system requirements (also see
Additional Documentation).
The following patch must also be applied to your HP ALM installation before installing the Keynote
DeviceAnywhere Add-In: HP ALM 11.0 Patch 2 (Filename: TD4QC_00167.zip).
The Keynote DeviceAnywhere Add-in components can be installed on Windows Server 2003 and
Windows Server 2008 machines on which HP ALM is installed.
A license for TCE Automation
Keynote DeviceAnywhere Add-In for HP ALM components, provided together in an archive file:
CustomTestTypes folder
DATestFiles folder
[Link] folder
Keynote DeviceAnywhere Studio client software, installed on the HP ALM client machine (see
System Requirements for DeviceAnywhere Studio below). Studio must point to a fully operational
Keynote DeviceAnywhere mobile test environment (including DeviceAnywhere Access Server, SQL
Server, and other components).
An account enabling you to log in to Studioif you require an account, please contact your system
administrator.

1.2 System Requirements for Keynote DeviceAnywhere Studio

NOTE These requirements are for installing Studio only; requirements for installing the complete
Keynote DeviceAnywhere test environment are detailed in the TCE Private System Installation Guide.

Minimum system requirements are as follows:

2 GHz dual-core processor (Pentium 4)
2 GB RAM
At least 10 GB available hard disk space
Monitor with at least 1024x768 screen resolution
Optional: Audio card for sound input/output
Supported Windows operating systems: Windows XP SP2, Windows Server 2003, Windows Vista,
Windows 7, Windows Server 2008

Keynote DeviceAnywhere Confidential 7

KDA-HP QC Integration Guide

NOTES Studio can be installed on machines with 32-bit operating systems and 64-bit operating
systems running in 32-bit compatibility mode.
Components of the Keynote DeviceAnywhere test environment require a network connection to
communicate with each other.

8 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

2 Keynote DeviceAnywhere Add-In Installation

This section describes the procedure for installing and initiating the Keynote DeviceAnywhere Add-In for
HP ALM.

NOTE HP ALM 11.0 should already be installed on your server machine.

1 Unpack the archive file provided by Keynote DeviceAnywhere on the HP ALM server machine. The
archive file contains:
CustomTestTypes folder
DATestFiles folder
[Link] folder
[Link] (this document)
2 Copy the CustomTestTypes folder to the application\[Link] folder of your HP ALM
installation, e.g., C:\Program Files\HP\HP Application Lifecycle Management
Platform\application\[Link].
3 Copy the DATestFiles folder to the applications\[Link]\Extensions folder of your HP
ALM installation, e.g., C:\Program Files\HP\HP Application Lifecycle Management
Platform\application\[Link]\Extensions.
4 Copy the [Link] folder to the applications\[Link]\Extensions folder of
your HP ALM installation, e.g., C:\Program Files\HP\HP Application Lifecycle
Management Platform\application\[Link]\Extensions.
5 Run the HP Server Deployment Wizard to restart JBoss: From your windows Start menu, select All
Programs > HP ALM Platform > Server Deployment Wizard.
A splash screen and a command window indicate that the program is starting up.

Keynote DeviceAnywhere Confidential 9

KDA-HP QC Integration Guide

6 Click Next in the following wizard screen.

The wizard indicates that JBoss is being shut down.

7 Click Finish to exit the deployment wizard (ensure that Start JBoss is checked).

10 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

The wizard indicates that JBoss is being restarted.

8 In the browser application screen that appears, select Site Administration.

NOTE If you are unable to launch HP Site Administration in this way, navigate to your Windows
Start menu and select All Programs > HP ALM Platform > Site Administration.

Keynote DeviceAnywhere Confidential 11

KDA-HP QC Integration Guide

9 Enter administrative credentials and Login.

10 If you have no HP ALM projects, create a new project and assign a user to it as administrator:
a Click Create Project.
b Click Next to advance through the project creation wizard.
The screenshot below shows a user assigned as project administrator in the wizard.

c Create to complete project creation.

12 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

11 From the Site Administration window, select Tools (top-left corner) > Update Test Types.

12 Select Yes in the confirmation window that appears and then click OK.

Keynote DeviceAnywhere Confidential 13

KDA-HP QC Integration Guide

3 Running a Keynote DeviceAnywhere - HP ALM Session

This chapter describes:
Preliminary steps Keynote DeviceAnywhere Studio for a Keynote DeviceAnywhere HP ALM
session
Launching a Keynote DeviceAnywhere HP ALM session
Setting up a mobile test
Viewing run results

3.1 Keynote DeviceAnywhere Studio

Before starting a Keynote DeviceAnywhere HP ALM integrated session:
1 Ensure that Keynote DeviceAnywhere Studio is installed on the client machine. Studio is required for
creating the automated mobile test cases that are executed from HP ALM.
2 Launch Studio, log in, and save your password at least once. This saves your profile (login credentials
on a specified access server), which the Add-In uses to connect to the Keynote DeviceAnywhere test
environment.

3 Build the project(s) containing the test case(s) you wish to execute from HP ALM. You can perform
this step at any point before selecting a test case in an HP ALM test (see Creating a Mobile Test
below). If you do not build your Studio project(s), you will not be able to view or select any Keynote
DeviceAnywhere test cases in your HP ALM test and will encounter a No scripts found error.
a Launch Studio and navigate to the Scripting tab of the Test Automation view.
b Double-click to load the project.
c Right-click the project in the project list > Build Project.
d Exit Studio (Studio does not need to be open during Keynote DeviceAnywhere mobile test
execution from HP ALM).

3.2 Launching HP ALM

To start a Keynote DeviceAnywhere HP ALM session:
1 If starting the HP ALM client for the first time after installing the Keynote DeviceAnywhere Add-In
(you must do this on every client machine):
a Log in to the Windows client machine as an administrator and launch a browser.

14 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

NOTE Refer to HP ALM documentation for supported browsers.

b Point the browser to

[Link]
c You will be asked if you wish to install required Keynote DeviceAnywhere files. Click Install.

NOTE To avoid having to install files each time you launch the browser, select More options >
Always install software from Keynote Systems Incorporated, and then click Install.

d Close the browser.

Keynote DeviceAnywhere Confidential 15

KDA-HP QC Integration Guide

2 After installing the Keynote DeviceAnywhere Add-In and downloading required client-side files,
access HP ALM as follows:
a Log in to the client machine as a regular user and launch the browser.
b Point the browser to
[Link]
c Enter and Authenticate your HP ALM your credentials, then Login.

3.3 Creating a Mobile Test in HP ALM

This section explains how to set up a mobile test in HP ALM using test cases created in Keynote
DeviceAnywhere Studio:
1 After launching HP ALM, Navigate to Testing > Test Plan in the left pane.

2 Create a New Folder to contain your HP ALM test.

16 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

3 Enter a name for your new test folder and click OK.

4 Right-click the new folder and select New Test.

5 In your new test, ensure that the Type is set to DEVICE_ANYWHERE. Enter other details and click
OK.

Your new test is now listed in the pane for test scripts. The Type displayed is DEVICE_ANYWHERE.

Keynote DeviceAnywhere Confidential 17

KDA-HP QC Integration Guide

6 Select the Test Script tab of your new test. You will see a list of test cases (created in Studio) that you
can call and run from HP ALM. Test cases from all Studio projects are listed.

7 If necessary, click Refresh Scripts to view an updated list of available test cases resulting from a
project build in Studio.
If you have not built any projects in Studio, you will encounter a No scripts found error.

8 Click to select/highlight a test case in the Test Script tab.

18 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

9 Click Configure Device beneath the list of test cases to select a device for each slot in your test case.
The screenshot below shows the device selection dialog box for a single-device test case.

10 Select a device and click OK. Devices are listed by MCD. You can determine a devices MCD in
Studio by looking up device informationsee the TCE Interactive User Guide.

NOTE The MCD number is a unique identifier issued by Keynote DeviceAnywhere. Refer to the
chapter Automated Test Cases in the TCE Automation User Guide for details on device selection.

Keynote DeviceAnywhere Confidential 19

KDA-HP QC Integration Guide

In the image below, 1=40028 in the Devices field implies that the selected device 1 has the MCD
number 40028.

11 Execute your HP ALM test (calling an automated Keynote DeviceAnywhere mobile test case) from
the Test Lab tab in the left pane.

3.4 Viewing Mobile Test Results

To view run results captured from the device screen:
1 Select your test in the Test Lab tab. Ensure that the Execution Grid is displayed. Results for the most
recent run are shown in the bottom pane.

20 Keynote DeviceAnywhere Confidential

 KDA-HP QC Integration Guide

2 Double-click your test in the Execution Grid. This opens a dialog box listing all runs for the test.
Select the Runs tab.

3 Select the select and double-click a specific run (listed by Run ID). This opens up Run Details.

Keynote DeviceAnywhere Confidential 21

KDA-HP QC Integration Guide

4 Select the Steps tab. All commands in your test case are listed. An attachment icon next to a
command implies that proofs are available for viewing.

5 Double-click a specific Keynote DeviceAnywhere command, e.g., NavTo, to see associated proofs in
the Attachments tab. Each file represents a proof image. Navigate To commands can have proofs for
the opening and closing screens of the command, expected and actual results, and a comparison of
the two.

6 Double-click an image file to view it in a picture viewer.

22 Keynote DeviceAnywhere Confidential