History & Versioning¶
Enjade tracks all changes to elements, providing complete audit trails and the ability to review past states.
History Tab¶
Access element history by clicking the History tab in the Viewer Panel.
Timeline View¶
The history timeline shows all changes chronologically:
┌─────────────────────────────────────────┐
│ History │
├─────────────────────────────────────────┤
│ ● Today, 14:32 │
│ Updated properties │
│ by John Smith │
│ │
│ ● Yesterday, 09:15 │
│ Type assignment changed │
│ by Jane Doe │
│ │
│ ● Dec 15, 11:20 │
│ Created │
│ by System Import │
└─────────────────────────────────────────┘
Version Details¶
Click on a history entry to see details:
- Date/Time - When the change occurred
- User - Who made the change
- Change Type - What kind of change
- Affected Properties - Which values changed
Change Types¶
Property Updates¶
When element properties are modified: - Shows old value → new value - Groups related changes together - Highlights what changed
Type Assignments¶
When types are assigned or removed: - Shows the type added/removed - Lists inherited properties affected - Notes any value overrides
Creation¶
When element was first added: - Initial import from BIM model - Manual creation - Bulk import
Deletion¶
When element was removed: - Soft delete (recoverable) - Hard delete (permanent)
Comparing Versions¶
Diff View¶
Compare two versions to see what changed:
- Select a starting version
- Select an ending version
- View the diff
┌─────────────────────────────────────────┐
│ Property │ Before │ After │
├─────────────┼─────────────┼─────────────┤
│ Status │ Draft │ Approved │
│ FireRating │ - │ REI 90 │
│ LoadBearing │ false │ true │
└─────────────────────────────────────────┘
Visual Indicators¶
| Color | Meaning |
|---|---|
| 🟢 Green | Added value |
| 🔴 Red | Removed value |
| 🟡 Yellow | Modified value |
| ⚪ Gray | Unchanged |
Filtering History¶
Filter the history timeline:
By Date Range¶
- Last 24 hours
- Last 7 days
- Last 30 days
- Custom range
By User¶
- Show changes by specific user
- Show only your changes
By Change Type¶
- Property changes only
- Type assignments only
- All changes
Restoring Previous Values¶
You can restore property values from a previous version:
- Find the history entry with desired values
- Click View Details
- Click Restore on specific properties
- Confirm the restoration
Note
Restoring creates a new version with the old values, preserving the full history.
Audit Trail¶
The history system provides a complete audit trail:
- Immutable - History cannot be edited or deleted
- Complete - Every change is recorded
- Traceable - User and timestamp for each change
- Exportable - History can be exported for compliance
Best Practices¶
- Add change notes - Document why changes were made
- Review before major changes - Check current state
- Use filters - Focus on relevant changes
- Export periodically - Keep external records for compliance