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

Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

Embed Size (px)

Citation preview

Page 1: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC)

Integration Guide TCE Automation 5.2

Page 2: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

ii Copyright © 2012 Keynote DeviceAnywhere. All Rights Reserved. Keynote DeviceAnywhere Confidential

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 [email protected].

Keynote DeviceAnywhere 777 Mariners Island Blvd. San Mateo, CA 94404

Page 3: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Copyright © 2012 Keynote DeviceAnywhere. All Rights Reserved. iii 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

Page 4: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE
Page 5: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 5

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, directories

Right-click the project’s actions directory.

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.

Page 6: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

6 Keynote DeviceAnywhere Confidential

Contacting Support If you have any comments or suggestions regarding this document, contact the DeviceAnywhere support organization for enterprise customers at [email protected]. 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/enterprise-support.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.

Page 7: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 7

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

Page 8: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

8 Keynote DeviceAnywhere Confidential

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.

Page 9: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 9

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.

Page 10: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

10 Keynote DeviceAnywhere Confidential

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).

Page 11: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 11

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.

Page 12: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

12 Keynote DeviceAnywhere Confidential

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.

Page 13: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 13

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.

Page 14: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

14 Keynote DeviceAnywhere Confidential

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.

Page 15: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 15

NOTE Refer to HP ALM documentation for supported browsers.

b Point the browser to http://<HPALM_server_hostname/IP>:<port>/qcbin/start_a.jsp?common=true.

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.

Page 16: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

16 Keynote DeviceAnywhere Confidential

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 http://<HPALM_server_hostname/IP>:<port>/qcbin/start_a.jsp.

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.

Page 17: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 17

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.

Page 18: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

18 Keynote DeviceAnywhere Confidential

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.

Page 19: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 19

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.

Page 20: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

20 Keynote DeviceAnywhere Confidential

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.

Page 21: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

Keynote DeviceAnywhere Confidential 21

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.

Page 22: Keynote DeviceAnywhere/HP Application Lifecycle Management (HP · PDF file · 2017-04-04Keynote DeviceAnywhere/HP Application Lifecycle Management (HP ALM/QC) Integration Guide TCE

KDA-HP QC Integration Guide

22 Keynote DeviceAnywhere Confidential

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.