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

 

CI#Contract

ivnt_VendorName

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:

  1. Log in to Ivanti Neurons for ITAM as a user with the Asset Administrator role.
  2. Open the Software workspace.
  3. 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.
  4. Set both Incoming and Outgoing to enabled.
  5. For more information, see the Ivanti Neurons for ITAM help.

  6. 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:

  1. Click Software > Ivanti Neurons for ITAM on the navigation bar.
    The Ivanti Neurons for ITAM configuration page appears.
  2. 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.