Access control: Team Owner 

Authorize Bitbucket account     

1. Click the gear icon in the top-right corner. The settings window will appear.
   
2. Select Others under Marketplace. 
   
3. Click Configure in the Bitbucket app.
   
4. Click Authorize. 
   

Map your repositories to workspace repository 

1. Click the gear icon in the top-right cornerMarketplace > Others in the upper-right corner. 
2. Select Bitbucket. 
   
3. View the list of repositories in your My Repository.   
   
4. Hover over the repository name.  
   
5. Click the arrow icon next to the repository name to map the repository to your workspace.  
   

Associate projects to workspace repository    

1. Click the gear icon in the top-right corner. The settings window will appear.
   
2. Select Others under Marketplace.
   
3. Select Bitbucket. 
   
4. View the list of repositories in your Workspace Repository. 
   
5. Click the Associate Projects button. 
   
6. Select the projects and click Update. 
   

You can associate only 50 projects to a workspace repository.  

Sync repository issues to projects

While mapping your projects to the repository, you can mark it as an  'Issue Project'. This will automatically sync all the upcoming issues that are added in your repository. You can have an exclusive project for issues and work upon them using sprints. 

1. Select Bitbucket.
   
2. Go to Workspace Repositories.
   
3. Select the project.
   
4. Click the toggle switch to enable Sync Only Bugs.
5. Click Update. 
   

1. You can access the issue details in the work item details page.
   
2. You can also access the link to Bitbucket directly from the work item details page. 
   

Note:  You can associate multiple projects to your repository. But, you can mark only one project to 'Sync Only Bugs'. 

 

Fields Synced from Bitbucket

Title, Description, Comments, and Priority

Note

1. Priority will be mapped based on the name. 
   

1. Since we sync only the bugs to the marked project, all the work items are created in default work item type 'BUG'. 
   

1. Status of the work items will be mapped to the defined status in Bitbucket. Mapping will not happen if the status does not match in both the applications.
   

Sync work items to Bitbucket

You will be able to simultaneously create data in Bitbucket while creating a work item in Sprints. The item creation screen includes the ability to add that particular work item to your Bitbucket account. The data is thus synced and the interaction is facilitated from and to Sprints. 

Fields Synced from Sprints

Title and Description

Quick Commands in Zoho Sprints    

Work item tagging is supported only through the pull request "Description" field.

• The email address of the Bitbucket user should be registered with the Zoho Sprints team only then they can process the commits: #comment, #time, #status, and #priority.  
  

Advanced commands 

Attach commits from work item details section 

1. Go to the work item details page.  
   
2. Select Bitbucket from the tabs. 
   
3. Click Attach Commit. 
   
4. Enter the required details. * All the fields are mandatory.  
   
5. Click Attach. 
   

  

Attach pull requests from work item details section 

1. Go to the work item details page.  
   
2. Select Bitbucket from the tabs. 
   
3. Click Attach Pull Request. 
   
4. Enter the required details.  * All the fields are mandatory.  
   
5. Click Attach. 
   

  

When you attach a commit via Bitbucket or from the work item details page, we trigger a feed message and notification to the work item assignees. 

It becomes daunting when you specify the project prefix and ID manually. You can just copy the work item ID from the work item details page and paste it in your commit messages and pull request comment. 

Delete commits and pull request 

You can delete the commit and pull request directly from the work item details page. Hover over the attached commit and pull request and click   . 

Access for commands  

Adding comments  

• You must be an active user in the project to tag comments to work items in your commits. 
  
• Anyone can add comments to the work items in the backlog.   
  
• You must be a part of the sprint and have the work item assigned to you before you can add comments to it.  
  
• You can also add comments for unassigned work items.  
  

• You must be an active user in the project to add log hours to the work items. 
  
• You can log hours for the work items only in active sprint.  
  
• You must be a part of the sprint.  
  
• You can only add log hours for unassigned work items and the work items that are assigned to you. 
  

Updating priority 

• You must be an active user in the project to update the priority of the work items.
  
• You should be the admin, joint admin, or project manager to update the priority of the work items.      
  
• The priority name that you provide must be an existing priority in the project. 
  
• You can update the priority of the work items only for the active and upcoming sprints and the work items in the backlog. 
  
• You cannot update the priority of the work items if they are in the closed status.   
  

Updating status 

• You must be an active user in the project to update the status of the work items.  
  
• You can be a sprint owner, assignee, admin, manager, or sprint creator to update the status of the work items.  
  
• The status name that you mention must be an existing status in the project. 
  
• You can update the status of the work items only in active sprints.  
  

1. Go to Bitbucket. 
2. Select  Associate Project button in your Workspace Repository.    
   
3. Deselect the projects in the Associate Projects form. 
   
4. Click Update.  
   

1. Go to Bitbucket. 
2. Click the associated project count in the workspace repository. 
   
3. Hover over the project that you want to dissociate. 
   
4. Click Remove Project.  
   

Remove repositories from team 

1. Go to Bitbucket. 
2. View the list of repositories in your Workspace Repository. 
   
3. Hover over the repository name.  
   
4. Click the arrow icon to the left end of the repository name to unmap the repository from the workspace.  
   

What happens when the repository is removed from the workspace? 

  

You can no longer attach commits and pull requests to the work items either via Bitbucket or directly from the work item details page.   

Remove Bitbucket authorization 

1. Go to Bitbucket. 
2. Click    at the bottom of My Repository. A confirmation pop-up will appear.
   
3. Click Delete. 
   

What happens when the authorization is removed?   

Once the repository is mapped to Workspace Repository, a webhook or subscription is created between both the applications. When the authorization is removed, the integration between both the application is stopped and all the mapped repositories and its associated projects will be removed.   

However, the webhook or subscription will not be deleted. If you want to delete the webhook or subscription created when the authorization was invoked, go to your Bitbucket settings and disable the webhook created for the respective workspace or my repository.