Zum Inhalt springen

Referenz & Datenmodell

Dateiverknüpfung (file_link)

Eine Dateiverknüpfung hängt eine Datei als Anhang an ein Objekt; Entfernen löst nur die Verknüpfung.

Die Verknüpfung ist die Kante „Objekt X hat Anhang F“. Der Inhalt liegt als gewöhnliche Datei in der Ablage „Anhänge“; eine Datei kann an mehreren Objekten hängen. (Datenart: Dateidaten, manuell/System)

Bereich „Dateien“ bzw. Knopf „Dateien anhängen“ in den Dialogen der verknüpfbaren Objekte; Zeile je Datei mit Upload-/Virenstatus und den Aktionen „Öffnen“, „Herunterladen“, „Entfernen“. Beim Anlegen eines Objekts sind Dateien zunächst „Vorgemerkt“ und werden nach dem Speichern hochgeladen. – Guides › Drive & Anhänge

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Objektart entity_kind Auswahl ja Art des Zielobjekts (Tabelle unten) System, aus dem Dialog
Objekt entity_id Verweis ja Zielobjekt System
Datei file_id Verweis ja angehängte Datei System
entity_kind Objekt Wo
issue Issue Issue-Dialog
task Aufgabe Aufgaben-Dialog
takeaway Erkenntnis Erkenntnis-Dialog und -Seite
document Dokument (service_documentation) Dokumenten-Dialog
technical_structure_node Technischer Knoten „Verknüpfte Dateien“
technical_structure_good Komponente „Verknüpfte Dateien“
conversation Unterhaltung Anhang im Polaris-/Agenten-Chat; nur der Ersteller der Unterhaltung
Zu Art Pflicht Beim Archivieren Beim Löschen
Datei gehört zu ja – mitlöschen
Zielobjekt gehört zu (per Art + ID) ja – Kante wird vom Server aufgeräumt
  • Idempotent: Dieselbe Datei am selben Objekt gibt es nur einmal; ein zweites Anhängen erzeugt keine Dublette.
  • Ziel muss existieren und darf nicht gelöscht sein; die Objektart muss aus der Liste stammen. Unterhaltungs-Verknüpfungen erzeugt nur der Server.
  • Unveränderlich: Objektart, Objekt und Datei einer Verknüpfung können nicht umgehängt werden; entfernte Verknüpfungen lassen sich nicht wiederherstellen – neu anhängen.
  • Entfernen („Anhang ‚…‘ wird entfernt. Die Datei bleibt erhalten.“) löscht nur die Kante; die Datei bleibt in der Anhänge-Ablage.
  • Lese-Regel gilt wie im Drive: „Öffnen“/„Herunterladen“ nur bei bereiter, geprüfter aktiver Version.

Datei · Issue