---
sourceDocument: Australia IT Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/it-service-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Service Management

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# DevOps work item import for Azure Boards

# DevOps work item import for Azure Boards {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Azure Boards work items are mapped to default ServiceNow
DevOps states and types during import. You can use the
DevOpsAzureDevOpsWorkItemHelper script include to customize the mappings.

## Default Azure Boards work item mapping {#dev-ops-azure-work-item-import__section_nwy_ybx_rmb}

Native State and Native Type fields of the
work item contain the original state and type values from the source tool.  
{#dev-ops-azure-work-item-import__table_rnv_ssx_glb__entry__4}

| ServiceNow DevOps | Azure Boards Basic | Azure Boards Agile | Azure Boards Scrum |
|-|-|-|-|
| Task | Task | Task Test case | Task Impediment Test case |
| Bug | Issue | Bug Issue | Bug |
| Story | -- | User story | Product backlog item |
| Epic | Epic | Epic | Epic |
| Feature | -- | Feature | Feature |
[Table 1. Work item type mapping]

{#dev-ops-azure-work-item-import__table_rnv_ssx_glb}  
Note:  
Historical import of Azure DevOps work items is not supported for Agile Boards CMMI process.  
{#dev-ops-azure-work-item-import__table_r41_4k2_vlb__entry__4}

| ServiceNow DevOps | Azure Boards Basic | Azure Boards Agile | Azure Boards Scrum |
|-|-|-|-|
| Planned | To Do | New | New Open Approved Committed To do |
| WIP | Doing | Active Design | In Progress Design |
| Complete | Done | Ready Closed | Done Ready Closed |
| Deleted | Deleted | Completed Deleted | Removed |
[Table 2. Work item state mapping]

{#dev-ops-azure-work-item-import__table_r41_4k2_vlb}  
Note:  
When an imported Azure Boards work item type or state is not recognized, the value is set to Other.

## Customize Azure Boards state and type mappings {#dev-ops-azure-work-item-import__section_rgt_sh1_wlb}

Access the DevOpsAzureDevOpsWorkItemHelper script include in the System DefinitionScript Includes module.

This script example adds new states and types for custom processes MyScrum and CustomBasic.
CustomBasic inherits the state and type defined for Basic process.  

    var DevOpsAzureDevOpsWorkItemHelper = Class.create();

    DevOpsAzureDevOpsWorkItemHelper.prototype = Object.extendsObject(DevOpsAzureDevOpsWorkItemHelperSNC, {
    	
    	setDefaultProcess: function (projectProcess){
    		
    		DevOpsAzureDevOpsWorkItemHelperSNC.prototype.setDefaultProcess.call(this, projectProcess);
    		
    		//set custom states and types
    		var newStates, newWITypes;
    		if (projectProcess == 'NPScrum'){
    			// no parent process set. So type and states avaibale will be linited to newStates
    			// and newWITypes
    			newStates = {
    				'Delayed': 'planned',
    				'Approved': 'wip'
    			};
    			newWITypes= {
    				'Request': 'story',
    				'Incident': 'task'
    			};
    			
    		} else  if (projectProcess == 'CustomBasic'){
    			//set parent process to Basic to inherit basic states and types
    			this.setParentProcess('Basic');
    			newStates = {
    				'Auto-Approved': 'wip'
    			};
    			newWITypes= {
    				'UserStory': 'story'
    			};
    		}
    		
    		this.setStates(newStates);
            this.setWorkItemTypes(newWITypes);
    	},
    	
    	type: 'DevOpsAzureDevOpsWorkItemHelper'
    });

*[\>]: and then