AWS CodeCommit integration | Zoho Sprints Help

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.

Notes
Access control :  Workspace Owner

Prerequisite:

  The following AWS Identity and Access Management (IAM) permissions are required to successfully configure this integration.

 

Features

Permissions

Show repositories and manage repository triggers

codecommit:ListRepositories

codecommit:GetRepository codecommit:GetRepositoryTriggers

codecommit:PutRepositoryTriggers

Process quick commands, show commits and pull requests

codecommit:BatchGetCommits
codecommit:GetCommit

codecommit:GetPullRequest

sns:CreateTopic

sns:Subscribe

sns:Unsubscribe

sns:DeleteTopic

iam:GetUser

Authorize AWS account                     

  1. Click the gear icon in the top-right corner.  The settings window will appear.

  2. Click Others under Marketplace.

  3. Click Configure under AWS Code Commit .

  4. Click Authorize.

  5. Select your AWS Region.

  6. Enter the AWS security credentials and click Authorize .


  Map My Repositories to Workspace     

  1. Click the gear icon in the top-right corner.  The settings window will appear.  

  2. Click Others under Marketplace.  

  3. Click AWS Code Commit .

  4. Hover over the repository name.   

  5. Click the arrow icon next to the repository name to map the repository to your Zoho Sprints workspace.

 

Once authorized successfully, the user can view all the repositories under the My Repository section.

Associate projects to workspace repository         

You can associate a project to your workspace repository.    
  1. Go to Workspace Repository .    
  2. Click the Associate Projects button.  
  3. Select the projects.
  4. Click Update.   

   

All the commits and pull requests of AWS CodeCommit can be viewed/managed by clicking the link in the attached commits and pull requests in the work item details page.

Quick Commands in Zoho Sprints        

Once you've finished mapping repositories and associating projects with them, you're ready to start attaching commits. The commands that are supported are listed below.  
 

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.  

    

Only users whose email address is registered with the Zoho Sprints team can process commits: #comment, #time, #s tatus, 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 in work item details  

  1. Go to the work item details page.   
  2. Select AWS CodeCommit from the tabs.  
  3. Click  Attach Commit.  
  4. Select a repository which is mapped with this project.
  5. Select the commit that needs to be attached to this work item.
  6. Select the commit details and click Attach.

  

 

Attach pull requests from work item details  

  1. Go to the work item details page.   
  2. Select AWS CodeCommit  from the tabs.  
  3. Click  Attach Pull request button .  
  4. Select a repository that is mapped with this project.
  5. Enter the ID of the pull request that needs to be attached to this work item.
  6. Select the Pull Request and click Attach .

 

Detach commits and pull request 

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

.  

Disassociate projects from repository     

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

From the associate project form  

  1. Click the gear icon at the top-right corner. The settings window will appear.

  2. Click Others under Marketplace . 
  3. Click AWS Code Commit.
  4. Select Associate Project in the right corner of the mapped repository in your Workspace Repository .     
  5. Deselect the projects.
  6. Click Update .   

Directly from the Workspace Repository   

  1. Select AWS Code Commit. 
  2. Click the count next to the workspace repository. 
  3. Hover over the project that you want to dissociate. 
  4. Click Remove Project . 

   Remove repositories from team             

  1. Go to AWS Code Commit. 
  2. View the list of repositories in your Workspace Repository .  
  3. Hover over the repository name.   
  4. Click the arrow icon on the left end of the repository name to unmap the repository from the team.   

Remove AWS authorization  

You can remove the AWS account from Zoho Sprints.
  1. Go AWS Code Commit.   
  2. Click    at the bottom-right corner of your personal repository.  A confirmation pop-up will appear.
  3. Click  Delete.