Skip to main content
Matrix42 Self-Service Help Center

Empirum connector attribute mapping

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 WindowsDomain​Name Based on the retrieved domain name
Domain SPSComputerClassBase NT4DomainName
Domain SPSComputerClassAD Domain  
InventoryID SPSAssetClassBase InventoryNumber  
MacAddress SPSComputerClassBase PrimaryMAC​Address  
Name SPSComputerClassBase Name  
GetComputerBasic​Inventory ClientID SPSInventoryClassBase EmpirumClientID  
DNSName SPSComputerClassBase DNSName  
IPAddress SPSComputerClassBase IPAddress  
LastScanDate SPSInventoryClassBase LastScanDate  
Memory SPSComputerClassBase Memory  
OSLogin SPSComputerClass​Logon LoggedAccount  
OperatingSystem​Info 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 SPSComputerClass​OpticalDrive Model  
Manufacturer SPSComputerClass​OpticalDrive Manufacturer  
GetDiskDriveInformation ClientID SPSInventoryClassBase EmpirumClientID  
DeviceID SPSComputerClass​HardDisk InternalDrive​Number Transformation
DiskSize SPSComputerClass​HardDisk TotalRawSize  
Manufacturer SPSComputerClass​HardDisk Manufacturer  
Model SPSComputerClass​HardDisk Model  
SerialNumber SPSComputerClass​HardDisk SerialNumber  
GetDMIHardware​PortInformation ClientID SPSInventoryClassBase EmpirumClientID  
ExternalReference SPSComputerClassBase ParPortCount Count('Parallel')
ExternalReference SPSComputerClassBase SerialPortCount Count()
GetDMIProcessor​Information ClientID SPSInventoryClassBase EmpirumClientID  
MaxSpeed SPSComputerClassBase ProcessorClock  
GetDMIMainboard​Information ClientID SPSInventoryClassBase EmpirumClientID  
Manufacturer SPSComputerClassBase MBManufacturer  
Product SPSComputerClassBase MBModel  
GetFixedDiskInformation ClientID SPSInventoryClassBase EmpirumClientID  
DiskType SPSComputerClassDisk​Partition PartitionType  
FreeSpace SPSComputerClassDisk​Partition PartitionFreeSpace  
Label SPSComputerClass​HardDisk DeviceID  
TotalSpace SPSComputerClassDisk​Partition PartitionSize  
Volume SPSComputerClassDisk​Partition DriveLetter  
GetHardwareDMI​Information ClientID SPSInventoryClassBase EmpirumClientID  
Manufacturer SPSAssetClassBase ManufacturerName  
Product SPSAssetClassBase Model  
SerialNumber SPSAssetClassBase SerialNumber  
GetWMIComputersystem ClientID SPSInventoryClassBase EmpirumClientID  
Manufacturer SPSAssetClassBase ManufacturerName  
Model SPSAssetClassBase Model  
GetHardwareSlot​Information ClientID SPSInventoryClassBase EmpirumClientID  
Type SPSComputerClassBase MBISASlots Transformation
Type SPSComputerClassBase MBPCISlots Transformation
GetHardwareWMI​Information ClientID SPSInventoryClassBase EmpirumClientID  
BiosVersion SPSComputerClassBase BIOSVersion  
Manufacturer SPSComputerClassBase BIOSManufacturer  
SerialNumber SPSComputerClassBase SystemSerialNumber  
GetMemoryModule​Information ClientID SPSInventoryClassBase EmpirumClientID  
CurrentMemoryType SPSComputerClass​BaseMemoryModule MemoryType  
InstalledSize SPSComputerClass​BaseMemoryModule ModuleSize  
SocketDesignations SPSComputerClass
​BaseMemoryModule
Socket  
GetModemInformation ClientID SPSInventoryClassBase EmpirumClientID  
AttachedTo SPSComputerClass
​Modem
ComPort  
Caption SPSComputerClass
​Modem
Model  
ProviderName SPSComputerClass
​Modem
Manufacturer  
GetNetworkCard​Information ClientID SPSInventoryClassBase EmpirumClientID  
DHCPIPAddress SPSComputerClass​NetworkCard IPAddress  
DHCPSubnetMask SPSComputerClass​NetworkCard SubnetMask  
DNSServer SPSComputerClass​NetworkCard DNSServerList  
SPSComputerClassBase DNSServerList  
DefaultGateway SPSComputerClass​NetworkCard DefaultGateway  
Description SPSComputerClass​NetworkCard WindowsDescription  
EnableDHCP SPSComputerClass​NetworkCard DHCPEnabled  
IPAddress SPSComputerClass​NetworkCard IPAddress  
MACAddress SPSComputerClass​NetworkCard MACAddress  
Subnetmask SPSComputerClass​NetworkCard SubnetMask  
SoftwareAUTInformation ClientID SPSInventoryClassBase EmpirumClientID  
ActiveTime SPSInventoryClass​Application ActiveTime  
RunTime SPSInventoryClass​Application RunTime  
LastModTime SPSApplicationClass​Usage LastUsageDate  
FileName SPSApplicationClass​Usage ApplicationName  
FileVersion SPSApplicationClass​Usage ApplicationVersion  
GetSoftwareInformation ClientID SPSInventoryClassBase EmpirumClientID  
ProductName SPSApplicationClass​Usage ApplicationName  
ProductNameShort SPSApplicationClass​Usage ApplicationName  
Version SPSApplicationClass​Usage ApplicationVersion  
GetSoundDevice
​Information
ClientID SPSInventoryClassBase EmpirumClientID  
Caption SPSComputerClassBase​SoundCard Model  
Manufacturer SPSComputerClassBase​SoundCard Manufacturer  
GetVideoController​Information ClientID SPSInventoryClassBase EmpirumClientID  
AdapterCompatibility SPSComputerClass​GraphicCard Manufacturer  
AdapterRAM SPSComputerClass​GraphicCard Memory  
CurrentRefreshRate SPSComputerClass​GraphicCard CuurentRefresh​Rate  
Name SPSComputerClass​GraphicCard Model  
VideoModeDescription SPSComputerClass​GraphicCard CurrentResolutionX  
VideoModeDescription SPSComputerClass​GraphicCard CurrentResolutionY  
GetWMIParallelPort​Information ClientID SPSInventoryClassBase EmpirumClientID Quantity of parallel ports is calculated
GetWMIProcessor​Information ClientID SPSInventoryClassBase EmpirumClientID  
MaxClockSpeed SPSComputerClass​Logon ProcessorClock  
NumberOfCores SPSComputerClassBase AmountProcessor​Cores  
GetWMISerialPort​Information ClientID SPSInventoryClassBase EmpirumClientID Quantity of serial ports is calculated
SPSConnectorClass​EmpirumLocation ID SPSInventoryClassBase EmpirumLocation  

Device

The devices are imported to Matrix42 Workspace Management as network devices, printers, and computers.

Matching Keys

  • SPSComputerClassBase.PrimaryMAC​Address
  • 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
GetInventoryFor​Devices DeviceType SPSStockKeepingUnitClass​Base 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 SPSComputerClassNetwork​Card IPAddress  
InventoryID SPSAssetClassBase InventoryNumber  
LastModTime SPSAssetClassBase InventoryDate  
MACAddress SPSComputerClassBase PrimaryMAC​Address  
MACAddress SPSComputerClassNetwork​Card MACAddress  
Model SPSAssetClassBase Model  
Model SPSStockKeepingUnitClass​Base Model  
Name SPSAssetClassBase Name  
Name  SPSComputerClassBase Name  
Vendor SPSAssetClassBase Manufacturer​Name  
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 SVCServiceProvisioningClass​BaseInstallSoftware EmpirumObject​ID  
SoftwareName SVCServiceProvisioningClass​BaseInstallSoftware EmpirumObject​Name  
SoftwareName SPSArticleClassBase Name  
SoftwareName SPSArticleClassBase SSPName  
SoftwareName SPSArticleClassBase Description  
SoftwareName SPSArticleClassBase SSPDescription  
SoftwareName SPSArticleClassBase SSPDescription​HTML  

 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 SVCServiceProvisioningClass​BaseInstallSoftware EmpirumObjectID  
ClassName SVCServiceProvisioningClass​BaseInstallSoftware 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 SVCServicePickupEasyRecovery​Template Description  
Name SVCServicePickupEasyRecovery​Template DisplayString  
Partition SVCServicePickupEasyRecovery​Template Partition  
TemplateID SVCServicePickupEasyRecovery​Template TemplateID