{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":32101,"path":"it-service-management/devops-change-velocity/dev-ops-azure-work-item-import.md","title":"DevOps work item import for Azure Boards","bundle":null,"doc_type":null,"release":"australia","body":"\n# DevOps work item import for Azure Boards\n\nAzure 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.\n\n## Default Azure Boards work item mapping\n\n**Native State** and **Native Type** fields of the work item contain the original state and type values from the source tool.\n\n<table id=\"table_rnv_ssx_glb\"><thead><tr><th>\n\nServiceNow DevOps\n\n</th><th>\n\nAzure Boards Basic\n\n</th><th>\n\nAzure Boards Agile\n\n</th><th>\n\nAzure Boards Scrum\n\n</th></tr></thead><tbody><tr><td>\n\nTask\n\n</td><td>\n\nTask\n\n</td><td>\n\nTask\n\n Test case\n\n</td><td>\n\nTask\n\n Impediment\n\n Test case\n\n</td></tr><tr><td>\n\nBug\n\n</td><td>\n\nIssue\n\n</td><td>\n\nBug\n\n Issue\n\n</td><td>\n\nBug\n\n</td></tr><tr><td>\n\nStory\n\n</td><td>\n\n--\n\n</td><td>\n\nUser story\n\n</td><td>\n\nProduct backlog item\n\n</td></tr><tr><td>\n\nEpic\n\n</td><td>\n\nEpic\n\n</td><td>\n\nEpic\n\n</td><td>\n\nEpic\n\n</td></tr><tr><td>\n\nFeature\n\n</td><td>\n\n--\n\n</td><td>\n\nFeature\n\n</td><td>\n\nFeature\n\n</td></tr></tbody>\n</table>**Note:** Historical import of Azure DevOps work items is not supported for Agile Boards CMMI process.\n\n<table id=\"table_r41_4k2_vlb\"><thead><tr><th>\n\nServiceNow DevOps\n\n</th><th>\n\nAzure Boards Basic\n\n</th><th>\n\nAzure Boards Agile\n\n</th><th>\n\nAzure Boards Scrum\n\n</th></tr></thead><tbody><tr><td>\n\nPlanned\n\n</td><td>\n\nTo Do\n\n</td><td>\n\nNew\n\n</td><td>\n\nNew\n\n Open\n\n Approved\n\n Committed\n\n To do\n\n</td></tr><tr><td>\n\nWIP\n\n</td><td>\n\nDoing\n\n</td><td>\n\nActive\n\n Design\n\n</td><td>\n\nIn Progress\n\n Design\n\n</td></tr><tr><td>\n\nComplete\n\n</td><td>\n\nDone\n\n</td><td>\n\nReady\n\n Closed\n\n</td><td>\n\nDone\n\n Ready\n\n Closed\n\n</td></tr><tr><td>\n\nDeleted\n\n</td><td>\n\nDeleted\n\n</td><td>\n\nCompleted\n\n Deleted\n\n</td><td>\n\nRemoved\n\n</td></tr></tbody>\n</table>**Note:** When an imported Azure Boards work item type or state is not recognized, the value is set to **Other**.\n\n## Customize Azure Boards state and type mappings\n\nAccess the DevOpsAzureDevOpsWorkItemHelper script include in the **System Definition** &gt; **Script Includes** module.\n\nThis script example adds new states and types for custom processes MyScrum and CustomBasic. CustomBasic inherits the state and type defined for Basic process.\n\n```\nvar DevOpsAzureDevOpsWorkItemHelper = Class.create();\n\nDevOpsAzureDevOpsWorkItemHelper.prototype = Object.extendsObject(DevOpsAzureDevOpsWorkItemHelperSNC, {\n\t\n\tsetDefaultProcess: function (projectProcess){\n\t\t\n\t\tDevOpsAzureDevOpsWorkItemHelperSNC.prototype.setDefaultProcess.call(this, projectProcess);\n\t\t\n\t\t//set custom states and types\n\t\tvar newStates, newWITypes;\n\t\tif (projectProcess == 'NPScrum'){\n\t\t\t// no parent process set. So type and states avaibale will be linited to newStates\n\t\t\t// and newWITypes\n\t\t\tnewStates = {\n\t\t\t\t'Delayed': 'planned',\n\t\t\t\t'Approved': 'wip'\n\t\t\t};\n\t\t\tnewWITypes= {\n\t\t\t\t'Request': 'story',\n\t\t\t\t'Incident': 'task'\n\t\t\t};\n\t\t\t\n\t\t} else  if (projectProcess == 'CustomBasic'){\n\t\t\t//set parent process to Basic to inherit basic states and types\n\t\t\tthis.setParentProcess('Basic');\n\t\t\tnewStates = {\n\t\t\t\t'Auto-Approved': 'wip'\n\t\t\t};\n\t\t\tnewWITypes= {\n\t\t\t\t'UserStory': 'story'\n\t\t\t};\n\t\t}\n\t\t\n\t\tthis.setStates(newStates);\n        this.setWorkItemTypes(newWITypes);\n\t},\n\t\n\ttype: 'DevOpsAzureDevOpsWorkItemHelper'\n});\n```\n\n**Parent Topic:**[Azure DevOps integration with DevOps Change Velocity](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/it-service-management/devops-change-velocity/azure-devops-integration-dev-ops.md)\n\n"}}