This article describes the Azure DevOps to OnePlan Plans default field mappings and strategies for your integration.
Integration Information
OnePlan Changes
Once the integration is complete, three things will occur in the OnePlan integration page:
- Integration Line-Item Creation.
- Azure DevOps Availability in Connected Systems.
- After completion, Azure DevOps becomes accessible within the Connected Systems icon, indicating its successful integration with OnePlan.
Integration Line-Item Details
Each entry in the Integration section provides an overview of OneConnect Integrations associated with the OnePlan Work Plan, offering a comprehensive list of connected systems.
Identifying Connected Systems
Any item connected to Azure DevOps will display the Azure DevOps icon on both the My Portfolio page and the Work Plan Backlog page, indicating the association between plans/tasks and Azure DevOps.
Connecting Items
To link an item from OnePlan to Azure DevOps:
- Navigate to the Work Plan - Schedule or Backlog page.
- Click on the "Integrations" link (Connected Systems Icon).
- Select the option to connect to an existing item in Azure DevOps or create a new item.
Once connected, the Connected Systems window allows for Import, Export, Disconnect or Opening of the Azure DevOps plan-level item.
Plans - Plans
| OnePlan Field | Azure DevOps Field | Direction | Notes |
|---|---|---|---|
| Name | Title | Both | Required |
| Owner | Assigned To | Both | Required |
| Portfolio Parent Id | Parent Item ID | Both | Required |
| Portfolio Plan Type | Work Item Type | Both | Required |
Backlogs - Items
| OnePlan Field | Azure DevOps Field | Direction | Notes |
|---|---|---|---|
| Assigned To | Assigned To | Both | |
| Due | Target Date | Both | |
| Item Type | Work Item Type | Both | Required |
| Iteration (OnePlan System) | Iteration Path | Both | |
| Name | Title | Both | Required |
| Parent Id (Structure) | Parent Item ID | Both | Recommended |
| Start | Start Date | Both |
Strategies
The following strategies are available:
OnePlanUpdate
Publish data from Azure DevOps to OnePlan.
This strategy has a filter within the Azure DevOps - OnePlan > Epics – Plans section. This filter will only sync items that are already mapped to OnePlan. Please talk to your OnePlan Contact about filtering the information being brought into OnePlan. If this filter is removed (and not replaced with an alternative filter), all items will be brought into OnePlan.
This strategy will bring in all Azure DevOps plan-level work item types listed and their associated work item types into OnePlan. It is recommended that a filter be put in place to limit what work item types are desired to be brought over. To facilitate large-scale data manipulation, this strategy now efficiently processes multiple records simultaneously. Additionally, for consistency and accuracy alignment between Azure DevOps and OnePlan, the strategy will automatically remove tasks from OnePlan if they are deleted in Azure DevOps. This deletion specifically applies to backlog items and does not affect plans within OnePlan.
Filters can be applied to this strategy on the Azure DevOps -> OnePlan section, within the Plans -> Plans table.
OnePlanPublish
Publish data from OnePlan to Azure DevOps.
This strategy has a filter within the OnePlan - Azure DevOps > Plans – Epics section. This filter will only sync items that are already mapped to OnePlan. Please talk to your OnePlan Contact about filtering the information being brought into Azure DevOps. If this filter is removed (and not replaced with an alternative filter), all items will be brought into Azure DevOps.
Filters can be applied to this strategy on the OnePlan -> Azure DevOps section, within the Plans -> Plans table.
OnePlanPlanItemsCleanUp
The OnePlanPlanItemsCleanUp strategy removes OnePlan task or backlog items that have been deleted in Azure DevOps. It does not delete plans in OnePlan.
While the OnePlanUpdate strategy already includes logic to remove items, the OnePlanPlanItemsCleanUp strategy provides an additional, dedicated cleanup step. This ensures that any items deleted in Azure DevOps are also removed from OnePlan, keeping both systems aligned.
SyncLookupToADO
Synchronize a choice field list of options from OnePlan to go into an ADO lookup/choice field options.
SynchLookups
Synchronize a choice field list of options from ADO to OnePlan.
Comments
0 comments
Please sign in to leave a comment.