Linking to Master
Linking connects a project resource (or template) to its master counterpart. Once linked, TX1 tracks the version of the master at the time of linking and monitors for updates.
Linking a Resource
- Select the project resource in the Resources view.
- Right-click → Link to Master → pick master resource.
- Choose a sync behaviour: Manual or AutoSync.
Behind the scenes: LinkToMasterAsync(projectResourceId, masterResourceId, syncBehavior).
The resource now shows a chain icon and the following fields are populated:
| Field | Meaning |
|---|---|
MasterResourceId | Points at the master. |
LinkedMasterVersion | Version captured on link. |
LastSyncedFromMaster | Timestamp of last sync. |
SyncBehavior | Manual / AutoSync. |
HasLocalModifications | True once you edit the linked resource. |
IsLinkedToMaster (derived) | True. |
Unlinking
Right-click → Unlink from Master. The resource keeps its current data but loses the link — future master changes no longer flow in.
Linking a Template
Same pattern via Templates → Link to Master.
LinkSyncStatus Values
| Value | Meaning |
|---|---|
| Unlinked | No MasterResourceId. |
| Synced | Up to date with master. |
| LocallyModified | You've edited it since sync. |
| UpdateAvailable | Master is newer than your link. |
| LocallyModifiedWithUpdate | Both local edits and a newer master exist. Conflict. |
The Resources view shows the status per resource with a colour-coded icon.
HasLocalModifications
Flips to true the first time you edit any property on a linked resource. Once set, a manual sync will warn you that local changes may be overwritten.
The flag is set via MarkLocallyModifiedIfLinked() inside property setters. During a sync, SuppressLocalModificationTracking is temporarily true so the sync itself doesn't re-flag the resource.
Save to Master
Promote a project resource to the master library: Right-click → Save to Master.
This creates a new master record (or updates an existing one if you have admin permissions) and automatically links the project resource to it.
Bulk Linking
Resources → Bulk Link to Master runs through project resources and links those whose names match a master resource exactly. Useful when you've imported a project from elsewhere and want to reconnect to your standard library.