Zum Inhalt springen

Referenz & Datenmodell

Dateiversion (file_version)

Eine Dateiversion ist ein konkreter Inhalt einer Datei mit Upload-Status und Virenprüfungs-Ergebnis.

Versionen tragen den Inhalt: MIME-Typ, Größe, Speicherort und die beiden Statusachsen Upload und Virenprüfung. Eine Datei hat mindestens eine Version; derzeit legt kein Pfad weitere Versionen an; ältere Dateien können frühere Versionen tragen (Vorschau, Wiederherstellen). Ein erneuter Upload derselben Datei erzeugt keine Version, sondern eine neue Datei. (Datenart: Dateidaten, System)

Dialog „Versionsverlauf“ (Menü „Versionen“ oder Seitenleiste „Versionen (n)“): je Version Versionsbezeichnung, Badge „Aktuell“, Virenstatus, Größe, Ersteller, Datum, Upload-Status sowie die Knöpfe „Vorschau“ und „Wiederherstellen“. Die Seitenleiste zeigt Werte der aktiven Version. – Guides › Drive & Anhänge

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Versionsbezeichnung version_label Text nein Kennzeichen der Version System; bei Uploads leer („v?“)
Typ (MIME) mime_type Text ja Inhaltstyp; nach der Prüfung ggf. auf den erkannten Typ korrigiert System
Größe bytes Zahl nein Bytes, formatiert als B/KB/MB/GB System
Status status Auswahl ja Upload-Zustand (Tabelle unten) System
Sicherheit av_status Auswahl ja Ergebnis der Virenprüfung (Tabelle unten) System, nur Server schreibt
Version von created_by Verweis ja Nutzer bzw. Dienstkonto, das die Version erzeugte System
Erstellt created_at Datum ja Zeitpunkt System

Nicht angezeigt: Speicherort, Prüfsummen, Zeitpunkte uploaded_at/ready_at/av_scanned_at, Prüfgrund, MIME-Abgleich (mime_status).

Zu Art Pflicht Beim Archivieren Beim Löschen
Datei gehört zu ja – mitlöschen
Wert Label Wer setzt
pending Ausstehend Server beim Reservieren (Upload-Start)
uploading Wird hochgeladen Upload-Server während der Übertragung
processing Wird verarbeitet im Schema vorgesehen, derzeit nicht gesetzt
ready Bereit Upload-Server nach vollständiger Übertragung; Engine nach sauberem Scan
failed Fehlgeschlagen Server bei Abbruch/Fehler („Erneut hochladen“ in Anhängen)
deleted Gelöscht Server; im Versionsverlauf ausgeblendet
Wert Label Bedeutung
pending Prüfung läuft noch nicht gescannt
clean Geprüft sauber; einzige Freigabe zum Lesen
infected Infiziert Fund; dauerhaft gesperrt
error Prüfung fehlgeschlagen Scanner-Fehler; gesperrt bis zum erneuten Scan
Upload: pending ──> uploading ──> ready ──┐
└──> failed │ Virenscan (automatisch nach Bereitschaft)
├──> clean → lesbar
├──> infected → blockiert
└──> error → blockiert (Rescan möglich)
  • Scan ist Pflicht (System): Nach dem Upload startet ein Prüf-Workflow; erst clean gibt Vorschau und Download frei (Lese-Regel in Datei). Beim Scan wird der tatsächliche Inhaltstyp erkannt und mime_type bei Abweichung korrigiert. Archive können inhaltlich nicht geprüft werden („Keine Virenprüfung möglich“).
  • Neue Versionen legt derzeit kein Pfad an. Eine Datei aus dem Arbeitsbereich einer Polaris-Unterhaltung gelangt nur als NEUE Datei in den Drive: per „In Drive kopieren“ im Dateien-Reiter oder indem Polaris sie speichert (save_to_drive), jeweils mit Virenprüfung.
  • Wiederherstellen setzt active_version_id der Datei auf die gewählte Version – nur für „geprüfte, bereite Versionen“, nie für die bereits aktuelle. Es entsteht keine Kopie.
  • Der Server ist alleiniger Schreiber aller Statusfelder; Clients können sie nicht setzen.

Datei · Automation & AI