Upload Files¶
calServer v2 provides a convenient file upload function through the integrated Document Management System (DMS).
Upload Page¶
The upload function is accessible at /v2/dms/upload.
Supported File Types¶
| Category | Formats |
|---|---|
| PDF Documents | .pdf |
| Images | .jpg, .jpeg, .png, .tiff |
| Office Documents | .xlsx, .xls, .docx, .doc |
File Size
The maximum file size is configured server-side. The default limit is 20 MB per file. An error message is displayed when exceeded.
Drag-and-Drop Upload¶
The upload area supports drag and drop:
- Drag one or more files from your file manager into the upload area.
- The files are uploaded automatically.
- After uploading, assign the files to a device or calibration.
Alternatively, you can open the file dialog via the Select Files button.
Multiple Upload
You can upload multiple files at once by dragging them together into the upload area or selecting multiple files in the file dialog.
Assignment¶
After uploading, files must be assigned to an entity:
- Inventory Item — Device documentation, data sheets, photos
- Calibration — Calibration protocols, measurement results
The assignment is made via a selection field in the upload form.
Storage Backends¶
The storage location is configured by the administrator. The following backends are available:
| Backend | Description |
|---|---|
local |
Local file system of the server |
s3 |
Amazon S3 or S3-compatible object storage |
sftp |
External server via SFTP connection |
Transparent to Users
The chosen storage backend is transparent to end users. The upload and download functions behave identically regardless of the backend.
Versioning¶
When a file with the same name is uploaded again, the system automatically creates a new version. All previous versions are preserved and can be viewed via the Document Detail View.
Version History
In the document detail, you will find the complete version history with timestamp and uploading user for each version.
Permissions¶
The dms_upload permission is required to upload files. Assigning a file to a device
additionally requires read access to the respective inventory object.