The real-time integration of Path to Agility Navigator with Azure DevOps (ADO) follows these rules:
- The integration involves Action Items in Navigator
- Only Action Items created in Navigator can be synchronized with ADO
- Work Items created in ADO, will not be synchronized with Navigator
- Navigator will listen for updates to work items it created in ADO. When updates are detected, Navigator will update the corresponding Action Item in Navigator
- If a work item in ADO is deleted, the action item in Navigator will be deleted
- Configuration will be required in ADO to enable the integration
- Configuration will be required in Navigator to enable the integration
Prerequisite(s)
- Microsoft administrator will need to:
- register Path to Agility Navigator in Microsoft Entra ID
- add a Service Principal (SP) to ADO
- assign the appropriate permissions to the SP
- provide a Client ID, Tenant ID, and Client Secret to a Path to Agility Navigator administrator
Create the Integration in Navigator
As a company administrator, the integration can be configured with the credentials identified in the prerequisites.
Log into Navigator with an account that has the Company Admin role
Go to Settings and select the Azure DevOps Integration option
Click Add Integration to open the modal to create the integration
Select the "Service Principal / SPN" option
Enter the Organization Name, Tenant ID, Client ID, and Client Secret (credentials obtained from the Microsoft Administrator)
Saving will run a validation check to ensure the organization exists in ADO
Once verified, the integration will be enabled and the Webhook URL and Webhook Client Secret are accessible. These are required to create the Service Hook.
Add & Configure Projects
Once the integration is fully configured, business units can be configured so action items are created on the appropriate boards in ADO.
- In Navigator, as a Company Admin
- Go to Settings
- Go to the ADO Integration page
- Go to the Add and Sync Projects section
- Select a Business Unit
- Select the appropriate Project and Team from the drop downs
- Select the First and Last Status for items on that board. The list of statuses supported for issues on that board will be pulled in to populate the drop downs for First Status and Last Status. Select the status that corresponds to the initial state of issues as the First Status and the final status for issues (i.e. complete, done, released) as the Last Status.
- Click Add
Service Hook Creation in ADO
The final step is to create the Service Hook. The Service Hook ensures updates to work items in ADO will be shared with Navigator, thus keeping the information in sync in both systems. See the steps to setup the Service Hook here.
