Serenity and HP ALM Integration Guide¶

Software teams often use Serenity to write automated acceptance tests and produce cool reports. Sometimes they also want to see results of acceptance tests in HP ALM and this can be easily done with Bumblebee.

Prerequisites¶

One of the popular CI server like Jenkins, Atlassian Bamboo or TeamCity with corresponding Bumblebee plugin/add-on installed
Bumblebee Server must be installed and be accessible via HTTP from the machine where CI server/agent runs.

Generate Serenity report in JSON format¶

Bumblebee works best with Serenity report in JSON format because it contains information about test steps and can also contain embedded screenshots. This report is generated by default when using Serenity with JUnit

Setting up CI job to send results to HP ALM¶

Check CI corresponding pages for your CI system for initial Bumblebee configuration:

In all following examples Jenkins CI and Maven build tool will be used, but it's more or less the same for other CI systems.

Building Maven project in Jenkins¶

Assuming you have a Maven project with Serenity test which are run with JUnit framework, all we need to build it in Jenkins is add "Invoke top-level Maven targets" build step with clean test goals:

Adding new Bumblebee HP ALM Uploader post build action¶

To send generated serenity reports to HP ALM Reports, a "Bumblebee HP ALM Uploader" post build action should be added:

Note

Note, that "Format" field must have serenity value and "Result File Pattern" must have path to a JSON report defined in Serenity test class.

Execution and results¶

During Jenkins build Bumblebee prints information about progress into Jenkins console output:

Results in HP ALM TestPlan¶

Automatic folder structure creation

Folder structure is being automatically created by Bumblebee during exporting results, so there is no need to create it upfront