PSA Asset Mapping

Both the Dashboard and ConnectWise contain a list of Clients (Customers), Sites and Devices (Configuration Items). Before Device and Check information can be transferred between the two systems, an asset association must first be established through the Dashboard's PSA Asset Mapping.

PSA Asset Mapping is accessible as part of the integration setup, or post-installation from: Settings > PSA Integration > Asset Mappings

When first opened the Dashboard retrieves the latest customer information from ConnectWise. These details are cached by the Dashboard to improve load times when subsequently accessing the Asset Mapping dialog. To ensure the ConnectWise information is kept up-to-date with any changes made in ConnectWise (renamed devices etc.) we have included the option to Refresh Cache.

After retrieving the customer information, we then perform an exact name comparison between the Dashboard and ConnectWise assets. We automatically map any discovered matches, with the ability to accept or decline this mapping. If the asset only exists in the Dashboard, a new item is created in ConnectWise using the asset's Dashboard name.

The PSA Asset Mappings dialog defaults to the Clients view, with the view level controlled from the Actions column. Choose View Sites to return all Sites under the Client and View Devices to inspect all of the Site's Devices. The view's breadcrumbs allow you to return to a higher level in the hierarchy.

To provide more targeted information, two filter options are available above the main window. Search for assets in the current and View based on the current mapped status (All assets, Unmapped assets only, New assets only). These filter options are only applied to the current view.

At each level the dialog displays the asset's Dashboard name, the mapped ConnectWise name, its mapping status and whether a New ConnectWise item is required for mapping. When viewing the Device Level an additional columns is displayed for device type identification (server or workstation). For visibility, status indicators in the Asset Mapping dialog provice an at-a-glance view of the state of mapped entities. These also contain the entity count, where applicable.

From here you can review, edit and save mapping suggestions before they are applied. To change an asset's ConnectWise mapping, click its edit icon (pencil) and choose the association from the returned results.

If you do not want to associate an Dashboard asset to an entry in ConnectWise or remove an existing mapping, opt to Unmap or Never Map assets by clicking the three dots on the end of the asset row.

When working in the Asset Mapping section, use the Add Client, Add Site or Add Device option under the edit button to create the required entity in ConnectWise. This functionality allows you to easily add a ConnectWise entity and continue the mapping process, rather than navigate to the ConnectWise portal to create a new element.

Once satisfied with the selection, Save to apply.

Where a selection is not made, the Save Selected button returns an error message.

Asset mapping supports automatic selection when mapping a child asset or entity. For example, when changing the mappings for Sites or Devices, the associated Clients are automatically selected. This ensures that when multiple child level changes are made, you do not have to remember navigate to them then reselect the Client.

As well as individual Clients, you can use the selector column header and it's drop down menu to Select all items on all pages or Select all items on this page. Where a selection already exists, you can use the drop-down to Unselect all items.

Sites (Optional)

Dashboard 2019.07.08 introduced ConnectWise Site mapping. To match the potential mixed usage of sites in ConnectWise and the Dashboard, we support one to one (Dashboard and ConnectWise hierarchy match) as well as many to one (multiple entities on the Dashboard to one entity in ConnectWise) relationships, as covered in the below example.

Sites are an optional mapping setting. If you do not have sites configured in ConnectWise and do not intend to use them, do not select a Site from the drop-down.

Where you do not intend to use Sites, we suggest disabling the Enable site mapping option during the integration or migration process. Once the integration is setup, go to Settings > PSA Integration > Configureto change this setting.

Please be aware that after a Site is selected and confirmed, you cannot return this mapping to the No Site state.

Relationship Dashboard Client Dashboard Site ConnectWise Client ConnectWise Site
One to One Abertay Pharmaceuticals Lab01 Abertay Pharmaceuticals Lab01
One to One Abertay Pharmaceuticals Lab02 Abertay Pharmaceuticals Lab02
One to Many Fìobha Motors Forecourt Fìobha Motors Newport
One to Many Fìobha Motors Garage Fìobha Motors Newport
One to Many Fìobha Motors Back Office Fìobha Motors Newport

Where an entity or asset does not exist in ConnectWise it is added as part of the mapping process. To avoid misconfiguration, or the creation of duplicate entities and assets in ConnectWise, we suggest reviewing your mapping settings before saving.

Please be aware that regardless of the method used to create an entity or asset in ConnectWise, you can only move or remove them in the ConnectWise.

When using the ConnectWise MSP Management IT Solution module, you must first associate existing customers with the entered Management IT Solution (Solution Name) before they are selectable in the Asset Mappings section.

From Dashboard v2020.04.03, when an asset name changes in the Dashboard, for example a server or workstation is renamed, this is updated in ConnectWise.