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

Rules

  • By default computers from Matrix42 Empirum are matched to computers in Matrix42 Software Asset & Service Management by EmpirumLocation and EmpirumClientID attributes. If one of these values does not exist or does not match to a corresponding value in Matrix42 Empirum, the system switches to the secondary matching rules.
  • If custom attribute matching has been configured for an Empirum location, the default matching rules do not apply and only the custom matching is used.

For detailed information on default and custom matching rules, see: Rules for Data Synchronisation.

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

Rules

  • Devices from Matrix42 Empirum are matched to devices in Matrix42 Workspace Management by the MACAddress attribute.
  • 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 in Matrix42 Workspace Management.

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

Rules

  • Software packages from Matrix42 Empirum are matched to services in Matrix42 Workspace 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

Rules

  • Software bundles from Matrix42 Empirum are matched to service bundles in Matrix42 Workspace 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

Rules

  • EasyRecovery templates from Matrix42 Empirum are matched to pickup records in Matrix42 Workspace 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