Table of Contents
- FreeCAD-Addon Handbuch
- Ziel des Addons
- Voraussetzungen
- Installation und Aktivierung
- Verbindung einrichten
- Aufbau der Addon-Ansicht
- Konsolenausgaben
- Lokaler Workspace
- Ablauf: Verbinden und Daten laden
- Ablauf: Projekt, Teil und Revision finden
- Ablauf: Revision read-only öffnen
- Ablauf: Revision auschecken
- Checkout-Guard
- Ablauf: Aktiven Checkout wieder öffnen
- Ablauf: Einchecken
- Änderungserkennung
- Ablauf: Checkout abbrechen
- Projekt importieren aus FreeCAD
- Projekt und Teil bearbeiten
- Notizen und Anmerkungen
- Server-API, die das Addon verwendet
- Cache-Limits
- Best Practices
- Troubleshooting
- Keine Projekte werden geladen
- 403 oder Scope-Fehler
- Checkout ist laut Server aktiv, lässt sich aber nicht wieder öffnen
- Server meldet bereits aktiven Checkout
- Check-in erzeugt keine neue Revision
- SHA-256 stimmt nicht
- Referenzen fehlen nach dem Öffnen
- Meldungen erscheinen nicht im Dock
- Begriffsabgleich
- Wann die Web-UI besser ist
FreeCAD-Addon Handbuch
Das FreeCAD-PLM Addon verbindet FreeCAD direkt mit dem PLM-Server. Es ist für den täglichen CAD-Arbeitsablauf gedacht: Projekt finden, Teil oder Baugruppe auswählen, Revision öffnen, Änderungen auschecken, bearbeiten und wieder einchecken.
Dieses Handbuch richtet sich an technisch versierte Anwender. Es erklärt nicht FreeCAD selbst, sondern wie das Addon mit FreeCAD-PLM zusammenspielt, welche lokalen Dateien entstehen und welche typischen Fehlerbilder du einordnen solltest.
Ziel des Addons
Das Addon ist kein Ersatz für die Web-Oberfläche. Die Web-UI bleibt die Stelle für Übersicht, Administration, Revisionhistorie, Artefakte, Fertigungsdateien und tiefergehende Prüfung. Das Addon ist die Arbeitsbrücke in FreeCAD.
Der Normalfall sieht so aus:
PLM verbinden
-> Projekt wählen
-> Teil oder Baugruppe wählen
-> Revision wählen
-> read-only ansehen oder auschecken
-> in FreeCAD bearbeiten
-> einchecken oder Checkout abbrechen
Wichtig ist die Unterscheidung zwischen read-only öffnen und auschecken:
Read-only öffnenlädt eine Revision zum Ansehen. Es entsteht kein Checkout-Lock auf dem Server.Auscheckenreserviert die Revision für dich, lädt den zusammengehörenden Dateisatz und aktiviert Check-in/Abbrechen.
Voraussetzungen
Du brauchst:
- FreeCAD mit installiertem
FreeCAD-PLMWorkbench-Addon, - eine erreichbare FreeCAD-PLM-Server-URL,
- ein API-Token mit passenden Scopes,
- Schreibzugriff auf den lokalen Workspace-Ordner.
Typische Server-URL:
https://plm.lan.schumbi.de
Typischer Workspace:
~/FreeCAD-PLM
Das API-Token wird serverseitig erzeugt. Für normale CAD-Arbeit werden diese Scopes empfohlen:
read write checkout
Für Projektanlage und Projektmetadaten über das Addon ist zusätzlich admin nötig:
read write checkout admin
Scope-Bedeutung:
read: Projekte, Teile, Revisionen, Manifeste, Downloads und Anmerkungen lesen.write: Teile bearbeiten, Notizen und Anmerkungen schreiben.checkout: Revisionen auschecken, aktive Checkouts laden, einchecken und abbrechen.admin: Projekte anlegen oder Projektstammdaten ändern.
Installation und Aktivierung
Das Addon muss als FreeCAD-Workbench im Benutzer-Mod-Verzeichnis liegen.
Unter Linux mit Flatpak ist der typische Pfad:
~/.var/app/org.freecad.FreeCAD/data/FreeCAD/v1-1/Mod/freecad-plm-addon
Bei klassischer Linux-Installation ist es oft:
~/.local/share/FreeCAD/Mod/freecad-plm-addon
In FreeCAD kannst du den tatsächlich verwendeten Benutzerpfad in der Python-Konsole abfragen:
import FreeCAD as App
App.getUserAppDataDir()
Nach dem Start von FreeCAD wählst du die Workbench FreeCAD-PLM. Die Toolbar enthält Befehle wie:
PLM-Verbindung aktivieren,Verbinden,Aktualisieren,Auschecken,Einchecken,Checkout abbrechen,Anmerkung erstellen.
Der wichtigste Einstieg ist PLM-Verbindung aktivieren. Dadurch öffnet sich das Dock und das Addon versucht, Projekte und aktive Checkouts zu laden.
Verbindung einrichten
Oben im Addon-Dock steht der Verbindungsstatus, zum Beispiel:
Verbunden mit plm.lan.schumbi.de
Über Verbindungseinstellungen öffnest du den Dialog für:
- Server-URL,
- API-Token,
- Workspace,
- Cache-Limits für read-only geöffnete Dateien.
Nach Speichern und verbinden speichert das Addon die Werte in den FreeCAD-Preferences und lädt Projekte sowie aktive Checkouts neu.
Die Einstellungen liegen in FreeCAD unter:
User parameter:BaseApp/Preferences/Mod/FreeCADPLM
Praktisch bedeutet das: Die Werte gehören zum FreeCAD-Benutzerprofil, nicht zum Projektordner.
Aufbau der Addon-Ansicht
Die aktuelle Ansicht ist auf den Arbeitsfluss reduziert.
+----------------------------------------------------+
| Verbunden mit ... Aktualisieren Verbindungseinstellungen |
+----------------------------------------------------+
| Projekte |
| CHIPBOX |
| |
| Teile |
| P-001 - Box |
| |
| Revisionen |
| R0001 · Entwurf · Box.FCStd · 2026-07-10 |
| |
| Aktive Checkouts |
| Checkout 42 - CHIPBOX, P-001, Revision R0001 |
+----------------------------------------------------+
| R0001 · Entwurf · Box.FCStd Auschecken ... |
| Aktiver Checkout ... Öffnen Einchecken...|
+----------------------------------------------------+
Die vier Listenbereiche teilen sich den verfügbaren Platz dynamisch. Du kannst die Trennlinien im Dock verschieben.
Projekte
Die Projektliste zeigt Projekte als:
CODE - Name
Aktionen in diesem Bereich:
Projekt importieren: lokalen FreeCAD-Ordner als Projektstand importieren oder neues Projekt anlegen.Projekt bearbeiten: Code, Name, Status, Datum und Beschreibung bearbeiten.
Teile
Die Teileliste zeigt Teile und Baugruppen als:
P-001 - Box
Wenn ein Status vorhanden ist, erscheint er in eckigen Klammern.
Aktionen:
Neues Teil: neues Teil oder neue Baugruppe als PLM-Metadatensatz anlegen.Teil bearbeiten: Name, Kategorie, Beschreibung, Material, Lieferant, Tags und Archivstatus bearbeiten.
Revisionen
Die Revisionsliste ist die primäre Arbeitsliste. Labels sind bewusst kurz:
R0001 · Entwurf · Box.FCStd · 2026-07-10
Aktionen:
- Einfachklick: Revision auswählen.
- Doppelklick: Revision auschecken.
Auschecken: Checkout-Lock erzeugen und Dateien in den Workspace laden.Read-only öffnen: Revision ohne Lock öffnen.Details: technische und fachliche Revisionsdaten anzeigen.Notizen: Revisionsnotizen bearbeiten.Anmerkungen: Anmerkungen zu Teil und Revision anzeigen und bearbeiten.
Aktive Checkouts
Die Liste Aktive Checkouts kommt vom Server. Sie zeigt aktive Checkouts deines API-Benutzers. Dadurch gehen Checkout-Locks nicht verloren, nur weil FreeCAD geschlossen wurde.
Die untere Arbeitsleiste zeigt zusätzlich den lokal aktiven Checkout. Das ist der Checkout, den das Addon gerade in dieser FreeCAD-Sitzung geöffnet hat und für den Einchecken und Abbrechen aktiv sind.
Konsolenausgaben
Das Addon schreibt Statusmeldungen in das normale FreeCAD-Ausgabefenster. Alle Meldungen beginnen mit:
[FreeCAD-PLM]
Beispiele:
[FreeCAD-PLM] 4 Projekte geladen. Aktive Checkouts: 1.
[FreeCAD-PLM] Checkout geöffnet (3 Datei(en))
[FreeCAD-PLM] Checkout geöffnet: /home/ralf/FreeCAD-PLM/.../Box.FCStd (3 Datei(en))
Wenn du ein Problem analysierst, öffne zuerst FreeCADs Ausgabefenster beziehungsweise Report View und suche nach [FreeCAD-PLM].
Lokaler Workspace
Das Addon legt Dateien nicht irgendwo neben deiner aktuellen Konstruktion ab, sondern unter dem konfigurierten Workspace.
Default:
~/FreeCAD-PLM
Checkout-Pfad:
~/FreeCAD-PLM/<server-slug>/<project-code>/checkout-<checkout-id>/
Beispiel:
~/FreeCAD-PLM/plm-lan-schumbi-de/CHIPBOX/checkout-42/
Darin liegen:
manifest.json
checkout.json
files/
Box.FCStd
parts/Halter.FCStd
Bedeutung:
manifest.json: vom Server gelieferte Dateiliste mit Revisionen, Pfaden, Hashes und Root-Datei.checkout.json: lokale technische Metadaten zur Änderungserkennung.files/: die wirklichen FreeCAD-Dateien mit relativer Struktur aus dem Manifest.
Bei read-only geöffneten Revisionen nutzt das Addon einen getrennten Cache:
~/FreeCAD-PLM/<server-slug>/<project-code>/readonly/revision-<revision-id>/
Read-only Dateien werden lokal schreibgeschützt abgelegt. Sie sind zum Ansehen gedacht, nicht als Arbeitskopie.
Ablauf: Verbinden und Daten laden
Benutzer klickt PLM-Verbindung aktivieren
-> Addon liest Server-URL, Token und Workspace aus FreeCAD-Preferences
-> GET /api/projects/
-> GET /api/checkouts/active/
-> Projekte anzeigen
-> aktive Checkouts anzeigen
-> Status ins FreeCAD-Ausgabefenster schreiben
Wenn dieser Ablauf scheitert, prüfe:
- stimmt die Server-URL?
- ist das Token eingetragen?
- ist das Token noch gültig?
- hat das Token mindestens
readundcheckout? - ist der Server aus FreeCAD heraus erreichbar?
Ablauf: Projekt, Teil und Revision finden
Projekt auswählen
-> GET /api/projects/<id>/parts/
-> Teileliste füllen
Teil auswählen
-> GET /api/parts/<id>/
-> Revisionen aus Antwort lesen
-> Revisionsliste füllen
-> Anmerkungen für Teil/Revision laden
Die Web-Oberfläche ist weiterhin besser für globale Suche und Historie. Das Addon ist absichtlich auf den aktuellen Projektkontext optimiert.
Ablauf: Revision read-only öffnen
Read-only ist der sichere Weg, wenn du nur prüfen, messen, ansehen oder eine alte Revision vergleichen willst.
Revision auswählen
-> Read-only öffnen
-> GET /api/revisions/<revision-id>/manifest/
-> manifest.files herunterladen
-> SHA-256 je Datei prüfen
-> manifest.json in readonly Cache schreiben
-> Root-Datei öffnen
-> vollständigen lokalen Pfad im FreeCAD-Ausgabefenster melden
Dabei entsteht kein aktiver Checkout auf dem Server.
Nutze read-only für:
- Kontrolle alter Revisionen,
- Sichtprüfung,
- Vergleich,
- Referenzieren ohne Änderungsabsicht.
Nutze read-only nicht für echte Bearbeitung. Wenn du Änderungen einchecken willst, musst du auschecken.
Ablauf: Revision auschecken
Checkout ist der normale Bearbeitungspfad.
Revision auswählen oder doppelklicken
-> Addon prüft lokalen aktiven Checkout
-> wenn kein Checkout aktiv: POST /api/revisions/<id>/checkout/
-> Manifest laden oder aus Checkout-Antwort übernehmen
-> Dateien herunterladen
-> SHA-256 prüfen
-> manifest.json und checkout.json schreiben
-> Root-Datei in FreeCAD öffnen
-> aktiven Checkout im Dock anzeigen
Ein Checkout erzeugt serverseitig einen Lock. Dadurch soll verhindert werden, dass mehrere Benutzer denselben Stand gleichzeitig als Arbeitsstand einchecken.
Checkout-Guard
Das Addon verhindert absichtliches oder versehentliches Überschreiben des lokalen Arbeitskontexts.
Auschecken angefordert
-> keine Revision gewählt?
Meldung ausgeben
-> kein aktiver Checkout?
Checkout starten
-> gleiche Revision bereits lokal aktiv?
aktive Root-Datei öffnen/fokussieren
-> anderer Checkout lokal aktiv?
Entscheidungsdialog anzeigen
Bei einem anderen aktiven Checkout fragt das Addon:
Aktiven Checkout öffnen,Einchecken,Checkout abbrechen,Nicht starten.
Es startet keinen stillen zweiten Checkout.
Ablauf: Aktiven Checkout wieder öffnen
Nach einem FreeCAD-Neustart kann der Server noch aktive Checkouts kennen. Diese erscheinen in Aktive Checkouts.
Aktiven Checkout auswählen
-> Öffnen
-> wenn derselbe Checkout lokal schon aktiv ist:
Root-Datei öffnen/fokussieren
-> sonst:
lokalen Workspace-Pfad rekonstruieren
Manifest vom Server laden, falls nötig
fehlende Dateien herunterladen
checkout.json prüfen
Root-Datei öffnen
Wenn checkout.json fehlt, meldet das Addon:
[FreeCAD-PLM] PLM-Fehler: Checkout-Metadaten fehlen. Bitte Checkout abbrechen und neu auschecken.
Diese Meldung bedeutet: Der Server kennt noch den Checkout, aber die lokale Arbeitskopie ist nicht mehr vollständig genug, um Änderungen sicher zu erkennen. Das Addon kann dann nicht garantieren, welche Dateien wirklich geändert wurden.
Sinnvolle Reaktion:
- Wenn du keine lokalen Änderungen brauchst: Checkout abbrechen und neu auschecken.
- Wenn du lokale Änderungen retten musst: Workspace-Ordner manuell sichern, danach mit dem PLM-Zustand abgleichen.
Ablauf: Einchecken
Beim Check-in speichert das Addon zuerst geöffnete Checkout-Dokumente und prüft dann, welche Manifest-Dateien modellrelevant geändert wurden.
Einchecken
-> geöffnete Checkout-Dokumente speichern
-> manifest.json lesen
-> checkout.json lesen
-> technische Änderungen analysieren
-> unveränderte Dateien ignorieren
-> Änderungskommentar abfragen
-> geänderte Dateien mit Metadaten senden
-> POST /api/checkouts/<id>/checkin/
-> neue Revisionen vom Server übernehmen
-> lokale Checkout-Dokumente schließen
-> Checkout aus lokalem aktiven Zustand entfernen
-> Projekte/Revisionen/aktive Checkouts neu laden
Der Änderungskommentar ist Pflicht. Er soll fachlich beschreiben, was geändert wurde, zum Beispiel:
Laschenposition angepasst und Wandstärke auf 2,4 mm erhöht.
Nicht hilfreich sind Kommentare wie:
update
neu
fix
Änderungserkennung
FreeCAD speichert viele technische Daten, die sich ändern können, ohne dass sich das Modell fachlich geändert hat. Das Addon versucht, solche Speicherartefakte nicht als neue Revision zu behandeln.
Grundprinzip:
Base-Datei aus Checkout
-> aktuelle Datei aus Workspace
-> technische FCStd-Inhalte normalisieren
-> modellrelevante Änderung erkennen
Wenn keine modellrelevanten Änderungen gefunden werden, bleibt der Checkout aktiv. Das Addon bietet dann an, den Checkout abzubrechen.
Das ist Absicht: Eine neue Revision soll eine fachliche Änderung dokumentieren, nicht nur einen FreeCAD-Speichervorgang.
Ablauf: Checkout abbrechen
Checkout abbrechen bedeutet: Der Server-Lock wird freigegeben, ohne neue Revision anzulegen.
Checkout abbrechen
-> Bestätigung abfragen
-> POST /api/checkouts/<id>/cancel/
-> geöffnete Checkout-Dokumente schließen
-> lokalen aktiven Checkout zurücksetzen
-> aktive Checkouts neu laden
Nutze Abbrechen, wenn:
- du nur etwas ausprobiert hast,
- keine fachliche Änderung entstanden ist,
- du neu vom Serverstand starten willst,
- der lokale Workspace unbrauchbar geworden ist.
Brich nicht ab, wenn du lokale Änderungen noch brauchst. Sichere dann zuerst die Dateien aus dem Checkout-Workspace.
Projekt importieren aus FreeCAD
Das Addon kann einen lokalen FreeCAD-Ordner als Projektstand importieren.
Projekt importieren
-> neues oder ausgewähltes Projekt wählen
-> lokalen Ordner wählen
-> alle .FCStd-Dateien darunter in ZIP packen
-> ZIP an Server senden
-> Server legt fehlende Teile/Baugruppen und Revisionen an
-> Server legt Projektstand an
-> optional importiertes Root-Teil direkt auschecken
-> optional lokalen Importordner archivieren
Wichtig sind die relativen Pfade. Wenn deine Baugruppe auf parts/Halter.FCStd verweist, muss diese Struktur im lokalen Ordner vorhanden sein.
Beispiel:
Chipbox.FCStd
parts/Halter.FCStd
parts/Deckel.FCStd
Nach erfolgreichem Import kann das Addon den Ursprungsordner nach:
~/FreeCAD-PLM/imported/<server>/<project-code>/...
verschieben. Das verhindert, dass du versehentlich im alten Importordner weiterarbeitest, während der PLM-Checkout die eigentliche Arbeitskopie ist.
Projekt und Teil bearbeiten
Projekt- und Teilstammdaten liegen nicht dauerhaft im Hauptpanel, sondern in Dialogen.
Projekt bearbeiten:
- Code,
- Name,
- Status,
- Datum,
- Beschreibung.
Teil bearbeiten:
- Name,
- Kategorie,
- Beschreibung,
- Material,
- Lieferant,
- Tags,
- Archivstatus.
Die Nummer eines vorhandenen Teils wird im Addon nicht frei editiert. Sie ist die stabile fachliche Kennung.
Notizen und Anmerkungen
Notizen gehören zur Revision. Sie sind gut für freien technischen Kontext, der nicht als strukturierter Status modelliert ist.
Anmerkungen gehören zum Teil beziehungsweise optional zu einer Revision. Sie können einen Status haben und lassen sich erledigen oder wieder öffnen.
Typischer Ablauf:
Revision auswählen
-> Anmerkungen
-> Filter wählen
-> Neu oder Bearbeiten
-> Text speichern
Aus FreeCAD heraus kann der Toolbar-Befehl Anmerkung erstellen versuchen, die aktuelle Auswahl als Objekt/Subelement zu übernehmen. Das ist hilfreich, wenn du eine Anmerkung auf ein bestimmtes FreeCAD-Element beziehen willst.
Server-API, die das Addon verwendet
Für die Fehlersuche ist nützlich zu wissen, welche Endpunkte beteiligt sind.
GET /api/projects/
GET /api/projects/<id>/parts/
GET /api/parts/<id>/
POST /api/projects/<id>/
POST /api/projects/<id>/parts/
POST /api/parts/<id>/
POST /api/projects/import/
POST /api/projects/<id>/snapshots/import/
GET /api/revisions/<id>/manifest/
POST /api/revisions/<id>/checkout/
GET /api/checkouts/active/
GET /api/checkouts/<id>/manifest/
POST /api/checkouts/<id>/checkin/
POST /api/checkouts/<id>/cancel/
GET /api/parts/<id>/annotations/
POST /api/parts/<id>/annotations/
POST /api/annotations/<id>/
DELETE /api/annotations/<id>/
Alle Requests senden:
Authorization: Bearer <token>
Dateidownloads werden ebenfalls mit Bearer Token ausgeführt.
Cache-Limits
Die Verbindungseinstellungen enthalten Limits für read-only Caches:
- maximale FCStd-Dateien,
- maximale Projekte,
- maximale Revisionen pro Projekt.
Diese Limits betreffen den read-only Cache. Checkout-Workspaces werden nicht als Wegwerf-Cache behandelt, weil sie aktive Arbeit enthalten können.
Best Practices
Arbeite mit dieser Grundregel:
Ansehen = read-only
Ändern = auschecken
Abgeben = einchecken
Verwerfen = abbrechen
Weitere Empfehlungen:
- Öffne eine Revision read-only, wenn du unsicher bist, ob du sie ändern willst.
- Checke nur aus, wenn du wirklich bearbeiten möchtest.
- Halte nur einen lokalen Checkout aktiv, solange du nicht bewusst mehrere Arbeitsstände koordinierst.
- Schreibe Änderungskommentare so, dass du sie in sechs Monaten noch verstehst.
- Arbeite nach einem Import nicht im alten Quellordner weiter, sondern im Checkout-Workspace.
- Verändere
manifest.jsonundcheckout.jsonnicht manuell. - Lösche Checkout-Ordner nicht, solange der Server-Checkout noch aktiv ist.
Troubleshooting
Keine Projekte werden geladen
Prüfe im FreeCAD-Ausgabefenster die Meldung mit [FreeCAD-PLM].
Typische Ursachen:
- Server-URL falsch,
- Token leer oder abgelaufen,
- Token hat keinen
read-Scope, - Server ist aus FreeCAD nicht erreichbar,
- Reverse Proxy oder Zertifikat blockiert die Verbindung.
403 oder Scope-Fehler
Das Token reicht für die Aktion nicht aus.
Beispiele:
- Projekt bearbeiten braucht
admin. - Teile oder Anmerkungen ändern braucht
write. - Auschecken, Einchecken und Abbrechen brauchen
checkout.
Checkout ist laut Server aktiv, lässt sich aber nicht wieder öffnen
Wenn die lokale Datei checkout.json fehlt oder veraltet ist, kann das Addon Änderungen nicht sicher erkennen. Dann meldet es einen Metadatenfehler.
Empfohlene Wege:
- lokale Änderungen nicht wichtig: Checkout abbrechen und neu auschecken,
- lokale Änderungen wichtig: Workspace manuell sichern, dann mit einem frischen Checkout vergleichen.
Server meldet bereits aktiven Checkout
Der Server ist die Wahrheit für Checkout-Locks. Wenn das Addon einen Konflikt meldet, lade aktive Checkouts neu und entscheide:
- aktiven Checkout öffnen,
- einchecken,
- abbrechen,
- neuen Checkout nicht starten.
Check-in erzeugt keine neue Revision
Dann wurden keine modellrelevanten Änderungen erkannt oder der Server hat keine neue Revision angelegt.
Prüfe:
- wurde die richtige Datei im Checkout-Workspace geändert?
- wurde die Datei gespeichert?
- ist die Änderung fachlich im Modell sichtbar?
- hast du nur technische FreeCAD-Speicherartefakte erzeugt?
SHA-256 stimmt nicht
Das Addon verwirft Downloads, deren Hash nicht zum Manifest passt.
Mögliche Ursachen:
- unvollständiger Download,
- Proxy- oder Serverproblem,
- Datei wurde serverseitig unerwartet geändert,
- falsches Manifest.
Lade erneut. Wenn der Fehler reproduzierbar bleibt, prüfe Serverlogs und Revisiondatei.
Referenzen fehlen nach dem Öffnen
Bei read-only und Checkout lädt das Addon Dateien aus dem Manifest. Wenn FreeCAD trotzdem Referenzen nicht findet, prüfe:
- ob die Baugruppe im PLM-Projektstand vollständig importiert wurde,
- ob relative Pfade im ursprünglichen Projektordner korrekt waren,
- ob referenzierte Dateien im Manifest enthalten sind,
- ob die Root-Datei wirklich aus
files/geöffnet wurde.
Meldungen erscheinen nicht im Dock
Das ist normal. Das Addon schreibt Statusmeldungen ins FreeCAD-Ausgabefenster, nicht in eine dauerhaft sichtbare Dock-Zeile. Suche dort nach [FreeCAD-PLM].
Begriffsabgleich
| Begriff | Bedeutung im Addon |
|---|---|
| Projekt | fachlicher Rahmen, enthält Teile und Baugruppen |
| Teil/Baugruppe | CAD-Objekt mit Revisionen |
| Revision | unveränderlicher .FCStd-Stand |
| Projektstand | eingefrorene Kombination mehrerer Dateipfade und Revisionen |
| Manifest | Server-Dateiliste für read-only oder Checkout |
| Checkout | serverseitiger Bearbeitungs-Lock plus lokale Arbeitskopie |
| Check-in | Upload geänderter Dateien als neue Revisionen |
| Cancel/Abbrechen | Lock freigeben ohne neue Revision |
| Workspace | lokaler Addon-Arbeitsbereich unter ~/FreeCAD-PLM |
Wann die Web-UI besser ist
Nutze die Web-Oberfläche für:
- globale Suche,
- Historie und Vergleich,
- Artefakte wie STEP, STL, PNG,
- Fertigungsdateien und 3MF-Metadaten,
- Benutzer, Rollen und Tokens,
- administrative Korrekturen.
Nutze das Addon für:
- schnelle Auswahl aus FreeCAD heraus,
- read-only Ansicht einer Revision,
- Checkout und Check-in,
- Bearbeitung im lokalen FreeCAD-Kontext,
- Anmerkungen direkt aus der Konstruktion heraus.
Beide Oberflächen greifen auf dieselbe Server-Wahrheit zu. Wenn du unsicher bist, prüfe den Stand im Web und lade danach im Addon neu.