Integrate with Bugzilla

The Bugzilla integration allows you to push features and requirements from Aha! Roadmaps to engineering teams working in Bugzilla. Before you create this integration it is worth thinking about how to integrate Aha! Roadmaps with your development tool.

This integration uses the REST API of Bugzilla version 5.0.

Configure this integration in Settings ⚙️ → Workspace. You need to be a workspace owner in Aha! Roadmaps to set it up.

Click any of the following links to skip ahead:

• Prerequisites

• Features of the integration

• Enabling the integration

• Test your integration

Prerequisites

Integration type	One-way (from Aha! Roadmaps to Bugzilla)
Aha! Roadmaps level	Workspace level
Required versions	Bugzilla REST API version 5.0
Required user permissions: Configuration	Workspace owner
Required user permissions: Use integration	Workspace owner Contributor
Associated record types	Features / Activities Requirements

Top

Features of the integration

• One Aha! Roadmaps workspace is associated with one product and component in Bugzilla.

• A feature or activity can be sent to Bugzilla using the Integrations dropdown on the Aha! Roadmaps feature or Aha! Roadmaps activity detail or drawer view.

• Requirements are sent to Bugzilla as bugs blocking the parent feature or activity.

• Only the name, description, and attachments of features / activities and requirements are sent. Any other fields that are marked as mandatory in Bugzilla will be automatically populated with the last option for the field.

• Bugs created from a requirement will block the bug created from the feature or activity.

Top

Enable the integration

In Bugzilla

To configure this integration, you need an API key from Bugzilla.

1. In Bugzilla, go to Preferences and then choose the API Keys tab.

2. Create a new API key or use an existing one. Be aware that the integration will only have the permissions of the user that created the API key.

In Aha! Roadmaps

1. Navigate to Settings ⚙️ → Workspace and click the + icon next to Integrations.

2. Select Bugzilla from the list of integration options.

3. Enter the URL of your Bugzilla installation.

4. Enter the API key you created in Bugzilla.

5. Click the Test connection button.

6. If successful, you should be able to choose a product and a component from Bugzilla.

7. Enable the integration and test it by going to one of your features or activities in Aha! Roadmaps and clicking Send to Bugzilla from the Integrations dropdown.

8. The feature or activity should appear as a bug in Bugzilla, and any requirements should appear as bugs that block the first bug.

Top

Test your integration

Congratulations! You're ready to test your new integration. To do this, send a feature to Bugzilla by following these steps:

1. Navigate to Features → Board.

2. Open one of your features in Aha! Roadmaps and use the Integrations dropdown and select Send to Bugzilla. You should see a link to the created Bugzilla record appear on the Aha! Roadmaps feature after a few seconds. This will let you easily click into Bugzilla to verify that everything was sent through correctly.

You can also bulk send a subset of features to Bugzilla.

Top