Dokumentenverwaltung¶
Die Dokumentenverwaltung ist der zentrale Bereich für alle im DMS gespeicherten Dateien. Hier können Dokumente gesucht, gefiltert und verwaltet werden.
Dokumentenübersicht¶
Die Dokumentenliste erreichen Sie unter /v2/dms. Die Darstellung erfolgt über die
TableMaster-Komponente.
| Spalte | Beschreibung |
|---|---|
| Name | Dateiname des Dokuments |
| Typ | Dateityp (PDF, Bild, Office) |
| Größe | Dateigröße |
| Hochgeladen am | Datum des Uploads |
| Verknüpfung | Zugeordnete Entität (Gerät, Kalibrierung) |
| Version | Aktuelle Versionsnummer |
Schnellsuche
Nutzen Sie die Freitextsuche, um Dokumente nach Name, Typ oder verknüpfter Entität zu finden. Die Suche berücksichtigt auch Metadaten.
Dokumentendetail¶
Die Detailansicht eines Dokuments finden Sie unter /v2/dms/[id]. Hier werden
alle Metadaten und der Versionsverlauf angezeigt.
Metadaten¶
Die DynamicDetailCard-Komponente zeigt folgende Informationen:
- Dateiname — Originalname der hochgeladenen Datei
- Dateityp — MIME-Type und Dateiendung
- Dateigröße — Größe in KB/MB
- Hochgeladen am — Datum und Uhrzeit des Uploads
- Hochgeladen von — Name des hochladenden Benutzers
- Verknüpfte Entität — Zugeordnetes Gerät oder Kalibrierung
Vorschau¶
Der Reiter Vorschau zeigt die Datei in der Oberfläche: PDF seitenweise (auch auf dem Tablet), Bilder direkt. Ein digitaler Kalibrierschein (DCC, eine XML-Datei nach PTB-Schema) wird im DCC-Viewer angezeigt — als lesbarer Schein, nicht als Quelltext. Für alle übrigen Dateitypen bleibt der Download der Weg zum Inhalt.
Versionierung¶
Dokumente im calServer v2 unterstützen eine vollständige Versionierung.
Versionsverlauf¶
Jede Version eines Dokuments wird mit folgenden Informationen gespeichert:
| Feld | Beschreibung |
|---|---|
| Versionsnummer | Fortlaufende Nummer (1, 2, 3, ...) |
| Zeitstempel | Datum und Uhrzeit der Version |
| Benutzer | Hochladender Benutzer |
| Dateigröße | Größe dieser Version |
Freigabe-Workflow (DocumentRelease)¶
Dokumente können einen Freigabe-Workflow durchlaufen:
- Entwurf — Dokument ist hochgeladen, aber noch nicht freigegeben.
- Zur Prüfung — Dokument wurde zur Prüfung eingereicht.
- Freigegeben — Dokument ist geprüft und freigegeben.
- Abgelehnt — Dokument wurde zurückgewiesen und muss überarbeitet werden.
Freigabe
Der Freigabe-Workflow ist optional und kann pro Dokumententyp aktiviert werden. Nicht freigegebene Dokumente sind für Endbenutzer dennoch sichtbar, werden jedoch als Entwurf gekennzeichnet.
Suche und Filter¶
Die Dokumentenliste bietet umfangreiche Filtermöglichkeiten:
- Dateityp — Einschränkung auf PDF, Bilder oder Office-Dokumente
- Zeitraum — Filterung nach Upload-Datum
- Verknüpfung — Nur Dokumente eines bestimmten Geräts oder Kunden
- Freigabestatus — Filterung nach Freigabestatus
- Dokumentart — die Dokumentarten, die tatsächlich im DMS liegen. Das sind
die konfigurierten Datei-Kategorien (
file_setting) und die Arten, die ein Modul selbst ablegt (siehe unten)
Dateien aus Modulen (Berichtsdateien, PDF-Vorlagen)¶
Nicht jedes Dokument kommt aus dem Eingangsordner oder aus einem Upload mit Datei-Kategorie. Die Berichtsverwaltung legt ihre eigenen Dateien direkt im DMS ab — mit voller Versionierung, aber ohne Kategorie:
| Dokumentart | Inhalt | Verknüpft mit |
|---|---|---|
| Berichtsdatei (JRXML/ZIP) | Hochgeladenes Berichtspaket | Bericht |
| PDF-Vorlage | Briefkopf-/Overlay-PDF | Vorlagenname |
Diese Dokumente erscheinen in der Dokumentenliste wie alle anderen: Die Spalte Dokumentart zeigt den lesbaren Namen statt des technischen Schlüssels, die Spalte Verknüpft mit den Bericht bzw. die Vorlage statt einer rohen UUID. Der Versionsverlauf ist derselbe wie bei jedem anderen Dokument — mit abgeschaltetem Filter „Nur aktuelle Version" sind alle Stände sichtbar.
Eingangsordner-Protokoll
Jeder Upload einer Berichtsdatei oder PDF-Vorlage hinterlässt zusätzlich eine Zeile im Eingangsordner mit Status Importiert und Verweis auf das erzeugte Dokument. Ordner und Muster bleiben dort leer — die Datei kam nicht aus einem Einleseordner. Der Eingangsordner ist damit das vollständige Verarbeitungsprotokoll aller DMS-Schreibvorgänge.
Große Datenmengen
Bei einer großen Anzahl von Dokumenten empfiehlt sich die Nutzung der Filter, um die Ladezeiten zu optimieren. Die serverseitige Paginierung begrenzt die Anzahl der gleichzeitig geladenen Datensätze.
Download¶
Dokumente können direkt aus der Detail- oder Listenansicht heruntergeladen werden. Ältere Versionen sind über den Versionsverlauf in der Detailansicht verfügbar.