Zurück zur Dokumentation

Dateiversionierungssystem

Einführung

Das Dateiversionierungssystem von Sutram bietet einen kollaborativen Workflow zur Verwaltung von Dokumentrevisionen in Ihren Projekten. Inspiriert von traditionellen Dokumentenkontrollverfahren im Ingenieurwesen ermöglicht es Teams, Änderungen zu verfolgen, eine Revisionshistorie zu führen und sicherzustellen, dass nur eine Person gleichzeitig eine Datei bearbeitet.

Wann Versionierung verwenden

Verwenden Sie die Versionierung für Dateien, die:

  • Eine formale Revisionsverfolgung erfordern (Verträge, Spezifikationen, Zeichnungen)
  • Von mehreren Teammitgliedern bearbeitet werden
  • Freigabeworkflows vor der Veröffentlichung benötigen
  • Einen Audit-Trail der Änderungen erfordern

Dateien, die typischerweise keine Versionierung benötigen:

  • Referenzmaterialien, die sich nicht ändern
  • Exportierte Berichte oder Momentaufnahmen
  • Mediendateien (Bilder, Videos)

Schlüsselkonzepte

Dateitypen

Jede Datei in Sutram ist entweder eine Referenz-Datei oder eine Bearbeitbare Datei:

Typ Beschreibung Versionierung
Referenz Standarddateien ohne Versionskontrolle. Jeder mit Bearbeitungsrechten kann die Datei jederzeit ersetzen. Deaktiviert
Bearbeitbar Dateien mit aktivierter Versionskontrolle. Erfordert Check-out vor der Bearbeitung und unterstützt formale Versionierung. Aktiviert

Standardmäßig sind alle hochgeladenen Dateien Referenz-Dateien. Sie können die Versionierung für jede Datei aktivieren.

Lebenszyklus-Status

Bearbeitbare Dateien haben einen Lebenszyklus-Status, der ihren aktuellen Zustand anzeigt:

Status Beschreibung
Entwurf In Bearbeitung. Kann über Check-out/Check-in bearbeitet werden. Noch nicht formal freigegeben.
Veröffentlicht Formal freigegebene Version. Erstellt eine permanente Momentaufnahme in der Versionshistorie.

Check-out/Check-in

Das Check-out/Check-in-System stellt sicher, dass nur eine Person gleichzeitig eine Datei bearbeiten kann:

  • Check-out: Reserviert die Datei für Ihre exklusive Bearbeitung. Andere können sie ansehen, aber nicht ändern.
  • Check-in: Gibt die Datei mit Ihren Änderungen zurück. Erfordert das Hochladen einer neuen Version der Datei.

Dies verhindert widersprüchliche Bearbeitungen und gewährleistet eine klare Aufzeichnung, wer Änderungen vorgenommen hat.

Versionen

Wenn Sie eine Datei veröffentlichen, erstellt Sutram eine permanente Momentaufnahme, die als Version bezeichnet wird. Versionen werden fortlaufend nummeriert (v1, v2, v3...) und können nicht geändert oder gelöscht werden. Dies bietet:

  • Vollständige Revisionshistorie
  • Möglichkeit, jede vorherige Version herunterzuladen
  • Klarer Audit-Trail veröffentlichter Freigaben

Erste Schritte

Versionierung für eine Datei aktivieren

Um die Versionierung für eine bestehende Datei zu aktivieren:

  1. Navigieren Sie zum Inhalt-Tab Ihres Projekts
  2. Finden Sie die Datei, für die Sie die Versionierung aktivieren möchten
  3. Klicken Sie auf das ...-Menü (Weitere Optionen)
  4. Wählen Sie „Versionierung aktivieren"

Die Datei wird zu einer Bearbeitbaren Datei im Entwurf-Status.

Hinweis: Nur Projekt-Eigentümer und Mitglieder können die Versionierung aktivieren.

Versionierung deaktivieren

Um die Versionierung zu deaktivieren und zurück zu einer Referenz-Datei zu konvertieren:

  1. Stellen Sie sicher, dass die Datei nicht ausgecheckt ist
  2. Klicken Sie auf das ...-Menü der Datei
  3. Wählen Sie „Versionierung deaktivieren"

Warnung: Das Deaktivieren der Versionierung entfernt die Möglichkeit, Check-out/Check-in zu verwenden, löscht aber nicht die Versionshistorie.


Check-out/Check-in-Workflow

Schritt 1: Eine Datei auschecken

Bevor Sie eine bearbeitbare Datei bearbeiten, müssen Sie sie auschecken:

  1. Klicken Sie auf das ...-Menü der Datei
  2. Wählen Sie „Zur Bearbeitung auschecken"
  3. Die Datei ist jetzt für Ihre exklusive Bearbeitung reserviert

Nach dem Auschecken:

  • Die Datei zeigt ein Badge „Ausgecheckt von [Ihr Name]"
  • Andere Benutzer können die Datei ansehen, aber nicht auschecken
  • Sie können die aktuelle Version herunterladen, um sie lokal zu bearbeiten

Schritt 2: Die Datei lokal bearbeiten

  1. Laden Sie die aktuelle Datei von Sutram herunter
  2. Nehmen Sie Ihre Änderungen mit der entsprechenden Software vor (Word, AutoCAD usw.)
  3. Speichern Sie die geänderte Datei auf Ihrem Computer

Schritt 3: Mit Ihren Änderungen einchecken

Wenn Sie bereit sind, Ihre Änderungen zu speichern:

  1. Klicken Sie auf das ...-Menü der Datei
  2. Wählen Sie „Einchecken"
  3. Ein Dialog erscheint und fordert Sie auf, Ihre geänderte Datei hochzuladen
  4. Ziehen Sie die Datei per Drag & Drop oder klicken Sie, um Ihre aktualisierte Datei auszuwählen
  5. Warten Sie, bis der Upload abgeschlossen ist

Wichtig: Die Ersatzdatei muss die gleiche Erweiterung wie das Original haben (z. B. .docx-Dateien müssen durch .docx-Dateien ersetzt werden).

Ein Check-out abbrechen

Wenn Sie sich entscheiden, keine Änderungen vorzunehmen:

  1. Klicken Sie auf das ...-Menü der ausgecheckten Datei
  2. Wählen Sie „Check-out abbrechen"

Dies gibt die Datei ohne Änderungen frei. Die Datei kehrt zu ihrem vorherigen Zustand zurück.

Ein Check-in rückgängig machen

Einen Fehler gemacht? Wenn ein Backup verfügbar ist:

  1. Klicken Sie auf das ...-Menü der Datei
  2. Wählen Sie „Check-in rückgängig machen"
  3. Die vorherige Version wird wiederhergestellt

Hinweis: Rückgängig machen ist nur verfügbar, wenn ein Backup existiert (typischerweise direkt nach dem Check-in). Sobald Sie erneut aus- und einchecken, wird das vorherige Backup überschrieben.

Sperre erzwungen freigeben (nur Eigentümer)

Wenn ein Teammitglied eine Datei ausgecheckt hat, aber nicht verfügbar ist:

  1. Klicken Sie als Projekteigentümer auf das ...-Menü
  2. Wählen Sie „Sperre erzwungen freigeben"

Dies gibt die Sperre sofort frei. Alle nicht gespeicherten Änderungen des ursprünglichen Benutzers gehen verloren.

Mit Vorsicht verwenden: Nutzen Sie dies nur, wenn nötig, da es zu Arbeitsverlust führen kann.


Versionsverwaltung

Eine Version veröffentlichen

Wenn ein Entwurf bereit für die formale Freigabe ist:

  1. Stellen Sie sicher, dass die Datei nicht ausgecheckt ist
  2. Klicken Sie auf das ...-Menü
  3. Wählen Sie „Version veröffentlichen"

Dies erstellt eine permanente Momentaufnahme:

  • Die Versionsnummer wird erhöht (v1 → v2 → v3...)
  • Die Momentaufnahme wird in der Versionshistorie gespeichert
  • Der Dateistatus wechselt zu Veröffentlicht

Hinweis: Nur Projekteigentümer können Versionen veröffentlichen.

Eine neue Version aus einer veröffentlichten erstellen

Um eine veröffentlichte Datei weiter zu bearbeiten:

  1. Klicken Sie auf das ...-Menü einer veröffentlichten Datei
  2. Wählen Sie „Neue Version erstellen"

Dies:

  • Erstellt einen neuen Entwurf aus der veröffentlichten Version
  • Erhöht die Versionsnummer
  • Ermöglicht Ihnen, auszuchecken und Änderungen vorzunehmen

Versionshistorie anzeigen

Um alle veröffentlichten Versionen zu sehen:

  1. Klicken Sie auf die Datei, um sie zu öffnen
  2. Klicken Sie im Viewer auf „Versionshistorie"
  3. Eine Zeitleiste zeigt alle veröffentlichten Versionen mit:
    • Versionsnummer
    • Veröffentlichungsdatum
    • Wer sie veröffentlicht hat

Frühere Versionen herunterladen

Aus dem Versionshistorie-Modal:

  1. Finden Sie die benötigte Version
  2. Klicken Sie auf das Download-Symbol neben dieser Version
  3. Die historische Datei wird auf Ihren Computer heruntergeladen

Dies ist nützlich für:

  • Vergleich von Änderungen zwischen Versionen
  • Rückkehr zu einem früheren Entwurf
  • Audit- und Compliance-Anforderungen

Berechtigungen und Rollen

Verschiedene Projektrollen haben unterschiedliche Versionierungsfähigkeiten:

Aktion Eigentümer Admin Mitglied Betrachter
Dateien & Versionen anzeigen Ja Ja Ja Ja
Versionen herunterladen Ja Ja Ja Ja
Versionierung aktivieren/deaktivieren Ja Ja Ja Nein
Dateien auschecken Ja Ja Ja Nein
Dateien einchecken Ja Ja Ja Nein
Eigenes Check-out abbrechen Ja Ja Ja Nein
Check-in rückgängig machen Ja Ja Ja Nein
Versionen veröffentlichen Ja Nein Nein Nein
Neue Version erstellen Ja Nein Nein Nein
Sperre erzwungen freigeben Ja Nein Nein Nein

Wichtige Punkte:

  • Nur Eigentümer können Versionen veröffentlichen und neue Versionen erstellen
  • Nur Eigentümer können Sperren anderer Benutzer erzwungen freigeben
  • Betrachter können nur anzeigen und herunterladen, nicht bearbeiten

Visuelle Indikatoren

Status-Badges

Bearbeitbare Dateien zeigen Badges an, die ihren aktuellen Zustand darstellen:

Badge Bedeutung
Entwurf (bernsteinfarben) Datei ist in Bearbeitung, noch nicht veröffentlicht
Veröffentlicht (indigoblau) Datei wurde formal als Version veröffentlicht
Ausgecheckt von [Name] (Warnung) Datei ist vom angegebenen Benutzer zur Bearbeitung gesperrt

Gesperrte Dateien erkennen

Wenn eine Datei ausgecheckt ist:

  • Ein Schloss-Symbol erscheint in der Dateiliste
  • Das Badge zeigt, wer sie ausgecheckt hat
  • Die Check-out-Option ist ausgeblendet (Datei ist nicht verfügbar)

Ihre eigenen Check-outs

Wenn Sie eine Datei ausgecheckt haben:

  • Die Option „Einchecken" erscheint im Menü
  • Die Option „Check-out abbrechen" ist verfügbar
  • Andere Benutzer sehen, dass Sie die Datei gesperrt haben

Bewährte Praktiken

Wann Versionierung aktivieren

Aktivieren Sie die Versionierung für:

  • Ingenieurzeichnungen und Spezifikationen
  • Verträge und Rechtsdokumente
  • Projektpläne und Zeitpläne
  • Jedes Dokument, das eine formale Freigabe erfordert

Vermeiden Sie Versionierung für:

  • Häufig aktualisierte Arbeitsdateien
  • Referenzbilder oder Medien
  • Exportierte Berichte (erstellen Sie stattdessen neue Dateien)

Veröffentlichungs-Workflow

Empfohlener Workflow für formale Dokumente:

  1. Erstellen/Hochladen: Fügen Sie die erste Datei zum Projekt hinzu
  2. Versionierung aktivieren: In bearbeitbare Datei konvertieren
  3. Im Entwurf arbeiten: Änderungen über Check-out/Check-in vornehmen
  4. Überprüfen: Entwurf mit dem Team zur Rückmeldung teilen
  5. Veröffentlichen: Nach Genehmigung als formale Version veröffentlichen
  6. Iterieren: Neue Version für zukünftige Änderungen erstellen

Tipps zur Teamkoordination

  • Kommunizieren: Informieren Sie Ihr Team, wenn Sie Dateien auschecken
  • Nicht horten: Checken Sie Dateien zeitnah ein, wenn Sie fertig sind
  • Regelmäßig veröffentlichen: Veröffentlichen Sie stabile Versionen regelmäßig, nicht nur an Meilensteinen
  • Kommentare nutzen: Fügen Sie Kontext im Projekt-Chat hinzu, wenn Sie größere Änderungen veröffentlichen

Häufig gestellte Fragen

F: Kann ich eine Datei ohne Auschecken bearbeiten?

A: Bei Referenz-Dateien ja. Bei bearbeitbaren Dateien nein — Sie müssen zuerst auschecken. Dies stellt sicher, dass nur eine Person gleichzeitig bearbeitet.

F: Was passiert, wenn ich vergesse, eine Datei einzuchecken?

A: Die Datei bleibt für Sie gesperrt, bis Sie einchecken oder abbrechen. Wenn Sie nicht erreichbar sind, kann der Projekteigentümer die Sperre erzwungen freigeben.

F: Kann ich eine veröffentlichte Version löschen?

A: Nein. Veröffentlichte Versionen sind permanent für Audit-Zwecke. Sie können neue Versionen erstellen, aber die Historie wird bewahrt.

F: Was ist der Unterschied zwischen Versionen und Dateihistorie?

A: Versionen sind formale, nummerierte Momentaufnahmen, die durch Veröffentlichung erstellt werden. Jede Version ist permanent und herunterladbar. Check-ins ohne Veröffentlichung aktualisieren die Arbeitskopie, erstellen aber keine nummerierten Versionen.

F: Können mehrere Personen dieselbe Datei auschecken?

A: Nein. Nur eine Person kann eine Datei gleichzeitig ausgecheckt haben. Dies ist beabsichtigt, um widersprüchliche Bearbeitungen zu verhindern.

F: Verliere ich meine Änderungen, wenn jemand meine Sperre erzwungen freigibt?

A: Ja, alle nicht eingecheckten Änderungen gehen verloren. Checken Sie immer regelmäßig ein. Die erzwungene Freigabe sollte nur bei Bedarf verwendet werden.

F: Kann ich die Versionierung für CAD-Dateien aktivieren?

A: Ja! Die Versionierung funktioniert mit jedem Dateityp — CAD-Zeichnungen, Office-Dokumente, PDFs und mehr.


Fehlerbehebung

„Datei ist bereits ausgecheckt"

Problem: Sie können eine Datei nicht auschecken, weil jemand anderes sie hat.

Lösung:

  1. Prüfen Sie das Badge, um zu sehen, wer sie ausgecheckt hat
  2. Kontaktieren Sie die Person zur Koordination
  3. Wenn es dringend ist und die Person nicht erreichbar ist, bitten Sie den Projekteigentümer um eine erzwungene Freigabe

„Sie haben diese Datei nicht ausgecheckt"

Problem: Sie versuchen einzuchecken, aber haben die Datei nicht ausgecheckt.

Lösung: Checken Sie die Datei zuerst aus, nehmen Sie dann Ihre Änderungen vor und checken Sie ein.

„Datei muss die Erweiterung haben: .xyz"

Problem: Sie versuchen, eine Datei mit einer anderen Erweiterung einzuchecken.

Lösung: Stellen Sie sicher, dass Ihre Ersatzdatei die gleiche Erweiterung wie das Original hat. Zum Beispiel muss eine .docx-Datei durch eine andere .docx-Datei ersetzt werden.

„Nur der Projekteigentümer kann Dateien veröffentlichen"

Problem: Sie haben keine Berechtigung zum Veröffentlichen.

Lösung: Bitten Sie den Projekteigentümer, die Version zu veröffentlichen, oder bitten Sie um eine Rollenänderung.

Check-in-Upload schlägt fehl

Problem: Der Upload während des Check-ins wird nicht abgeschlossen.

Lösung:

  1. Überprüfen Sie Ihre Internetverbindung
  2. Stellen Sie sicher, dass die Datei nicht zu groß ist (prüfen Sie die Projektlimits)
  3. Versuchen Sie es erneut mit einer kleineren Datei oder besserer Verbindung
  4. Wenn das Problem bestehen bleibt, kontaktieren Sie den Support

Versionshistorie wird nicht angezeigt

Problem: Sie können die Versionshistorie einer Datei nicht sehen.

Lösung: Die Versionshistorie erscheint nur für Dateien, die mindestens einmal veröffentlicht wurden. Wenn die Datei noch im Entwurf ist und nie veröffentlicht wurde, gibt es noch keine Versionshistorie.


Dokumentversion: 1.0 Zuletzt aktualisiert: November 2025 Autor: Sutram Development Team