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

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