This add-on package tightly integrates Squish with any HP Quality Center™ 10 and HP Quality Center™ 11 server. This allows Squish test cases and test suites to be imported into and executed from within HP Quality Center™. All that's necessary to make this work is an extra software package provided by froglogic which installs a plugin into your HP Quality Center™ server, making it aware of how to invoke Squish.
![[Note]](images/note.png) | Separate Purchase |
|---|---|
This add-on must be bought separately. Contact
At the time of this writing, the add-on only supports HP Quality Center™ 10 and HP Quality Center™ 11—other HP Quality Center™ versions may or may not work. |
Here is a quick overview what you can do once HP Quality Center™ is integrated with Squish:
Create new Squish test suites and test cases in any of the scripting languages supported by Squish.
Edit the Squish test cases' test scripts.
Run Squish tests on any host known to the HP Quality Center™.
Run arbitrary commands before and after each test case is run.
Inspect the results of a test run without having to start the Squish IDE.
Inspect the results of any previous Squish test runs, since all test run results are recorded in the HP Quality Center™'s database.
Import a set of Squish test cases and test suites in one go using a command line tool.
We're including a step-by-step list of actions to take to install the plugin into HP Quality Center™ here. However, please note that these instructions might be slightly different in case you have a different HP Quality Center™ version. In case you hit problems, you can also refer to the official HP documentation by opening the Documentation Library from within HP Quality Center™, selecting the Custom Test Type Integration manual and then following the steps described in the Registering the Test Type chapter. The authoritative document on installing custom plugins is the one by HP.
![[Warning]](images/warning.png) | Temporary Shutdown |
|---|---|
During the installation of the HP Quality Center™ plugin, the HP Quality Center™ server will be shut down, and then restarted. This means that users won't be able to connect to HP Quality Center™ for the short time it takes to complete the installation. |
Note that the installation process only has to be done once, on the HP Quality Center™ server. The client desktops do not need anything done to them at all.
The following steps will use the placeholder <QCDIR>
to refer to the directory where HP Quality Center™ is installed. On Solaris, this is usually
/opt/qc, on Windows systems it's
something like C:\Program Files\HP\HP Quality
Center Starter Edition\QCStarter (for the HP Quality Center™ 10
Starter Edition).
Create a working copy of the
<QCDIR>\application\20qcbin.wardirectory into some temporary directory. For the following steps we will assume that the working copy is inC:\Temp\20qcbin.warCopy the following files into the
C:\Temp\20qcbin.war\Installdirectory:SquishTestType.lldSquishExecConfiguration.xcoSquishScriptEditor.xcoSquishResultViewer.xcosquishremoteagent.xxxMSCOMCTL.xcoQtCore4.lld
Copy the file
squishtest.cabinto theC:\Temp\20qcbin.war\CustomTestTypesdirectory. If this directory doesn't exist, create it.If the file
C:\Temp\20qcbin.war\custom_modules.cabexists, send it to<squish@froglogic.com>; this file must be modified, and it must be digitally signed afterwards. We will then send the modified file back to you. Otherwise, simply copy the filecustom_modules.cabwhich is shipped with the plugin intoC:\Temp\20qcbin.war.Shut down HP Quality Center™.
Rename the directory
<QCDIR>\application\20qcbin.warto<QCDIR>\application\20qcbin.war.bak.Copy the directory
C:\Temp\20qcbin.war(which contains the modified files) to<QCDIR>\application\20qcbin.war.Rename the directory
<QCDIR>\jboss\server\default\deploy\qcbin.warto<QCDIR>\jboss\server\default\deploy\qcbin.war.bak.Copy the directory
C:\Temp\20qcbin.warto<QCDIR>\jboss\server\default\deploy\qcbin.war.Directory Renaming Note that the target directory is renamed to qcbin.warnot20qcbin.warStart HP Quality Center™ again. The plugin is now installed in the server and only needs to be registered in the list of test types, and described in the next steps.
Log on to HP Quality Center™ and select Customize from the Tools menu.
Tools Customize MenuClick Project Entities to open the Project Entities window.
In the Project Entities list, expand the Test entity, expand the System Fields folder under it, and select Type.
Select TypeClick the Goto List button to open the Project Lists dialog box.
Click the New Item button, and type the name
SQUISH-TESTto add it to the list of test types.
Add Squish Test TypeClose the Project Lists dialog box, and click Save.
The following steps will use the placeholder <QCDIR>
to refer to the directory where HP Quality Center™ is installed. On Windows systems it's
something like C:\Program Files (x86)\HP\HP Application
Lifecycle Management Platform (for the HP Quality Center™ 11).
Create the directory
<QCDIR>\application\20qcbin.war\Extensionsif it doesn't exist yet.Copy the contents of the “Extensions” directory of the plugin ZIP file to
<QCDIR>\application\20qcbin.war\Extensions- after this step, the file<QCDIR>\application\20qcbin.war\Extensions\squishtesttype.cabshould exist as well as the<QCDIR>\application\20qcbin.war\Extensions\Squishdirectory.Create the directory
<QCDIR>\application\20qcbin.war\CustomTestTypesif it doesn't exist yet.Copy the file
squishtest.inifrom the plugin ZIP file to<QCDIR>\application\20qcbin.war\CustomTestTypesExecute the HP Server Deployment tool, either by selecting || in the Windows Start menu, or by executing the program
<QCDIR>\bin\run_server_deploy_tool.batAfter the deployment tool finished, log into the “Site Administrator” interface and select | from the menu.
A new SQUISH-TEST test type is now registered in HP Quality Center™.
To run Squish tests on a client desktop the HP Quality Center Connectivity tool has to be run once.
Login into “HP ALM - Quality Center 11”
Click |
Click HP Quality Center Connectivity
Click Download Add-in
| Screenshots |
|---|---|
| The following screenshots are taken from HP Quality Center™ 10 but also apply for HP Quality Center™ 11 which has a different style. |
After the plugin has been installed and registered, you will need to setup the initial configuration. You might also want to adjust and augment the configuration later on. How this is accomplished will be discussed in this section.
The configuration of the Squish integration plugin consists of two settings keys which are stored in the “Site Configuration” of your HP Quality Center™ server.
| Setting | Description |
|---|---|
| SQUISH_SCRIPTING_LANGUAGE | Indicates the scripting language to be used when creating new Squish test cases within the HP Quality Center™. Can be “Python”, “Tcl” or “JavaScript”. |
| SQUISH_PATHS | This string in the format
You can also use An example entry which describes that on the host
“TREBULUS” Squish is installed in
|
You need to configure these entries before being able to execute Squish runs in the Site Configuration. In case they don't exist yet, you might have to add them. To do so, open the Site Administrator interface of HP Quality Center™, then click on the Site Configuration tab at the top of the screen to move to the site configuration screen. Here you can add and edit any keys.
Creating new Squish test cases within the HP Quality Center™ works virtually the same as creating any other kind of test. In the Test Plan module, create a new test folder called “froglogic Squish Tests”. In this folder, you can then create as many test folders as you want. (We recommend that each test suite folder name begins with the prefix “suite_”, since this is what the Squish IDE expects.)
Here's a quick rundown on how to create a new Squish test in HP Quality Center™.
Log into the HP Quality Center™ project to which you want to add a test.
Click on the button labelled Test Plan at the left side of the screen to move to the Test Plan module.
In the tree view of the Test Plan module screen, open the froglogic Squish Tests folder. If it doesn't exist yet, create it using the New Folder button above the tree view.
Right-click on the froglogic Squish Tests folder item to open the context menu. In the context menu, select New Test....
In the dialog that shows up, select “SQUISH-TEST” from the combo box to indicate that you want to create a Squish test. Choose any name for the test you want, then press OK.
- In the Required Test Fields that now shows up, select any values which are appropriate for your organizational testing discipline. For this sample, choose any values you want (you can always change them later on), then press OK.
Congratulations, you just created a Squish test!
Since Squish tests always have at least one test script attached to them, you could now switch to the Test Script tab of the newly created test case to see the simple (mostly empty) test script.
| Screenshots |
|---|---|
| The following screenshots are taken from HP Quality Center™ 10 but also apply for HP Quality Center™ 11 which has a different style. |
Executing this Squish test works like executing any other test which is stored in a HP Quality Center™ server: move to the Test Lab module by clicking on Test Lab on the left side of the screen, then drag the tests you want to execute into the exeuction grid. When you have assembled all the tests for a test run, press the Run button to run the them.
| squishserver Must be Running |
|---|---|
Before running any tests the squishserver must be running. You could start the squishserver before using HP Quality Center™ and then stop it once you have finished creating and running your tests. |
Executing a Squish test within HP Quality Center™ will cause the integration plugin to invoke squishrunner, much like the Squish IDE does internally. You might want to pass special arguments to squishrunner when executing the test though (for instance, you probably want to specify any additional wrapper libraries you want to use, and you will want to specify an application which to test).
You can also specify arbitrary commands to be executed before and/or after squishrunner is invoked. (See squishrunner (Section 16.4.1) for full details of squishrunner's command line options.)
To configure a Squish test run, right-click on the test in the test execution grid of the Test Lab, then select Test Instance Properties... in the context menu to open the dialog which presents all kinds of execution parameters. The Squish-specific settings are accessible by clicking on Configuration on the left side of the dialog, then clicking on the Automated tab.
| Quota Control |
|---|---|
If an HP Quality Center™ test run produces a “Server throws an exception” error, one possible cause is that the plugin has hit a quota limit when connecting to the HP Quality Center™ server. (Even a single user on a single machine will need at least two connections—one from the client to the server, and another between the plugin and the server.) To try to solve this problem, go to the HP Quality Center™'s Site Administration, select and open the Project User Quota dialog. Inside the dialog check the radio button, then click . Now try running the test again. If the problem has been solved you may wish to return to the Project User Quota dialog and experiment with a specific number of connections; or you can just leave it unlimited. (For more information on this topic see the Quality Center Admin Guide.)  User Quota |
The HP Quality Center™ integration also features a Windows command line tool called
qcimporter.exe which can be used to import a batch of
Squish test cases into HP Quality Center™ at once. For each imported test case, the name
of the test (as it is stored in HP Quality Center™) as well as its ID number will be
printed (e.g. in order to allow further operations on the test using the
OTA API).
The qcimporter.exe utility also requires that the
HP Quality Center Connectivity tool has been run once. See
Installation for HP Quality Center™ 11 (Section 18.7.2.3) for the installations
steps.
There are two ways to invoke the qcimporter.exe program:
qcimporter {--testsuite <directory>} [--field <fieldname>=<value>...] [--attachment <filename>] {--server <hostname>} {--domain <name>} {--project <name>} {--user <name>} [--password <string>] [--path <path>]
This invocation, using the --testsuite switch, can be used to
implement a complete Squish test suite to HP Quality Center™ in one go. This includes all
test cases as well as shared scripts.
qcimporter {--testcase <directory>} [--objectmap <filename>] [--field <fieldname>=<value>...] [--attachment <filename>...] {--server <hostname>} {--domain <name>} {--project <name>} {--user <name>} [--password <string>] [--path <path>]
This way of running the utility will upload just a single test case to HP Quality Center™.
This allows you to attach different files to individual test cases, set custom
fields on a single test case and it will print output in the form
<testcasename>=<ID>.
on the command shell.
The exact meaning of the individual arguments mentioned in the above synopses is as follows:
--testsuite <directory>Indicates that a complete Squish test suite should be imported into HP Quality Center™. Takes the name of the directory in which the test suite is stored, e.g.
C:\Squish\suite_mysuite. Either this switch or the--testcaseargument must be given.--testcase <directory>Indicates that a single Squish test case should be imported into HP Quality Center™. Takes the name of the directory in which the test case is stored, e.g.
C:\Squish\suite_mysuite\tst_login. Either this switch or the--testsuiteargument must be given.--objectmap <filename>Allows attaching an object map file to a test case. The name of the object map file is expected as an argument to this switch, e.g.
C:\suite_mysuite\objects.map. This switch is only valid if--testcaseis used.--field <name>=<value>This switch can be used to set custom fields of the test cases being created in HP Quality Center™. See the Examples (Section 18.7.5.4) for examples of how to use this switch.
--attachment <filename>Allows attaching arbitrary files to the test cases being uploaded.
--server <hostname>This argument specifies the host at which HP Quality Center™ is running. The
qcimporter.exeutility will assume that the server is running on port 8080 (the default).--domain <name>Specifies the domain of the project into which the test cases should be uploaded.
--project <name>Specifies the name of the project in which the test cases should be created.
--user <name>Defines the name of the user as which the utility should log into HP Quality Center™.
--password <string>Defines the password to be used when logging into HP Quality Center™. You may omit this argument in case the password is empty.
--path <path>Allows specifying the folder in the subject tree of the HP Quality Center™ test plan within which the test cases should be created. If this argument is omitted, a folder called
froglogic Squish Testswill be created at the root of the subject tree.In case the
--testsuiteswitch was given, a folder with the name of the test suite (e.g.suite_mysuitewill be created below the given path).The <path> is a list of folder names separated by forward slashes. See the Examples (Section 18.7.5.4) for a sample path.
Here are various sample invocations of the
qcimporter.exe utility, showcasing the aforementioned
switches.
Importing a complete test suite to the Quality Center server running on the host
einstein:qcimporter --testsuite C:\Squish\suite_mysuite --server einstein --domain AcmeDomain --project SampleProject --user alex --password xyzzy
Importing a single test case, and attaching two files to it:
qcimporter --testcase C:\Suites\suite_office\tst_login --server einstein --domain AcmeDomain --project SampleProject --user bob --password frog --attachment C:\firstattachment.txt --attachment C:\anotherattachment.ini
Importing a single test case and setting the custom
TS_DESCRIPTIONfield:qcimporter --testcase S:\suite_webapp\tst_adduser --server pc0124 --domain Web --project WebSale --user alice --password al1ce --field "TS_DESCRIPTION=This is the description"
Importing a single test case into a custom location in the subject tree, using the
--pathswitch:qcimporter --testcase C:\Suites\suite_office\tst_login --server einstein --domain AcmeDomain --project SampleProject --user bob --password frog --path "Our Suites/Business/New Test Cases"
This will put the test
tst_logininto the folder New Test Cases, which is stored in the folder Business, which in turn is stored in the folder Our Suites.