Using the Bitbucket extension

Attach your pull requests directly to tasks and see the review results with our Bitbucket extension.

How to add Bitbucket to a space

Open the space in the Workast web app where you'd like to add pull requests. (You will need to add the bitbucket app to each space individually).

In the top right of your space click on the plus button or arrow, if you have more than three apps, to open the app menu.

bitbucket

Click on "Manage extensions".

bitbucket 1

This will open the extensions dialogue for the space. You'll find the apps that are not added to your current space under the "Add new extensions" heading. Find "Bitbucket" then click "Add" to add it to the space.  

bitbucket 2

Authorizing Bitbucket

The first time you use Bitbucket in Workast, you'll need to log in to your account and authorize the app.

Click on the apps menu in the upper right-hand corner of your space. Select "Bitbucket".

bitbucket 3

If you see the Bitbucket icon in the top of your space, you can click that instead.

bitbucket 4

A dialogue will open. Click "Connect Bitbucket".

bitbucket 5

Next, the login screen will open. Log in to your Bitbucket account. 

bitbucket 6

A permission dialogue will open next. Click "Grant access" to confirm. 

You will then be able to connect a repository to your space. 

How to connect a repository

In order to attach a pull request to a task, you must first connect the repository to your team.

Click on the apps menu in the upper right-hand corner of your space. Select "Bitbucket". If you see the Bitbucket icon in the top of your space, you can click that instead.

A dialogue will open. Select "Connect a repository" then "Connect repository".

bitbucket 8
bitbucket 9

You'll then be directed to a new screen which will allow you to search your repositories.

bitbucket 10

Search for the repository that you wish to connect by entering its name into the search field. Click on it when it appears in the search results.

bitbucket 11

Once you connect a repository, it will be available in the initial "Connect a repository" dialogue in all spaces where the Bitbucket integration has been added.

bitbucket 12

How to disconnect a repository

Click on the the apps menu (arrow in the upper right-hand corner of your space). Select "Bitbucket".

Click on the repository that you want to disconnect.

bitbucket 13

Click "Yes" to confirm.

bitbucket 14

How to add a Bitbucket pull request to a task

In the Workast web app, open the task details screen by clicking on your task.

Click on the ellipses (three dots - the task menu) in the task header and select "Attach Pull Request".

CleanShot 2022-09-08 at 11.43.19

A dialogue will open with a list of your connected repositories. Choose the repository by clicking on it. (If you only have one connected repository, this step may be bypassed).

bitbucket 16

Once you select a repository, you'll be presented with a list of all the available pull requests. Only open pull requests will be listed.

bitbucket 17

Click on your pull request to attach it to the task.

bitbucket 18

Quick note - if you click on a repository with no pull requests, you'll need to use close the dialogue by clicking on the X.

Seeing the pull request results in your task

When a pull request is merged, the merge will be confirmed in your task:

bitbucket 19

When a pull request is declined, it will also be confirmed in your task:

bitbucket 20

Was this article helpful?
/

Related articles