Werkzeugkasten-Handbuch für ExyViewer und JaMo App

Wichtige Optionen oder Eingaben

• Unterstützte Formate: `.ifc` und `.frag`.
• `.frag` ist das von ExyViewer erzeugte vorverarbeitete Schnellladeformat.

So wird es verwendet

1. 1. Klicken Sie auf `Load` und wählen Sie eine IFC- oder FRAG-Datei aus.
2. 2. Warten Sie, bis die Viewer-Fläche und der Strukturbaum aufgebaut sind.
3. 3. Wenn Sie mit mehreren Modellen arbeiten, verwenden Sie das Struktur-Panel zum Entladen oder Hinzufügen weiterer Dateien.

Wichtige Optionen oder Eingaben

• Navigationsmodus: `Orbit` oder `Pan`.
• Orientierungs-Shortcuts: vorne, hinten, links, rechts, oben, unten und isometrische Ansichten über den ViewCube.

So wird es verwendet

1. 1. Wählen Sie `Orbit`, um das Modell zu drehen, oder `Pan`, um das Kameraziel zu verschieben.
2. 2. Klicken Sie auf `Zoom All`, wenn das Modell außerhalb des Bildes liegt oder Sie alles erneut einrahmen möchten.
3. 3. Nutzen Sie den ViewCube, um direkt auf eine standardisierte orthogonale oder isometrische Richtung zu springen.

Wichtige Optionen oder Eingaben

• Optionen für Schnittkanten: Kanten anzeigen, Kantenfarbe und Kantenstärke.
• Die Grid-Sichtbarkeit wird im lokalen Speicher des Browsers zwischen Sitzungen gemerkt.

So wird es verwendet

1. 1. Wählen Sie ein oder mehrere Elemente aus, wenn nur diese ausgeblendet oder isoliert werden sollen.
2. 2. Aktivieren Sie `Section`, um Schnittebenen einzuschalten, und passen Sie bei Bedarf die Kantenoptionen an.
3. 3. Verwenden Sie `Hide` oder `Isolate` für die fokussierte Prüfung und `Reset`, um Schnittebenen zu löschen, Sichtbarkeit wiederherzustellen, Split-Views zu schließen und in den Standardzustand zurückzukehren.

Wichtige Optionen oder Eingaben

• Das Struktur-Panel kann Modelle hinzufügen und entladen.
• Das Eigenschaften-Panel unterstützt Suche und Zusammenfassungen für Mehrfachauswahlen.

So wird es verwendet

1. 1. Öffnen Sie `Structure`, um die geladene Modellhierarchie zu durchsuchen und ein Element auszuwählen.
2. 2. Öffnen Sie `Properties`, um Identitätsdaten, IFC-Informationen, Property Sets, Materialien, Layer und gemeinsame Werte einer Mehrfachauswahl zu prüfen.
3. 3. Verwenden Sie das Suchfeld in `Properties`, um lange Eigenschaftslisten einzugrenzen.

Wichtige Optionen oder Eingaben

• Overlay-Werkzeuge umfassen Text-, Wolken-, Pfeil- und Koordinaten-Annotationen.
• Markup-Anker können Kamerabewegungen folgen und an der Szenengeometrie haften.

So wird es verwendet

1. 1. Schalten Sie `Markup` über die Symbolleiste ein.
2. 2. Platzieren Sie Notizen, Wolken, Pfeile oder Koordinaten über dem Bereich, den Sie erläutern möchten.
3. 3. Verlassen Sie den Markup-Modus anschließend, damit normale Viewer-Interaktionen wieder sauber funktionieren.

Wichtige Optionen oder Eingaben

• Eingabedatei: IDS XML.
• Ergebnisfilter: `FAIL`, `PASS` oder `ALL`.

So wird es verwendet

1. 1. Öffnen Sie den Tab `IDS` und laden Sie eine IDS-Datei.
2. 2. Klicken Sie auf `Run Validation`, sobald Modell und IDS-Datei bereit sind.
3. 3. Filtern Sie die gruppierten Ergebnisse, klicken Sie auf ein fehlerhaftes Element zum Isolieren und Zoomen und erstellen oder öffnen Sie bei Bedarf das zugehörige BCF-Issue.

Wichtige Optionen oder Eingaben

• Modus: `internal` für ein Modell oder `federated` für Modell-zu-Modell-Prüfungen.
• Clash-Matrix: IFC-Typ-Paare aktivieren oder deaktivieren.
• Toleranzen: horizontal, vertikal, optionale Volumentoleranz und minimal meldepflichtiges Volumen.
• Clash-Klassen: duplicate, inside und overlapping.
• Optionaler `.clss`-Import zur Eingrenzung über eine Klassifikationsdatei.

So wird es verwendet

1. 1. Wählen Sie den Clash-Modus und bei Bedarf das aktive Modell oder Modellpaar.
2. 2. Passen Sie die Matrix so an, dass nur relevante Typkombinationen aktiv bleiben.
3. 3. Setzen Sie Toleranzen und starten Sie die Clash-Erkennung. Prüfen Sie anschließend gruppierte Ergebnisse, isolieren Sie Kollisionen oder exportieren Sie ausgewählte Clashs nach BCF.

Wichtige Optionen oder Eingaben

• Issue-Felder: Titel, Beschreibung, Priorität, Status, Typ, Verantwortlicher und Fälligkeitsdatum.
• Optionale Snapshot-Erfassung und Verknüpfung mit ausgewählten Elementen.
• Import- und Exportformate: `.bcfzip` und XLSX.

So wird es verwendet

1. 1. Wählen Sie ein oder mehrere Elemente aus, wenn das Issue mit Modellkomponenten verknüpft bleiben soll.
2. 2. Erstellen Sie bei Bedarf einen Snapshot und legen Sie dann das Issue an.
3. 3. Bearbeiten Sie bestehende Issues, fügen Sie Kommentare hinzu, aktualisieren Sie Metadaten, stellen Sie Ansichten wieder her oder exportieren Sie die Issue-Liste.

Wichtige Optionen oder Eingaben

• Klassifikationslayer mit Farben und Unterstützung für Duplikate.
• Kriterienquellen: query-basierte Regeln oder bestehende Klassifikationen.
• Abfragedimensionen umfassen IFC-Typ, Metadatenfelder, Property-Set-Namen, Property-Namen und Property-Werte.
• Exportoptionen umfassen Templates, benutzerdefinierte Header, ausgewählte Spalten, Formelzeilen, Elementzeilen, XLSX-Export und `.clss`-Export.

So wird es verwendet

1. 1. Erstellen Sie eine Klassifikation und fügen Sie einen oder mehrere Layer hinzu.
2. 2. Wählen Sie die Regelquelle, definieren Sie die Abfrage oder die referenzierte Klassifikation und prüfen Sie danach Treffer und Kennzahlen.
3. 3. Wenden Sie Farben im Viewer an, isolieren Sie bei Bedarf ein Ergebnis und exportieren Sie entweder die Arbeitsmappe oder die `.clss`-Datei.

Wichtige Optionen oder Eingaben

• Messwerkzeuge: Maß, Winkel, Neigung, Bandmaß und Fläche.
• Messoptionen: Farben, Einheiten, Genauigkeit, Schriftgröße und Textversatz.
• Werkzeuge des technischen Editors: Leader, Callout und Symbolplatzierung.
• Ansichtswerkzeuge: Smart Views, Geschosspläne, Kontextansichten, aktuelle Ansicht erfassen, Split View öffnen und Ansichten schließen.
• Exportformate: SVG, PDF, PNG und DXF mit Schaltern für Messungen, Annotationen und benutzerdefinierte Zeichnungen.

So wird es verwendet

1. 1. Erzeugen Sie eine Smart View, einen Geschossplan, eine Ansicht oder erfassen Sie die aktuelle Szene.
2. 2. Öffnen Sie eine erzeugte Ansicht im Split-Modus, wenn Sie offizielle Werkzeuge wie Maße, Winkel, Neigungstags, Leader, Callouts oder Symbole benötigen.
3. 3. Fügen Sie Annotationen oder manuelle Zeichnungen hinzu und exportieren Sie das Blatt im Format, das zu Ihrem Folgeworkflow passt.

Wichtige Optionen oder Eingaben

• Formate: JSON, CSV und XLSX.
• Einbezogene Datenblöcke: IDS-Validierung, Clash-Ergebnisse und BCF-Issues je nach verfügbaren Daten und gewähltem Format.

So wird es verwendet

1. 1. Öffnen Sie `Report`, nachdem die gewünschte Analyse abgeschlossen wurde.
2. 2. Wählen Sie das Exportformat und aktivieren Sie die Datenblöcke, die enthalten sein sollen.
3. 3. Starten Sie den Export und verwenden Sie die generierten Dateinamen auf Basis von Modellname und Zeitstempel.

Wichtige Optionen oder Eingaben

• Unterstützte Produkteditionen laut Repository-Metadaten: Revit 2024, 2025, 2026 und 2027.
• Lizenzlaufzeiten laut Repository-Mapping: 3 Monate, 6 Monate und 1 Jahr.

So wird es verwendet

1. 1. Bestätigen Sie, welche Revit-Version der Benutzer verwendet.
2. 2. Wählen Sie die passende JaMo-App-Edition und Laufzeit.
3. 3. Verwenden Sie den Installer und das Download-Mapping für genau diese Kombination.

Wichtige Optionen oder Eingaben

• Die Aktivierung verwendet einen Lizenzschlüssel plus Hash-Schlüssel.
• Das Refactor-Repository enthält Installer-, License-Service- und About-Window-Flows für Aktivierung und spätere Validierung.
• Die meisten Ribbon-Befehle bleiben deaktiviert, bis die Lizenzprüfung erfolgreich ist.

So wird es verwendet

1. 1. Laden Sie das MSI herunter, das zum Ziel-Revit-Jahr passt.
2. 2. Starten Sie den Installer und geben Sie die Aktivierungsschlüssel ein, wenn Sie dazu aufgefordert werden.
3. 3. Öffnen Sie Revit und prüfen Sie, ob der Tab `JaMoApp` mit seinen Panels erscheint.
4. 4. Wenn Befehle weiterhin deaktiviert bleiben, öffnen Sie `About` und führen Sie die Aktivierung oder erneute Lizenzprüfung dort zu Ende.

Wichtige Optionen oder Eingaben

• Der Button `About` ist immer aktiviert.
• Das About-Fenster ist der vorgesehene Zugriffspunkt für Kauf und Aktivierungswiederherstellung, wenn die Lizenz den Rest des Ribbons sperrt.

So wird es verwendet

1. 1. Öffnen Sie `About` im Panel `Info`.
2. 2. Prüfen Sie den angezeigten Lizenzstatus, das Ablaufdatum und den Aktivierungszustand.
3. 3. Nutzen Sie die dort angebotenen Kauf- oder Aktivierungsaktionen, falls das Add-in aktuell nicht lizenziert ist.

Wichtige Optionen oder Eingaben

• Betriebssystem: Windows 10 oder 11, 64-Bit.
• Unterstützte Revit-Editionen laut Web- und Add-in-Repository: 2024, 2025, 2026 und 2027.
• Das Add-in verwendet versionsspezifische Builds und API-Kompatibilitätsbehandlung für diese Revit-Versionen.

So wird es verwendet

1. 1. Prüfen Sie, ob der Benutzerrechner auf einer unterstützten Windows-Version läuft.
2. 2. Prüfen Sie, ob das richtige Revit-Jahr installiert ist.
3. 3. Bestätigen Sie, dass Sie den passenden JaMo-App-Build für genau dieses Revit-Jahr verteilen.
4. 4. Prüfen Sie vor einem größeren Rollout die benötigten Runtime- und Installer-Voraussetzungen.

Wichtige Optionen oder Eingaben

• Läuft über `ParametersWindow` mit Parameter-Service und Calculation-Service.
• Verwendet das aktive Revit-Dokument und öffnet als modeless Window.

So wird es verwendet

1. 1. Öffnen Sie `Parameters` im Panel `Pset_Parameters`.
2. 2. Prüfen Sie die verfügbaren Parameterdaten und wählen Sie den benötigten Prüf- oder Berechnungsworkflow.
3. 3. Lassen Sie das Fenster offen, wenn Sie parallel weiter in Revit arbeiten möchten.

Wichtige Optionen oder Eingaben

• Startet das `ParameterCheckerWindow` mit dem aktuellen `UIDocument`.
• Ist für schnelle Prüfung und visuelles Farbfeedback gedacht, nicht für ausführliches Reporting.

So wird es verwendet

1. 1. Öffnen Sie `Parameter Checker`.
2. 2. Wählen Sie den gewünschten Parameter oder den Prüfbereich im Dialog.
3. 3. Starten Sie die Prüfung und beurteilen Sie das farbcodierte Ergebnis im Modell.

Wichtige Optionen oder Eingaben

• Erfordert ein aktives Revit-Dokument.
• Startet ein modales Dashboard-Fenster und übergibt das aktive `UIDocument` an den Audit-Workflow.
• Ist auf Filterung, Analyse und statusbasierte Auswertung ausgelegt.

So wird es verwendet

1. 1. Öffnen Sie `PaRadar` im Ribbon.
2. 2. Filtern Sie das Parameterinventar oder den Audit-Umfang anhand des aktuellen Modell- oder Familienkontexts.
3. 3. Bewerten Sie die Statusanzeigen im Dashboard und leiten Sie daraus Bereinigungs- oder Folgeaufgaben ab.

Wichtige Optionen oder Eingaben

• Öffnet das `MassSurfaceWindow` für das aktive `UIDocument`.
• Läuft als fokussierter modaler Workflow.

So wird es verwendet

1. 1. Öffnen Sie `Mass Surface`.
2. 2. Geben Sie die erforderlichen Eingaben im Dialog an.
3. 3. Prüfen Sie das erzeugte Ergebnis in Revit und verfeinern Sie es bei Bedarf weiter.

Wichtige Optionen oder Eingaben

• Erfordert die Auswahl eines Toposolid und eines Floor.
• Verwendet Slab-Shape-Editing und dicht gesampelte Punkte aus den Kanten des gewählten Toposolid.

So wird es verwendet

1. 1. Klicken Sie auf `FloorFromTopo`.
2. 2. Wählen Sie das Quell-Toposolid aus, wenn Sie dazu aufgefordert werden.
3. 3. Wählen Sie anschließend den zu verändernden Boden aus.
4. 4. Lassen Sie JaMo App die Slab-Shape-Punkte anhand der topografischen Geometrie neu aufbauen.

Wichtige Optionen oder Eingaben

• Arbeitet mit Elementen in der aktiven Ansicht.
• Benötigt ein schreibbares Dokument.
• Unterstützt IFC-Schema-Erkundung und Entity-Zuordnung.

So wird es verwendet

1. 1. Öffnen Sie die Zielansicht in Revit und filtern Sie sie auf die zu bearbeitenden Elemente.
2. 2. Starten Sie `IFCmap`.
3. 3. Prüfen Sie die sichtbaren Elemente und weisen Sie die gewünschten IFC-Export-Entities zu.

Wichtige Optionen oder Eingaben

• Erfordert ein schreibbares Dokument und eine aktive Ansicht mit sichtbaren Elementen.
• Ist für Elemente gedacht, die bereits über `IFCmap` eine IFC-Entity-Zuordnung erhalten haben.

So wird es verwendet

1. 1. Bereiten Sie eine aktive Ansicht mit den zu bearbeitenden Elementen vor.
2. 2. Stellen Sie sicher, dass das IFC-Mapping bei Bedarf bereits gesetzt wurde.
3. 3. Öffnen Sie `Pset_map` und führen Sie den Workflow zur Property-Set-Validierung und -Anbindung aus.

Wichtige Optionen oder Eingaben

• Erfordert ein schreibbares Dokument und eine aktive Ansicht mit sichtbaren Elementen.
• Ist für Elemente gedacht, die bereits über `IFCmap` vorbereitet wurden.

So wird es verwendet

1. 1. Öffnen Sie eine Arbeitsansicht mit den Ziel-Elementen.
2. 2. Bestätigen Sie, dass die IFC-Entity-Zuordnungen bereits vorhanden sind.
3. 3. Starten Sie `Qto_map` und führen Sie den Quantity-Set-Workflow aus.

Wichtige Optionen oder Eingaben

• Basiert im Refactor-Repository auf IDS-1.0-orientierten Workflows.
• Verwendet gemeinsam Document-, Validation- und IFC-Mapping-Services.
• Öffnet als modeless Single-Instance-Fenster.

So wird es verwendet

1. 1. Öffnen Sie `IDS Spec`.
2. 2. Laden oder erstellen Sie die IDS-Definition, mit der Sie arbeiten möchten.
3. 3. Starten Sie die Validierung und prüfen Sie die resultierenden Konformitätsbefunde.

Wichtige Optionen oder Eingaben

• Benötigt ein schreibbares Dokument.
• Arbeitet als wertsetzende Ergänzung zu `IDS Spec`.
• Konzentriert sich auf falsche oder leere Property- und Attributwerte.

So wird es verwendet

1. 1. Öffnen Sie das Modell und stellen Sie sicher, dass das Dokument bearbeitbar ist.
2. 2. Starten Sie `IDS_Map`.
3. 3. Laden Sie die relevante IDS-Definition, prüfen Sie die Abweichungen und übernehmen Sie die erforderlichen Werte auf die Ziel-Elemente.

Wichtige Optionen oder Eingaben

• Erfordert ein schreibbares Dokument und eine aktive Ansicht.
• Setzt numerische Projektparameter in der Phasing-Gruppe voraus, z. B. `JM_Existing`, `JM_Demolished`, `JM_TEMporary` und `JM_New`.
• Wird im Refactor-Repository für Revit 2024 bis 2027 unterstützt.

So wird es verwendet

1. 1. Bereiten Sie die erforderlichen Phasing-Parameter vor und weisen Sie den Elementen Werte zu.
2. 2. Öffnen Sie `PH4D` und erstellen oder prüfen Sie die Phase Templates und Zeilen.
3. 3. Starten Sie die Simulation oder die View-Erzeugung, um die Baufolge zu bewerten.

Wichtige Optionen oder Eingaben

• Zielt auf IFC4-Georeferenzierungs-Workflows.
• Umfasst Prüfungen zu `IfcProject`, `IfcGeometricRepresentationContext`, `IfcMapConversion` und `IfcProjectedCRS`.
• Das zugehörige PRD beschreibt editierbare Werte wie EPSG, Easting, Northing, Höhe, Achsrotation und Maßstab.

So wird es verwendet

1. 1. Öffnen Sie `BIMGeoRef`.
2. 2. Führen Sie die Validierung der IFC-Georeferenzierungsdaten aus.
3. 3. Prüfen Sie fehlgeschlagene Regeln, bearbeiten Sie die erforderlichen Georeferenzierungswerte und speichern Sie bei Bedarf die korrigierte IFC-Datei.