Model ID mapping

Title: Repair topic viewpoints after a model is removed
Audience: Design / CDE Admins

Purpose

Map an old model id (still referenced in viewpoints/clashes) to a current federated model, to repair viewpoints after a model is removed or replaced.

Relevance

Without remapping, Topics and clashes point to non-existent models, resulting in a “viewpoint failed” error. This is essential after re-uploading or changing federation.

Usage example

After replacing Architecture.ifc, the coordinator sees the old id in Model ids that need attention, selects 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 needing 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 left to map

Active mappings

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

How to use

1. Project Settings → Model ID mapping.
2. Review the attention table.
3. Add replacement mapping → From → To → save.
4. Test restore viewpoint in a Topic.

Links

• Topics · Explorer · Files

Tips / common errors

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