Note: Troubleshooting Azure DevOps pipeline runs by configuring verbose logs or HTTP trace logs will result in sensitive information recorded in the log files. Please do not share them with anyone.

Configure Azure DevOps Pipeline extension for cloud and server

To configure the extension:

1. Click the gear icon at the top-right. The settings window will appear.
   
2. Click Others under Marketplace section. The listing page will appear.
   
3. Click Configure under Azure DevOps Pipeline extension.
   
4. Select the Project and Accessibility controls and click Install Now.
   
5. Enter the Domain/Host URL.
   
   
6. Provide your Azure DevOps Organization name (Collection Name, if it is Azure DevOps server).
   
7. Click Save & Next.
   
8. Authorize the connections and triggers. While authorizing the Azure DevOps Connection, generate the Personal Access Token from Azure DevOps by using the scopes mentioned below:
   
1. Build.Read
   
2. Code.Read
   
3. Project and Team.Read
4. Extensions.Read&Manage (Portal owner only)
5. Service connections. Read, query & mange (Portal owner only)
   
9. Choose the projects to be associated from Azure DevOps. In case of server, select one project because Azure has an API restriction in place.
   
   
10. Click Associate. The selected projects will be mapped.
    

Azure Authorization behavior

Common task parameters in Azure DevOps Pipeline  

Tasks

1. Add a Feed Status in Zoho Sprints
   
2. Add an Item comment in Zoho Sprints
   
3. Add a Sprint comment in Zoho Sprints
   
4. Complete a Sprint in Zoho Sprints
   
5. Create an Item in Zoho Sprints
   
6. Create a Release in Zoho Sprints
   
7. Create a Sprint in Zoho Sprints
   
8. Start a Sprint in Zoho Sprints
   
9. Update an Item in Zoho Sprints
   
10. Update a Release in Zoho Sprints
    
11. Update a Sprint in Zoho Sprints

Task Parameters  

Work Items in Zoho Sprints

1. Project: Provide a Project Number
   
2. Sprint: Specify the Sprint number (0 means Project Backlog)
   
3. Item Number: Provide the Item number of the item in which the fields need to be updated.
   
4. Name: Enter the name of the work item
   
5. Description: Describe your work item
   
6. Status: Specify the status of the work item
   
7. Type: Specify the work item type, e.g.,Task
   
8. Priority: Set the work item priority, e.g., High
   
9. Start Date: Specify work item start date, e.g., 2022-08-13T00:00:00Z
   
10. End Date: Specify the work item end date. It should be greater than the start date, e.g., 2022-09-13T00:00:00Z
    
11. Item Assignee: Provide the email addresses of the item users (separated by commas)
    
12. Estimation points: Mention the index of the estimation points set for the item, e.g.,The index of 2 in a Fibonacci estimation type is 2 and the index of 8 will be 5.
    
13. Comment: Type the comment to be added for that work item
    
14. Duration: Time spent on that work item,e.g., 2hrs 50min
    
15. Custom Fields: Specify the custom field values here.  If there are multiple custom fields, they should be mentioned in a new line.
    
1. Example
   
2. UDF1_BOOLEAN=123456
   
3. UDF1_TEXT=text value

Sprints in Zoho Sprints

1. Project: Mention the project number.
   
2. Sprint: Mention the sprint number.
   
3. Sprint Name  Provide a name to the sprint.
   
4. Description: Describe the sprint
   
5. Scrum Master: Mention the email address of the scrum master
   
6. Sprint Users: Provide the email addresses of the sprint users (separated by commas)
   
7. Start Date: Specify the sprint start date, e.g., 2022-08-13T00:00:00Z
   
8. End Date: Specify the sprint end date, e.g., 2022-08-13T00:00:00Z
   
9. Duration: Mention a tentative duration of the sprint. A sprint duration cannot exceed 8 weeks when strict scrum is enabled. And if strict scrum is disabled, it can last up to 30 weeks, e.g., 2hrs 50min
   
10. Comment: Type the comments to be added to that sprint
    
11. Custom Fields: Specify the custom field values here. If there are multiple custom fields, they should be mentioned in a new line.
    
1. Example:
   
2. UDF1_BOOLEAN=12345
   
3. UDF1_TEXT=text value

Releases in Zoho Sprints  

1. Project: Enter the project number
   
2. Release Name: Provide a name to the release
   
3. Release Goal: Describe the purpose of release
   
4. Start Date: Enter the starting date of the release, e.g., 2022-08-13T00:00:00Z
   
5. Release Date: Enter the release date, e.g., 2022-10-13T00:00:00Z
   
6. Owners: Mention the email address of the owner separated by commas
   
7. Release Stage: Specify the stage in which the release is currently in, e.g., PLAN
   
8. Custom Fields: Specify the custom field values here. If there are multiple custom fields, they should be mentioned in a new line.
   
1. Example:
   
2. UDF1_BOOLEAN=12345
   
3. UDF1_TEXT=text value

Associate build from Azure DevOps

1. Navigate to the details page of a work item in Zoho Sprints.
   
2. Click the Azure DevOps Pipeline icon on the right corner.
   
3. Click Associate Build button.
   
4. Enter the preferred criteria.
   
5. Click Find.
   
6. Choose the build(s) to be associated and click Associate.
   

View Azure DevOps Pipeline's build status

1. Sign in to Zoho Sprints.
   
2. Select CI/CD view from the left navigation panel.
   
3. Select Azure DevOps Pipeline.
   
4. Hover and click the View Log. You can view the logs of each pipeline by clicking the View Logs button.
   
5. These pipelines can also be viewed based on a particular criteria. Click on the top right corner, set the criteria and click Apply Filter.

Disable extension

1. Click the gear icon at the top-right. The settings window will appear.
   
2. Click All under Marketplace section. The listing page will appear.
   
3. Find Azure DevOps Pipeline for Zoho Sprints.
   
4. Click Disable. The extension will be disabled.

Uninstall extension

1. Click the gear icon at the top-right. The settings window will appear.
   
2. Click All under Marketplace section. The listing page will appear.
   
3. Find Azure DevOps Pipeline for Zoho Sprints.
   
4. Click Uninstall. The extension will be uninstalled and configuration will be removed.