Skip to content

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.

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)

„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

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
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
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
  • 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.

File · Issue