# BIM 3D-Viewer Der BIM 3D Viewer bietet eine interaktive dreidimensionale Visualisierung des IFC-Modells (Industry Foundation Classes) Ihres Gebäudes. Betrieben von **Speckle**, ermöglicht er Beteiligten die Erkundung der Gebäudegeometrie, die Inspektion einzelner Objekte, die Verwaltung strukturierter Datenfelder und die Zusammenarbeit bei der Datenanreicherung — alles innerhalb der Magma-Plattform. *** ## Zugang zum BIM 3D Viewer Auf den BIM 3D Viewer kann auf zwei Arten zugegriffen werden: 1. Aus dem **Data Room** — Navigieren Sie zu einem IFC-Unterordner und klicken Sie auf **In BIM öffnen**. 2. Über die **Hauptnavigation des Gebäudes** — Klicken Sie auf die Registerkarte **3D-Modell** oder **BIM** im Gebäudemenü. *** ## Unterstütztes Dateiformat und Grenzen | Eigenschaft | Wert | | ------------------- | ----------------------------------------------------------------------------------------- | | Dateiformat | IFC (Industry Foundation Classes) | | Maximale Dateigröße | Bis zu 10 GB pro IFC-Datei | | Upload-Methode | Chunk-Upload (große Dateien werden für eine zuverlässige Übertragung in Teile aufgeteilt) | *** ## Magma-Gebäudeebenen Der BIM 3D Viewer organisiert Gebäudedaten über 7 hierarchische Ebenen, die jeweils einem Fachbereich oder einer Schicht des Gebäudes entsprechen: | Code | Ebene | Beschreibung | | ---- | ------------------------------ | --------------------------------------------------------------------- | | S | Structure | Statische Bauelemente (Stützen, Träger, Platten, Fundamente). | | A | Architecture | Architektonische Elemente (Wände, Türen, Fenster, Decken, Böden). | | W1 | Wired 1 — Mechanisch | HLK-Anlagen, Lüftung, Klimaanlage. | | W2 | Wired 2 — Sanitär | Sanitäranlagen, Wasserversorgung, Entwässerung. | | W3 | Wired 3 — Beleuchtung | Elektroanlagen, Beleuchtungseinrichtungen, Stromverteilung. | | W4 | Wired 4 — Geräte & Ausstattung | Installierte Geräte, Einrichtungsgegenstände, Ausrüstung. | | W5 | Wired 5 — Lebens- & Sicherheit | Brandschutz, Sicherheitssysteme, Notfallsysteme. | | F | Filled | Innengestaltung, Einrichtungsgegenstände, nicht tragende Ausbauteile. | > **Wichtig:** **Genesis** ist KEINE BIM-Ebene. Genesis-Dokumente (Eigentum, Recht, Finanzen) existieren nur im Data Room und sind im 3D-Modell nicht dargestellt. *** ## Objektdatenstruktur Jedes Objekt im BIM-Modell kann strukturierte Daten speichern, die in 12 Abschnitte gegliedert sind: | Abschnitt | Beschreibung | | ------------------------------ | -------------------------------------------------------------------------------------------------- | | **INDEX\_LEVEL** | Die Magma-Ebene, zu der dieses Objekt gehört (S, A, W1–W5, F). | | **OBJECT\_IDENTIFICATION** | Name, IFC-GUID, Objekttyp und eindeutige Bezeichner. | | **OBJECT\_CREATION** | Hersteller, Marke, Modellreferenz, Seriennummer, Einbaudatum. | | **SPATIAL\_DATA** | Stockwerkebene, Raum, Zone, Koordinaten, Abmessungen. | | **CONDITION\_ASSESSMENT** | Aktueller Zustandsstatus, Inspektionsnotizen, Wartungshistorie. | | **COMPLIANCE** | Zertifizierungen, Normenkonformität, Genehmigungen. | | **LIFECYCLE\_DATA** | Garantieinformationen, erwartete Lebensdauer, Ersatzplan. | | **SMART\_DATA** | IoT-Sensorkennungen, verbundene Geräte, Smart-Building-Datenverknüpfungen. | | **CONTRACT\_AND\_MAINTENANCE** | Wartungsverträge, Dienstleister, SLA-Details. | | **FINANCIAL\_DATA** | Anschaffungskosten, Aktuellwert, Abschreibung, Versicherungswert. | | **OBJECT\_LIVE\_DATA** | Echtzeit-Datenfeeds (Sensormesswerte, Betriebsstatus). | | **ADVANCED\_DATA** | Benutzerdefinierte oder spezialisierte Felder, die von anderen Abschnitten nicht abgedeckt werden. | ### Feldtypen Felder innerhalb jedes Abschnitts sind typisiert: | Typ | Beschreibung | | ----------- | ------------------------------------- | | **TEXT** | Freitextzeichenkette. | | **NUMBER** | Dezimalzahlenwert. | | **INTEGER** | Ganze Zahl. | | **BOOLEAN** | Wahr/Falsch-Umschalter. | | **FILE** | Dateianlage (Dokument, Bild, PDF). | | **SELECT** | Dropdown mit vordefinierten Optionen. | *** ## Objektdetailbereich Wenn Sie auf ein Objekt im 3D-Viewer klicken, öffnet sich der **Objektdetailbereich** auf der rechten Seite des Bildschirms. Dieser Bereich ist in Registerkarten gegliedert: ### Registerkarte OVERVIEW Eine Zusammenfassung der wichtigsten Identifizierungsinformationen des Objekts: * Objektname und -typ * IFC-GUID * Magma-Ebenenzuweisung * Aktueller Datenvollständigkeitsstatus ### Registerkarte BIM\_DATA Die wichtigste Dateneingabe- und Ansichtsschnittstelle, in Unterregisterkarten gegliedert: | Unterregisterkarte | Inhalt | | ------------------ | -------------------------------------------------------------------------------------------- | | **Basic** | Kernfelder aus OBJECT\_IDENTIFICATION, SPATIAL\_DATA und anderen grundlegenden Abschnitten. | | **Smart Queries** | Erweiterte Abfragen, die berechnete oder abgeleitete Daten aus mehreren Abschnitten abrufen. | | **Live Basic** | OBJECT\_LIVE\_DATA-Felder mit Echtzeit-Sensor- und Betriebsdaten. | | **Advanced** | ADVANCED\_DATA-Abschnittsfelder für spezialisierte oder benutzerdefinierte Daten. | ### Registerkarte BIM\_ORIGINAL\_DATA Zeigt die rohen, unverarbeiteten Eigenschaften an, die direkt aus der hochgeladenen Original-IFC-Datei extrahiert wurden. Dies sind die Quelldaten vor jeder Magma-Anreicherung. Nützlich für den Quervergleich, was im Originalmodell vorhanden war, gegenüber dem, was über die Plattform hinzugefügt wurde. ### Registerkarte CF\_DATA Vertrags- und Finanzdaten, in zwei Unterregisterkarten gegliedert: | Unterregisterkarte | Inhalt | | ------------------ | ----------------------------------------------------------------------------- | | **Contract** | CONTRACT\_AND\_MAINTENANCE-Abschnittsfelder (Serviceverträge, Wartungspläne). | | **Financial** | FINANCIAL\_DATA-Abschnittsfelder (Kosten, Werte, Abschreibung). | *** ## Seitenbereich Der Viewer enthält einen ausklappbaren Seitenbereich auf der linken Seite des Bildschirms: * **Auswahl ausblenden / anzeigen** (Augensymbol) — Sichtbarkeit der aktuell ausgewählten Objekte in der 3D-Szene umschalten. * **Isolieren / Isolation aufheben** (Filtersymbol) — Das/die ausgewählte(n) Objekt(e) isolieren, sodass alle anderen Geometrien transparent oder ausgeblendet werden, damit Sie sich auf ein bestimmtes Element konzentrieren können. * Der Seitenbereich ist **in der Größe veränderbar** — Ziehen Sie den Trenner, um seine Breite anzupassen. *** ## Viewer-Werkzeuge Die Werkzeugleiste oben oder seitlich am Viewer bietet Zugang zu einer Reihe von Werkzeugen. Auf jedes Werkzeug kann auch über eine Tastenkombination zugegriffen werden: ### Ansichten (Alt + Zahl) Zwischen voreingestellten Kameraansichten wechseln: | Tastenkürzel | Ansicht | | ------------ | -------------- | | Alt+1 | Draufsicht | | Alt+2 | Vorderansicht | | Alt+3 | Linke Ansicht | | Alt+4 | Rückansicht | | Alt+5 | Rechte Ansicht | ### Anzeigemodi (Shift + Zahl) Den visuellen Rendering-Modus des Modells ändern: | Tastenkürzel | Modus | Beschreibung | | ------------ | ---------- | ----------------------------------------------------------- | | Shift+1 | Standard | Standardmäßige schattierte Darstellung. | | Shift+2 | Kanten | Drahtgitter-ähnliche Kantenanzeige. | | Shift+3 | Schattiert | Glatt schattiert ohne Kanten. | | Shift+4 | Stift | Stilisierte Stift-/Tuschedarstellung. | | Shift+5 | Arktisch | Minimale weiße/helle Darstellung für saubere Dokumentation. | | Shift+6 | Farben | Farbcodierung nach Objekttyp. | ### Weitere Werkzeuge (Shift + Buchstabe) | Tastenkürzel | Werkzeug | Beschreibung | | ------------ | ------------------ | ---------------------------------------------------------------------------------------- | | Shift+R | Messungen | Messwerkzeug aktivieren. | | Shift+F | Stockwerke | Stockwerkauswahl öffnen. | | Shift+P | Projektion | Zwischen Perspektiv- und orthografischer Projektion umschalten. | | Shift+B | Schnittbox | Eine Beschneidungsbox aktivieren, um das Modell zu schneiden und Innenräume freizulegen. | | Shift+Space | Zoom anpassen | Zoomen und verschieben, um das gesamte Modell in die Ansicht einzupassen. | | Shift+M | Modelle | Modellverwaltungswerkzeug öffnen. | | Shift+S | Suche / Filter | Such- und Filterpanel öffnen. | | Shift+E | Explorer | Objektexplorer (Hierarchiebaum) öffnen. | | Shift+N | Benachrichtigungen | Benachrichtigungspanel öffnen. | | Shift+T | Aufgaben | Aufgabenpanel öffnen (zeigt Aufgabenanzahl-Badge an). | *** ## Messwerkzeug Über **Shift+R** aktiviert. Das Messwerkzeug ermöglicht präzise Abstandsmessungen zwischen Punkten im 3D-Modell. ### Messtypen | Typ | Beschreibung | | ------------------ | --------------------------------------------------------------------------------------- | | **Punkt-zu-Punkt** | Klicken Sie auf zwei Punkte im Modell, um den geraden Abstand zwischen ihnen zu messen. | | **Senkrecht** | Den senkrechten Abstand von einem Punkt zu einer Oberfläche oder Kante messen. | ### Einrasten Das Werkzeug rastet an **Objekteckpunkten** für präzise Messungen ein und stellt sicher, dass Sie exakte Kante-zu-Kante- oder Ecke-zu-Ecke-Abstände erfassen. ### Einheiten Messungen können in jeder der folgenden Einheiten angezeigt werden, die aus den Werkzeugoptionen wählbar sind: `mm` | `cm` | `m` | `km` | `in` | `ft` | `yd` | `mi` *** ## Modelle-Werkzeug (Shift+M) Das Modelle-Werkzeug verwaltet die in den Viewer geladenen IFC-Dateien. ### Eine neue IFC-Datei hochladen 1. Modelle-Werkzeug öffnen (Shift+M). 2. Auf **Modell hochladen** klicken. 3. Ihre IFC-Datei auswählen (bis zu 10 GB). Große Dateien werden automatisch in Teilen hochgeladen. 4. Das Modell erscheint in der Liste mit dem Status **PENDING** und einem Fortschrittsbalken. ### Modellverarbeitungsstatus | Status | Beschreibung | | ------------- | ----------------------------------------------------------------------------------- | | **PENDING** | Die Datei wurde hochgeladen und wartet auf Verarbeitung. | | **FAILED** | Verarbeitung fehlgeschlagen. Eine Schaltfläche **Erneut versuchen** wird angezeigt. | | **AVAILABLE** | Die Verarbeitung ist abgeschlossen. Das Modell wird im Viewer geladen. | ### Ein Modell löschen Ein Modell kann gelöscht werden, wenn mehr als ein Modell geladen ist. Klicken Sie auf das Löschen-Symbol (Papierkorb) neben dem Modell in der Liste. Das Löschen entfernt die Geometrie aus dem Viewer, hat jedoch keinen Einfluss auf im Data Room gespeicherte Dokumente. *** ## Beteiligte-Werkzeug Das Beteiligte-Werkzeug, auf das von innerhalb des BIM 3D Viewers zugegriffen werden kann, bietet die vollständige Funktionalität der Beteiligten-Verwaltung, ohne den Viewer-Kontext verlassen zu müssen. Sie können: * Die aktuelle Beteiligtenliste mit ihren Rollen anzeigen. * Neue Beteiligte einladen. * Bestehende Beteiligtenrollen ändern. * Beteiligte entfernen. Dies spiegelt das vollständige Beteiligten-Verwaltungspanel wider, das in den Gebäudeeinstellungen verfügbar ist. *** ## Filterwerkzeug (Shift+S) Filtern Sie, welche Objekte in der 3D-Szene sichtbar sind, basierend auf ihren BIM-Feldwerten. ### So filtern Sie 1. Filterwerkzeug öffnen (Shift+S). 2. Ein **Feld** aus dem Dropdown auswählen (aus einem der 12 Datenabschnitte). 3. Einen **Operator** auswählen (gleich, enthält, größer als, kleiner als usw.). 4. Einen **Wert** zum Filtern eingeben. 5. Auf **Anwenden** klicken. Objekte, die dem Filter entsprechen, werden im Viewport hervorgehoben oder isoliert. Mehrere Filter können mit UND/ODER-Logik kombiniert werden. *** ## Initialisierungsassistent Für neue Gebäude oder neu hochgeladene IFC-Dateien führt der **Initialisierungsassistent** Sie durch die anfängliche Dateneingabe für alle 12 Abschnitte über alle Objekte hinweg. ### Funktionsweise 1. Der Assistent zeigt ein **Formular pro Abschnitt** für jedes Objekt (oder Gruppen von Objekten) an. 2. Für jeden Abschnitt füllen Sie die entsprechenden Felder aus. 3. Der **Original-BIM-Daten-Assistent** ist als Hilfsbereich verfügbar — er zeigt die aus der hochgeladenen Datei extrahierten IFC-Roheigenschaften an, die **durchsuchbar** sind und als Referenz verwendet oder direkt zum Ausfüllen von Formularfeldern zugeordnet werden können. 4. Ein **WebSocket-Fortschrittsanzeiger** zeigt den Echtzeit-Verarbeitungsstatus an, während die Daten gespeichert und synchronisiert werden. Der Assistent kann angehalten und fortgesetzt werden. Teilweise abgeschlossene Objekte werden automatisch gespeichert. *** ## Workflow für Feldänderungsanfragen Wenn ein Beteiligter einen Feldwert an einem BIM-Objekt ändern möchte, reicht er eine **Feldänderungsanfrage** ein, anstatt den Wert direkt zu bearbeiten. Dies stellt die Datenintegrität durch einen Validierungsgenehmigungsprozess sicher. ### Eine Änderungsanfrage einreichen 1. Im Objektdetailbereich auf **Bearbeiten** für das Feld klicken, das Sie ändern möchten. 2. Den vorgeschlagenen neuen Wert eingeben. 3. Eine optionale Notiz hinzufügen, die den Grund für die Änderung erläutert. 4. Die Anfrage einreichen. ### Validator-Abstimmung * Validatoren, die dem Objekt oder der Ebene zugewiesen sind, werden über die ausstehende Änderung benachrichtigt. * Jeder Validator gibt eine Stimme ab: **Genehmigen** oder **Ablehnen**. * Bei einer Ablehnung muss ein Ablehnungsgrund angegeben werden. * **Alle zugewiesenen Validatoren müssen genehmigen**, damit die Änderung übernommen wird. Wenn **irgendein Validator ablehnt**, wird die Änderungsanfrage blockiert. ### Popup für ausstehende Änderungen Validatoren sehen ein **Popup für ausstehende Änderungen**, wenn sie das betroffene Objekt öffnen. Dieses Popup zeigt: * **Aktueller Wert** — Der bestehende Feldwert. * **Vorgeschlagener Wert** — Der angeforderte neue Wert. * **Abstimmungsstatus** — Wer hat abgestimmt, wer steht noch aus. * **Genehmigen**- und **Ablehnen**-Schaltflächen (mit Pflichtfeld für Ablehnungsgrund). ### Aufgabenintegration Feldänderungsanfragen erzeugen automatisch **VALIDATE\_3D\_MODEL\_FIELD**-Aufgaben, die im [Aufgaben](/magma-documentation/de/funktionen/tasks.md)-Panel (Shift+T) sichtbar sind. *** ## Direkte Verlinkung zu Objekten Jedes Objekt im BIM-Viewer kann direkt verlinkt werden. Der URL-Parameter `?objectId=`, der an die Viewer-URL angehängt wird, öffnet den Viewer mit diesem spezifischen vorausgewählten und fokussierten Objekt. **Beispiel:** ``` https://app.mymagma.com/buildings/[building-id]/bim?objectId=abc123 ``` Dieser Link kann mit Beteiligten geteilt werden — ein Klick öffnet den Viewer und wählt sofort das angegebene Objekt aus. Direkte Verlinkungen werden auch von der Funktion [Wertbeiträge](/magma-documentation/de/funktionen/value-contributions.md) genutzt, bei der ein Klick auf eine Zeile eines 3D-Modellobjekts in der Beiträgetabelle den Viewer an genau diesem Objekt öffnet. *** ## Tipps und Best Practices * Verwenden Sie **Shift+B (Schnittbox)**, um durch Wände und Böden zu schneiden, wenn Sie HLS-Systeme (Heizung, Lüftung, Sanitär) inspizieren, die im Inneren der Struktur verborgen sind. * Verwenden Sie **Shift+F (Stockwerke)**, um eine einzelne Stockwerkebene zu isolieren und visuelle Unordnung zu reduzieren, wenn Sie an Innenelementen arbeiten. * Das **Filterwerkzeug** ist leistungsstark für die Qualitätskontrolle — filtern Sie Objekte nach `CONDITION_ASSESSMENT`-Feldern, um schnell Elemente in schlechtem Zustand zu identifizieren. * Schließen Sie immer den **Initialisierungsassistenten** für neu hochgeladene Modelle ab, bevor Sie Beteiligte zur Überprüfung der Daten einladen — unvollständige Daten reduzieren den Magma Index-Wert. * Verwenden Sie **direkte Verlinkungen** (`?objectId=`) bei der Koordination mit Beteiligten in E-Mails oder Aufgabenbeschreibungen, um sie direkt zum jeweiligen Objekt zu leiten. * Laden Sie mehrere fachspezifische IFC-Dateien (eine pro Ebene: S, A, W1–W5, F) statt eines kombinierten Modells hoch, für bessere Leistung und Datenorganisation. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mymagma.com/magma-documentation/de/funktionen/bim-3d-viewer.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.