Kaseya BMS field mapping
This article defines how Kaseya BMS fields are mapped to IT Glue fields. Learn more about integrating with Kaseya BMS in this article.
A summary of the two-way sync behavior:
- Configurations <--> Asset
- Organizations <--> Account
- Locations <--> Locations
- Contacts <--> Contacts
For more details on how to enable two-way sync, refer to our Enabling Kaseya BMS two-way sync topic.
Configurations
| IT Glue: Configuration | Kaseya BMS: Asset |
| Name | Name |
| Asset Tag | Asset Tag |
| Contact | Contact |
| Default Gateway | Default Gateway |
| Configuration Status | Status |
| Configuration Type | Category |
| Primary IP Address | IP Address |
| Location | Client Location |
| Manufacturer | Manufacturer |
| Model | Model Number |
| Notes | Description |
| Operating System | OS Info |
| Physical Position | Physical Location Info |
| Platform | OS Type |
| Purchased Date | Acquisition Date |
| Serial Number | Serial |
| Primary MAC Address | MAC Address |
| Expiration Date | Warranty Expiration Date |
Organizations
| IT Glue: Organization | Kaseya BMS: Account |
| Name | Name |
| Type | Type |
| Status | Status |
| Parent Organization | Parent Account |
| Primary Location | Main Location |
| Short Name | Account Code |
Contacts
| IT Glue: Contact | Kaseya BMS: Contact |
| First Name | First Name |
| Last Name | Last Name |
| Title | Job Title |
| Emails | Emails |
| Phones | Contact Phone Numbers |
| Location | Location |
| Important Contact | Point of Contact |
Locations
| IT Glue: Location | Kaseya BMS: Location |
| Name | Location Name |
| Address 1 | Address 1 |
| Address 2 | Address 2 |
| City | City |
| State/Province | State/Province |
| Zip/Postal Code | Zip/Postal Code |
| Country | Country |
| Phone | Phone |
| Fax | Fax |
Matching logic
Standard matching rules are used to match records within IT Glue when pulling data from Kaseya BMS. The sync will discover accounts, configuration items, contacts, and account/contact addresses in Kaseya BMS and match them to data in IT Glue using the Kaseya BMS fields shown in the table below:
| IT Glue: Rule | Matches on |
| Organization | Account Name |
| Contacts | (Account) AND (First Name AND Last Name) |
| Configurations |
(Account) AND (Asset Type AND Asset Name) AND (Serial Number AND MAC address) * |
| Locations | (Location) AND (Address 1 AND Address 2 AND City AND State/Province AND Country) |
If the matching logic is unsuccessful in finding a match, a new record is created. When one or more identical matches are found, the item that was created first is matched on.
- Configurations: If more than one match, the system will try to narrow the matches using a unique identifier, such as a serial number or MAC address, before matching on date created.
- When a BMS integration is active, the configurations will use the following rules for matching:
- MAC and Serial Number both match.
- Only MAC matches.
- Only Serial Number matches.
