Revisionen, Exporte und Vergleich

Revisionen sind die Kernhistorie eines Teils oder einer Baugruppe. Exporte und PNG-Ansichten sind abgeleitete Daten, die beim Prüfen und Vergleichen helfen.

Revisionsstatus

Eine Revision startet als Entwurf. Admins können sie auf Freigegeben setzen. Eine freigegebene Revision kann später als Obsolet markiert werden.

Typischer Ablauf:

1. Neue .FCStd hochladen.
2. 3D-Anzeige und Metadaten kontrollieren.
3. Optional PNG-Ansichten und Exporte erzeugen.
4. Revision freigeben.
5. Alte freigegebene Revisionen obsolet markieren, wenn sie nicht mehr verwendet werden sollen.

Jobs und Artefakte

Unter Mehr -> Jobs und Artefakte findest du:

• laufende oder abgeschlossene Jobs,
• Fehlermeldungen fehlgeschlagener Jobs,
• erzeugte Artefakte,
• PNG-Galerie, falls PNG-Ansichten vorhanden sind.

Jobtypen:

• FreeCAD-Analyse: liest exportierbare Objekte und VarSets,
• Export: erzeugt STEP, STL oder 3MF,
• PNG-Ansichten: erzeugt feste Ansichten für Sichtvergleich.

Der Worker verarbeitet diese Jobs im Hintergrund.

FreeCAD-Analyse

Die Analyse nutzt FreeCADCmd und liest aus der Datei aus, welche Objekte exportierbar sind und ob VarSets vorhanden sind. Danach kann die Web-UI gezieltere Exportoptionen anbieten.

Wenn keine Objektliste vorhanden ist, muss zuerst eine Analyse erfolgreich gelaufen sein.

Exporte

Nach erfolgreicher Analyse kannst du Exporte planen. Unterstützte Exportformate sind:

• STEP,
• STL,
• 3MF.

Exporte sind abgeleitete Dateien. Sie ersetzen nicht die .FCStd-Revision, sondern erleichtern Weitergabe, Viewer und Fertigungsvorbereitung.

PNG-Ansichten

PNG-Ansichten werden serverseitig für definierte Blickrichtungen erzeugt. Sie dienen vor allem dazu, Revisionen visuell nebeneinander vergleichen zu können.

Das aktuelle Konzept nutzt keinen FreeCAD-GUI-Viewport. Der Worker exportiert headless mit FreeCADCmd und rendert daraus deterministische Vorschaubilder.

Bei Baugruppen gehört zur Revision auch ihr damaliger Projektstand: Der Worker lädt die Hauptdatei zusammen mit genau den Unterteilrevisionen, die in diesem historischen Projektstand verknüpft waren. Er verwendet nicht die aktuellsten gleichnamigen Dateien aus dem Projekt. Dadurch zeigen 3D-Vorschau und PNG-Vergleich tatsächlich den Zustand der gewählten Revision.

Die Vorschauerzeugung besitzt eine interne Generator-Version. Wenn sich die Erzeugungslogik ändert, gelten ältere PNG- und Viewer-Artefakte nicht mehr als aktuelle Vorschau und werden bei Bedarf neu erzeugt.

Revisionen visuell vergleichen

Auf der Teilseite klickst du Visuell vergleichen.

Dann wählst du:

• linke Revision,
• rechte Revision.

FreeCAD-PLM zeigt gleichnamige PNG-Ansichten nebeneinander an. Wenn für eine oder beide Revisionen noch PNGs fehlen, zeigt die Seite den PNG-Status und weist darauf hin, dass zuerst Ansichten erzeugt werden müssen.

Jede Seite des Vergleichs verwendet ausschließlich PNGs der dort ausgewählten Revision und der aktuellen Vorschaugenerator-Version.

Praktisch ist dieser Vergleich vor allem für kleine Konstruktionsänderungen: Du siehst schnell, ob sich die erwarteten Ansichten verändert haben, ohne jede Revision einzeln in FreeCAD zu öffnen.

3D-Anzeige

Die 3D-Anzeige ist für schnelle Sichtprüfung in der Web-UI gedacht. Sie öffnet einen Dialog mit Viewer-Werkzeugen wie Drahtgitter und Ansicht zurücksetzen.

Je nach vorhandenen Artefakten nutzt der Viewer vorbereitete STL- oder 3MF-Quellen. Falls eine Vorschau erst erzeugt werden muss, läuft das als Hintergrundjob.

Berechtigte Bearbeiter können über Anmerkung setzen einen Punkt auf der Modelloberfläche wählen und dort eine PLM-Anmerkung verankern. Marker werden revisionsbezogen geladen; ihr Status entspricht dem normalen offenen oder erledigten Anmerkungsstatus. Die Verankerung ergänzt die Anmerkung, sie erzeugt keinen getrennten Review-Datensatz.

Fehlgeschlagene Jobs

Wenn ein Job fehlschlägt:

1. Öffne Mehr -> Jobs und Artefakte an der betroffenen Revision.
2. Lies die Fehlermeldung.
3. Prüfe, ob der Worker läuft.
4. Prüfe, ob die Datei in FreeCADCmd headless geladen werden kann.
5. Prüfe bei Baugruppen, ob die referenzierten Dateien im Projektstand vorhanden sind.

Betriebliche Kommandos stehen in Troubleshooting.