Track Changes Designer UI (Reference): Features for logging and tracking Introduction to Track Changes
Access: Track Changes (in Solution Explorer)
Table of Contents maxLevel
2 minLevel 2 indent 10px exclude Steps style none
Navigation Pages
| Page | Purpose | Primary Use |
|---|
| Recent Changes |
| Change log with configurable persistence | Audit trail and navigation |
| Version Control |
| Table version tracking | Online configuration sync |
| Cross-Reference |
| Object usage locations | Impact analysis |
| Use Count |
Presents the list objects in use, and the number of times it has been used. See Use Count.
Unused Objects
Presents the list objects created but not used in the configuration. See Unused Objects.
| Usage frequency | Resource optimization | |
| Unused Objects | Unreferenced objects | Cleanup candidates |
Core Functions
Change Tracking
Version Control tables maintain summaries by Module and Configuration Table, tracking current versions and last modifications of all solution elements. This ensures consistency when connecting to Runtime for online changes.
Cross-Reference Engine
Powers multiple analysis features:
- Find Results Panel in Designer
- Use Count calculations
- Unused Objects detection
- Impact analysis for changes
Limitations
Important: Cross-Reference only detects direct object usage. Indirect references are not tracked:
| Indirect Usage Type | Example | Impact |
|---|---|---|
| String references | Asset("/folder1/tag1") | Not detected |
| .Link property | TagReference via string | Not tracked |
| API access | External applications | Not visible |
| Dynamic references | Script-generated names | Not found |
| OPC UA/MQTT | External consumers | Not tracked |
Integration Points
With Designer
| Feature | Integration | Purpose |
|---|---|---|
| Find Results Panel | Uses Cross-Reference data | Object search |
| Home Page | Shows Recent Changes | Quick access |
| Runtime Diagnostics | Compares versions | Online config |
| Double-click navigation | From any table row | Direct access |
With Runtime
Version Control data enables:
- Online configuration verification
- Hot reload compatibility checks
- Change synchronization
- Version mismatch detection
Best Practices Checklist
Regular Maintenance
- Review Recent Changes daily
- Check Unused Objects weekly
- Monitor Use Count for optimization
- Verify Cross-References before deletion
Before Removing Objects
- Check Unused Objects table
- Verify no indirect references
- Confirm no external usage
- Use Find Results for verification
- Document removal reason
Change Management
- Configure appropriate auto-delete settings
- Keep audit trail for compliance
- Export changes for version control
- Review Version Control before deployment
Performance Considerations
| Aspect | Recommendation | Impact |
|---|---|---|
| Recent Changes | Set auto-delete policy | Database size |
| Cross-Reference | Refresh periodically | Query speed |
| Use Count | Review weekly | Performance insight |
| Unused Objects | Clean quarterly | Solution size |
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Missing references | Indirect usage | Manual verification |
| Version mismatch | Unsaved changes | Save and build |
| Large change log | No auto-delete | Configure cleanup |
| Slow navigation | Large database | Optimize settings |
In this section...
| Page Tree | ||
|---|---|---|
|
In this section:
Overview
Content Tools
Tasks