<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><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 Halo Asset Discovery?</strong></p><p><strong>- Requirements of the Integration</strong></p><p><strong>- Connecting to Halo Asset Discovery</strong></p><p><strong>- Adding Mappings</strong></p><p><strong>- Optional Configuration</strong></p><p><strong>- Importing Assets</strong></p><p><strong>- Connecting to the Halo Integrator</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is Halo Asset Discovery?</span></strong></p><p>Halo Asset Discovery is the hosted cloud version of Lansweeper, allowing import and management of assets.</p><p><br></p><p><strong><span style="font-size: 14pt;">Requirements of the Integration</span></strong></p><p id="isPasted">This guide explains how to connect Lansweeper's Web Application with Halo's Asset Discovery integration. While demonstrated in trial instances, the setup for a connection between two production instances follows identical steps.</p><p><br></p><p>The following is required for setup of this integration:</p><p><br></p><ul><li>Purchase of Halo Asset Discovery via an agreement between your organization and Halo Service Solutions or a previous purchase of Lansweeper. </li><li>Lansweeper's Hosted Version known as "Lansweeper Sites"<em>.</em><ul style="list-style-type: disc;"><li>If your Lansweeper instance is hosted in an On-Prem SQL database instead of Lansweeper's Web App, we suggest considering a discussion with your Lansweeper representative. Explore the feasibility of transitioning to Lansweeper's hosted version, their flagship product featuring all the latest and future developments, along with robust support services.<ul style="list-style-type: disc;"><li>For connecting On-Prem SQL Database Lansweeper instances:<ul style="list-style-type: disc;"><li style="font-weight: bold;"><a href="https://usehalo.com/haloitsm/guides/1073" rel="noopener noreferrer" target="_blank"><strong>Lansweeper Integration (ITSM)</strong></a></li><li style="font-weight: bold;"><a href="https://usehalo.com/halopsa/guides/1073" rel="noopener noreferrer" target="_blank"><strong>Lansweeper Integration (PSA)</strong></a></li></ul></li></ul></li></ul></li><li>Lansweeper to be setup (Please contact your designated Custmer Success Manager to assist with this).</li></ul><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjliODZhNDAzLTI5MzItNDdmMS1iOTE5LTc5YjE5MzM5MGZlNyJ9.6_bqpwmDoxPrVsDK6gzcMyF5HaOjM-QiWyoomZ-fjlI" class="fr-fic fr-fil fr-dib" width="1218" style="width: 1220px; height: 603.426px;" height="603"></p><p><strong><span style="font-size: 10pt;">Fig 1. Lansweeper setup.</span></strong></p><p><br></p><ol><li>Site prepared.</li><li>Scanning device.</li><li>Assets processed.</li></ol><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Halo Asset Discovery</span></strong></p><p>Navigate to your Halo Asset Discovery integration setup page. You can find this in Configuration > Integrations > Halo Asset Discovery or <Halo Agent Portal URL>/config/integrations/haloassetdiscovery.</p><p><br></p><p>Click "Authorize Application".<img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZkMjI2NzEyLTYxYzctNGVjNC1hYmYxLTFkNmE3ODhmNjNiMCJ9.3U5Ih-TXE0WddV7o-RqszeU3HnboXuI0utBWDED86_0" class="fr-fic fr-fil fr-dib" width="339" height="221"></p><p><strong><span style="font-size: 10pt;">Fig 2. Authorize Application button.</span></strong></p><p><br></p><p>This will redirect you to your hosted instance of Lansweeper. You will then be redirected back to Halo where you can start making specific configuration changes.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImU0NTc3Yzk1LTk1NDAtNGQ1ZS1hYTBiLWVhMjE5ZWQ2YmFmNSJ9.TXa9iDp3IOy3253uUsaZchuD84SKrw6QY_xVpMOxULc" class="fr-fic fr-fil fr-dib" width="536" height="379"></p><p><strong><span style="font-size: 10pt;">Fig 3. Connected Halo Asset Discovery instance with a connection type set.</span></strong></p><p><br></p><p>Choose a connection type from the below.</p><p><br></p><ul><li>REST API (Representational State Transfer API) - <strong>Recommended</strong>.<ul style="list-style-type: disc;"><li>REST APIs are designed to provide a standardized way for clients to interact with a server or web service, enabling CRUD (Create, Read, Update, Delete) operations on resources through the use of HTTP methods and URLs.</li></ul></li><li>Export API.<ul style="list-style-type: disc;"><li>Export APIs are primarily focused on allowing users or external systems to extract data from a system or application in a structured format, such as CSV, Excel, or XML, often including features like pagination and filtering to facilitate data retrieval.</li></ul></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">Adding Mappings</span></strong></p><p>Click the "Add" button under the "Site Mappings" table to configure Halo to import assets from a specific site in Lansweeper to a specific site in Halo.</p><p><br></p><p>The "IP Address" criteria can be set within a range here.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQzZDY2OGEyLTZkZDctNDRiZi05MWNmLWRlMmNhY2RmOTc2MSJ9.wtIV65QMrumvQFUwJT-RxjfNdK1iL0lI-KgjbTPhuvA" class="fr-fic fr-fil fr-dib" width="1211" style="width: 1213px; height: 218.912px;" height="219"></p><p><strong><span style="font-size: 10pt;">Fig 4. Site Mappings table.</span></strong></p><p><br></p><p>The following popup will then show to configure the mapping.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImEyNzBlZTM1LTAwY2UtNDNiZi1hOTMyLTY1NDI0Nzc3NjJkNSJ9.stPo0Vkxn93vL-Vl5L0bDnBLf2CSFXvko3wUgv59LBg" class="fr-fic fr-fil fr-dib" width="713" height="333"></p><p><strong><span style="font-size: 10pt;">Fig 5. Adding site mappings.</span></strong></p><p><br></p><p>There is also the ability to route to different sites based on site rules. To utilise these rules you will need to set up a mapping under Site Mappings using the value '*Determine site via rules*'</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ5NTBkYmU0LTAyODctNDk2ZC1iNTA0LWVkYzBlNjUzZjc2NyJ9.jy6ngnF4KQMiaihTe5-MEY90hMP1HRk1ydjBQzrtxBw" class="fr-fic fr-fil fr-dib" width="432" style="width: 432px; height: 201.146px;" height="201.146"></p><p><strong>Fig 6. Determine Site via Rules</strong></p><p><br></p><p>When this is set, you can create new site rules, via the site rules table, such as the criteria for a certain IP range.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjVhMTJiOWU3LTA4NDEtNGVkMi04ODczLWRkOTNjM2FiYzQ4YyJ9.92c7sLg80OpyrcjyI7ZpmS5leIijymVxXi6q6_Xt8WE" class="fr-fic fr-fil fr-dib" width="681" height="385"></p><p><strong><span style="font-size: 10pt;">Fig 7. Criteria for Site Rules</span></strong></p><p><br></p><p>Now if the imported asset matches an IP address within this range, it will be routed to the Halo House site</p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImUyMDVjM2M4LWNhODQtNDU5Ni1hMWQxLWZkOGYyYTY1YTg0ZiJ9.Uhxmaf0AqvhH3qgHtaw9qX3XzcIOXeieXEvgR8rYoYo" class="fr-fic fr-fil fr-dib" width="682" height="408"></p><p><strong><span style="font-size: 10pt;">Fig 8. IP Address Range Criteria for a Site Rule Mapping</span></strong></p><p><br></p><p>When importing new assets, Halo will match entries onto the asset types that live in Halo at the time of the sync. If an asset type in Lansweeper does not exist in Halo, Halo will create a new asset type. You must configure which asset group that new asset type is generated under.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc0OWUxMDlhLTMwNDktNDk5NS1hZTdkLWE3MzhmN2ZmOWZkNiJ9.sbOC-L4HOeBoKDx61ilPw_do_-1ci2IVtkroO88chaY" class="fr-fic fr-fil fr-dib" width="512" height="145"></p><p><strong><span style="font-size: 10pt;">Fig 9. Setting a default group.</span></strong></p><p><br></p><p>Field mappings are the rules which tell Halo <strong>what</strong> information to pull from Lansweeper and <strong>where </strong>to store the information once the asset is brought into Halo. Click "Add" on the "Field Mappings" table to start building our your field mappings.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRiN2FhNDQ4LTE5MTEtNGNiNi05YjQ2LWY0ZDBjYTQ0ZWRmZiJ9.bxIkPuVO0uuShhhlFgBZW-lw_KYONnQDj821GeTkmJw" class="fr-fic fr-fil fr-dib" width="1221" style="width: 1223px; height: 119.236px;" height="119"></p><p><strong><span style="font-size: 10pt;">Fig 10. Field Mappings table.</span></strong></p><p><br></p><p>The popup to configure the mapping will then show ash shown in figure 11.</p><p><br></p><p>For example, the field "isRunning" from "Virtual Machine" can be mapped to indicate if the virtual machine is currently powered on.</p><p><br></p><p>From v2.236+ you can map "operatingSystem.name" to bring the Operating system's name into a field in Halo. </p><p><br></p><p>From v2.240+, OIDdata can be mapped here. You can specify which OID key you would like to import and the corresponding value will be mapped into the selected field.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk3NzZlMDcyLTllYjItNDUyNS04MTNiLTA4YjI4YjgzOTg5NSJ9.kt7VYJG6rTWWU6p4tCpCxDqXStMV1O3ieMcv8YDmnPA" class="fr-fic fr-fil fr-dib" width="713" height="573"></p><p><strong><span style="font-size: 10pt;">Fig 11. Adding field mappings.</span></strong></p><p><br></p><p>You can select among various "Halo Asset Discovery Field Type" (Categorizations of fields from Lansweeper) and then select the field itself. Then you designate which Halo field this will come in as. </p><p><br></p><p><strong><em>Note: If mapping to "*Create a new Field during the next import*", it will to auto-match onto Halo fields with the same name as the Lansweeper field. If no field exists with the same name (name has to be exact match), the a new field will be auto-generated to store the information.</em></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Import Network Security Groups</span></strong></p><p>Information can be imported from the Resource Group > Network Security Groups field. As this field contains multiple entries of data in Lansweeper you will need to create an asset table in Halo to store this data and map the asset discovery fields within Network Security Groups to columns in this table. </p><p><br></p><p>For information on creating custom tables, see our guide <a href="https://usehalo.com/haloitsm/guides/2037" target="_blank" rel="noopener noreferrer">here</a>. You will need to create an asset custom table, with the same number of fields (columns) as the number of fields you would like to bring in from Lansweeper. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY5ODEyYThkLTNjZmItNGVkZi1iYWRjLTZhM2Q1YTE1NjFkMyJ9.x5cINgaC1uZhO_Y59qcvU_4nGBADlwQbZOSMpDTZkWw" class="fr-fic fr-fil fr-dib" width="1235" style="width: 1237px; height: 413.397px;" height="413"></p><p><strong><span style="font-size: 10pt;">Fig 12. Custom table in Halo.</span></strong></p><p><br></p><p>To use this table it will need to be stored in an asset custom field. </p><p><br></p><p>Once created you can map the custom field (storing the table) in Halo to the networkSecurityGroups field. Once mapped an additional table will appear allowing you to complete field mappings. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjM2MjczYWVhLTI4ZjQtNGUzOC1iOGRjLTQzNTgxYTNiZjBmYSJ9.xxHw3H67igkmnUInHlT3t1AteYwTna8_j3jJFg7F2aI" class="fr-fic fr-fil fr-dib" width="561" style="width: 563px; height: 588.518px;" height="589"></p><p><strong><span style="font-size: 10pt;">Fig 13. Field mapping for Network Security Group.</span></strong></p><p><br></p><p>In the field mappings table, map fields within the custom table to a Lansweeper field. This will be the field in the table the data from Lansweeper will be imported into. </p><p><br></p><p><strong><span style="font-size: 12pt;">Asset Matching</span></strong></p><p>Set the asset matching field. This field tells Halo what value to watch out for in case the same exists in its database already. In that case, Halo would update an existing asset in your system rather than creating a new one (potentially duplicating assets).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjliYzVmNDBjLWRkNTAtNDJmMC04OGYzLTdjODI5N2Y3NzIzZSJ9.-T0YPBW0mSYtkhSiH_-8NayVTdgbUB8bv37_MOuqv6c" class="fr-fic fr-fil fr-dib" width="891" height="99"></p><p><strong><span style="font-size: 10pt;">Fig 14. Setting an asset matching field.</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">Determining an Asset's Type</span></strong></p><p>Setup the asset type matching logic. You can set one of three options.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEwMDEzYmU4LTQ3M2UtNGM2Yy1hMDg2LTI2OTBkYmEwYTgzYSJ9.zei1GiRnrlrGoQutgU_-xYPVto08MN_puLBaCQOq-Qk" class="fr-fic fr-fil fr-dib" width="309" height="167"></p><p><strong><span style="font-size: 10pt;">Fig 15. Setting the method to determine asset type.</span></strong></p><p><br></p><p>This is for the simple import where every asset from Lansweeper should be imported as a single asset type. Once selected, you will be prompted to select an asset type for assets to be imported into Halo as.</p><p><br></p><p>This allows you to differentiate the asset type of the asset based on a field against the asset type. At the moment, this option only allows you to select the "Type" field from Lansweeper. This field is intended to match well with the type field in Halo. This configuration is most commonly used.</p><p><br></p><p>This allows you to write additional logic to decide which assets come in as what asset types based on rule sets. When selected you are prompted with the below table. Click "Add" to create a new rule. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI0ZTZiMzAwLTZjYTEtNGI4Yy04NGVlLTE1OWRjMWIyODEzNyJ9.hKRLKYrl0JTotB4voRar7wGxXmIu4QmghpZnqKWpPjA" class="fr-fic fr-fil fr-dib" width="1208" style="width: 1210px; height: 359.244px;" height="359"></p><p><strong><span style="font-size: 10pt;">Fig 16. Asset type configuration.</span></strong></p><p><br></p><p>The popup will then show to configure the asset type mappings.</p><p><br></p><p id="isPasted">You select which asset type this rule matches to. Multiple conditions can be added in the criteria table.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhjMTYyMGU0LWU4MmQtNGQ0OS04ODEwLTdmM2NlMDIwY2MzMiJ9.2PDoDC6kKpnD8uWNvLN6zyzaLyYFC3_HkgZr7-P2JKQ" class="fr-fic fr-fil fr-dib" width="704" height="584"></p><p><strong><span style="font-size: 10pt;">Fig 17. Adding asset type mappings.</span></strong></p><p><br></p><p>Also with this selection, you are able to tell Halo to not pull any assets that do not match a rule.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNkYTAxMWQ5LTFjMjktNGViZC1iN2MxLTMyZGI4Y2M0YjNhMyJ9.0h93gIl4sORm58G6yPfF96M8_ySLQIi7q-ERbwzYeVM" class="fr-fic fr-fil fr-dib" width="340" height="72"></p><p><strong><span style="font-size: 10pt;">Fig 18. Setting to not import assets if they do not match rules set.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Optional Configuration User Matching</span></strong></p><p>Assets imported from Halo asset discovery can be matched to the correct user in Halo on import, based on their user in Lansweeper. You can toggle this functionality on and off using the setting "Allow User matching".</p><p><br></p><p>When user matching is enabled you can choose which field will be used to match users in the 'User Matching Field'. However, regardless of how this field is set user matching will always be attempted on the username, email, and network login fields. </p><p><br></p><p>Under the user matching field you will see additional settings that control how user matching functions, shown in figure 19. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjAxMTg1YWUzLWJjZmMtNGJkOC1hZDE2LTNiNmQyYTQzZDg5ZSJ9.SH5r_MKD7wj3c5x77aGNeYCVDDzjQwOFtnqeccYL8y4" class="fr-fic fr-fil fr-dib" width="1019" style="width: 1021px; height: 713.521px;" height="714"></p><p><strong><span style="font-size: 10pt;">Fig 19. User matching and optional configuration.</span></strong></p><p><br></p><p data-pasted="true"><strong>User Assignment Behaviour - </strong>This controls how users are assigned to assets when a matching using is found. </p><ul><li>Add User to Asset's existing Users - When chosen, any matched users will be added to the asset's users in Halo, in addition to any users already assigned to the asset in Halo. Use this when assets are allowed to have multiple users assigned. </li><li>Remove existing Users and replace - When chosen, any matched users will be assigned to the asset in Halo, replacing any users currently assigned to the asset. Use this when Lansweeper is the source of truth for the users assigned to assets. </li><li>Ignore if Asset already exists - When chosen, if the asset being imported is matched to an existing asset in Halo, the asset in Halo will not be assigned a user. Use this if Halo is the source of truth for users assigned to assets and you are managing assigned users directly in Halo. </li></ul><p><br></p><p>Partial user matching is available with the checkbox 'Allow partial matching on the email address, network login and User matching fields'. When enabled, partial matches are made if an exact match cannot be found: first based on the network login, followed by the email address, and then matching field (provided one is set in the "User Matching Field" dropdown).</p><p><br></p><p><strong><span style="font-size: 12pt;">Enable user matching for certain asset types only</span></strong></p><p>You can restrict asset user matching to selected asset types in Halo. This allows you to have certain asset types match to their corresponding user, but have others not matched, therefore not assigned to a user. </p><p><br></p><p>To do this you will need to disable user matching for halo asset discovery globally. This is done using the setting 'Allow User matching' (as seen in figure 19), disable this. </p><p><br></p><p>When disabled now head to the asset type in Halo you would like user matching to be enabled for, configuration > asset management > asset types > select an asset type > details tab > enable 'Allow User matching for this Asset Type for the Halo Asset Discovery integration'. </p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNmZDdiYTEzLWU0N2QtNDM2Yy04ZmJjLTY0NDAwNzY3MzNkNCJ9.tnzTD1Bt50UCaxhkbwel0FowAqDjUD4hlpjRN8p1Ero" class="fr-fic fr-fil fr-dib" width="923" style="width: 925px; height: 721.83px;" height="722"></p><p><strong><span style="font-size: 10pt;">Fig 20. Allow User matching for this Asset Type for the Halo Asset Discovery integration.</span></strong></p><p><br></p><p><strong><em>Note: This setting will only appear against asset types when user matching is disabled against the Halo asset discovery integration. </em></strong></p><p><br></p><p>When this option against the asset type is enabled, next time assets of this type are imported from Lansweeper/Halo asset discovery, a user will be attempted to be matched to the asset. </p><p><br></p><p><strong><span style="font-size: 14pt;">Importing Assets</span></strong></p><p>The method differs based on the API method being used.</p><p><br></p><p><strong><span style="font-size: 12pt;">Export API</span></strong></p><p>Click the "Export Data" button to begin an export of site information from Lansweeper. This is a required step prior to importing asset entries.</p><p><br></p><p id="isPasted">Once exporting has begun, you can check the progress of your export in the table below it.</p><p><br></p><p>You can then use the "Import Assets" button to run a manual import (optional).</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY2MWRjNmUxLTU0MzMtNGE1OC04Y2QxLTMxZmE3MDY4OTlmMyJ9.SxSqpmuXQgLbREB-hEdF64m-gjYO6Qo6yBUUJpHGb4c" class="fr-fic fr-fil fr-dib" width="1214" style="width: 1216px; height: 455.866px;" height="456"></p><p><strong><span style="font-size: 10pt;">Fig 21. Asset Imports when set to Export method.</span></strong></p><p><br></p><p><strong><span style="font-size: 12pt;">REST API</span></strong></p><p>When set to the above, assets can be manually imported for mapped sites. Click "Import Assets" to bring up the import screen.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjllOGE3YTkzLTU3ZGQtNDQ0NS1hYWFlLTA4NDc5YzRmZTMwOSJ9.uig6-m4jNrYWDOavYX0S1aPP5XOM4vnggIvZKKAJGhA" class="fr-fic fr-fil fr-dib" width="1116" height="208"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 22. Asset Imports when set to REST method.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to the Halo Integrator</span></strong></p><p id="isPasted">Check the below box to enable this integration for the Halo Integrator to run when its schedule permits.</p><p><br></p><p>It is worth noting, the Halo Integrator is generally a hosted application which Hosted customers of Halo Service Solutions will already have setup for them. If you have questions regarding the state of your Halo Integrator application, please reach out to your dedicated support team. You can find support information by going to the agent portal and hitting the '?' on the top right of your screen.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRjODc5NGI1LTFiMzAtNDU1Yi1hYjIwLWU5MTIzOGM4ZDQzMCJ9.my5GXSkZZ6YieF1tx1hT7KoRU7T78taDevLYnNrqRJE" class="fr-fic fr-fil fr-dib" width="806" height="199"></p><p><strong><span style="font-size: 10pt;">Fig 23. Enabling the Halo Integrator.</span></strong></p>
