Reference & Data Model
File link (file_link)
A file link attaches a file to an object as an attachment; removing it only clears the link.
Purpose
Section titled “Purpose”The link is the edge “object X has attachment F”. The content lives as an ordinary file in the „Anhänge“ (Attachments) volume; a file can be attached to several objects. (Data type: file data, manual/system)
Where in the app
Section titled “Where in the app”„Dateien“ (Files) section or button „Dateien anhängen“ (Attach files) in the dialogs of the linkable objects; one row per file with upload/virus status and the actions „Öffnen“ (Open), „Herunterladen“ (Download), „Entfernen“ (Remove). When creating an object, files are initially „Vorgemerkt“ (Queued) and are uploaded after saving. – Guides › Drive & attachments
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Object kind | entity_kind |
Selection | yes | kind of the target object (table below) | System, from the dialog |
| Object | entity_id |
Reference | yes | target object | System |
| File | file_id |
Reference | yes | attached file | System |
Linkable object kinds
Section titled “Linkable object kinds”entity_kind |
Object | Where |
|---|---|---|
issue |
Issue | issue dialog |
task |
Task | task dialog |
takeaway |
Key takeaway | key takeaway dialog and page |
document |
Document (service_documentation) |
document dialog |
technical_structure_node |
Technical node | „Verknüpfte Dateien“ (Linked files) |
technical_structure_good |
Component | „Verknüpfte Dateien“ |
conversation |
Conversation | attachment in the Polaris/agent chat; only the creator of the conversation |
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| File | belongs to | yes | – | deleted along |
| Target object | belongs to (via kind + ID) | yes | – | edge is cleaned up by the server |
Rules & automation
Section titled “Rules & automation”- Idempotent: The same file on the same object exists only once; attaching it a second time creates no duplicate.
- Target must exist and must not be deleted; the object kind must come from the list. Conversation links are created by the server only.
- Immutable: Object kind, object and file of a link cannot be re-pointed; removed links cannot be restored – attach again.
- Removing („Anhang ‚…‘ wird entfernt. Die Datei bleibt erhalten.“ – Attachment ‘…’ will be removed. The file is kept.) deletes only the edge; the file stays in the attachments volume.
- Read rule applies as in the Drive: „Öffnen“/„Herunterladen“ only with a ready, scanned active version.