Trimble Connect Integration¶
Trimble Connect provides cloud-based and desktop BIM viewing with Enjade integration through both the Workspace API (web) and BIM Sync Hub (desktop).
Overview¶
| Feature | Web | Desktop |
|---|---|---|
| Connection Type | Workspace API | BIM Sync Hub |
| Selection Sync | Full support | Full support |
| Viewpoint Sync | Full support | Full support |
| Property Editing | Read only | Full support |
| Colorization | Limited | Full support |
| Visibility/Isolation | Limited | Full support |
| Section Box | Limited | Full support |
| Multi-model | Full support | Full support |
| Offline Support | No | Yes |
Trimble Connect Web¶
Prerequisites¶
- Trimble Connect account
- Enjade account linked to Trimble
- Project configured in both systems
Accessing Viewer Panel¶
- Open your project in Trimble Connect Viewer (web.connect.trimble.com)
- Navigate to Extensions → Enjade
- The Viewer Panel opens in a side panel
- Log in with your Enjade credentials
Project Linking¶
Link your Trimble Connect project to Enjade:
- In Enjade Admin, go to Project Settings
- Under Viewer Integration, select Trimble Connect
- Enter your Trimble project ID
- Click Connect
Features¶
Selection Sync¶
Selection synchronizes between Trimble and Enjade:
| Action | Result |
|---|---|
| Select in Trimble | Panel shows element |
| Search in Panel | Trimble highlights |
| Clear in Trimble | Panel clears |
Property Access¶
View properties from the viewer:
- Trimble properties - From uploaded models (read-only)
- Enjade properties - Extended properties
- Linked data - Classifications, costs, etc.
Trimble Connect Desktop¶
Prerequisites¶
- Trimble Connect Desktop installed (Windows)
- BIM Sync Hub running locally
- Enjade account
Installation¶
- Download the BIM Sync Hub plugin from your Enjade organization
- Extract to Trimble Connect Desktop extensions folder:
%APPDATA%\Trimble\Trimble Connect Desktop\Extensions\BimSyncHub - Restart Trimble Connect Desktop
- Access via View → BIM Sync Hub panel
Configuration¶
- Open the BIM Sync Hub panel in Trimble Connect Desktop
- Click Connect to connect to the local hub
- Select your project from the dropdown
- Configure sync options as needed
Features¶
Full Bidirectional Sync¶
The desktop plugin supports full bidirectional synchronization:
- Selection: Select elements in any connected viewer
- Viewpoint: Share camera position and orientation
- Colorization: Apply color overrides to elements
- Visibility: Show/hide elements across viewers
- Isolation: Isolate elements across viewers
- Section Box: Share section box configuration
Sync Options¶
| Option | Description |
|---|---|
| Selection | Sync element selection |
| Viewpoint | Sync camera position |
| Colors | Sync colorization overrides |
| Visibility | Sync show/hide state |
| Isolation | Sync isolation state |
| Section Box | Sync section box |
Trimble-Specific Options¶
| Option | Description |
|---|---|
| Sync model tree | Expand tree to selected elements |
| Auto-detect project | Auto-subscribe based on loaded models |
Manual Sync¶
Use manual sync buttons when automatic sync is disabled:
- Send Selection - Push current selection to other viewers
- Send Viewpoint - Push current camera to other viewers
- Send Section Box - Push current section to other viewers
- Reset All - Clear all sync state
Multi-User Collaboration¶
Multiple users can work simultaneously:
- Changes sync in real-time (via BIM Sync Hub)
- User presence shown in panel
- Conflict resolution for concurrent edits
API Integration¶
Web Integration¶
The web adapter uses the Trimble Connect Workspace API:
import { trimbleAdapter } from '@/services/adapters/trimbleAdapter'
// Check availability
if (trimbleAdapter.isAvailable()) {
await trimbleAdapter.connect()
// Subscribe to selection changes
trimbleAdapter.subscribeSelectionChanges((event) => {
console.log('Selected:', event.globalIds)
})
// Set selection
await trimbleAdapter.setSelectedGlobalIds(['1ABC...', '2DEF...'])
}
Desktop Integration¶
For custom Trimble Connect Desktop integrations:
using BimSyncHub.TrimbleConnect;
// Initialize plugin
BimSyncHubPlugin.Instance.Initialize();
// Get coordinator for direct API access
var coordinator = BimSyncHubPlugin.Instance.Coordinator;
// Connect to hub
await coordinator.ConnectAsync();
// Subscribe to project
coordinator.SubscribeToProject("project-123");
Troubleshooting¶
Extension not available (Web)¶
- Check Trimble Connect subscription level
- Verify Enjade extension is installed
- Contact admin for access
Plugin not loading (Desktop)¶
- Verify files are in correct extensions folder
- Check Windows event log for errors
- Ensure .NET 8 runtime is installed
Sync issues¶
- Check BIM Sync Hub is running (desktop)
- Verify project linking
- Check internet connection (web)
- Refresh the browser/restart application
Permission errors¶
- Verify Enjade permissions
- Check Trimble project role
- Contact project admin
Mobile Access¶
Trimble Connect supports mobile viewing:
- View elements on tablet/phone
- Limited editing on mobile
- Full sync with desktop (when online)