<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 id="isPasted"><strong>In this guide we will cover:</strong></p><p><strong>- What is the Alemba Migration Tool?</strong></p><p><strong>- Connecting to Alemba </strong></p><p><strong>- Importing Data</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Alemba Migration Tool?</span></strong></p><p>The Alemba migration tool can be used to import data from your Alemba instance into Halo. It can import the following by connecting via your Alemba credentials and a Client ID.</p><p><br></p><ul><li>Organisations</li><li>Users</li><li>Articles</li><li>Tickets</li><li>Change Requests</li><li>Tasks</li></ul><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Alemba</span></strong></p><p>Navigate to Configuration > Migrations, where you will find the Alemba module. Click into this.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI1YzUwOGU1LTVkYWMtNDY0MS05ZGQwLTFhYTcwZTdkNTgwMSJ9.75evtza_pEFnv_AbqVfnWZ2otEHXCJg-WXlSeDlMQdA" class="fr-fic fr-fil fr-dib" width="545" height="173"></p><p id="isPasted"><span style="font-size: 10pt;"><strong>Fig 1. Alemba migration module.</strong></span></p><p><br style="box-sizing: inherit;"></p><p>The first step is to enter your Alemba details, starting with your URL.</p><p><br></p><p>You will need to configure an API client that allows password authorisation in Alemba, and instructions to do so can be found <a href="https://docs.alemba.com/asm-legacy-product-documentation/integrate/apis/alemba-restful-api/authentication/configuring-authentication-for-the-alemba-api" target="_blank" rel="noopener noreferrer"><strong>here</strong></a>. These details can then be entered into Halo.</p><p><em><strong>Note: Do not log in with these credentials during the process of the import, as this will invalidate the access token and stop the sync from progressing correctly.</strong></em></p><p><br></p><p>You can then click the "Test Configuration" button to ensure the connection is correct, before moving onto the import stage.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br style="box-sizing: inherit; color: rgb(0, 0, 0); font-family: Poppins, sans-serif, Roboto; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; white-space: normal; background-color: rgb(255, 255, 255); text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;"></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjUxMGU2Y2I0LTMwMzgtNDc3ZS1hNjY2LWNlMTA5NmFjZmQ0YSJ9._1ix8hLzAsjq2OOw9pLMXKOoQ_OIa8Z8WCjOoa_0G2I" class="fr-fic fr-fil fr-dib" width="1211" style="width: 1213px; height: 262.093px;" height="262"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 2. Alemba connection.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Importing Data</span></strong></p><p>You can now configure your migration. The first option is a button for "Migration Exclude Values". This is where you can configure a list of action types to be excluded from the import.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjMzNjdkZWY0LTc4YjAtNDI3My05MGRmLTQ3MjRlMWM5NzViYiJ9.wf5IRQMae9_WcGTEWcMCSjGk61APjfI-SW_4mZC7U3k" class="fr-fic fr-fil fr-dib" width="1212" style="width: 1214px; height: 182.427px;" height="182"></p><p><strong><span style="font-size: 10pt;">Fig 3. Migration Exclude Values button.</span></strong></p><p><br></p><p>Clicking into this will show a list of Action Types to exclude, and additional ones can be added here.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjdjNGU5NDBmLTlkNDYtNDM4Yi04ZDAxLWRhODJkNGZiMGMyMyJ9.D-qGC4SKpjUv8nWnZJ65Jhot0DWCzTIdxcVNfG0gDms" class="fr-fic fr-fil fr-dib" width="230" height="235"></p><p><strong><span style="font-size: 10pt;">Fig 4. Migration Values.</span></strong></p><p><br></p><p id="isPasted">Going back to the main Alemba module, you can select an Alemba Entity to import from the dropdown, and click "Import Now" to bring up the import screen.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI1ZDdlZTM0LTM5ZTAtNDg2My1iZTViLWU2YzBjNGMxNTA5OCJ9.K5_jEjF8u1KaWS2HhtQFSLXxTqbzSQvNsbozpen4DMQ" class="fr-fic fr-fil fr-dib" width="732" height="148"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 5. Selecting an entity to import.</span></strong></p><p><br></p><p>With some entities, a popup will show before the import screen to set configuration for the imported entities. For example, "Tickets" will ask for a Ticket Type default, as well as what Statuses and Dates to include on the import.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM0NDc3Y2JmLWRjNzMtNDM2NC04MDFkLTg1N2Q1ZmRlMGRmZSJ9.Hwhk7cKwPtmxnQet57fTHYIwEMH3nIeyI_5DUPSt8kQ" class="fr-fic fr-fil fr-dib" width="711" height="555"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 6. Configuring the entity defaults.</span></strong></p><p><br></p><p>Upon saving, the import screen will then show for that entity. By default, all rows will be selected for import, but you can unselect all by clicking the checkbox at the very top (in line with the column headers), and then checking the ones you do want to import.</p><p><br></p><p>Once set, click the "Start" button in the top right.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM4MTQwZTBlLWNlN2UtNDNkZC04ZWExLTY1OTI3NDhiNTE5MCJ9.FzswfMEcwEWltOfLhfyLH2L7jvIjLdwGuDBu8Ccqu7g" class="fr-fic fr-fil fr-dib" width="1217" style="width: 1219px; height: 131.94px;" height="132"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 7. Import screen.</span></strong></p><p><br></p><p>Repeat this process with each entity you wish to import.</p>
