Integrating with Basecamp Classic
Beanstalk can integrate with your Basecamp Classic account, providing clean notification posts for each commit to your team in your Basecamp projects. In addition to posting messages, Beanstalk can also post time sheets for a project when you include tags in the commit message.
What it looks like…
When Beanstalk and Basecamp Classic are integrated, each commit to your repository will result in a post to Basecamp Classic. This post will show who made the commit, the revision, commit message, and affected files. Beanstalk will also insert a link to redirect back to the changeset in Beanstalk. Here is what the post would look like in Basecamp Classic:
If time tags are included in your commit message, time sheets are posted in Basecamp Classic too. Here is what the time tracking would look like in Basecamp Classic:
Please note that in order to post time sheets, time tracking feature needs to be enabled in your Basecamp Classic account.
To setup Basecamp Classic integration, follow the steps below.
How to setup integration
Before you get started, make sure you enable API access in your Basecamp Classic account. This can be found at the bottom of the Account (Upgrade/Invoices) section in your Basecamp Classic account.
In order to integrate Basecamp Classic with Beanstalk, you need to enable Basecamp Classic integration within your repository. To do this, go to your Repository, then Setup → Integration → Basecamp Classic. To get started with the setup, click on Basecamp Classic icon, and then on Activate integration button inside the page.
Define Account Information
In the first step, you should define your Basecamp Classic account information and API key. Your API key can be found in the My Info section (look in the top right in Basecamp Classic).
Fill in the Account Url of your Basecamp Classic account, and Api Token which you have copied from your Basecamp Classic account.
Choose Project
Next, you can choose the project where Beanstalk will post notifications. It’s best to associate each repository with the corresponding project in Basecamp Classic.
Setup messaging and time tracking
On this step you can select whether you want:
- to post messages to Basecamp Classic and choose message category
- to post time sheets to track time
- to post messages to Basecamp Classic and choose message category and post time sheets to track time
Only the options you select will work in Basecamp Classic. So if you selected only messaging, time sheets will not go to Basecamp Classic and vice versa.
Assign users
If you selected time tracking on the previous step, you have one more additional step for setting up Basecamp Classic integration. On this step you can choose the Beanstalk users that you want to track time for, and corresponding users from Basecamp Classic. Only the matched users will have time tracking enabled, so if you add users in the future make sure to update the settings.
Activate and Save Changes
Finally, once you have confirmed everything, you can activate the changes.
How to use the integration
To test and make sure everything works, commit something to your repository. You should see the new commit notification in your Basecamp Classic project. It may take a minute or so to post.
To post time sheets for a project, include tags in the commit message. For example:
Fixed logo positioning in IE6 [time:2.00]
A list of the supported Time tags you can use in your commit messages can be found here.
Please note that you can't use empty commit messages to post to Basecamp Classic.