Azure DevOps Integration - OnePlan Setup

This article explains how to set up OnePlan for your Azure DevOps integration. This is the first part of the integration setup. To complete your Azure DevOps integration, you must complete:

1. (You are here) Azure DevOps Integration - OnePlan Setup

2. Azure DevOps Integration - Azure DevOps Setup

3. Azure DevOps Integration - Epics Field Mappings

The following video walks through the steps to set up OnePlan for the Azure DevOps Epics to OnePlan Plans integration.

Note

These setup steps apply to all of the Azure DevOps integrations.

To set up this integration, you need:

• to have OnePlan and OneConnect approved by an Office365 tenant admin

• to be a OnePlan admin, meaning you are a user with Owner permissions in OnePlan

• to be an Azure DevOps admin

Select the Integration

1. Log in to OneConnect with your Office365 account.

2. Locate and select the OnePlan and Azure DevOps integration.

   

3. Decide which version of the Azure DevOps integration you would like. Then click Configure. The integration configuration form will open.

   Note

   We use the Azure DevOps Epics integration in this procedure.

Add Backlog app to OnePlan

If you haven't already done so, add the Backlog App. By adding the Backlog App, the the Backlog work type is created. This integration will map from Azure DevOps to the Work Plan, specifically the type: Backlog.

For instructions how to install an app click here: How do I add apps?

OnePlan Setup

For the integration configuration, you will need to collece the following information from OnePlan:

• the group name

• an authentication key

• the authentication key name

1. Keep the OneConnect integration configuration form open. Open a new tab in your browser and go to OnePlan.

   

2. Log in to your OnePlan group with your Office365 account.

3. Locate and note the OnePlan group name. Go to the OneConnect tab and enter the OnePlan group name into the OnePlan Group Name field.

   
   

4. Go to the OnePlan tab.

5. Generate a new authentication key

   1. Open the Admin pages by clicking on the Settings gear.

   2. Select Integration in the admin navigation.

   3. Click the + (plus) icon in the Authentication Keys section.

   4. Enter a name for the new authentication key. Then click ADD to create the key.

      Note

      It is best practice to create a new authentication key for each integration, and to name each authentication key so you know which integration it belongs to. For this integration, we recommend a name like "Azure DevOps Integration".

   5. Save the key name and generated key somewhere secure. Once you navigate away, the key is hidden.

      

6. Go to the OneConnect tab and enter the authentication key into the OnePlan Authentication Key field, and the authentication key name into the Integration Key Name field.

   

7. Once all of the OnePlan information is entered (group name, authentication key, and authentication key name), click Test.

8. If the connection test is successful, click Next. Then follow Azure DevOps Integration - Azure DevOps Setup.

   Note

   Keep the OneConnect integration configuration tab in your browser open.