<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;}.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><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the ServiceNow Migration Tool?</strong></p><p><strong>- Getting Details from ServiceNow</strong></p><p><strong>- Connecting to ServiceNow</strong></p><p><strong>- Importing Data</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the ServiceNow Migration Tool?<br></span></strong></p><p>The ServiceNow migration tool can be used to bring over data from a ServiceNow instance into Halo. It can migrate companies and locations, users, articles, incidents, problems, change requests and service requests.</p><p><br></p><p><em><strong>Note: To import, the user (you) will need full API access within ServiceNow, and you will need read/write/modification access to the information that is being imported. </strong></em></p><p><em><strong>You need to be a user with "Web service access only" set against your profile.</strong></em></p><p><em><strong><br></strong></em></p><p id="isPasted"><em><strong>You will need roles that will allow access of information from:</strong></em></p><ul><li style="font-weight: bold; font-style: italic;"><em><strong>Core company.</strong></em></li><li style="font-weight: bold; font-style: italic;"><em><strong>User groups.</strong></em></li><li style="font-weight: bold; font-style: italic;"><em><strong>Users.</strong></em></li><li style="font-weight: bold; font-style: italic;"><em><strong>Choices.</strong></em></li><li style="font-weight: bold; font-style: italic;"><em><strong>Journal fields.</strong></em></li><li style="font-weight: bold; font-style: italic;"><strong><em>Incidents.</em></strong></li></ul><p><strong><span style="font-size: 14pt;">Getting Details from ServiceNow</span></strong></p><p>The first step is to get the login details from ServiceNow. Click onto your profile picture, and navigate to "Manage Instance Password".</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhkYmMwOTIzLTIzMjUtNDYzZi1hYjQyLTkwNWU1NTk0ZDUxNiJ9.YBU1YQlpI-aThDoADgrK6T6kaEDM3b4drLwIAhD-oRA" class="fr-fic fr-fil fr-dib" width="1214" style="width: 1216px; height: 509.562px;" height="510"></p><p><strong><span style="font-size: 10pt;">Fig 1. Getting the password details.</span></strong></p><p><br></p><p>A popup will then show. Make note of these credentials and copy the instance URL, Username, and Password.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM4MzA4NTFhLTg3YmUtNDlkNS04OTMyLTg3MGUwMGY3YzUwMSJ9._FlVIb7Y5gqwRHNa-OlaOTyNae7uIERd2O2D9x6wXa0" class="fr-fic fr-fil fr-dib" width="984" style="width: 986px; height: 555.536px;" height="556"></p><p><strong><span style="font-size: 10pt;">Fig 2. ServiceNow login details.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to ServiceNow</span></strong></p><p>Now back to Halo. In Configuration > Migrations, open the "ServiceNow Migration" module. You will be faced with this screen to enter the details you previously made note of. Enter the URL, username, and password into their corresponding boxes. </p><p><br></p><p><strong><em>Note: Locale is left empty, unless using a multi-tenanted ServiceNow instance and you only want to import data from one instance.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVhNTczZGY1LTdhNTktNDQwNi05YmYwLWQ3YTYyOTJhZjE3MiJ9.B5Q6HrEVJ_wpm0eGXinPFEj0eiDiD0wztXPkDZ9hWYE" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 301.803px;" height="302"></p><p><strong><span style="font-size: 10pt;">Fig 3. ServiceNow Details fields.</span></strong></p><p><br></p><p>You can then click the "Test Configuration" button that shows underneath. It will load for a minute, and if successful, the following popup will show.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNiNWI3ZWZmLTQ3ZjMtNGQ1My1hMDE1LTJkNDI2Mzg1NjdkMSJ9.KYHppyQOabn7BqbSUPLiztMuTCgWEvuTAkHOD67Dvc4" class="fr-fic fr-fil fr-dib" width="170" height="117"></p><p><strong><span style="font-size: 10pt;">Fig 4. Test successful popup. </span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Importing Data</span></strong></p><p>Once connected, you can then import your relevant entities. Here, I have selected to import incident tickets, and can then click the "Import Now" button.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjlhZGZjYTRhLWUxZTctNDNlNi1iYzI2LTY3YmQwZmZiOTdkZiJ9.3puXYtw73sIc4oWOPwKHJj5JyCO3suAykRyZhBpNmy4" class="fr-fic fr-fil fr-dib" width="1212" style="width: 1214px; height: 229.698px;" height="230"></p><p><strong><span style="font-size: 10pt;">Fig 5. Migrate Data from ServiceNow configuration.</span></strong></p><p><br></p><p>A popup will then appear to configure relevant settings for that entity. For instance, importing customers will show options to select a top level if that is enabled, users will show selection of a default site, or articles will show selection of an FAQ list to add them to.</p><p><br></p><p><strong><em>Note: From v2.234+ you will be able to filter which articles are imported, based on their status. Allowing you to import only articles that are open (active) in ServiceNow. </em></strong></p><p><br></p><p>For the example below, incidents required selection of a ticket type to import them as, which statuses to import, and a minimum creation date. This configuration will import the tickets as "Incident" ticket types, will import all tickets regardless of their status, but only those created after February 1st 2025.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU2YzFhZGRjLWIxYWEtNDlmOC1hMjU3LTNhZDRjZmYxNGE4NyJ9.RnFaHzm_MvcLpD29VytqnlGNz6N9Q2E0UlDNzN0_QqU" class="fr-fic fr-fil fr-dib" width="708" height="522"></p><p><strong><span style="font-size: 10pt;">Fig 6. Incidents popup to configure the import.</span></strong></p><p><br></p><p>Upon clicking the "Save" button, the import screen will appear showing items of the entity that meet that condition. By default, all will be selected to be imported, but individual ones can be set if wished. Click "Start" and let the import run. Depending on how many items that entity contains, this may take a while.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU1MGNjZDRiLTkxMzEtNDE0YS1hNDk3LWNiZWExNWZlYjEwYyJ9.soPpPxTiaYZ6omvUvJUT6tBSgCOA_vYNjlHNhJ6q_qk" class="fr-fic fr-fil fr-dib" width="1221" style="width: 1223px; height: 575.417px;" height="575"></p><p><strong><span style="font-size: 10pt;">Fig 7. Import screen.</span></strong></p><p><br></p><p>After the sync is finished, the import is completed. Below is an example ticket that has been imported via the above. The "ServiceNow Number" field shows in the "Ticket information" on the right hand side, and the summary, details and SLA have been mapped based on the import. It has been assigned the ticket type that was set in <strong>Fig 6</strong>.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFkMjMxYzc4LTUxMjAtNDg2ZC05NTBkLTk5NmZhNjlmNWUyNiJ9.K8peToP7B8vh1QjWnawZHFqoRuNiR-Pc2UPr9synJ44" class="fr-fic fr-fil fr-dib" width="1223" style="width: 1225px; height: 576.057px;" height="576"></p><p><strong><span style="font-size: 10pt;">Fig 8. Imported incident ticket from ServiceNow into Halo.</span></strong></p><p><br></p>
