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)
Wo in der App
Abschnitt betitelt „Wo in der App“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 |
Verknüpfbare Objektarten
Abschnitt betitelt „Verknüpfbare Objektarten“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 |
Beziehungen
Abschnitt betitelt „Beziehungen“| 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 |
Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- 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.