QualityCenterPlugin Reference

Aus ExpeccoWiki

Inhaltsverzeichnis 1 Quality Center Interface Plugin 1.1 Installation 1.2 Preparation 2 Operation & GUI 2.1 Connect & Login 2.2 Uploading a Test-Suite 2.3 Downloading a Test-Suite 2.4 Downloading an Attachment 2.5 Test Execution & Result Upload 3 Execution from the Quality Center GUI 4 Special Configuration Options 4.1 Autologout 4.2 Skip Checks for Extra Fields 5 QC Interfacing Library Blocks 5.1 Connection Setup / Release 5.2 Object Access 5.3 Field Access 5.4 Defect Access 5.5 Requirements Access 5.6 Test Access 5.7 Test-Set Access 5.8 Attachment Access 6 See also

Quality Center Interface Plugin

The Quality Center plugin allows for test-suites to be up- and downloaded to/from an HP-QC server, for tests to be define as QC-tests, for testplans to be up- and downloaded as test-sets and for results to be sent to QC as test-run. Test execution and test-run update can both be initiated by the operator at the expecco site, or alternatively, tests can be executed under control of the QC user interface or scheduler.

Installation

The plugin consists of two parts:

• the plugin-dll (installed in the plugins subfolder in the expecco installation folder)
• an expecco building-block library, providing access to the plugins functions. This library can be used for automation tasks or custimized interaction with the Quality Center service. The library is found in the libraries folder under the expecco installation folder.

Preparation

The QC plugin requires additional custom fields to be added to some of the QC objects (in the QC database). These fields are needed to define a link between a QC artefact (test, test-set or test-run) and the corresponding expecco object (activity, testplan or result). The additional fields will hold the expecco-ID (the UUID of the expecco object) and should not be changed manually.

Expecco will check for the presence of those fields and try to create them if absent. This check is automatically performed, whenever connecting to a QC server. You will need admin rights within QC, for this to work. If in doubt, ask your QC administrator and have him connect initially. This procedure needs to be done only once - after that, no special administrative rights are required, and the check can be disabled in the settings dialog to speedup the login procedure slightly.

Operation & GUI

Connect & Login

If the QC interface plugin is loaded (and not disabled), an additional menu item appears in the expecco main-menu. If you prefer to have this menu less exposed in the Plugins-menu instead, hide it by unchecking the "Show QC-Menu in Main-Menu" box in the Extras->Settings->Plugins->Quality Center Interface settings-dialog.

Please select the "Define QC Connection" item, to get the following login dialog:

Enter your account info, press "Authenticate" and choose an appropriate domain and project. Then close the dialog by clicking on "OK".

As long as you are connected, a little indicator is shown in the lower right of the expecco main window:

Uploading a Test-Suite

To upload a test-suite, choose the "Save TestSuite in QC" menu item, and fill out the dialog:

You can choose between two upload modes:

• basic suite-only upload
  Here, only the testSuite itself is uploaded. The upload saves the testSuite as an attachment of the selected QC-tree node. This basically uses QC as a repository for testSuite exchange and maintenance.

• individual test upload
  Here, a new folder is created whch contains QC-test items for the testSuite and for all testCases which have been marked as "Exported to QC".

Notice, that you can keep multiple versions of a test-suite side-by-side in the QC hierarchical tree structure. After uploading multiple versions of the "Data Generators" test-suite, the "subject"-tree looks like:

The newest released revision is shown in bold.

Downloading a Test-Suite

To download a suite, choose the "Load TestSuite from QC" menu item, and either select an explicit version's attachment, or click on the QC-test item. The later selects the newest version.

Downloading an Attachment

The "Load TestSuite from QC" dialog can also be used to load an individual attachment into the current project. To do this, open the dialog, navigate to the attachment, select it, and choose the popup-menus "Load as Attachment" menu item. The attachment will be generated in the top level of the project, and can be moved as required.

Test Execution & Result Upload

When uploading a test result, you have the choice of:

• a) uploading a result as a run for an existing test-set
• b) creating a test-set for an existing test and uploading a run for it
• c) creating both a new test-set and a new test and uploading a run for it

In the upload dialog (a), choose an existing test-set. For (b) and (c), select a destination directory, where the new test-set is to be created.

Execution from the Quality Center GUI

to be documented

Special Configuration Options

Autologout

If this option is enabled, the connection to QC is automatically released whenever you have not been using the quality center server for some time. In installations with floating licences, this releases licences and gives other users a chance to work with the server whenever you are not up- or downloading. To enable this option, enter a time duration (such as "5m") into the "Autologout Time Duration" field on the plugin's settings tab ("Main-menu" - "Settings" - "Plugins" - "Quality Center Interface").

Skip Checks for Extra Fields

Disables the check for the presence of the additional database fields (as described above) at startup time. This makes the connect process slightly faster. Once the QC database has been setup correctly, this option can be safely enabled.

QC Interfacing Library Blocks

In addition to the previously described menu interfaces, many functions for interaction with a QC system are also available as building blocks for automation tasks. This allows for artefacts such as defects, requirements, tests or runs to be created, fetched and updated from an expecco testSuite.

At the time of writing, the following blocks are available:

Connection Setup / Release

• QC [ Connect with Dialog ]
  Opens the connection dialog.
• QC [ Connect without Dialog]
  Connects to the QC server.
• QC [ Disconnect ]
  Disconnects from the QC server.

Object Access

• QC [ AllObjects ]
  Retrieves a collection of all objects from a factory object.

Field Access

• QC [ Fetch Field ]
  Fetch a single field's value from an Object (Bug, Requirement, Test, etc.)
• QC [ Change Field ]
  Change a single field's value in an Object (Bug, Requirement, Test, etc.)

• QC [ Get Name of Custom Field ]
  Retrieve the name of a user defined custom field

Defect Access

• QC [ BugFactory ]
  Retrieves the Bug-Factory object.
• QC [ AllBugs ]
  Retrieves a collection of all bugs (defects).
• QC [ Bug by ID ]
  Retrieves a single Bug.
• QC [ Bug Fetch Attributes ]
  Fetch common attributes from a Bug
• QC [ Bug Change Attributes ]
  Change common attributes in a Bug

Requirements Access

• QC [ RequirementFactory ]
  Retrieves the Requirement-Factory object.
• QC [ AllRequirements ]
  Retrieves a collection of all requirements.

Test Access

• QC [ TestFactory ]
  Retrieves the Test-Factory object.
• QC [ AllTests ]
  Retrieves a collection of all tests.

Test-Set Access

• QC [ TestSetFactory ]
  Retrieves the Test-Set-Factory object.
• QC [ AllTestSets ]
  Retrieves a collection of all test-sets.

Attachment Access

• QC [ Upload Attachment]
  To upload a file as attachment
• QC [ Download Attachment]
  Retrieves an attachment file

See also

• Synchronizing QC from JIRA - an example use for the QC building block library
• Expecco Plugin API Reference

 

---

Back to Online Documentation