Zum Inhalt springen

Referenz & Datenmodell

Datei (file)

Eine Datei ist die benannte Hülle um eine Versionsreihe; lesbar ist sie nur, wenn ihre aktive Version bereit und virenfrei ist.

Die Datei trägt Name, Art und Endung und zeigt auf ihre aktive Version. Jede Datei liegt in genau einer Ablage, entweder in einem Ordner oder direkt in der Ablage. Anhänge sind gewöhnliche Dateien in der flachen Ablage „Anhänge“; die Zuordnung zum Objekt steckt in der Dateiverknüpfung. (Datenart: Dateidaten, manuell/System)

Dateiliste im Drive mit den Spalten „Name“, „Typ“, „Größe“, „AV“, „Hochgeladen von“, „Geändert“; Seitenleiste mit Vorschau, Version, „Größe“, „Kategorie“, „Status“, „Sicherheit“, „Typ“, „Erstellt von“, „Version von“, „Erstellt“, „Geändert“, „ID“, „Originalname“, „Endung“. Kontextmenü: „Öffnen“, „Umbenennen“, „Verschieben nach…“, „Details“, „Versionen“, „Herunterladen“, „ID kopieren“, „Löschen“. Upload per „Dateien hochladen“ oder Ziehen („Dateien hier ablegen“). – Guides › Drive & Anhänge

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Name title Text ja Anzeigename, beim Upload = Dateiname „Umbenennen“; eindeutig je Ordner unter fertigen Dateien
Originalname original_filename Text ja Dateiname beim Upload System, unveränderlich
Kategorie kind Auswahl ja Bild, Video, Audio, Dokument, Archiv, Sonstige System, aus dem MIME-Typ abgeleitet
Endung extension Text nein Teil nach dem letzten Punkt System
Aktive Version active_version_id Verweis nein Version, die Liste, Vorschau und Download nutzen System; „Wiederherstellen“ im Versionsverlauf setzt sie um
Ordner folder_id Verweis nein leer = oberste Ebene der Ablage „Verschieben nach…“
Größe / Typ / Status / Sicherheit – Anzeige – Werte der aktiven Version siehe Dateiversion
Erstellt von / Hochgeladen von created_by Verweis ja Nutzer, der die Datei anlegte System
Erstellt / Geändert created_at / updated_at Datum ja Zeitstempel System
Zu Art Pflicht Beim Archivieren Beim Löschen
Ablage gehört zu ja – mitlöschen
Ordner gehört zu nein bleibt mitlöschen
Dateiversion hat viele – – mitlöschen
Dateiverknüpfung hat viele – – mitlöschen

Die Datei selbst hat keinen Status; angezeigt werden Upload-Status und Virenstatus der aktiven Version. Zusammengefasst gilt:

Upload gestartet ──> Prüfung ──┬─> bereit (status = ready UND av_status = clean)
├─> blockiert (av_status = infected | error | pending)
└─> fehlgeschlagen (status = failed)
  • Anlegen nur per Upload. Jeder Upload erzeugt eine neue Datei mit einer ersten Version – auch wenn eine Datei gleichen Namens existiert. Clients können keine Dateizeilen direkt anlegen.
  • Lese-Regel (System, packages/file-acl): „Öffnen“, Vorschau und „Herunterladen“ sind nur möglich, wenn die Datei nicht gelöscht, ihr Ordner nicht archiviert, die Version im Status „Bereit“ und die Virenprüfung „Geprüft“ (clean) ist. „Prüfung läuft“ und „Prüfung fehlgeschlagen“ sperren ebenso wie „Infiziert“. Menüeinträge sind dann ausgegraut; der Server erzwingt dieselbe Regel.
  • Eindeutige Namen: Erst wenn die erste Version bereit ist, wird die Datei gestempelt (first_ready_at) und nimmt an der Namenseindeutigkeit teil. Kollidiert der Name mit einer vorhandenen fertigen Datei desselben Ordners, hängt der Server einen Zähler an den Namen.
  • Verschieben nur in Ordner derselben Ablage; Umbenennen ändert nur title, nicht den Originalnamen.
  • Löschen ist ein Soft-Delete (Datei verschwindet aus dem Drive, Verknüpfungen werden mitgelöscht); gelöschte Dateien lassen sich nicht wiederherstellen.
  • Die Kategorie leitet der Server aus dem MIME-Typ ab (image/* → Bild, PDF/Office/text/* → Dokument, zip/tar/gz/7z/rar → Archiv, sonst Sonstige).

Dateiversion · Dateiverknüpfung · Guides › Drive