Bitbucket integration Zoho Sprints

Bitbucket integration




Track your code changes, manage your repositories, add commits, and pull requests from the work item details page in Zoho Sprints using the Bitbucket integration.  
Availability:  Premium and Enterprise plan 
Region:  This feature is not available in the CN region. 
Access control:   Team Owner 

Authorize Bitbucket account     

  1. Navigate to    in the upper-right corner. 
  2. Select Bitbucket
  3. Click  Authorize
Zoho Sprints adheres to privacy and transparency of your data. So, we receive a consent from you before you start the integration process.  
Personal Repository 

Personal repository lists all the repositories with admin access in Bitbucket.

Team Repository  

Team repository lists all the repositories that are mapped from your personal repository. Once mapped, these repositories can be associated to the projects. Once associated, team members can add or attach commit and pull requests to a work item using quick commands or from the work item details page.

Map personal repositories to team repository 

  1. Navigate to   in the upper-right corner. 
  2. Select Bitbucket
  3. View the list of repositories in your  Personal Repository .   
  4. Hover over the repository name.  
  5. Click the map icon next to the repository name to map the repository to your team.  
 

Associate projects to team repository    


You can associate a project to your team repository.   
  1. Navigate to   in the upper-right corner. 
  2. Select Bitbucket
  3. View the list of repositories in your Team Repository
  4. Click  + next to the repository. 
  5. Select the projects and click  Update
You can associate only 50 projects to a team 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. Navigate to   Settings  in the upper-right corner.
  2. Select   Bitbucket .
  3. Configure your account.
  4. Map repositories to Zoho Sprints portal.
  5. Enable   Sync  Only  Bugs   to the right corner of your project name.
  6. Click   Associate

You can 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
Note:
  1. Only the repositories with "Sync Only Bugs" enabled will be listed in the Create Item window.

  2. Status of the work items will be mapped to the open and closed status in Bitbucket. 

Quick Commands in Zoho Sprints    


Once you are done with mapping of repositories and associating projects to the repositories, you are all set to start attaching commits and pull requests. Here are the supported commands.  
Work item tagging is supported only through the pull request "Description" field.

Format 
Syntax 
Purpose 
#workitem  
#<Project Prefix>- <i/I><Item number> 
Example:  #SP-i30 
Represents the work item ID. 
#comment 
#workitemid #comment <message1> #comment <message2> 
Example:  #SP-I15 #comment Please share the final build by EOD. #comment Fix the existing issues and update the local build. 
Note: 
You can add multiple comments to a single work item. 
Add comment for the work item. 
#status 
#workitemid #status <status_name> 
Example 1:  #SP-i20 #status Done 
Example 2:  #SP-i20 #status To_be_Tested 
Note: 
1. If the status name carries multiple words, separate them with an underscore. 
2. Statuses are not case sensitive. 
Update the status of the work item. 
#priority 
#workitemid #priority <priority_name> 
Example 1:  #SP-i40 #priority Critical 
Example 2: #SP-i42 #priority Should_be 
Note: 
1. If the priority name carries multiple words, separate them with an underscore. 
2. Priorities are not case sensitive. 
Update the priority of the work item. 
#time 
#workitemid #time <hours>h <minutes>m 
Example:  #SP-I52 #time 5h 30m 
Add log hours for the work item. 
   
  • 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     


Single command for multiple work items

Syntax 
#workitemid,#workitemid,#workitemid #comment <message>   
Example 
#SM-I25,#SM-I42,#SM-I98 #comment Issues are resolved and updated in the local build. 
What happens? 
All the three work items are added with the comment.  

Multiple commands for single work item

Syntax 
#workitemid #comment <message> #priority <priority_name> #time < > h < > m #status <status_name> 
Example 
#SM-I34 #comment List out the requirements #priority High #time 5h 3m #status In_progress 
What happens? 
The work item is added with comment and log hours. It is also updated with status and priority. 

Multiple commands for multiple work items

Syntax 
#workitemid,#workitemid,#workitemid #comment <message> #priority <priority_name> #time <>h <>m  #status <status_name> 
Example 
#SM-I34, #SM-I45, #SM-I54 #comment List out the requirements #priority High #time 5h 3m #status In_progress 
What happens? 
All the three work items are added with comments, log hours and updated with status and priority.  


Attach commits from work item details section 

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

Attach pull requests from work item details section 

  1. Navigate to work item details page.  
  2. Select  Bitbucket from the tabs. 
  3. Click  Attach Pull  Request
  4. Select the required field.  * 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. 

How to copy the work item ID?  
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.  
Adding Log hours 
  • 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.  
Disassociate projects from repository  

You can also disassociate projects from the repository in two different ways. 

From the associate project form 
  1. Navigate to   in the upper-right corner. 
  2. Select  Bitbucket
  3. Select  in the right corner of the mapped repository in your  Team  Repository.    
  4. Deselect the projects in the  Associate Projects  form. 
  5. Click  Update .  
Directly from the Team Repository 
  1. Navigate to   in the upper-right corner. 
  2. Select  Bitbucket
  3. Click on the count next to the team repository. 
  4. Hover over the project that you want to dissociate. 
  5. Click  Remove Project .  

Remove repositories from team 

  1. Navigate to   in the upper-right corner. 
  2. Select  Bitbucket
  3. View the list of repositories in your Team  Repository
  4. Hover over the repository name.  
  5. Click the unmap icon to the left end of the repository name to unmap the repository from the team.  
What happens when the repository is removed from the team? 
  
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 


You can remove the Bitbucket account anytime from Zoho Sprints. To do this: 
  1. Navigate to   in the upper-right corner. 
  2. Select  Bitbucket
  3. Click     at the bottom-right corner of your personal repository.  
  4. Click  Yes, delete
What happens when the authorization is removed?   

Once the repository is mapped to Team 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 team or personal repository.     

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Get started with Zoho Sign

            in a few quick steps!

            Download Help Guide





                        Still can't find what you're looking for?

                        Write to us:  support@zohoforms.com


                              




                            

                          Zoho Marketing Automation

                            Zoho Sheet Resources

                             




                                Zoho Forms Resources


                                  Secure your business
                                  communication with Zoho Mail


                                  Mail on the move with
                                  Zoho Mail mobile application

                                    Stay on top of your schedule
                                    at all times


                                    Carry your calendar with you
                                    Anytime, anywhere




                                          Zoho Sign Resources

                                            Sign, Paperless!

                                            Sign and send business documents on the go!

                                            Get Started Now


                                                Zoho SalesIQ Resources



                                                    Zoho TeamInbox Resources



                                                            Zoho DataPrep Resources



                                                              Zoho DataPrep Demo

                                                              Get a personalized demo or POC

                                                              REGISTER NOW


                                                                Design. Discuss. Deliver.

                                                                Create visually engaging stories with Zoho Show.

                                                                Get Started Now











                                                                                      • Related Articles

                                                                                      • GitHub integration

                                                                                        Track your code changes and improve and revise them using the developer-friendly platform: GitHub. Integrate your Zoho Sprints team with GitHub and manage repositories.   Availability: Starter, Elite and  Premier Region: This feature is not available ...
                                                                                      • GitLab integration

                                                                                        Manage your GitLab repositories in Zoho Sprints. Map the repositories to relevant projects, attach commits, and pull requests in the work item details page.  Availability: Starter, Elite and  Premier plans    Region:  This feature is not available in ...
                                                                                      • AWS CodeCommit Integration

                                                                                        Manage your AWS CodeCommit repositories in Zoho Sprints. Map the repositories to relevant Zoho Sprints projects, attach commits, and pull requests from the work item details page.   Availability: Starter, Elite and Premier plans    Region :  This ...
                                                                                      • Zoho Projects Integration

                                                                                        No matter how many projects you have on your list or teams to coordinate - Managing everything in the right way matters the most. Project management methodologies are many, and every team is bound to follow a standard process. That's why moving to a ...
                                                                                      • Google apps integration

                                                                                        Integrate your Zoho Sprints team to your Google apps. Add your daily work items to your Google Task and Calendar to keep things on track. Get your scrum meetings scheduled to your Google Calendar and never miss any meet ups. Access Privileges: Team ...
                                                                                      Wherever you are is as good as
                                                                                      your workplace

                                                                                        Resources

                                                                                        Videos

                                                                                        Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                        eBooks

                                                                                        Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                        Webinars

                                                                                        Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                        CRM Tips

                                                                                        Make the most of Zoho CRM with these useful tips.



                                                                                          Zoho Show Resources