---
title: Customizing imports from the Ivanti Neurons Platform
slug: neurons-for-itam/help/enu/latest/customizing-imports-from-the-ivanti-neurons-platform
createdAt: 2026-07-06T09:08:30.361Z
---

Asset Administrators can create device parent type/subtype filters and field mappings that define how the Ivanti Neurons connector will import source asset data. These customizations provide a high level of control over how data is displayed in the Hardware Assets workspace and are useful when importing many records at once.

You can export the connector customizations as a package, then test them in a staging or UAT environment before using in a production landscape to sync data from the Ivanti Neurons Platform. The package enables you to duplicate the customizations across multiple tenants, each of which must be installed with the most recent version of Ivanti Neurons for ITAM Cloud.

To access this feature, you're required to apply content package update Drop #21 (202002) and above, which is downloadable from the [Ivanti Marketplace](https://marketplace.ivanticloud.com/). (Note that Drop #21 may be part of a consolidated package.)

:::hint{type="info"}
**Non-computer asset type support**
This content package also provides SNMP connector support for importing non-computer asset types from the Ivanti Neurons Platform. For example, printer data can be imported as a Printer subtype into the target database.

To enable support, you must first create a new subtype mapping for the non-device type in the **Asset Sub Type** workspace under one of the existing parent types. You can then add the required mapping for the SNMP connector by following the next procedure.
:::

::::ExpandableHeading
## To customize asset data imports

1. Log in to ITAM as Asset Administrator.
2. Click the :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/wevvEsOtADDqOcTqHbPUf_configicon12x12.png" alt="Wrench icon Asset Administrators use to open the Configuration Console." caption size="10" width="12" height="12"} icon in the menu bar at the top of any workspace. The Configuration Console displays in a new browser tab.
3. In the left navigation pane, expand **Extend > Integration Tools > Data Import Connections**. The Data Source Manager page lists all data import connections currently defined for your installation.
4. Scroll down the list to the **Ivanti Neurons Connector – Device** link. Ensure the connector is set to **ON** and click the link to open.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/Y0vroeDSjOb_-0yiclsuO_neuronsconnector.png" alt="Ensure the Ivanti Neurons Connector-Device link is set to ON." position="flex-start" size="100" width="1377" height="671" initialPath="Images/NeuronsConnector.png" githubPath="ITAM Help/Images/NeuronsConnector.png" darkWidth="1377" darkHeight="671" showCaption="false" indent="1"}

5. **Connection Setting page**: We recommend leaving the defaults as they are, though you can change as needed. Click **Test Connection** near the bottom of the page to verify that your connection settings work. If successful, click **Next**.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/HNjlNTqbRjq_fhXgQhxHx_consetting.png" alt="Test the connector connection. If it's successful, continue on to the Object Mapping page." position="flex-start" size="94" width="937" height="579" initialPath="Images/ConSetting.png" githubPath="ITAM Help/Images/ConSetting.png" darkWidth="937" darkHeight="579" showCaption="false" indent="1"}

2. **Object Mapping page**: We recommend leaving the defaults as they are, though you can change as needed. **Source mapping tables** is a list of populated tables based on settings defined on the previous page. **Batch size** is the number of records processed at a time for any given job. **Max size** is the number of records retrieved each time the connector queries the source database. **Root table** is the primary table containing the master data that defines all devices in your organization. **Unique key** uniquely identifies all devices in your organization. **Change-Time column** is not currently in use.
3. Click **Next**.
4. **Filter Setting page**: Define optional filter conditions for the records you want to import. Based on the filters defined, only those records will be imported from the source database. For example, you can choose to import an asset type of Laptop by creating the filter value **Laptop** as shown below.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/vrU-pkH4lq1wticduwZwe_filtersetting.png" alt="Define optional filter conditions for the records you want to import from Ivanti Neurons." position="flex-start" size="99" width="990" height="291" initialPath="Images/FilterSetting.png" githubPath="ITAM Help/Images/FilterSetting.png" darkWidth="990" darkHeight="291" showCaption="false" indent="1"}

:::Paragraph{listStyleType="disc" indent="2"}
In the left drop-down, select a field from the source database. For this procedure, select **Device.Type**, but you can create filters for different fields as well. *Do not* select a field that results in a collection of values being imported from Ivanti Neurons—filters will not work for those fields. For example, don’t select a value such as Device.BIOS.BIOSSettings.
:::

:::Paragraph{listStyleType="disc" indent="2"}
In the middle drop-down, select an operator. In most cases, you’ll want to select **Equal**.
:::

:::hint{type="info"}
**Important**: The operator **IsNotEmpty** must be used for filtering out null parameters instead of **NoContain**. For example, use IsNotEmpty when syncing devices from Ivanti Neurons that don't have a serial number.
:::

:::Paragraph{listStyleType="disc" indent="2"}
In the field to the right, enter your filter condition. You can only add one filter per row.
:::

:::Paragraph{listStyleType="disc" indent="2"}
Use the AND/OR conditions as necessary and click the :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/qAGbomHoYN9eOSEQYMGiJ_greenplusicon14x14.png" alt="Green plus icon used to add more filters to the list." caption size="10" width="14" height="14"} icon to add more filters to the list. To remove a filter, click the :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/tM6-6non9r2vPi6o7qrvf_redminusicon12x12.png" alt="Red minus icon used to remove filters from the list." caption size="10" width="12" height="12"} icon.
:::

9. When finished, click **Next**.
10. **Field Mapping page**: Use this page to define how fields in the source database are mapped to fields in the target ITAM database. The newly added map types of **CIParentType** and **CISubType** reconcile the asset parent type and subtype of the imported records based on the “type” received from Ivanti Neurons (as defined in the Asset Sub Type workspace).
    Always ensure that both the parent type and subtype mapping are up to date in the **Asset Sub Type** workspace. This mapping will determine the asset import categorization. Also note the following:
    - If CIParentType reconciliation doesn't find a proper parent type in the Asset Sub Type workspace, then the parent type will be mapped to the **New CI Type** category as defined in the **Asset Processor Configuration** workspace (by default, ivnt\_UnmanagedAsset). The device record will display in the Hardware Assets workspace under the same category.
    - If CISubType reconciliation doesn't find a proper subtype in the Asset Sub Type workspace, then the asset import will fail.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/fzvjz7bun6CbxpQPJVKlB_devicemappings.png" alt="define how fields in the source database are mapped to fields in the target ITAM database. " position="flex-start" size="100" width="1362" height="359" initialPath="Images/DeviceMappings.png" githubPath="ITAM Help/Images/DeviceMappings.png" darkWidth="1362" darkHeight="359" showCaption="false" indent="1"}

:::Paragraph{listStyleType="disc" indent="2"}
The left column displays the source field names, and the right column displays the target field names. It’s assumed that you know the Source mapping names in advance. If you need sample mapping scenarios, see the section below.
:::

:::Paragraph{listStyleType="disc" indent="2"}
Scroll down the page until you find the Device.Type source field in the left column. (There will be two Device.Type sections. In the first, you’ll select the **CIParentType** mapping. In the second section, you’ll select the **CISubType**). Note that to have a CISubType field mapping, it's mandatory to first have a CIParentType mapping.
:::

:::Paragraph{listStyleType="disc" indent="2"}
Under the Device.Type source, use the drop-downs to select the asset parent type you want imported into the database.
:::

:::Paragraph{listStyleType="disc" indent="2"}
From the middle column drop-down, select **CIParentType**.
:::

:::Paragraph{listStyleType="disc" indent="2"}
From the right column drop-down, select **ComputerSystem.Property.CIType** for the field you want to map to.
:::

:::Paragraph{listStyleType="disc" indent="2"}
Scroll down to the second Device.Type source field in the left column. Use the drop-downs to select the asset subtype you want imported into the database.
:::

:::Paragraph{listStyleType="disc" indent="2"}
From the middle column drop-down, select **CISubType**.
:::

:::Paragraph{listStyleType="disc" indent="2"}
From the right column drop-down, select **ComputerSystem.Property.SubType**.
:::

11. When finished, click **Next**.
12. **Schedule Setting page**: Use this page to schedule when the connector will sync with Ivanti Neurons to import data into ITAM. Available options are located in the Schedule List; click the schedule you want to enable. If needed, you can select more than one schedule using the Ctrl button on your keyboard. To create a custom schedule, see [About the Schedule Entry and Scheduled Jobs Workspaces](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/enu/latest/about-the-schedule-entry-and-scheduled-jobs-workspaces)  in the Ivanti Neurons for ITSM online help.
13. **Review & Publish page**: Click **Preview** to ensure that the mappings look as expected. Click **Back** to make any changes.
    When you’re satisfied with the results, click **Publish** to save your settings and run the connector at the schedule(s) you set, or click **Publish & Run Now** to save your settings and run the connector immediately. In either case, once the connector is finished running, device records will display in the Hardware Assets workspace, and invoice records will display in the Invoices workspace. Click **Publish & Test Run** to conduct a test run of the connector but not save the records to the target ITAM database.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/88BuMW6h48k98Y_PSQSvh_reviewpub.png" alt="Preview the field mappings, publish the settings, and run the connector." position="flex-start" size="94" width="939" height="342" initialPath="Images/ReviewPub.png" githubPath="ITAM Help/Images/ReviewPub.png" darkWidth="939" darkHeight="342" showCaption="false" indent="1"}

This a one-time configuration that is saved until you manually change it again. After publishing, you'll want to test that the customizations work as intended. For details, see the following section.
::::

:::ExpandableHeading
## Sample mapping scenarios

**Use case 1**: For the mapping **Portable > Computer = CIParentType = ComputerSystem.Property.CIType** shown below, the asset imported from Ivanti Neurons having Device.Type > Portable is mapped to the parent type Computer in the target database. Hence, the device is imported under the parent type of Computer.

![Mapping scenario for use case 1.](https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/lted4G2xJg7FevIZD0CHc_devicemappings1.png)

**Use case 2**: If you create a mapping of **Laptop > Computer = CIParentType = ComputerSystem.Property.CIType**, it won't work if Laptop isn't also defined in the Asset Sub Type workspace. In this situation, devices of type Laptop will be moved to the **New CI Type** category defined in the **Asset Processor Configuration** workspace (by default, Ivnt\_UnmanagedAsset) and will display in the Hardware Assets workspace under that same category.

**Use case 3**: If a CIParentType mapping is not defined in the Ivanti Neurons connector Field Mapping page, then the **New CI Type** category defined in the **Asset Processor Configuration** workspace will be used (by default, Ivnt\_UnmanagedAsset), and the device will display in the Hardware Assets workspace under that same category.

**Use case 4**: With the subtype mapping **Portable > Laptop = CISubType = ComputerSystem.Property.SubType** shown below, the Device.Type received from Ivanti Neurons as Portable is imported as subtype Laptop under the parent type of Computer.

![Mapping scenario for use case 4.](https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/HCYhpES6sP1_aqotNTd_t_devicemappings2.png)

**Use case 5**: If a Device.Type is received as Laptop, which does not exist in the mapping (left panel), then this subtype will be considered as Laptop in the target database.
:::

## Testing the connector customizations

It's recommended that you export your customizations as a metadata package and test them in a staging or UAT environment before importing into a production landscape. The process for doing so follows these general steps and is explained in the procedure below:

- Export the customizations (created in the procedure above) as a package.
- Contact Ivanti customer support to have them point the Neurons Platform to your staging or UAT tenant.
- Import the package to the same staging or UAT tenant and test it. Make any necessary changes.
- Contact Ivanti again to have them point the Neurons Platform to your production tenant.
- Import the package to your production tenant in preparation for importing data from the Neurons Platform.

:::hint{type="info"}
In all cases, the latest version of Ivanti Neurons for ITAM must be installed on your tenants.
:::

**Important**:

- The following procedure is applicable only for an update scenario; exported packages won’t create new connections if the connector doesn't already exist as part of your installation.
- Before applying the package, **back up your database**.
- Clone and delete actions for Ivanti Neurons connectors (Device and Invoice) are currently disabled or have been removed.

:::ExpandableHeading
## To test and verify the customizations

1. Log in to ITAM as Asset Administrator.
2. Click the :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/wevvEsOtADDqOcTqHbPUf_configicon12x12.png" alt="Wrench icon Asset Administrators use to open the Configuration Console." caption size="10" width="12" height="12"} icon in the menu bar at the top of any workspace. The Configuration Console displays in a new browser tab.
3. In the left navigation pane, expand **Extend > Integration Tools > Data Import Connections**.
4. Scroll down the list to the **Ivanti Neurons Connector – Device** link. Scroll to the far right of that link and click the :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/U50sSn6juB-IwZFH-dC-U_exporticon14x13.png" alt="Export icon used to export connector customizations as a package." caption size="10" width="14" height="13"} icon to export the customizations as a package. In the Warning dialog that displays, click **Continue**. The package is exported to your Downloads folder.
5. Contact Ivanti to have them point Ivanti Neurons to your staging or UAT tenant.
6. From your browser, log into a staging or UAT tenant and open the Configuration Console.
7. In left navigation pane, click **Build > Development Package > Packages**. Ensure that you're in the list view, then click **Import Package** (top right of the toolbar).
8. Browse for and open the customization package. In the dialog that displays, click **Preview Impact** to view details about how this package may impact your database. Click **Execute** to apply it; this process may take a few minutes to complete.
9. Verify that the package works as intended and make any necessary changes.
10. Contact Ivanti again to have them point the Neurons Platform to your production tenant.
11. Import the package to your production tenant. If needed, you can duplicate the package across multiple production tenants.
:::

Once you've completed this procedure, you can begin importing asset data. For details, see **The import process** section in [Importing from the Ivanti Neurons Platform](https://docs.ivanti.com/neurons-for-itam/help/enu/latest/importing-from-the-ivanti-neurons-platform).
