Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide. TCE Automation 5.2

Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE Automation 5.2

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@keynote.com. Keynote DeviceAnywhere 777 Mariners Island Blvd. San Mateo, CA 94404 ii Copyright 2012 Keynote DeviceAnywhere. All Rights Reserved. Keynote DeviceAnywhere Confidential

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. Keynote DeviceAnywhere Confidential iii

About This Document This document describes the installation and use of Keynote DeviceAnywhere s Add-In for HP Application Lifecycle Management software (also called HP Quality Center). The Add-in integrates HP ALM (HP QC) with Keynote DeviceAnywhere s 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 http://www.keynotedeviceanywhere.com 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 project s actions directory. directories Monospace bold User input In a command window, type adb killserver. 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

Contacting Support If you have any comments or suggestions regarding this document, contact the DeviceAnywhere support organization for enterprise customers at kda-esupport@keynote.com. You may also send your inquiries about DeviceAnywhere product demonstrations and consulting services to this address. Enterprise customers can find support information at http://www.deviceanywhere.com/enterprisesupport.html. Additional Documentation You can find additional information in the following documents available at http://www.keynotedeviceanywhere.com/testing-automation-documentation.html: 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 http://support.openview.hp.com/selfsolve/manuals (requires HP Passport login). Documentation is also available from the HP ALM Help menu. 6 Keynote DeviceAnywhere Confidential

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 DATestFiles.cab 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 Studio if 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

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

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 DATestFiles.cab folder KDAALMIntegrationGuide.pdf (this document) 2 Copy the CustomTestTypes folder to the application\qcbin.war folder of your HP ALM installation, e.g., C:\Program Files\HP\HP Application Lifecycle Management Platform\application\20qcbin.war. 3 Copy the DATestFiles folder to the applications\qcbin.war\extensions folder of your HP ALM installation, e.g., C:\Program Files\HP\HP Application Lifecycle Management Platform\application\20qcbin.war\Extensions. 4 Copy the DATestFiles.cab folder to the applications\qcbin.war\extensions folder of your HP ALM installation, e.g., C:\Program Files\HP\HP Application Lifecycle Management Platform\application\20qcbin.war\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

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

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

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 b Click Create Project. 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

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

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 b c d Launch Studio and navigate to the Scripting tab of the Test Automation view. Double-click to load the project. Right-click the project in the project list > Build Project. 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

NOTE Refer to HP ALM documentation for supported browsers. b c Point the browser to http://<hpalm_server_hostname/ip>:<port>/qcbin/start_a.jsp?common=true. 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

2 After installing the Keynote DeviceAnywhere Add-In and downloading required client-side files, access HP ALM as follows: a b c Log in to the client machine as a regular user and launch the browser. Point the browser to http://<hpalm_server_hostname/ip>:<port>/qcbin/start_a.jsp. 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

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

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

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 device s MCD in Studio by looking up device information see 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

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

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

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