Model ID mapping | Help

UI: Model ID mapping (BETA)
Title: Repair topic viewpoints after a model is removed
Deep link: ?settings=project&section=model-reference-remaps
Audience: Design / CDE Admins

What it's for

Mapping an old model ID (still referenced in viewpoints/clashes) to a current federated model, to repair viewpoints after model removal/replacement.

Relevance

Without remapping, Topics and clashes point to non-existent models — “viewpoint failed”. Essential after re-upload or federation change.

Usage example

After replacing Architecture.ifc, the coordinator sees the old ID in Model IDs that need attention, Add replacement mapping → From old ID → To federated model, and confirms.

Who can use it

Project Settings with access to Model ID mapping.

Screen anatomy

Title + description.
Table of IDs that need attention.
Add replacement mapping form.
Active mappings list with remove option.

Options and fields

Usage table

Control	Function
Model IDs that need attention	Orphans / broken refs
Mapped · Model ID · Name · In project · Federated (current) · Viewpoint refs · Clash refs	Columns
Empty	No broken references detected from viewpoints.
Yes/No	Exists / federated

Add replacement mapping

Control	Function
Add replacement mapping	Opens flow
From (old model ID)	Old GUID / select Select model to remap
To (replacement model)	Destination federated model
Loading / empty federated	Loading… or paste manual GUID
All models needing attention are already mapped.	Nothing to map

Active mappings

Control	Function
From / To (replacement)	Active pairs
Remove mapping	Removes
Empty	No mappings yet.
Action Map	Confirms mapping (label may appear in PT in the UI)

How to use

Project Settings → Model ID mapping (BETA).
Review the attention table.
Add replacement mapping → From → To → save.
Test viewpoint restore in a Topic.

Model ID mapping

Tips / common errors

No federated models → paste GUID manually in To.
Remapping does not recreate geometry; it only resolves IFC GUID lookups in the replacement model.