Guides - Azure DevOps Integration

Azure DevOps Integration

This guide has multiple versions available:

<head><style> .chartjs-size-monitor { display: none !important; height: 0 !important; overflow: hidden !important; }p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style></head><body><style> p { margin: 0; } span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px; } blockquote blockquote { border-color: #00bcd4; color: #00bcd4; } blockquote blockquote blockquote { border-color: #43a047; color: #43a047; } table.grid { border-collapse: collapse; } table.grid td, table.grid th { border: 1px solid #ddd; } .fr-fic.fr-dib { display: block; margin: 5px auto; } .fr-fic.fr-dib.fr-fir { text-align: right; margin: 5px 0 5px auto; } .fr-fic.fr-dib.fr-fil { text-align: left; margin: 5px auto 5px 0; } </style>In this guide we will cover:- What is the Azure DevOps Integration?- Connecting to DevOps- Syncing between DevOps and Halo- Halo Configuration Options What is the Azure DevOps Integration?The Azure DevOps integration allows you to sync tickets from Halo to work items in Azure DevOps and vice versa. This includes ticket/work item creation as well as updates to various fields. Connecting to DevOpsConfigure the Azure DevOps integration by navigating to Configuration > Integrations and enabling the module by hovering your cursor over the integration button and clicking the + icon.  <img width="113" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM0MzIyNzgxLWZiNTUtNGJlZi1iYmZjLWNlMTIxNDdlZTdkMiJ9.1yMu75dtxgb6QxMTD0Wonz4Su08JJ9x7s2R5AXBBS6g" class="fr-fic fr-dii" height="123">Fig 1. Enable the module Once enabled, click into the integration module to start configuration. Upon clicking into the integration, click New in the top right corner to begin a new connection to Azure DevOps. This will prompt you to name your connection and provide an Azure DevOps instance URL. <img width="879" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjllM2RhYWM0LTdhOTEtNGE3My1hNzg1LTg4ZGQ0ZmNiODgwNCJ9.uA7aGSnnAITt-23YytZHqamQWjPujo8ePFHybjZd-BU" class="fr-fic fr-dii" style="width: 881px; height: 367.083px;" height="367">Fig 2. Details for connection From v2.250+ you will be able to choose the authentication method you wish to use for the integration. You can choose from:<ul><li>Using a personal access token</li><li>Use Entra ID OAuth </li></ul>On versions prior to this you will need to connect using a personal access token.  If setting up this integration for the first time, we advise connecting using Entra ID OAuth as <a href="https://devblogs.microsoft.com/devops/retirement-of-global-personal-access-tokens-in-azure-devops/" target="_blank" rel="noopener noreferrer">personal access tokens are being deprecated by Microsoft in 2026.</a> Generate a Personal Access TokenThis can easily be generated in Azure DevOps by clicking the “User Settings” icon next to your initials and selecting Personal access tokens from the drop down. <img width="415" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc5NzYyZDk2LWI5OWMtNDg0NS1hYzRmLTFlNjgyMjMwNDhkZCJ9.1PZeY4GTP8cO7dRAr_Y-Qn8o_Oisfk1UDYdgEEWavYs" class="fr-fic fr-dii" height="427">Fig 3. Personal access tokens area in Azure DevOps Upon clicking this, you will navigate to a table of existing Personal Access Tokens where you can click “New” to configure a new one. Configure this token as you wish. Fields to note:<ul><li>Name is simply the name of the Personal Access Token in Azure DevOps. Provide something sensible.</li><li>Expiration defaults to 30 days but you can set to your own desired time frame. We recommend taking note of this date so you can generate a new Personal Access Token when the time comes.</li><li>Scopes has to do with the permissions required by Halo to perform this integration. The functionality simply involves creating and updating work items, so the only permission required is Work Items with Read, Write, & Manage.</li></ul><img width="525" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJiMzliMjhlLTY4M2YtNGU5Zi05Mjk5LTYyYjY3YzViZjg4OSJ9.UnJaS1R8OYqXJzAm0WlYQEfnqeiZRDaog-ijazCYSlQ" class="fr-fic fr-dii" height="689">Fig 4. Configure Personal access tokens in Azure DevOps Please note that notes added to work items in Azure DevOps and subsequently synced to a Halo ticket will be attributed to the profile which generated the Personal Access Token. To ensure clarity, it is advisable to use a service account with a generic name to generate the Personal Access Token, minimizing confusion when notes are synchronized back to Halo. Once the credentials for your connection are saved, you are able to test your connection to ensure everything has been configured correctly. <img width="185" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ3OWFkYTNlLTFhNzYtNDg3My1hNDA2LTllMzYxYjVkMWEwMyJ9.s786-r907Hb3DM7d1Zad6RpX9EWP-KHUQaMAXxk2svk" class="fr-fic fr-dii" height="71"> Fig 5. Test configuration Generate OAuth Credentials (Recommended Method) (v2.250+)To connect using OAuth credentials you will need to create an azure application in your azure tenant and generate the relevant credentials. We support the use of the following credentials:<ul><li>Client Secret</li><li>Federated Credentials </li><li>Certificate</li></ul> Open the Entra Admin Centre (or similar) and navigate to the App Registration section. Click "New Registration". <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIyMzFkOTUyLTZiZmMtNDgzZS1hOGYxLTlmNDQ5NWE5YmQ5NCJ9.b6Ha-QGfAVzT63hWaKDKb24uI11Zx2uGI9SyoBDv4oo" class="fr-fic fr-fil fr-dib" width="1199" style="width: 1201px; height: 574.155px;" height="574">Fig 6. New Registration On the registration screen fill out:Name: Give the application a sensible name to reference it with.Supported Account Type: Choose Single Tenant. The Azure DevOps integration does not support a multi tenanted connection. Redirect URI: Enter the "Redirect uri to register in Azure application for imports" found on your integration setup page in Halo. This will be visible after selecting "Entra ID OAuth" as the authentication method. <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ5ZGY0OTk1LTI2NDQtNDAyNy1iZDliLWFkMjczNjJiYzE5YyJ9.OB-s1v40u8YgYnovY3D7d0U5HCC9YXpR3kOh13VyaNo" class="fr-fic fr-fil fr-dib" width="980" style="width: 982px; height: 711.607px;" height="712">Fig 7. Application Details Once registered, copy the "Application (client) ID" and "Directory (tenant) ID" from the Overview tab and store them safely, as these will be needed later.<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQzNzJhMWU4LWVjZDktNGE2Yy04MjBkLWRlMTA2YTZkNDlmMiJ9.VQhR_nVlMFB397H6en6dTYSBFD7rxOa4KBoUsRikRaM" class="fr-fic fr-fil fr-dib" width="1240" style="width: 1242px; height: 457.743px;" height="458">Fig 8. Application and Directory ID Now you will need to assign the required permissions to the application. The permissions the application needs can be found on the integration setup page in Halo.  To add permissions to the application head to the "API permissions" section, remove the default 'User.Read' permission, and add the following permission:<ul><li>user_impersonation</li></ul> When adding this permission ensure this is added from the "Azure DevOps" API<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjJlZjEyYWRlLTg3NDMtNGI2Ny04MWQ5LTY1YWY5NDU4YjgxNyJ9.BxwNNHcXtHnhBspvLOKlkEaL0NaC-IOwbd_9e8cuVZw" class="fr-fic fr-fil fr-dib" width="1715" style="width: 1717px; height: 683.652px;" height="684">Fig 9. Azure DevOps API Once added your application permissions should look as shown in Figure 10. <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM4NTVkYTRkLTkyNWYtNGJkZS04NmJlLTUwMzFlMmQxOTA2NiJ9.92_E4_AJ8toR_JMkpoECA8Ab4YYvVSM0XatB3PCltcQ" class="fr-fic fr-fil fr-dib" width="1494" style="width: 1496px; height: 605.078px;" height="605">Fig 10. Azure application with permissions Now you will need to generate the credentials for this application. You will only need to follow one the of next sections of this guide in line with the credential type you are using.  Client SecretIn Azure, navigate to the "Certificates & secrets" tab, and open the "Client secrets" tab. Click "New client secret", fill out the description and choose an expiry. Microsoft limits this to a maximum of 2 years from creation. Once this generates, copy the "Value" (not Secret ID) and store it securely. It will no longer be visible once you leave this screen.<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM1NjE2MDU1LTk2ZTktNDlhMy05NzRlLTNkMDUzZGM4NWJlOSJ9.hH_3I5nVP5JBNkodMQ88Q-sDSsd2covVcCXuaoNbujs" class="fr-fic fr-fil fr-dib" width="1185" style="width: 1187px; height: 655.003px;" height="655">Fig 11. Copy the Secret Value Now you have the client secret, Tenant ID and Application ID, head back to Halo and paste these values into the "Azure Application Details" on the integration setup page.  Federated CredentialsOnce you have chosen Federated credentials as your credential type for the integration in Halo, you will need to choose the 'Agent Account to use for Federated Credential'. Generate a Certificate In order to use this credential type you will need access to a valid X.509 certificate. You will need this in both ".pfx" format (with access to the export password) and in ".cer, .pem or .crt" for Azure.  Once you have these, within Halo navigate to Configuration > Advanced Settings > Certificates. Create a new certificate entry by giving it a name, uploading the file, entering the password, and saving.<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImVmYWYzNGY2LWYyYjMtNDk0YS1hMDQ0LTc1NzQ0MDlkMWYwYSJ9._L7Mu-cDGdPWrUV4kK5up0Mq3UeMCuhFSbT1hY5R91Y" class="fr-fic fr-fil fr-dib" width="1650" style="width: 1652px; height: 473.057px;" height="473">Fig 12. New Certificate Entry in Halo In Azure, navigate to the "Certificates & secrets" tab, and open the "Certificates" tab. Click "Upload Certificate", upload the file, and give it a description before clicking "Add".<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY5NDEwNzgwLTU2MGEtNGQ1Yi05YmQwLTZlZGQzNDBhZGQzMyJ9.i2evBdagr0zIiS-3v0LhX35YsUPQ3jsVQ1_CKIApDUY" class="fr-fic fr-fil fr-dib" width="1893" style="width: 1895px; height: 596.464px;" height="596">Fig 13. Upload Certificate in Azure Now, back in Halo, head back to the integration setup page and input the Tenant ID, Application ID and choose the uploaded certificate before saving. You should now have:<ul style="margin-left: 20px ;"><li>Azure Application (client) ID</li><li>Directory (tenant) ID</li><li>Relevant credentials</li></ul> Head back to Halo and plug these values into the integration setup page.<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3ZmMxMmM0LWVlOWYtNDM4OC04NGU2LWRjNDUxY2IxODZmNiJ9.P5eaBB2GPuM0X5WmCsh4kRElHhnhprWMXD_-7h653N8" class="fr-fic fr-fil fr-dib" width="1278" style="width: 1280px; height: 741.447px;" height="741">Fig 14. Azure Application Details plugged into Halo Once saved there will be a "Sign in with Microsoft" button. Once pressed, you will be directed to the Microsoft Sign-In screen where you can sign in before being re-directed back to Halo. You will need to sign in with an account with appropriate permissions to access the resources you wish to import/update. The account will need permission to access all the work items you wish to import/update. Syncing between DevOps and HaloSyncing Projects from Azure DevOps to Products in HaloProjects in Azure DevOps translate to Products in Halo. Knowing this, we must enable the Software Releases module in Halo to allow this integration to function. Find the module in Configuration and make certain that it is enabled. <img width="114" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc4NTA5MmMzLTZjYTYtNGZiOC1iYTNkLTgwNWFjYzAxYWY0MyJ9.DVwrI6lRc_i00_flt8I8y5Ptg6R_IaBHIN50abZcJEw" class="fr-fic fr-dii" height="140">Fig 15. Enable Software Releases Module Now navigate back to the Azure DevOps integration page’s Projects tab. Here you can click the button Import Projects to sync over the projects in your connected Azure DevOps instance as products in Halo. Tickets to Work Items Action ConfigurationTo perform the creation of a work item in Azure DevOps, you must click a pre-configured action which is set with proper fields and system for syncing. To configure this action, navigate to Configuration > Tickets > Actions and click New in the top right corner to start configuring a new action. Upon creating a new action, you will be prompted to enter various fields. Below we’ve noted the fields important for this integration. Outcome Description - Text which shows after action has been performed. <img width="177" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjIyNjkwYzM2LWNhNDQtNDc4Ni1hNjE0LTg4YzUzOTQ4YjAwOSJ9.W--9D0_sC2zAo2izDgbgV4ienTH6J3TPCIfYkzjszlM" class="fr-fic fr-dii" height="90">Fig 16. Outcome description Button Name - Text which shows on the button of the action.<img width="129" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdmY2U0MDE1LWVjYjYtNDBiMC04ZDM2LTY1ZDA2MTExY2RmNCJ9.njnZ3vFjr5ojVctL7RQnkYG2CF6dDNwDHQ3oZ7XXj_k" class="fr-fic fr-dii" height="79">Fig 17. Button name Button Icon - Small picture which shows on the button of the action.<img width="117" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3ZmFmODJlLTFjYTktNDI3NS04ZmYxLTAxZTc4ZTM5MmE4YiJ9.eDR7tFuHzoGF56f_Z_sca1rBoGvpl79WcQHsyZd2yas" class="fr-fic fr-dii" height="90"> Fig 18. Button icon System Use - The functionality which tells Halo to create a work item when this action is performed. <img width="256" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjE1YzEzNDZhLTFlNTEtNGYwZi05MjljLTY0ZmJhODA1MDk2YSJ9.m4NHGe049-0hqhPwVzXSe_vM8EsHOFV6HsDkVE_EGlo" class="fr-fic fr-dii" height="85"> Fig 19. System Use Work Item Type - Text box allowing you to denote a work item type to be created when this action is performed. <img width="248" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI0YTVlMTVkLTExYTYtNDRhZC05YzhjLTU4NmYyZjhhZjBlMyJ9.F2qOVWvbp1JseZ4GlB76wGG6NcMUV_aa7ZjH7XThbFU" class="fr-fic fr-dii" height="83"> Fig 20. Work Item Type Is a Quick Action checkbox (Not Required) - Will perform the action right at button press without prompting agents for fields to hit "Save". Ticket type fields required to be filled out in order for a work item to be successfully created from a ticket in Halo: <ul><li>Product - This can be defaulted against the ticket type in Configuration > Tickets > Ticket Types > Click into desired ticket type.</li></ul><img width="438" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNmMmRjMGNhLWJlNGUtNGEzMC05MDJhLTMzZDkxZDVjY2M5ZSJ9.2cLft211AXfwXOl4m_qDtxXt78B_tvBQXnzgNUPs5ZQ" class="fr-fic fr-dii" height="376"> Fig 21. Default product field Required for Halo to know which project in Azure DevOps to create a work item under. You can also set the “Product” field against the bug-creating action and set it as mandatory to ensure this field is filled in prior to completing the action. Syncing Action Notes to Azure DevOpsIt is possible to sync additional action notes from Halo tickets to work items in Azure DevOps. To do this you must perform a preconfigured action with the Send to Azure DevOps checkbox. This must be checked at the time of the action to send the new note to the correlating work item in Azure DevOps. <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFmYzc0NzVjLWZlNjctNGJlYS05NmFlLWY2OGNmYTJjNjA3ZiJ9.E5m18PRXJ1_pjjd29kQmaYo033kJSTmeeSItlBkQSG4" class="fr-fic fr-fil fr-dib" width="452" height="187">Fig 22. Send to Azure DevOps field Please note that it is not possible to push a comment to DevOps in the same action as creating a work item. Tip: Create an action that has all fields you are syncing between Halo and Azure DevOps. This gives you one place to make any necessary changes in Halo. <img width="1222" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjllOWQ3MDUxLWE5OGQtNGI5Yi1iYTFlLWY3NDU0MzJkZTFlYSJ9.r3LYOeWuxSh2aqxgx7mz7NyAaqnc4zByLNu2Vlo_1UQ" style="border-style: none; padding: 0px 1px; text-align: left;" class="fr-fil fr-dib" height="312">Fig 23. Action field list However, if you're doing this, please note that the Send to Azure DevOps field only controls when a comment is posted to the work item. If adding an action and altering other fields, even if the Send to Azure DevOps is unchecked, Halo will still push changes to other fields to the linked work item. Syncing to Azure DevOpsNavigate to the integration page’s "Syncing to Azure DevOps" tab and find the "Fields to Sync" subtitle. Here you can indicate which fields Halo should sync to DevOps as tickets/updated are created and updated. As you add these to the multi-select, you are then prompted to adjust their configuration below. <img width="624" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdjZGFkNTQ4LWZmMzAtNGU0ZS05ZWUxLTljZTZmYWYyN2I3MCJ9.c1ncmPNhaO2S9jHvhpfFTM694FP2CTDp7umjDirB7hw" class="fr-fic fr-dii" height="147">Fig 24. Fields to sync to Azure DevOps <ul><li style="font-weight: bold;">Any mapped Fields<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Syncs custom fields.</li><li>Choose product, which field in Halo, and which field in Azure DevOps.</li></ul></li><li style="font-weight: bold;">Area Path<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Work Item categorization field. Links to a category in Halo.</li><li>Choose Area Path value and correlating Halo Category Value.</li></ul></li><li style="font-weight: bold;">Attachments<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Syncs attachments.</li><li>No additional configuration is required. </li></ul></li><li style="font-weight: bold;">Iteration Path<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Work Item categorization field. Links to a category in Halo.</li><li>Choose Iteration Path value and correlating Halo Category Value.</li></ul></li><li style="font-weight: bold;">Priority<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Choose which priority number in Azure DevOps correlates to which priority number in Halo.</li></ul></li><li style="font-weight: bold;">Status<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Choose which Halo status correlates to which Azure DevOps status.</li></ul></li><li style="font-weight: bold;">Start Date<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Syncs start date.</li><li>No additional configuration is required. </li></ul></li><li style="font-weight: bold;">Target Date<ul style="font-style: initial; list-style-type: disc; font-weight: initial;"><li>Syncs target date (sometimes called end date).</li><li>No additional configuration is required. </li></ul></li></ul> Syncing from Azure DevOpsNow to configure this integration in the other direction! Namely, this would be to create a new ticket in Halo whenever a work item is created and to update Halo tickets which are linked to existing work items if those work items are updated. You can either configure this using webhooks or our Halo integrator. Webhooks allow for an almost instant sync, whereas the Halo integrator will run the sync on a schedule. The Halo integrator comes with an added benefit of allowing additional filtering.  WebhooksTo do this, you must create two Web Hook Subscriptions in Azure DevOps (one for creation and one for updating). Steps: Navigate to an Azure DevOps project and click "Project Settings" at the bottom-left corner of the screen. <img width="157" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRiZDllY2IxLTVjYWUtNGQ3MS05YTJiLTJhYWU2YzczMmFiZSJ9.VzX29YtFw8njPPm9DWBWmGCJLGg3pm5LcTHzzGNS8GE" class="fr-fic fr-dii" height="43">Fig 25. Project Settings). Click Service Hooks, then the + icon to create a new "Subscription", and select "Web Hooks" as the Service type. Click "Next". <img width="616" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZkZjA1N2ExLTAzNzktNGM4MC1iNDIyLWYzYmM3ZDRlZGZiYiJ9.2mYXIadowEM59Lf9VuBX5Qi4zz9VJWtXhQoy4xCwsjI" class="fr-fic fr-dii" height="609"> Fig 26. Webhooks Set the trigger to Work item created or Work item updated depending on which Web Hook Subscription you are creating. You may set more specific criteria for which work items trigger this new subscription or leave to all. Click Next. <img width="619" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFmOTJiZjdkLTA1ODgtNDgyYy1iMjM0LTU2ZDY0ZTJiN2Q4ZSJ9.Bn1clgNLzS_l4Gu06vkpi25cQ0E3arcI-3gbi7661v0" class="fr-fic fr-dii" height="613">Fig 27. Trigger (1) Is the URL this Web Hook Subscription will push information to and can be found on Halo's Azure DevOps Integration Page's "Syncing from Azure DevOps" tab by clicking Work Item Updated or Work Item Created.(2) Can be found in Halo’s Azure DevOps Integration Page’s "Syncing from Azure DevOps" tab.(3) Can be found in this same integration page by clicking Edit and Generate to create a new password. Just remember to click Save after you are done. <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE0MjUyODMyLWMyOGItNGFlZi1hN2ZiLTcxZDRlODY0ZWE2MiJ9.M9Cmscd_zvgPsu7WuEU3_fYI_JxRnCc5TgE3H7VyNT8" class="fr-fic fr-fil fr-dib" width="599" height="483">Fig 28. URL and authentication Set the rest of the page as follows and click Next.  <img width="538" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNjMWY4NmFkLWZlMzUtNDBhNC1hMDQyLWE2YTJjNmNjMTVmMiJ9.yp2fRBKkUnQ9tJLU6vjRdUHa2HeFd_b5010__1uc2O0" class="fr-fic fr-dii" height="423">Fig 29. Headers and what to send Click Test and ensure that connection is successful. Click Save and you’re done! Please note that the priority field value is not included in the work item created webhook unless manually changed on the new work item screen. To ensure consistent priority syncing, set the default priority of the ticket type in Halo to match the default priority value for work items in DevOps. Halo IntegratorTo use this syncing method, enable the checkbox 'Enable the Halo Integrator for the Azure DevOps integration' under the syncing from Azure DevOps tab. Then set the entities you would like to sync. You can choose how far back the sync checks for changes using the filed 'Check for work item updates for Tickets updated in the last X days'. For example, if I enter 5, when the sync runs any changes that have been made to work items in the last 5 days will update the related ticket in Halo, any changes older than 5 days will not update tickets.  To set which product in Halo a work item will be created under, use the work item filters. Found under the 'Syncing from Azure DevOps' tab, here you set filters in the table that will be applied to any work items syncing from Azure into Halo.  To set this up, add a filter to the table and choose which product the filter applies to. Then choose the field you would like to filter by and the operator. The operator determines if all the criteria in the table needs to be matched (AND), or only one criteria in the table needs to be matched (OR), for the filter to apply. Then set the filter type and the value. The available filter fields are: <ul><li>ID</li><li>State</li><li>Work Item Type</li><li>Area Path</li><li>Priority</li><li>Changed Date</li></ul>These filters will only apply to new work items being imported, updates to existing work items will still be imported only for work items linked to Halo tickets. Note: The Halo integrator must be enabled for the module for these filters to apply. <img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImFjMTNkZmJkLTgxZGYtNGI3NC1iNDU1LTVjOGM3ZDJjMjJjZiJ9.1EUWEHxY0Z3hqF0V5aIprJRplw-opp5mxj0XcY9tK8Q" class="fr-fic fr-fil fr-dib" width="1220" style="width: 1222px; height: 522.23px;" height="522">Fig 30.  Work items filter table Halo Configuration OptionsTicket Type for New Tickets<ul><li>Allows you to set which ticket type is initiated in Halo when the Azure DevOps Web Hook Subscription fires.</li></ul>User for New Tickets<ul><li>Allows you to set which user is assigned to new tickets coming from Azure DevOps.</li><li>You can also set this to default to the person who created the work item with below check box.</li></ul><img width="508" src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMwMTBlZTQ0LThhMWYtNDhkZS1hYTk0LTA3YWEzMDg5NTIzOCJ9.K6qNJmQFo5G2RziGwFIyhAWyYLPhGDm7uqGMlBtED4U" class="fr-fic fr-dii" height="395">  Fig 31. Additional configuration settings </body>

Feedback

Guide name here

Thank you! Your submission has been received!

Oops! Something went wrong while submitting the form.

One unified platform. Every team. Every workflow.

Tailored solutions for every industry.

Powerful capabilities, endless possibilities.

Browse Guides

Platform

Use Cases

Resources

Halo

Subscribe to Halo for latest news

Follow