Azure DevOps Agile Project Portfolio Management (PPM) Extension

The OnePlan Azure DevOps PPM Extension, available on the Azure DevOps Marketplace, provides a seamless way to integrate strategic planning and agile execution. This extension embeds OnePlan directly within Azure DevOps using secure Iframes, allowing users to view and interact with OnePlan content — such as portfolios, plans, and resource data — without ever leaving the Azure DevOps environment.

By using Iframes, the extension enables real-time access to OnePlan capabilities from a dedicated tab within Azure DevOps projects or work items. This ensures that development teams, project managers, and product owners can stay aligned and work efficiently across tools — all while maintaining secure, role-based access to OnePlan data.

Key Benefits

Centralized Work Management

View and manage OnePlan portfolios, programs, and plans right from Azure DevOps — ensuring your developers and project managers are always aligned.

Enhanced Visibility

Bring planning and execution data together in one view. Project managers can track real-time updates from development teams without leaving OnePlan, while engineers stay focused on Azure DevOps.

Streamlined User Experience

The Iframe-based integration minimizes disruption to your team’s workflow. It feels like part of the Azure DevOps environment, while securely connecting to the full power of OnePlan.

Secure

Leverages your organization’s authentication policies with Entra ID Single Sign-On support. Admins can configure which OnePlan pages are accessible via the Iframe for optimal usability.

How it Works

The OnePlan Azure DevOps PPM Extension enhances your Azure DevOps environment in two key ways:

1. Project Navigation Panel Integration - Once installed, the extension adds a OnePlan link in the left navigation panel of every Azure DevOps project across your organization. This link opens a configurable Iframe that displays OnePlan content — such as portfolios, plans, or dashboards — tailored to the context of your organization’s planning needs. This makes OnePlan easily accessible from any project without requiring separate logins or tabs.
2. Work Item Tab Integration - The extension also adds a dedicated OnePlan tab inside Azure DevOps work items or project views. This embedded tab uses a secure Iframe to show relevant OnePlan pages (e.g., plan details, resource plans, or status reports) directly within the Azure DevOps UI, giving users fast access to planning and portfolio data while staying focused on delivery work.
   1. In Azure DevOps, if the Work Items have not yet been brought into OnePlan, an event will automatically trigger to import the items into OnePlan once the OnePlan tab is clicked.

Technical Details

Setup Prerequisites

• Active OnePlan and Azure DevOps integration subscription in my.oneconnect.ai or in eu.oneconnect.ai
• Azure DevOps project permissions to install and access extensions

| NOTE: If an integration is not selected for the ADO extension, the first active ADO integration will be used.

Extension Installation

1. User must be an Azure DevOps Organization Owner (or have permissions to install extensions), and have access to the Azure DevOps Marketplace.
2. Once logged into Azure DevOps navigate to https://marketplace.visualstudio.com
3. In the search bar, type “OnePlan".
4. Click on the OnePlan extension labelled “Agile Project Portfolio Management”.
5. Click “Get”.
6. Select your Azure DevOps Organization from a dropdown.
7. Click "Install”. Azure DevOps will redirect you to the selected organization.
8. Confirm the extension is being added to the correct Azure DevOps Organization.

After Installation

Once installed:

1. A OnePlan extension will appear in the left navigation of every project across the organization.
2. The OnePlan tab will be available within individual work items.

How the Azure DevOps Extensions Select an Integration

The Azure DevOps extensions automatically determine which Azure DevOps integration to use based on the integrations configured in your OnePlan environment.

If You Have One (1) Azure DevOps Integration

If only one Azure DevOps integration exists in the environment, the extension will use that integration automatically, regardless of whether the integration is enabled or disabled.

If the extension is not functioning as expected, verify that the integration is enabled.

If You Have Two (2) or More Azure DevOps Integrations

When multiple Azure DevOps integrations exist, the extension follows this logic:

• If no enabled integration has Use this integration in the ADO DevOps Extension selected, the extension will use the first enabled integration it finds.
• If multiple enabled integrations exist, this can cause the extension to connect to an unintended integration.

To specify which integration the extension should use:

1. Open the desired Azure DevOps integration configuration.
2. Expand Azure DevOps Advanced Options section.
3. Enable the checkbox labeled Use this integration in the ADO DevOps Extension.
4. Save the integration settings.

It is recommended that only the intended integration has this option enabled to ensure the extension connects to the correct Azure DevOps instance.