Release Notes

Version Information

• Current Application Version: 2.0.0
• ServiceNow Compatibility: Certified for Yokohama and Zurich versions.

---

2.0.0

Distribution Model Change: This version marks a significant milestone as the first release distributed exclusively through the ServiceNow Store and Application Manager (store identifier x_nbl_cmdb_integration, NetBox Labs CMDB Integration). All future updates will be delivered through ServiceNow's official distribution channels, ensuring better version control, automated updates, and improved compatibility verification.

Architectural Changes: Version 2.0.0 introduces fundamental changes to the application's data model and scope:

• Data Model Transformation:

  • v1.x stored NetBox-specific fields directly on base ServiceNow tables (cmdb_ci, cmn_location, cmdb_hardware_product_model, cmn_department, core_company)
  • v2.x centralizes all NetBox metadata in the new x_nbl_cmdb_netbox_attributes table using a 1:1 relationship model
  • Each ServiceNow record requiring NetBox integration has one corresponding row in the attributes table containing all NetBox-specific fields
  • This architecture provides better separation of concerns and eliminates the need to extend standard ServiceNow tables

• Application Scope Changes:

  • Updated application scope to align with ServiceNow Store requirements
  • Enhanced security and access controls
  • Improved namespace management

Migration Path:

• CRITICAL: There is NO automatic upgrade path from v1.x to v2.x
• Users must follow this mandatory migration procedure:
  1. Backup all NetBox integration data in v1.x using the data management functionality
  2. Uninstall the v1.x application completely from ServiceNow
  3. Install v2.x from the ServiceNow Store via Application Manager
  4. Restore the backup during the v2.x Guided Setup process
• The backup/restore process handles conversion between v1.x field structure and v2.x attributes table
• See Upgrading Guide for detailed migration instructions

No New Features: This release focuses exclusively on architectural improvements and distribution model changes. All functionality from v1.4.0 is preserved and remains available in v2.0.0.

Known Issues:

• Guided Setup may display blank page after pre-installation checklist. See Known Issues for workaround procedure