Empirum connector attribute mapping
Empirum Connector is out of support with availability of Empirum Inventory Data Provider (Migration from Empirum Connector (legacy) - Matrix42 Self-Service Help Center)
Summary
This article contains attribute mapping for the Empirum connector. It lists all attributes that are imported or updated by the Empirum inventory for the following configuration items: Computers, Network Devices, Printers, SKUs (as part of import of Empirum devices), Services, Service Bundles, and EasyRecovery templates.
Computer
Matching keys
Priority 1: Matching of customer-specific attributes defined in the Empirum location
The following attributes are available for selection:
- SPSAssetClassBase.SerialNumber
- SPSAssetClassBase.InventoryNumber
- SPSComputerClassBase.IPAddress
- SPSComputerClassBase.PrimaryMACAddress
- SPSComputerClassBase.DNSName
- SPSComputerClassBase.Name
- SPSComputerClassBase.WindowsDomainName
- SPSComputerClassBase.NT4DomainName
- SPSComputerClassOS.Name
The values of all entries should match. If a value does not exist or the values of the existing and imported data do not match, then a new computer is generated.
If custom attributes have been defined, only this rule applies and the default synchronization rules will not be considered!
Priority 2: EmpirumLocation and EmpirumClientID
The values of both attributes should match. If a value does not exist or the values of the existing and imported data do not match, then the system switches to the next matching rule.
Priority 3: 4 out of 4 match
- Domain Name (SPSComputerClassAD.Domain.T(SPSADDomainName).NT4Name or SPSComputerClassAD.Domain.T(SPSADDomainName).DomainName)
- Computer Name (SPSComputerClassBase.Name)
- Primary MAC Address (SPSComputerClassBase.PrimaryMACAddress)
- Serial Number of Primary Hard Disc (SPSComputerClassHardDisk.SerialNumber)
The values of all four entries should match. If a value does not exist or the values of existing and imported data do not match, then the system switches to the next matching rule.
Priority 4: 3 out of 4 match
- Domain Name
- Computer Name
- Primary MAC Address
- Serial Number of Primary Hard Disc
The values of at least three out of four entries should match. If a value does not exist or two values of the existing and imported data do not match, then the system switches to the next matching rule.
Priority 5: 2 out of 2 match
- Domain Name
- Computer Name
If at least one value does not exist or does not match in the existing and imported data, then the system switches to the next matching rule.
Priority 6: SPSComputerClassBase.Name
Domains that exist in Matrix42 Workspace Management should have either no value or the NULL value.
For all the data that you want to import and which does not fulfill this last criterion, a new computer is created.
Stock keeping units can be created during the data import. The Configuration Item field is filled in depending on whether the corresponding source information is available, while the Type value is left empty. It should be set manually.
Attributes
| Empirum API Method | Empirum Field ID | Data Definition | Attribute | Note |
| GetClientInfo | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Domain | SPSComputerClassBase | WindowsDomainName | Based on the retrieved domain name | |
| Domain | SPSComputerClassBase | NT4DomainName | ||
| Domain | SPSComputerClassAD | Domain | ||
| InventoryID | SPSAssetClassBase | InventoryNumber | ||
| MacAddress | SPSComputerClassBase | PrimaryMACAddress | ||
| Name | SPSComputerClassBase | Name | ||
| GetComputerBasicInventory | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| DNSName | SPSComputerClassBase | DNSName | ||
| IPAddress | SPSComputerClassBase | IPAddress | ||
| LastScanDate | SPSInventoryClassBase | LastScanDate | ||
| Memory | SPSComputerClassBase | Memory | ||
| OSLogin | SPSComputerClassLogon | LoggedAccount | ||
| OperatingSystemInfo | SPSComputerClassOS | Name | ||
| Domain | SPSComputerClassAD | Domain | ||
| GetBIOSInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| BIOSACPISupport | SPSComputerClassBase | BIOSACPISupport | ||
| BIOSAPMSupport | SPSComputerClassBase | BIOSAPMSupport | ||
| BIOSManufacturer | SPSComputerClassBase | BIOSManufacturer | ||
| BIOSReleaseDate | SPSComputerClassBase | BIOSReleaseDate | ||
| Version | SPSComputerClassBase | BIOSVersion | ||
| GetCDROMDrive Information |
ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Caption | SPSComputerClassOpticalDrive | Model | ||
| Manufacturer | SPSComputerClassOpticalDrive | Manufacturer | ||
| GetDiskDriveInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| DeviceID | SPSComputerClassHardDisk | InternalDriveNumber | Transformation | |
| DiskSize | SPSComputerClassHardDisk | TotalRawSize | ||
| Manufacturer | SPSComputerClassHardDisk | Manufacturer | ||
| Model | SPSComputerClassHardDisk | Model | ||
| SerialNumber | SPSComputerClassHardDisk | SerialNumber | ||
| GetDMIHardwarePortInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| ExternalReference | SPSComputerClassBase | ParPortCount | Count('Parallel') | |
| ExternalReference | SPSComputerClassBase | SerialPortCount | Count() | |
| GetDMIProcessorInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| MaxSpeed | SPSComputerClassBase | ProcessorClock | ||
| GetDMIMainboardInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Manufacturer | SPSComputerClassBase | MBManufacturer | ||
| Product | SPSComputerClassBase | MBModel | ||
| GetFixedDiskInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| DiskType | SPSComputerClassDiskPartition | PartitionType | ||
| FreeSpace | SPSComputerClassDiskPartition | PartitionFreeSpace | ||
| Label | SPSComputerClassHardDisk | DeviceID | ||
| TotalSpace | SPSComputerClassDiskPartition | PartitionSize | ||
| Volume | SPSComputerClassDiskPartition | DriveLetter | ||
| GetHardwareDMIInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Manufacturer | SPSAssetClassBase | ManufacturerName | ||
| Product | SPSAssetClassBase | Model | ||
| SerialNumber | SPSAssetClassBase | SerialNumber | ||
| GetWMIComputersystem | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Manufacturer | SPSAssetClassBase | ManufacturerName | ||
| Model | SPSAssetClassBase | Model | ||
| GetHardwareSlotInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Type | SPSComputerClassBase | MBISASlots | Transformation | |
| Type | SPSComputerClassBase | MBPCISlots | Transformation | |
| GetHardwareWMIInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| BiosVersion | SPSComputerClassBase | BIOSVersion | ||
| Manufacturer | SPSComputerClassBase | BIOSManufacturer | ||
| SerialNumber | SPSComputerClassBase | SystemSerialNumber | ||
| GetMemoryModuleInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| CurrentMemoryType | SPSComputerClassBaseMemoryModule | MemoryType | ||
| InstalledSize | SPSComputerClassBaseMemoryModule | ModuleSize | ||
| SocketDesignations | SPSComputerClass BaseMemoryModule |
Socket | ||
| GetModemInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| AttachedTo | SPSComputerClass Modem |
ComPort | ||
| Caption | SPSComputerClass Modem |
Model | ||
| ProviderName | SPSComputerClass Modem |
Manufacturer | ||
| GetNetworkCardInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| DHCPIPAddress | SPSComputerClassNetworkCard | IPAddress | ||
| DHCPSubnetMask | SPSComputerClassNetworkCard | SubnetMask | ||
| DNSServer | SPSComputerClassNetworkCard | DNSServerList | ||
| SPSComputerClassBase | DNSServerList | |||
| DefaultGateway | SPSComputerClassNetworkCard | DefaultGateway | ||
| Description | SPSComputerClassNetworkCard | WindowsDescription | ||
| EnableDHCP | SPSComputerClassNetworkCard | DHCPEnabled | ||
| IPAddress | SPSComputerClassNetworkCard | IPAddress | ||
| MACAddress | SPSComputerClassNetworkCard | MACAddress | ||
| Subnetmask | SPSComputerClassNetworkCard | SubnetMask | ||
| SoftwareAUTInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| ActiveTime | SPSInventoryClassApplication | ActiveTime | ||
| RunTime | SPSInventoryClassApplication | RunTime | ||
| LastModTime | SPSApplicationClassUsage | LastUsageDate | ||
| FileName | SPSApplicationClassUsage | ApplicationName | ||
| FileVersion | SPSApplicationClassUsage | ApplicationVersion | ||
| GetSoftwareInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| ProductName | SPSApplicationClassUsage | ApplicationName | ||
| ProductNameShort | SPSApplicationClassUsage | ApplicationName | ||
| Version | SPSApplicationClassUsage | ApplicationVersion | ||
| GetSoundDevice Information |
ClientID | SPSInventoryClassBase | EmpirumClientID | |
| Caption | SPSComputerClassBaseSoundCard | Model | ||
| Manufacturer | SPSComputerClassBaseSoundCard | Manufacturer | ||
| GetVideoControllerInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| AdapterCompatibility | SPSComputerClassGraphicCard | Manufacturer | ||
| AdapterRAM | SPSComputerClassGraphicCard | Memory | ||
| CurrentRefreshRate | SPSComputerClassGraphicCard | CuurentRefreshRate | ||
| Name | SPSComputerClassGraphicCard | Model | ||
| VideoModeDescription | SPSComputerClassGraphicCard | CurrentResolutionX | ||
| VideoModeDescription | SPSComputerClassGraphicCard | CurrentResolutionY | ||
| GetWMIParallelPortInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | Quantity of parallel ports is calculated |
| GetWMIProcessorInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | |
| MaxClockSpeed | SPSComputerClassLogon | ProcessorClock | ||
| NumberOfCores | SPSComputerClassBase | AmountProcessorCores | ||
| GetWMISerialPortInformation | ClientID | SPSInventoryClassBase | EmpirumClientID | Quantity of serial ports is calculated |
| SPSConnectorClassEmpirumLocation | ID | SPSInventoryClassBase | EmpirumLocation |
Device
The devices are imported to Matrix42 Workspace Management as network devices, printers, and computers.
Matching Keys
- SPSComputerClassBase.PrimaryMACAddress
- The DeviceType attribute of retrieved objects is used by the Empirum connector to determine whether a device will be imported as a network device (SPSAssetTypeNetworkDevice), a printer (SPSPrinterType) or a computer (SPSComputerType).
- All unrecognized devices are imported as network devices.
- A relation to an SKU is also imported/updated for all devices. If an SKU does not exist, it is created.
Attributes
| Empirum API Method | Empirum Field ID | Data Definition | Attribute | Note |
| GetInventoryForDevices | DeviceType | SPSStockKeepingUnitClassBase | Type | The attribute value also determines which kind of object is created |
| Domain | SPSComputerClassBase | NT4DomainName | ||
| Domain | SPSComputerClassAD | Domain | Relation, @DomainID | |
| Domain | SPSADDomainClassBase | DomainName/NT4Name | Relation, @DomainID | |
| IPAddress | SPSComputerClassBase | IPAddress | ||
| IPAddress | SPSPeripheralClassBase | IPAddress | ||
| IPAddress | SPSComputerClassNetworkCard | IPAddress | ||
| InventoryID | SPSAssetClassBase | InventoryNumber | ||
| LastModTime | SPSAssetClassBase | InventoryDate | ||
| MACAddress | SPSComputerClassBase | PrimaryMACAddress | ||
| MACAddress | SPSComputerClassNetworkCard | MACAddress | ||
| Model | SPSAssetClassBase | Model | ||
| Model | SPSStockKeepingUnitClassBase | Model | ||
| Name | SPSAssetClassBase | Name | ||
| Name | SPSComputerClassBase | Name | ||
| Vendor | SPSAssetClassBase | ManufacturerName | ||
| Vendor | SPSSupplierClassBase | ShortName | ||
| Vendor | SPSSupplierClassBase | Name |
Service
Matching key
Software packages from Matrix42 Empirum are matched to services in Matrix42 Enterprise Service Management by the EmpirumObjectID attribute.
Attributes
| Empirum API Method | Empirum Field ID | Data Definition | Attribute | Note |
| GetSoftwarePackage | Category | SPSArticleCategoryClassBase | Name | Transformation |
| SoftwareID | SVCServiceProvisioningClassBaseInstallSoftware | EmpirumObjectID | ||
| SoftwareName | SVCServiceProvisioningClassBaseInstallSoftware | EmpirumObjectName | ||
| SoftwareName | SPSArticleClassBase | Name | ||
| SoftwareName | SPSArticleClassBase | SSPName | ||
| SoftwareName | SPSArticleClassBase | Description | ||
| SoftwareName | SPSArticleClassBase | SSPDescription | ||
| SoftwareName | SPSArticleClassBase | SSPDescriptionHTML |
Service bundle
Matching key
Software bundles from Matrix42 Empirum are matched to service bundles in Matrix42 Enterprise Service Management by the EmpirumObjectID attribute.
Attributes
| Empirum API Method | Empirum Field ID | Data Definition | Attribute | Note |
| GetSoftwareBundle | ClassID | SVCServiceProvisioningClassBaseInstallSoftware | EmpirumObjectID | |
| ClassName | SVCServiceProvisioningClassBaseInstallSoftware | EmpirumObjectName | ||
| ClassName | SPSArticleClassBase | Name | ||
| ClassName | SPSArticleClassBase | SSPName | ||
| ClassName | SPSArticleClassBase | Description | ||
| ClassName | SPSArticleClassBase | SSPDescription | ||
| ClassName | SPSArticleClassBase | SSPDescriptionHTML | ||
| SoftwareIDList | SPSArticleGroupClassArticle | Article |
EasyRecovery template
Matching key
EasyRecovery templates from Matrix42 Empirum are matched to pickup records in Matrix42 Enterprise Service Management by the TemplateID attribute.
Attributes
| Empirum API Method | Empirum Field ID | Data Definition | Attribute | Note |
| GetERTemplates | Description | SVCServicePickupEasyRecoveryTemplate | Description | |
| Name | SVCServicePickupEasyRecoveryTemplate | DisplayString | ||
| Partition | SVCServicePickupEasyRecoveryTemplate | Partition | ||
| TemplateID | SVCServicePickupEasyRecoveryTemplate | TemplateID |