<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 id="isPasted"><strong>- What is the Raynet Integration?</strong></p><p><strong>- Determine Asset Site</strong></p><p><strong>- Asset Imports</strong></p><p><strong>- Import Assets automatically on a schedule</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the Raynet Integration?</span></strong></p><p>The Raynet integration with Halo can be used to import sites and assets from Raynet into Halo. Assets and sites can be set to import automatically on a schedule so that any changes made to assets in Raynet sync over to Halo automatically. This integration is multi-tenanted, allowing you to connect multiple Raynet tenants to your Halo instance. </p><p><br></p><p><strong><span style="font-size: 14pt;">Connecting to Raynet</span></strong></p><p id="isPasted">First head to Configuration > Integrations and enable the Raynet module.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjRiNWZhZjg2LTgyMzYtNDk1MC04MjU1LTBlODgyMzY2MDAwZSJ9.DrJXMdLsSDCYmg0Z6kN5Jp4Zb0ENfVtyqCRt_yNURZ8" class="fr-fic fr-fil fr-dib" width="290" height="153"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 1. Enable integration module.</span></strong></p><p><br></p><p>Once enabled click into the module to begin configuration. Click new to create a new connection.</p><p><br></p><p>Now you will need to enter connection details to connect your Halo instance to Raynet. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY1NGFmOWQxLTZiN2ItNDY5Ny1hZGExLTgzZjQ0ODcxYmQ2NyJ9.HVsLCspgbvUB2twj-oAArNr_DJeorAM3ZIZ6AZY8F4E" class="fr-fic fr-fil fr-dib" width="1223" style="width: 1225px; height: 298.153px;" height="298"></p><p><strong><span style="font-size: 10pt;">Fig 2. Raynet connection details</span></strong></p><p><br></p><p id="isPasted"><strong>Name </strong>- Here, give your connection a sensible name. </p><p><strong>URL </strong>- Here, enter the URL of your Raynet instance. </p><p><strong>API Key </strong>- Here, enter an API key you have generated in Raynet. </p><p><br></p><p style="margin-left: 20px;"><strong><span style="font-size: 12pt;">Generate an API Key in Raynet</span></strong></p><p style="margin-left: 20px;">To create an API key head to your Raynet instance > Profile > manage API keys > add new key. </p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImJhMzc0ZWQ0LTc1ZDItNDcyYy04MWQyLWUyOTZkNGU5ZTAyYyJ9.bTvela2VgOOcwBBF_VujNS4EWAHfi16ozvO8dGmHaPQ" class="fr-fic fr-fil fr-dib" width="888" style="width: 890px; height: 431.874px;" height="432"></p><p style="margin-left: 20px;"><strong><span style="font-size: 10pt;">Fig 3. Create API key in Raynet.</span></strong></p><p style="margin-left: 20px;"><br></p><p style="margin-left: 20px;">The permissions given to the API key will be inherited from the user that generated the API key. Therefore, the user generating the key will need to have an administrator permission. </p><p><br></p><p><strong><span style="font-size: 14pt;">Determine Asset Site</span></strong></p><p>Now head to the 'Sites' tab. Here, you will need to configure how assets created by Raynet are assigned to sites in Halo. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjQ3OWE1MzI5LWY1NWEtNGY0ZC04YTY1LTYxNWIwNmIyYjI2NCJ9.fabcepnhHGa22S6uIoDxv6HkbNvea2biRZCmngF-XGg" class="fr-fic fr-fil fr-dib" width="1219" style="width: 1221px; height: 528.932px;" height="529"></p><p><strong><span style="font-size: 10pt;">Fig 4. Configure asset imports.</span></strong></p><p><br></p><p><strong>Site matching method</strong> - Here, choose how sites are imported and asset site allocation is configured. </p><ul><li><strong>Import and map sites from Raynet to sites in Halo</strong> - When selected Raynet sites can be mapped to Halo sites. Assets will be created under the site in Halo that is mapped to the site they are under in Raynet.</li><li><strong>Site Rules</strong> - When selected rules can be created, based on asset properties, that determine the Halo site assets are created under. </li></ul><p><br></p><p><strong><span style="font-size: 12pt;">Determine site by mapping Raynet and Halo sites</span></strong></p><p>Use site mapping when your assets in Raynet are currently organised into sites in line with your sites in Halo. </p><p><br></p><p>In the site mappings table map a Halo site to the corresponding site in Raynet. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY3MGU5NDQwLTU3OTMtNDQ0OC04NTM2LWYyMjhmNTliMTE1YyJ9.HBQcdjJIZcLgWxUYiGRNhlWesmztWgVcT-vRingaxoo" class="fr-fic fr-fil fr-dib" width="1214" style="width: 1216px; height: 96.8078px;" height="97"></p><p><strong><span style="font-size: 10pt;">Fig 5. Site mapping example.</span></strong></p><p><br></p><p>Any sites that are not mapped will create a new site in Halo when imported. This will then be added to the mappings table.</p><p><br></p><p>Now you will need to set the customer any new sites will be created under using the 'Customer for New Sites' field. Any new sites created by Raynet will be created under this customer. </p><p><br></p><p><strong>Assets will be assigned to this Site if no Site has been matched</strong>- Here, choose the site assets imported from Raynet will be created under if they belong to a site (in Raynet) that is not mapped. </p><p><strong><br></strong></p><p><strong>Don't update the asset site for existing or matched assets</strong>- Enable this setting if you would like existing assets in Halo to not have their site changed when the asset in Raynet is under a different site. </p><p><br></p><p><strong><span style="font-size: 12pt;">Determine site using Site Rules</span></strong></p><p>Use rules to determine asset's sites when your assets in Raynet are not currently organised into sites, or the sites they are under do not correspond with your sites in Halo. </p><p><br></p><p id="isPasted">To create a site rule add to the 'Site Rules' table. Here you can set some criteria based on an asset field, if an asset meets this criteria it will be imported to the selected site. In the figure 6 example any assets that have the 'asset number' field starting with 'Terrys-' will be imported to the customer Terry's Chocolate and the site 'Melbourne'. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijk0YWQwNjNmLTljMDEtNDc2OS04ZTc3LTJiNjE5ZDYxODQ1MCJ9.fVAfL7iIG5dnt7NW-gbqKXPUq_NlfgdLDpH4aOdQn3A" class="fr-fic fr-fil fr-dib" width="523" style="width: 525px; height: 393.289px;" height="393"></p><p><strong><span style="font-size: 10pt;">Fig. 6. Example Site rule.</span></strong></p><p><br></p><p><strong>Assets will be assigned to this Site if no Site has been matched</strong> - Here, choose the site assets imported from Raynet will be created under if they do not meet any site rule criteria. </p><p id="isPasted"><strong>Don't update the asset site for existing or matched assets </strong>- Enable this setting if you would like existing assets in Halo to not have their site changed when the asset should be under a different site in line with site rules.</p><p><br></p><p id="isPasted"><strong><span style="font-size: 14pt;">Asset Imports</span></strong></p><p>Head to the 'Assets' tab. Here you will need to complete some configuration to control how assets are imported. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjczMzVhMWM2LTY5MzAtNGU4NS1hYmY1LTU1MDU5M2FlNjIzYyJ9.v0QQLzJUf0KtRn_43FX9RctskEmUKMLPIHLS6FBsPyM" class="fr-fic fr-fil fr-dib" width="1215" style="width: 1217px; height: 579.165px;" height="579"></p><p><strong><span style="font-size: 10pt;">Fig 7. Asset import configuration.</span></strong></p><p><br></p><p id="isPasted"><strong>Asset matching Field </strong>- Here you can set which field is used to match assets in Raynet to assets in Halo. The asset unique identifier field should be selected here. </p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Asset Fields</span></strong></p><p>In the field mappings table you can map a Raynet field to a Halo field, this determines which field data from Raynet gets imported into in Halo. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImZlOGMxZDYwLWY1MzItNDQ1Yy1iZWUyLWYwMjY3M2I3NTNhYiJ9.ZoZvNb4iiKbYWUJN6RgnasCbMxPpnCRv5E9vL_F5MRw" class="fr-fic fr-fil fr-dib" width="565" height="332"></p><p><strong><span style="font-size: 10pt;">Fig 8. Asset field mappings.</span></strong></p><p><br></p><p><strong>Field Type</strong> - This will be the type of Halo field the data will be imported into. See our guide on <a data-fr-linked="true" href="https://usehalo.com/haloitsm/guides/1785/" id="isPasted" target="_blank" rel="noopener noreferrer"><strong>Asset Fields</strong></a> if you are unsure on the difference between asset fields and custom fields in Halo. </p><p><br></p><p id="isPasted">You can also have a Raynet field create a new field against an asset in Halo by selecting '*Create a new Field during the next import*' in the Halo service desk field. </p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Determine Asset types</span></strong></p><p>All assets in Halo must be assigned an asset type. Raynet does not have a concept of asset types so you will need to configure how asset types are determined for assets imported from Raynet. There are three options in Halo to control how asset types for new assets created from Raynet are determined.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQwNjQ2M2Y5LTI1NzItNGRjMS05MmQ4LTZjODczZWIyNjViMSJ9.7YEc9Q6cF3EHP6H3tmcoh4os2Ec8XC8OuDgJ4E92lMU" class="fr-fic fr-fil fr-dib" width="753" style="width: 755px; height: 269.777px;" height="270"></p><p><strong><span style="font-size: 10pt;">Fig 9. Fields to determine asset types.</span></strong></p><p><br></p><p id="isPasted">First set a default asset group, this will be the group new asset types are created under (each asset type in Halo sits within an asset group). </p><p><br></p><p>Use the 'Determining an Asset's type' field to determine how asset types are assigned to imported assets. The asset types of the assets can either use a fixed type for all assets, be determined from a field, or use asset type mappings that are determined using rules based on the values of the mapped asset fields.</p><p id="isPasted"><br></p><p><strong>Use a Fixed Type</strong></p><p>If you would like all imported assets to have the same asset type when imported set the 'Determining an Asset's type' field to be 'use the same type for all Assets' then set the 'Default Asset Type' field to be the asset type you would like assets from Raynet to be. Figure 10 shows how to set this so all assets are imported as the 'Application Server' asset type. </p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjU4MWZmMzFjLTM3OWMtNGZlOC05MjlhLWI4MGZiOWRhYTk5ZSJ9.k0ahWAwiDfxSDSL05edWonrRbRyb1dy88obgFv8lHxM" class="fr-fic fr-fil fr-dib" width="755" style="width: 757px; height: 251.388px;" height="251"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 10. Settings for assets to be imported as the same type</span></strong></p><p><br></p><p id="isPasted"><strong>Determine Asset type using a field</strong></p><p>If you would like all imported assets' types to be determined by a particular field, set the set the 'Determining an Asset's type' field to be 'Use a field to determine each Asset's type'. Then in 'Field for determining an Asset's type' choose the field you would like the type to depend on. The field you choose must contain the name of the desired asset type, if this name can be matched to an existing asset type in Halo, it will be assigned this asset type. If the name is not the same as an asset type in Halo, a new asset type will be created. Note that the names must be identical in order to match. </p><p><br></p><p>This setting is used if you have a field in Raynet that already determines an asset's type and you would like the types to be consistent between Halo and Raynet. You will still need to populate the default asset type field, assets that do not have the selected field populated will be imported as the default asset type. In figure 11 asset types will be determined by the value in the field 'corporateIdentifier'.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY5NDZmYTFkLWJmMGUtNDc4Ny05NmJiLTU3MTYxYTE4ODJhMyJ9.IR7vz2d6LyM6mEx7zdReuQsooz9Qa9Y5AoaNB9Tf2OE" class="fr-fic fr-fil fr-dib" width="703" style="width: 705px; height: 299.359px;" height="299"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 11. Settings for asset types to be determined by a field.</span></strong></p><p><br></p><p id="isPasted"><strong>Determine Asset type using rules</strong></p><p>If you would like asset types to be determined by asset rules set the set the 'Determining an Asset's type' field to be 'Determine asset type using rules'. Now you will be able to set asset's types based on rules, These rules are based on field values, and if matched will assign an asset to the chosen asset type. When creating a rule first add criteria for the rule, select the Halo field that you would like to base the criteria on, then set the rule type and the outcome needed in the field to match the rule. If an asset matches this rule it will be imported as this asset type. For example, in figure 12 the rule I have set up will check the name field of an asset, if the name begins with 'LAP' the asset will be imported with the 'Laptop' asset type. </p><p><br></p><p>This method is used when you would like to organise the asset types assets are created as but do not already have this information stored in a field in Raynet.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjZjYmEzYWEyLTcwZjEtNGI5ZC1iNTQ4LTZkZTQwY2EzMDRjMCJ9.pCsB0wyi9EOLWyTbWNvZqz9o4h2uzqzjhRsPAz-bEKI" class="fr-fic fr-fil fr-dib" width="1215" style="width: 1217px; height: 305.989px;" height="306"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 12. Determining asset type with rule setup.</span></strong></p><p><br></p><p id="isPasted">If an asset is imported that does not match any of these rules, it will be created under the default asset type. Alternatively, if you would like to not import assets that do not match these rules, set the 'Default Asset type' to 'Don't import assets that do not match any rules'.</p><p><br></p><p><strong>Don't update the Asset type for existing or matched Assets</strong>- Enable this setting if you would like the asset type of existing assets in your Halo instance to remain unchanged. When the sync runs other properties of the asset will be updates, but not the asset type. </p><p><br></p><p id="isPasted"><strong><span style="font-size: 12pt;">Miscellaneous Asset import settings</span></strong></p><p id="isPasted"><strong>Don't create new Assets</strong> - When enabled the sync/import will only update existing assets, no new assets will be created. </p><p><strong>Status of New Assets</strong> - Here, choose the status assets will have when created in Halo from Raynet. </p><p id="isPasted"><strong>Deactivate Assets in Halo when they are deleted from Raynet (Halo Integrator only)</strong> - When an asset is deleted from Raynet they are deactivated in Halo. This will only apply when the integrator is enabled. </p><p><br></p><p id="isPasted"><strong><span style="font-size: 14pt;">Import Assets automatically on a schedule</span></strong></p><p>To have assets update on a scheduled basis you will need to enable the Halo integrator for this integration. This can be done under the 'Syncing' tab by checking 'Enable the Halo Integrator for the Raynet integration'. You will then need to select 'Devices' and/or 'Sites' within the 'Entities to import' field. Once enabled the sync will take place daily.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImRmZjk1NmEyLWZjYjUtNDI2ZC05MzZmLTRiMzAxNmQxNWYwNiJ9.3X3AwRDD-1NfA-xM8VLDT9Exk5EqLTpqzKASh3xQMMs" class="fr-fic fr-fil fr-dib" width="999" height="471"></p><p id="isPasted"><strong><span style="font-size: 10pt;">Fig 13. Enable the Halo integrator for the integration.</span></strong></p>
