Überblick
Jeder Datensatz in UDM kann mit beliebig vielen Dateianhängen versehen werden — beispielsweise Bilder, PDFs oder Office-Dokumente. Die Anhang-Verwaltung bietet folgende Funktionen:
- Upload per Drag&Drop oder über den Upload-Button
- Download einzelner Anhänge direkt aus dem Panel
- Vorschau für Bilder und PDF-Dateien in einem Modal-Dialog
- Kategorisierung über den Objektkontext (z. B. „Vertrag“, „Foto“, „Protokoll“)
- Metadaten wie Dateigröße, MIME-Type und Prüfsumme werden automatisch erfasst
Sie möchten PDF-Verträge an Kundendatensätze anhängen. Dabei soll jeder Anhang die Kategorie „Vertrag“ erhalten. Das Anhang-Panel wird im Kundendialog angezeigt, sodass Sachbearbeiter die Verträge direkt einsehen und herunterladen können.
Schritt 1: Anhang-Panel im Dialog aktivieren
Damit Anhänge an einem Datenobjekt verfügbar sind, muss das zugehörige ViewModel das Interface IHasAttachments implementieren. Dies geschieht in der Regel durch den Administrator bei der Konfiguration des Dialogs.
-
Dialog-Konfiguration öffnen
Navigieren Sie zum gewünschten Datenobjekt (z. B. „Kunden“) und öffnen Sie die Verwaltungsansicht des Dialogs.
-
Anhänge aktivieren
Aktivieren Sie die Anhang-Funktion für dieses Datenobjekt. Wählen Sie dabei die gewünschte Platzierung des Panels:
- Unten (Bottom) — Standard-Position unterhalb der Formularfelder
- Rechts (Right) — seitlich neben dem Formular
- Tab — als eigener Reiter im Dialog
-
Kardinalität festlegen
Bestimmen Sie, ob pro Datensatz eine einzelne Datei (Single) oder mehrere Dateien (Multiple) erlaubt sein sollen.
Schritt 2: Dateien hochladen
Es stehen zwei Wege zur Verfügung, um Dateien an einen Datensatz anzuhängen:
-
Drag&Drop
Ziehen Sie eine oder mehrere Dateien aus dem Datei-Explorer direkt auf das Anhang-Panel. Die Dateien werden sofort hochgeladen und in der Liste angezeigt.
-
Upload-Button
Klicken Sie auf den Button „Datei hinzufügen“ im Anhang-Panel. Es öffnet sich ein Dateiauswahl-Dialog, in dem Sie eine oder mehrere Dateien auswählen können.
Nach dem Upload werden für jede Datei automatisch die folgenden Metadaten erfasst:
| Metadatum | Beschreibung |
|---|---|
| Dateiname | Originaler Dateiname inkl. Erweiterung (z. B. Vertrag_2026.pdf) |
| Dateigröße | Größe in KB oder MB |
| MIME-Type | Automatisch erkannter Dateityp (z. B. application/pdf) |
| Prüfsumme (SHA-256) | Eindeutiger Hash zur Integritätsprüfung |
| Sortierung | Reihenfolge der Anhänge innerhalb des Datensatzes |
| Name | Kategorie | Typ | Groesse | Hochgeladen am | Status |
|---|---|---|---|---|---|
| Vertrag_2026.pdf | Vertrag | 1,2 MB | 04.05.2026 09:42 | aktuell | |
| Foto_Anlage.jpg | Foto | JPG | 2,8 MB | 03.05.2026 14:21 | aktuell |
| Pruefprotokoll_Q1.docx | Protokoll | DOCX | 340 KB | 02.05.2026 16:55 | Entwurf |
| Aufmass.xlsx | Sonstiges | XLSX | 92 KB | 01.05.2026 11:08 | veraltet |
Schritt 3: Kategorien konfigurieren
Anhänge können über den Objektkontext kategorisiert werden. So lassen sich beispielsweise „Vertrag“, „Foto“ oder „Protokoll“ als separate Anhang-Bereiche innerhalb eines Datensatzes abbilden.
Der Objektkontext wird beim Konfigurieren des Anhang-Panels festgelegt. Mögliche Szenarien:
| Konfiguration | Verhalten |
|---|---|
| Kein Kontext | Alle Anhänge erscheinen in einer gemeinsamen Liste |
| Fester Kontext | Das Panel zeigt nur Anhänge einer bestimmten Kategorie (z. B. nur „Vertrag“) |
| Mehrere Panels | Verschiedene Panels mit unterschiedlichen Kontexten im selben Dialog (z. B. „Verträge“ und „Fotos“ getrennt) |
In unserem Beispiel: Das Anhang-Panel im Kundendialog erhält den Kontext „Vertrag“. Damit werden nur Vertragsdokumente in diesem Panel angezeigt.
Schritt 4: Anhänge anzeigen und herunterladen
Im Anhang-Panel stehen folgende Aktionen zur Verfügung:
-
Vorschau öffnen
Klicken Sie auf einen Anhang, um die Dateivorschau in einem Modal-Dialog zu öffnen. Bilder und PDFs werden direkt im Browser angezeigt. Mit den Navigationspfeilen können Sie zwischen den Anhängen blättern.
-
Herunterladen
Klicken Sie auf das Download-Symbol neben einem Anhang oder nutzen Sie den Download-Button in der Vorschau. Die Datei wird mit dem originalen Dateinamen heruntergeladen.
-
Löschen
Klicken Sie auf das Löschen-Symbol. Es erscheint eine Bestätigungsabfrage, bevor der Anhang endgültig entfernt wird.
Unterstützte Dateitypen und Größenlimits
| Kategorie | Dateitypen | Vorschau |
|---|---|---|
| Bilder | PNG, JPG/JPEG, GIF, SVG, WebP, BMP, TIFF | Ja — direkt im Modal |
| Dokumente | Ja — direkt im Modal | |
| Office | DOCX, XLSX, PPTX, DOC, XLS | Nein — nur Download |
| Text | TXT, CSV, XML, JSON | Nein — nur Download |
| Archive | ZIP, RAR, 7Z | Nein — nur Download |
| Sonstige | Alle weiteren Dateitypen | Nein — nur Download |
Verhalten bei Namenskollisionen
Das Verhalten beim Upload einer Datei mit bereits vorhandenem Namen hängt von der konfigurierten Kardinalität ab:
| Kardinalität | Verhalten |
|---|---|
| Single | Jeder Upload überschreibt die vorhandene Datei. Es ist nur ein Anhang pro Datensatz erlaubt. |
| Multiple | Datei mit gleichem Namen: wird aktualisiert (neue Version). Datei mit anderem Namen: wird als neuer Anhang hinzugefügt. |
Häufige Fragen
| Frage | Antwort |
|---|---|
| Wie viele Anhänge kann ein Datensatz haben? | Bei Kardinalität „Multiple“ gibt es keine feste Obergrenze. Die Anzahl wird nur durch den verfügbaren Speicher begrenzt. |
| Kann ich Anhänge auch im Nur-Lesen-Modus sehen? | Ja. Das Anhang-Panel kann als schreibgeschützt konfiguriert werden. In diesem Fall sind Download und Vorschau verfügbar, aber Upload und Löschen sind deaktiviert. |
| Werden Anhänge in der Datenbank gespeichert? | Standardmäßig ja (Storage-Provider „Database“). Alternativ kann ein externer Speicher wie Azure Blob Storage oder S3 konfiguriert werden. |
| Was passiert, wenn der Datensatz gelöscht wird? | Alle zugehörigen Anhänge werden zusammen mit dem Datensatz entfernt. |
| Kann ich die Reihenfolge der Anhänge ändern? | Ja. Die Sortierung wird über das Feld SortOrder gesteuert und kann im Panel angepasst werden. |
| Welche Dateitypen sind nicht erlaubt? | Ausführbare Dateien (.exe, .bat, .cmd, .ps1) werden aus Sicherheitsgründen blockiert. Der Administrator kann weitere Einschränkungen konfigurieren. |
| Unterstützt das System internationale Dateinamen? | Ja. Dateinamen mit Umlauten, Sonderzeichen und nicht-lateinischen Schriftzeichen werden korrekt verarbeitet (RFC 5987 Encoding). |