IBM Business Process Manager Testing Asset Quick Start Guide

Overview

The IBM Business Process Manager Testing Asset is a light-weight automation testing tool specifically designed for the IBM BPM product to support automated testing for coaches.

This asset is one of the IBM Services Assets which is an addition to the IBM product portfolio and built by IBM Software Services for WebSphere.

This quick start guide helps you to setup the environment for the IBM Business Process Manager Testing Asset.

Please refer to the following references for more information on how to use the IBM Business Process Manager Testing Asset:

• Within the Testing asset there is a doc directory which contains 2 pdf files that go though some testing scenarios using the tool.
• developerWorks article: Automating a process application with the IBM Business Process Manager Testing Asset

Download and Install JDK 7+ 32bit

The IBM Business Process Manager Testing Asset is base on java which is not supplied with the asset.
Before you install the tool you must install Java 7+ 32bit.

You can download and install Java JDK from here:
http://www.oracle.com/technetwork/java/javase/downloads/index.html

Once you have the JDK 7+ 32bit installed you need to set the JAVA_HOME environment variable within Windows.



Next set the CLASSPATH environment variable within Windows.

Add %JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar; to CLASSPATH

Download and Install IBM Business Process Manager Testing Asset

Download the latest IBM BPM Testing Asset from the IBM Client Success Portal.

https://odc.supportportal.com/ics/support/DLList.asp?task=download&folderID=121207

Unzip the IBM Business Process Manager Testing Asset Designer into a directory without spaces in it.

For this guide it will be uncompressed in C:\BPMTestTool.  This directory will be referred to <BPM_TEST_ASSET_HOME>.
 

Download and Install Selenium

The IBM Business Process Manager Testing Asset uses the selenium as an engine to execute and extend operations during test execution.

Download and unzip Selenium 2.46.0 into the <BPM_TEST_ASSET_HOME> directory.

Selenium 2.46.0 can be found here:
http://selenium-release.storage.googleapis.com/2.46/selenium-java-2.46.0.zip

Make sure that libs directory is under the uncompressed folder.



Next set the SELENIUM_HOME environment variable within Windows.

Download and Install SVG Viewer (Optional)

The asset needs to display SVG diagram through System Browser. If you are using IE8 then you need to download and install a plug-in as below.

http://www.adobe.com/devnet/svg/adobe-svg-viewer-download-area.html

Firefox Configuration

Create Firefox profile

The assets supports the browsers up to FireFox 40.0.3. You can download it from below address.

In order to use IBM Business Process Manager Testing Asset with an efficient and independent environment we recommend you to create a new Firefox profile and use this new profile in your project.

Add https exception on Firefox

Open the Business Process Manager Process Portal URL on Firefox then you will see the following page. Click Add Exception to store the exception permanently.

Internet Explorer Configuration

The asset supports the browsers up to IE 10.

If you are using Internet Explorer then download the selenium driver for Internet Explorer here:

http://selenium-release.storage.googleapis.com/2.46/IEDriverServer_Win32_2.46.0.zip

Unzip InternetExplorerDriver.exe to selenium folder.

Enable protected mode on Internet Explorer:

For Selenium IEDriver on IE 7 or higher on Windows Vista or Windows 7 you must set the Protected Mode settings for each zone to be the same value. The value can be on or off as long as it is the same for every zone.

To set the Protected Mode settings choose "Internet Options..." from the Tools menu and click on the Security tab. For each zone there will be a check box at the bottom of the tab labeled "Enable Protected Mode".

Security configuration on Internet Explorer:

If you don't change the IE security configuration the testing tool may not work normally.

Follow the instructions will help to solve the problem.

1.   Click "Tools" and "Internet Options" in the Internet Explorer window.
2.   Click the "Security" tab at the top of the "Internet Options" window.
3.   Select a zone for which to disable the security warning such as "Internet" by clicking its name.
4.   Edit the security settings by clicking the "Custom Level" button.
5.   Scroll down until you see "Display Mixed Content" under the "Miscellaneous" header in the "Settings" list.
6.   Click the "Enable" radio button under "Display Mixed Content." This is set to "Prompt" by default. "Enable" causes mixed content to be displayed with no security warning.
7.   Save your settings by clicking "OK" twice.

SSL Certification for HTTPS protocol

To make sure IBM Business Process Manager Testing Asset works properly additional settings with HTTPS certifications should be made so that you can use HTTPS protocol URL in IBM Business Process Manager Testing Asset.

Run the Install Asset.bat

Run the script <BPM_TEST_ASSET_HOME>\installation_scripts\Install Asset.bat and the profile will be created under %SELENIUM_HOME%\firefoxProfile directory automatically.

Note: You need run the script again whenever you upgrade Firefox.
 

Open the IBM Business Process Manager Testing Asset Designer

Open IBM Business Process Manager Testing Asset Designer by executing the following executable.

<BPM_TEST_ASSET_HOME>\eclipse.exe

The IBM Business Process Manger Testing Asset Designer should be open and you can start building testcases.