Aha! Roadmaps | Integrate with FogBugz

This integration allows you to push your features, activities and requirements in Aha! Roadmaps into FogBugz and get status changes back. Because this is a two-way integration, your strategy can flow from Aha! Roadmaps to your development team in FogBugz, and receive status updates back as they complete the work.

You can also create multiple integrations per workspace to accommodate how the engineering team is split up. If you do this, make sure you give each integration a unique name to keep the teams straight.

Click any of the following links to skip ahead:

• Prerequisites

• Features of the integration

  • From Aha! Roadmaps to FogBugz

  • From FogBugz to Aha! Roadmaps

• Configuration

  • In Aha! Roadmaps

  • In FogBugz

• Troubleshooting

Prerequisites

Top

Features of the integration

Aha! Roadmaps features and activities map to Fogbugz issues, and Aha! Roadmaps requirements map to Fogbugz sub-cases.

From Aha! Roadmaps to FogBugz

When Aha! Roadmaps sends a feature or activity to FogBugz, it sends the following fields: name, description, requirements, attachments, and tags.

• One Aha! Roadmaps workspace is associated with one or more FogBugz projects.

• Individual features can be sent to FogBugz using the Integrations dropdown on the Aha! Roadmaps feature details or drawer view.

• All features in a release that have not already been implemented or sent to FogBugz previously can be sent to FogBugz using the Send to FogBugz option in the Integrations dropdown on the release page.

• When a feature is copied to FogBugz, one issue will be created for the feature.

• Only the description of a feature is sent and its requirements are created as sub-cases. No tasks or comments are included.

• Attachments of a feature and requirements are also sent.

• Tags on a feature in Aha! Roadmaps will become tags in FogBugz.

• After a feature is first sent to FogBugz, changes to the name, description, and tags can also be sent to FogBugz using the Update FogBugz option from the More options menu. Find this next to the link to the FogBugz record on the features page. If an attachment is deleted on the Aha! Roadmaps side, the corresponding attachment in FogBugz is not deleted.

From FogBugz to Aha! Roadmaps

Changes in the status of a story in FogBugz will be reflected in Aha! Roadmaps. This allows you to track which stories have been completed.

Top

Configuration

You will need an API token to use the FogBugz integration.

In Aha! Roadmaps

1. In Aha! Roadmaps, navigate to the workspace you wish to integrate.

2. Under Settings ⚙️ Workspace, click the + icon next to Integrations, then click on FogBugz.

3. Enter your FogBugz URL and API token. Click the Test connection button.

4. After a short delay, you will be able to choose which projects the cases will be created in.

5. Enable the integration.

6. Test the integration by going to one of your features or activities in Aha! Roadmaps and selecting the Send to FogBugz option in the Integrations dropdown on the feature's or activity's detail or drawer view. You should then look at your FogBugz project and see that the feature or activity was properly copied to a case.

In FogBugz

1. Copy the Hook URL from the integrations page in Aha! Roadmaps.

2. In FogBugz, open the settings and select Webhooks.

3. Create a new trigger and select Case Events.

4. Paste in the Hook URL and append "?case_number={CaseNumber}"

5. Select Post.

6. Name your trigger "Aha! Roadmaps" and create it.

Top

Troubleshooting

To help you troubleshoot an error, we provide detailed integration logs below the integration's configuration page.

Note: All activity waits 5 minutes before posting to FogBugz. This is to keep communication concise and avoid excessive messaging when a user is performing multiple edits at once.

Top