Integration with Ivanti Neurons for ITAM

You can link Ivanti Neurons for Software with Ivanti Neurons for ITAM so that data relating to contracts and license transactions is automatically passed between the two systems. Any additions or edits of contracts or license transaction data is reproduced in both systems. This means the same data is used in both to provide an understanding of your software estate and software spend from Software, coupled with the asset management features such as procurement and lifecycle tracking from Ivanti Neurons for ITAM. License transactions in Software correspond to Contract Line Items of type Entitlement in Ivanti Neurons for ITAM.

If a Contract Line Item of type Entitlement from Ivanti Neurons for ITAM contains a SKU that is recognized by Software, then any additional information from the Ivanti SKU Library about the SKU is also included when it is added as a transaction.

Any cost data imported from Ivanti Neurons for ITAM is used in Software only if the currency associated with the cost is the same as the system currency set for Software. If the currency is different, the rules specified in Prices, cost, and spend are applied.

Only records that include the necessary mandatory fields for Software are synced from ITAM, so ensure your ITAM records include these. In particular, ensure each ITAM Contract has a Vendor.

All data imported from Ivanti Neurons for ITAM is associated with the Ivanti Neurons for ITAM import source (see Import sources). You must disable the integration with Ivanti Neurons for ITAM before you can delete this data source. Deleting this import source removes all contracts and transactions imported from ITAM, and reverts all contracts and transactions that were updated by ITAM.

How the data is mapped between the systems

Contracts in Software correspond with Contracts in Ivanti Neurons for ITAM, and Transactions in Software correspond with Contract line items of type Entitlement in Ivanti Neurons for ITAM. The following tables show how fields in one application are mapped to fields in the other.

Contract mappings

Mappings to the Contract object in Software:

Software attribute	ITAM object	ITAM attribute	Notes
Business Unit	OrganizationalUnit	DirectoryFullPath
Name	CI#Contract	Name
Contract Number	CI#Contract	ivnt_InternalID	Mandatory
Country of Contract	CI#Contract	ivnt_GoverningLaw
End Date	CI#Contract	ivnt_ExpiryDate
Start Date	CI#Contract	ivnt_DateSigned
Termination Notice Period	CI#Contract	ivnt_TerminationNoticeDays
Vendor	Vendor	Name	Mandatory
Vendor	CI#Contract	ivnt_VendorName	Mandatory

The Vendor attribute in Software is mapped to both the Name attribute on the Vendor and the Vendor Name attribute on the Contract in ITAM.

Transaction to Contract line item mappings

Mappings to the Transaction object in Software:

Software attribute	ITAM object	ITAM attribute	Notes
Business Unit	OrganizationalUnit	DirectoryFullPath
Contract End	CI#Contract	ivnt_ExpiryDate
Contract Number	CI#Contract	ivnt_InternalID
Contract Start	CI#Contract	ivnt_DateSigned
Coverage Start	ivnt_ContractLineItem#ivnt_Entitlement	EffectiveDate	If this value is empty in ITAM, then the current date is used in Software.
Coverage End	ivnt_ContractLineItem#ivnt_Entitlement	EndDate
Edition	CI#ivnt_SoftwareProduct	ivnt_Edition
Metric	ivnt_ContractLineItem#ivnt_Entitlement	LicenseMetricType
PO Number	ivnt_PurchaseOrder	ivnt_PurchaseOrderNumber
Product	CI#ivnt_SoftwareProduct	ivnt_Title	Mandatory
Product Description	ivnt_ContractLineItem#ivnt_Entitlement	EntitlementDetail
Product Type	ivnt_ContractLineItem#ivnt_Entitlement	EntitlementType	If the record is matched to an item in the SKU Library, then the value from the SKU Library is used.
Purchase Date	ivnt_ContractLineItem#ivnt_Entitlement	PurchaseDate	Mandatory. If this value is empty in ITAM, then the Effective Date from ITAM is used in Software if it is available, otherwise the current date is used.
Quantity	ivnt_ContractLineItem#ivnt_Entitlement	Quantity	Mandatory
SKU	ivnt_ContractLineItem#ivnt_Entitlement	SupplierSKU
Total Cost	ivnt_ContractLineItem#ivnt_Entitlement	InitialTotalCost
Unit Cost	ivnt_ContractLineItem#ivnt_Entitlement	InitialUnitCost
Vendor	CI#ivnt_SoftwareProduct	ivnt_Manufacturer	Mandatory
Version	CI#ivnt_SoftwareProduct	ivnt_Version

Enabling the integration

Before you can use the integration, you need to enable it in both Software and Ivanti Neurons for ITAM, and then load the initial data from one of the two systems into the other. If you already have license transaction data in both systems, we recommend exporting this data from one of the systems and then deleting the data from the system you exported it from. You can then reload the data from the other system and use your export to look for any missing items.

To enable the integration:

Log in to Ivanti Neurons for ITAM as a user with the Asset Administrator role.
Open the Software workspace.
Click Configuration > Ivanti Neurons for ITAM on the Software navigation bar.
The Ivanti Neurons for ITAM configuration page appears with all controls initially read-only.
Set both Incoming and Outgoing to enabled.

For more information, see the Ivanti Neurons for ITAM help.

Click Change, then select Enable Incoming data and Enable Outgoing data and click Save.
The integration between Contracts in both systems and between License Transactions in Software and Contract Line Items of type Entitlement in Ivanti Neurons for ITAM is enabled. Any additions or changes to these items will be reproduced in the other system.

Loading the initial data into the other system

Now that you have enabled the integration, any additions or changes to License Transactions in Software will be reproduced in Contract Line Items of type Entitlement in Ivanti Neurons for ITAM and also the other way around. However, any existing data in your source system will not be automatically transferred to the other system, so you need to initiate this transfer.

To load the initial data from Software to Ivanti Neurons for ITAM:

Click Software > Ivanti Neurons for ITAM on the navigation bar.
The Ivanti Neurons for ITAM configuration page appears.
Click Initiate Outgoing Data Full Load.
The data load from Software to Ivanti Neurons for ITAM starts and could take a significant amount of time, depending on the quantity of data. All contracts and license transactions in Software are copied to the Ivanti Neurons for ITAM database.

Click the Initiate Outgoing Data Full Load button only once, in either Software or Ivanti Neurons for ITAM.

For information about loading data from Ivanti Neurons for ITAM to Software, see the Ivanti Neurons for ITAM help.