Skip to content

Reference & Data Model

File version (file_version)

A file version is one concrete content of a file with upload status and virus scan result.

Versions carry the content: MIME type, size, storage location and the two status axes upload and virus scan. A file has at least one version; currently no path creates further versions; older files may still carry earlier versions (preview, restore). Uploading the same file again creates no version but a new file. (Data type: file data, system)

Dialog „Versionsverlauf“ (Version history) (menu „Versionen“ (Versions) or sidebar „Versionen (n)“): per version the version label, badge „Aktuell“ (Current), virus status, size, creator, date, upload status as well as the buttons „Vorschau“ (Preview) and „Wiederherstellen“ (Restore). The sidebar shows the values of the active version. – Guides › Drive & attachments

Field Technical Type Required Meaning Notes
Version label version_label Text no identifier of the version System; empty for uploads („v?“)
Type (MIME) mime_type Text yes content type; corrected to the detected type after the scan if needed System
Size bytes Number no bytes, formatted as B/KB/MB/GB System
Status status Selection yes upload state (table below) System
Security av_status Selection yes result of the virus scan (table below) System, written by the server only
Version by created_by Reference yes user or service account that created the version System
Created created_at Date yes point in time System

Not shown: storage location, checksums, timestamps uploaded_at/ready_at/av_scanned_at, scan reason, MIME comparison (mime_status).

Related to Kind Required On archive On delete
File belongs to yes – deleted along
Value Label Set by
pending Ausstehend (Pending) server on reservation (upload start)
uploading Wird hochgeladen (Uploading) upload server during transfer
processing Wird verarbeitet (Processing) provided for in the schema, currently not set
ready Bereit (Ready) upload server after complete transfer; engine after a clean scan
failed Fehlgeschlagen (Failed) server on abort/error („Erneut hochladen“ (Upload again) in attachments)
deleted Gelöscht (Deleted) server; hidden in the version history
Value Label Meaning
pending Prüfung läuft (Scan running) not yet scanned
clean Geprüft (Scanned) clean; the only clearance for reading
infected Infiziert (Infected) detection; permanently blocked
error Prüfung fehlgeschlagen (Scan failed) scanner error; blocked until rescanned
Upload: pending ──> uploading ──> ready ──┐
└──> failed │ virus scan (automatic once ready)
├──> clean → readable
├──> infected → blocked
└──> error → blocked (rescan possible)
  • Scan is mandatory (system): After the upload a scan workflow starts; only clean releases preview and download (read rule in File). During the scan the actual content type is detected and mime_type corrected on mismatch. Archives cannot be scanned for content („Keine Virenprüfung möglich“ – No virus scan possible).
  • New versions are currently not created by any path. A file from a Polaris conversation’s workspace reaches the Drive only as a NEW file: via “In Drive kopieren” in the Files tab, or when Polaris saves it (save_to_drive), each with the virus scan.
  • Restore sets the file’s active_version_id to the chosen version – only for “scanned, ready versions”, never for the one already current. No copy is created.
  • The server is the sole writer of all status fields; clients cannot set them.

File · Automation & AI