<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 data-pasted="true"><strong>In this guide we will cover:</strong></p><p><strong>- What is the VM Workspace One Integration?</strong></p><p><strong>- Enabling the VM Workspace One Module</strong></p><p><strong>- Connecting to VM Workspace One</strong></p><p><strong>- Sites</strong></p><p><strong>- Assets</strong></p><p><strong>- Syncing (Halo Integrator)</strong></p><p><br></p><p><br></p><p><strong><span style="font-size: 14pt;">What is the VM Workspace One Integration?</span></strong></p><p>VM Workspace One can be integrated with Halo to import and manage Sites and Assets, and sync these on a recurring schedule to ensure details stay up-to-date.</p><p><br></p><p><strong><span style="font-size: 14pt;"><strong data-pasted="true">Enabling the VM Workspace One Module</strong></span></strong></p><p data-pasted="true" style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">In Configuration > Integrations > Asset Management and Alerting, find the "VM Workspace One" module. Hover over it and click the "+" icon to enable the module.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg1MzlhZTJmLTRlNGItNDdmZS1hN2ExLWQ2ZDliYWQwNTFiOSJ9.QRd6fEiqofYx2OXB03xoxzfyGjPeNgqX2LWZZNms9t0" class="fr-fic fr-fil fr-dib" width="347" height="164"></p><p><strong><span style="font-size: 10pt;">Fig 1. Enabling the VM Workspace One module</span></strong></p><p><br></p><p><strong data-pasted="true"><span style="font-size: 14pt;">Connecting to VM Workspace One</span></strong></p><p data-pasted="true" style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">Clicking into the module will show a list of any existing connections. Click the "New" button.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY2ZWZiNWNlLTk4NWQtNDIwNi04ZWEzLTI5ODU1YzYwM2YwMCJ9.7PEEtJR0YdpppwXAnKzwLYPeen7Yu0JZMPpwYaoBzVo" class="fr-fic fr-fil fr-dib" width="1695" style="width: 1697px; height: 113.442px;" height="113"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 2. VM Workspace One connections</span></strong></p><p><br></p><p data-pasted="true">This will show the "Details" tab to create a new VM Workspace One connection. Give the connection a name, and enter your VM Workspace One Region and URL.</p><p><br></p><p>Connection is via a Client ID and Secret, which are generated in VM Workspace One.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg5ZmM3ZGRiLTEyNzQtNDdiZi04MzY4LTcwYWI5OTI1NTJhMyJ9.5xCXv2A02rCZNwJjWU6GrxKOOnEizz2qMZcQqEss9ks" class="fr-fic fr-fil fr-dib" width="1190" height="638"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 3. Connecting to VM Workspace One</span></strong></p><p><br></p><p data-pasted="true">In the Workspace ONE UEM (Omnissa) console:</p><p><br></p><ul><li>Go to Groups & Settings > Configurations.</li><li>Search "OAuth" in the search box, select "OAuth Client Management".</li><li>Click "Add", fill in Name, Description, Organisation Group, and Role permissions.</li><li>Save, and copy the Client ID/Secret.</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijc0ZGFjMzRlLWE5OWEtNDY1NS04MTM2LWRjZjk4MDAwYmY0YyJ9.JstUmE37Z3GqEUKWyGfUc1rSFGiaLDh2qFi-AS_g6VY" class="fr-fic fr-fil fr-dib" width="1201" height="484"></p><p><strong data-pasted="true"><span style="font-size: 10pt;">Fig 4. Enabling the VM Workspace One module</span></strong></p><p><br></p><p data-pasted="true" style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">Upon saving, you can then click the "Test Configuration" button that will appear. A popup will then show to tell if the test was successful. If the credentials are invalid, an error message will show here to help troubleshoot.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImQ4NjE0ZTYxLTc0OWEtNDNkNi1hMzEyLWU4NTJiNTZhODQxMiJ9.8GxIlItGAYsyMhuA6BYKtz1U92DvzKk7t9if1wtIq9Y" class="fr-fic fr-fil fr-dib" width="367" height="520"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 5. Test Configuration button</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Sites</span></strong></p><p data-pasted="true">Since VM Workspace One does not have a concept of sites or clients, "Site Rules" can be set. These add criteria for which asset falls into a certain site.</p><p><br></p><p data-pasted="true">A default site should be set for assets that do not match one of these rules.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjNlMDdmZGU2LTlkOGQtNGRiMy04ZDM0LWFlMzhhOTZhNGIxZSJ9.IOvvnBlIOrhMVYO2G3Q8PqKNx6jY_lhoaRmd_FRqTug" class="fr-fic fr-fil fr-dib" width="1688" style="width: 1690px; height: 422.884px;" height="423"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 6. Site configuration</span></strong></p><p><br></p><p>Clicking the "Add" button will show this popup to map a Halo Site based on criteria. You can choose a field, and whether data that includes or omits certain information falls into that criteria. In this example, any asset's name that begins with "ACO" will be imported under the "Acorn Construction" client's "Main" site.</p><p><br></p><p><strong><em>Note: Criteria is based on Halo fields, so any fields set here will need to be mapped in the following "Assets" tab.</em></strong></p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImE4YzVmNGIwLTI1YjgtNDdiMi05ZGFmLTEzMzI3M2MyZjZkMSJ9.VMEvQhl9LMuhZq2QWwU5ugo8KQNkHHWssQqwGTi2i4o" class="fr-fic fr-fil fr-dib" width="709" height="539"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 7. Setting site rules</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Assets</span></strong></p><p data-pasted="true">Once sites have been matched, you can then import the assets.</p><p><br></p><p>The first field is the "Asset Matching Field", which will determine how assets are matched to existing records when updated. This should be an field that is unique per asset.</p><p><br></p><p>You can then set Field Mappings in the table below this. This determines which Halo fields information from VM Workspace One is pulled into.</p><p><br></p><p>Ensure every field that is used as site rule criteria is correctly mapped here to match that. For example, the site rules for "Acorn Construction/Main" were set to any asset where the "Name" field starts with "ACO". In this asset field mappings table, we have then mapped the "DeviceFriendlyName" field from VM Workspace One to that "Name" field in Halo, so any devices where the friendly name starts with "ACO" in VM Workspace One will be assigned to that "Acorn Construction/Main" site.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjBlNmM5MjVlLTMxMTAtNGMzMS04NzRhLTdiZTMzYjNjMDcyZSJ9.i9bDekrXxQjyzcNE_mhGQpHKJ-AB7LQhvKVlZmAl1Yw" class="fr-fic fr-fil fr-dib" width="1700" style="width: 1702px; height: 394.082px;" height="394"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 8. Enabling the VM Workspace One module</span></strong></p><p><br></p><p data-pasted="true" style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">Clicking the "Add" button will bring up the below pop to map a VM Workspace One field to a Halo field. This can be with both system asset fields or custom fields.</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.eyJpZCI6IjJiMmFmNGJiLTFlZTYtNDUxZi1iZmU3LTRjYTMzODcxM2U4ZCJ9.T2VgmsmtZDrBew9LAFC62Bg7fEmK-rPn5t3m7XriIZM" class="fr-fic fr-fil fr-dib" width="714" height="414"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 9. Asset field mappings</span></strong></p><p><br></p><p data-pasted="true">After completing the Field mappings, you can then set the the Asset Type configuration.</p><p><br></p><ul style="list-style-type: disc;"><li><strong>Default Group for new Asset Types: </strong>Sets the asset group newly created asset types will be assigned to.</li><li><strong>Determining an Asset's type: </strong>Sets how the asset type is determined.<ul style="list-style-type: disc;"><li><strong>Use the same type for all Assets: </strong>Assigns all assets to a set asset type.</li><li><strong>Use a field to determine each Asset's type:</strong> A set field will be used for determining an asset's type. If an asset cannot match via this field, it will be assigned to a set default asset type.</li><li><strong>Determine Asset Type using rules: </strong>Criteria can be mapped to asset types based on values in Halo fields. If an asset cannot match via this field, it will be assigned to a set default asset type.</li></ul></li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjI2M2EwMzYyLTUxNDEtNDQwMS1iNDQwLTNmMTQ1ODI0OWFhYiJ9.mzo_Yjb62KW082nSQs97rKfSiokbfvYqN0zOiXID2DQ" class="fr-fic fr-fil fr-dib" width="639" height="432"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 10. Asset type configuration</span></strong></p><p><br></p><p data-pasted="true">Finally, set the miscellaneous Asset configuration.</p><p><br></p><ul><li><strong>Deactivate Assets in Halo when they are deleted from VMWorkspace One (Halo Integrator only): </strong>If assets are deleted in VM Workspace One, they will be made inactive in Halo (via the "Active" checkbox) when syncing via the Halo Integrator.</li><li><strong>Don't create new Assets:</strong> If enabled, assets will not be created, only updated.</li><li><strong>Don't update the Asset type for existing or matched Assets: </strong>If enabled, pre-existing assets will not have their asset type updated (if different in VM Workspace One).</li><li><strong>Don't update the asset site for existing or matched assets: </strong>If enabled, pre-existing assets will not have their site updated (if different based on the site rules).</li></ul><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImM3MzRjYTViLTgyOTMtNDRhOS05MGJhLTRmNDg2NzIxOGYzYyJ9.td_x9yC4sy5JQ22-bYSVC0AR0FNV2V9YnHN8b3ffDQM" class="fr-fic fr-fil fr-dib" width="623" height="250"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 11. Miscellaneous settings</span></strong></p><p><br></p><p data-pasted="true" style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;">Save, and the assets can now be imported. Click the "Import devices" button at the bottom of the tab.</p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em;"><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjMyY2U1OTg4LWE2OTctNDJhOS1iNmZiLTNhYzdkYjYwYmQ1OSJ9.M0zza8nxDB3KjdejCXROEpabpov9ZvwquambYzdOjoo" class="fr-fic fr-fil fr-dib" width="1306" height="1170"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 12. Import devices button</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Syncing (Halo Integrator)</span></strong></p><p data-pasted="true">Once sites and assets are configured, you can enable the Halo Integrator to automatically sync assets.</p><p><br></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; 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;" data-pasted="true"><em style="box-sizing: inherit;"><strong style="box-sizing: inherit; font-weight: bolder;">Note: It is recommended to ensure you are happy with the configuration by manually importing before enabling automatic syncs via the Integrator.</strong></em></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; 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;"><br style="box-sizing: inherit;"></p><p style="box-sizing: inherit; margin: 0px; line-height: 1.4285em; 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;">Check "Enable the Halo Integrator for the VMWorkspace One integration", and set "Devices" in the box.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjFlMjAxNjViLTVmMDQtNGMxNy1hODRkLWViMTEwZTAwZDE5MyJ9.xFJ0k7mEXOBuukOC6khgFwbjiuWhNwD0E4kuZEvFV6o" class="fr-fic fr-fil fr-dib" width="1191" height="482"></p><p data-pasted="true"><strong data-pasted="true"><span style="font-size: 10pt;">Fig 13. Enabling the Halo Integrator</span></strong></p><p><br></p>
