Rules for data synchronization
Empirum Connector is out of support with availability of Empirum Inventory Data Provider (Migration from Empirum Connector (legacy) - Matrix42 Self-Service Help Center)
The import from Matrix42 Empirum follows different rules for data synchronization depending on the object type of the data to be imported.
Software packages
To match existing software services with incoming software packages, the EmpirumClientID attribute is used.
Computers
To match existing computers with the imported data, the following synchronization rules are used in order of descending priority.
A - Matching of customer-specific attributes
The Select computer attributes for matching checkbox is selected in an Empirum location settings.
The following attributes are available for selection and can be used as a matching key:
- SPSAssetClassBase.SerialNumber
- SPSAssetClassBase.InventoryNumber
- SPSComputerClassBase.IPAddress
- SPSComputerClassBase.PrimaryMACAddress
- SPSComputerClassBase.DNSName
- SPSComputerClassBase.Name
- SPSComputerClassBase.WindowsDomainName
- SPSComputerClassBase.NT4DomainName
- SPSComputerClassOS.Name
The values of all attributes 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!
B - Matching of source IDs
- Empirum Location
- Empirum Client ID
Both values should match for each object. 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 synchronization rule.
C - 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 attributes 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 synchronization rule.
D - 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 attributes 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 synchronization rule.
E - 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 synchronization rule.
F - 1 out of 1 match
- Computer Name
Domains that exist in Matrix42 Software Asset & Service 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 in Matrix42 Software Asset & Service Management.
Computers that fulfill one of the following conditions are excluded from the import:
- Computers that are configured in the location settings but have not been recorded in the Matrix42 Empirum inventory (missing ComputerBasicInventory)
- Computers without a name in Matrix42 Empirum (missing ClientInfo.Name)
- Computers without domains in Matrix42 Empirum (missing Clientinfo.Domain)
- Computers with identical names and domains in Matrix42 Empirum
- Computer duplicates in Matrix42 Empirum (duplicates are identified for each individual synchronization rule according to the criteria that are set in this rule)
- Computer duplicates in Matrix42 Software Asset & Service Management (duplicates are identified for each individual synchronization rule according to the criteria that are set in this rule)
Devices
To match existing network devices (routers, switches, printer, other) with incoming devices, the Primary MAC Address is used.
Imported attributes/field mapping
For more information about the imported Empirum attributes and their mapping to the database fields in Matrix42 Software Asset & Service Management, see Empirum connector attribute mapping.