Integrating and Using Azure DevOps

Inspire integrates with the third-party cloud-based application Azure DevOps.

Inspire integration with Azure DevOps allows licensed Inspire users to sync your tasks and objective progress with work you have tracked in Azure DevOps.

You can set up integration for third-party applications like Azure DevOps by using the Integrations tab on your User Profile. 

Navigating to Your User Profile

1. Click your Profile Image at the top right of the Inspire screen.

profileImageHomeScreen

2. Click My Profile myProfileButton.

3. Your User Profile page will open to the Public tab. Your personal details will display on every tab of your User Profile. Click on the Integration 0904 - Slack - Integration tab  tab. 

1120 Integrations tab

 4. Click on the Edit 2020-11-20_8-41-15 - edit button only button for Azure DevOps. 

1120 Integrations tab mock up - ADO - not connected

5. The Azure DevOps Authentication dialog opens. Click the blue Azure DevOps hyperlink.

2020-12-2_14-09-52

6. The Azure DevOps Settings - Personal access token page opens. Click the + New Token 2020-12-02_13-02-33 button.

2020-12-02_13-07

7. The Create a new personal access token page opens.

     a. Enter a name for the new token; for example, ADO Token.
     b. Make sure the check box is marked for Read in the Work Items section. The other settings are all defaulted. 
     c. Click the Create 2020-11-20_9-59-46 - PAT Close edited   button.2020-11-20_9-59-46 - PAT edited with blur

8. The Success dialog opens. Click the copy button (A), then click Close (B).2020-12-02_14-30-10

9. Select the My Profile tab for Inspire in your browser.

2020-12-02_15-19-26

10. Paste the token into Enter Your Personal Access Token (PAT), then click the Save Screen Shot 2020-07-13 at 12.30.34 PM button.  

2020-12-02_15-18-26

11. Your User Profile page will open and Azure DevOps will now show that it has been connected.

2020-12-02_15-41-01

Using Azure DevOps in Inspire

You can now use Inspire to sync your tasks and objective progress with work you have tracked in Azure DevOps.

Set up your Objective or Key Results

1. On the top toolbar, click the Modules  menu and select Objectives.

2020-11-20_16-05-12 - Objectives

2. Click on the pencil icon on your Objective to open your Objective.

2020-11-20_10-26-25

NOTE: TIP: See Adding a New Objective , Checking In On Your Objectives, Managing Individual Objectives for more information about Objectives and key results.

3. Add a new key result and/or edit an existing key result:

    • Add a new key result by clicking Add 2020-11-20_16-12-16 - Add button and entering a title for the new key result, and click Apply 2020-11-24_11-29-39.
      MicrosoftTeams-image (1)
    • Edit a key result by selecting the ellipses 2020-11-23_12-14-03and clicking Edit 2020-11-23_12-16-07

4. In the Integrations field, click the hyperlink for Select Integration 1123 Select Integration.

5. Click on Azure DevOps 1123 - ADO then click Apply 2020-11-24_11-29-39.

1123 - Edit Key Result - EDITED ADO

6. The Edit Integration Setup dialog opens. Use the dropdown arrows to select the Query and Measure Completion By type.

2020-12-03_15-12-41 - EDITED7. In this example, -My Tasks was selected as the Query, and Original Estimate was selected for Measure Completion By. Click Apply 2020-11-24_11-29-39  to apply these choices. 

2020-12-03_15-23-04 - Edited8. Azure DevOps is now listed as the Integration for this key result for the Objective.  Click 2020-11-24_11-29-39 Apply.   

2020-12-03_15-23-42 - Edited

9. Updates made in Inspire for this key result will now also update Azure DevOps.

  • The Azure DevOps symbol appears next to the ellipses 2020-11-23_12-14-03for this key result, indicating that the key result is connected.
  • Hovering over the Azure DevOps symbol displays the date and time that the key result last synced with Azure DevOps. 

  • The sync between this key result and Azure DevOps can also be forced by clicking on the  ellipses 2020-11-23_12-14-03, then selecting Sync Progress .