Requirements
ADO Cloud or ADO On-Premise (formerly TFS) minimal version v2020
Use Personal Access Tokens (PAT) with comprehensive permissions for ADO REST API
Data Management
ADO Work Item data stored in piplanning.io:
Work Item Title
Work Item ID
Optional: Work Item Story Points
Optional: Work Item WSJF (optional)
Work Item Area and Iteration Paths
Optional: Attributes used in the ADO Matching Filters
Relationships (Links) between synchronized Work Items
Connection Details
piplanning.io → ADO via REST-API of ADO (access on Ports 80/443)
Requests to the ADO REST API originate from a single IP
API Authentication with ADO PAT
Optional 2Way TLS (client certificate)
ADO → piplanning app via ADO Webhooks
Three separate Webhooks: Work item Created, Work item Deleted, Work item Updated
💡 Recommendation:
We recommend the use of a Service User account for the ALM Connection to ADO connection.