File Management¶
Under Administration > File Management, you configure the Document Management System (DMS) of calServer. Management is divided into File Settings, File Links, External Documents, and the DMS Browser.
File Settings¶
In the file settings, you define which documents are referenced via database columns in which modules and into which DMS directories the files are stored.
| Field | Description |
|---|---|
| Table Link | Associated module (e.g., INVENTORY, REPAIR, WIKI). |
| Column | Technical name of the column for the file information. |
| Column Label | Display name in the frontend. |
| Assignment | Placeholder logic for dynamic naming (e.g., {name}, {RTAG}). |
| Directory Name | Target directory in the DMS (e.g., "manuals", "certificates"). |
| Show only role-based released files | Restricts visibility to specific roles. |
| Show only group-based released files | Restricts visibility to specific groups. |
| Actions | Edit or delete the file assignment. |
Info
Deleting a file assignment only removes the configuration, not the physical file in the DMS.
File Links¶
File Links define actions or links for files with specific extensions in specific folders. This allows files to be linked with external programs or special commands.
| Field | Description |
|---|---|
| Linked Folder | DMS folder for which the rule applies. |
| File Extension | File extension (e.g., .pdf, .pxe). |
| Link | URL, file path, or execution command. Placeholders like {documentfile} are possible. |
| Icon | CSS class or icon reference for display in the file browser. |
| Actions | Edit or delete the link. |
External Document Settings¶
The automatic integration of external documents monitors a file system path and transfers newly detected files to a DMS target directory.
| Field | Description |
|---|---|
| External Documents Folder | Monitored source directory on the file system. |
| Target Inbox Folder | Target folder in the DMS (e.g., "certificates"). |
| Check for new Documents Interval | Check interval in minutes. |
Warning
Intervals that are too small can increase system load with large data volumes. Intervals that are too large delay data availability.
DMS Browser¶
The DMS Browser provides a file-system-like view for navigating, managing, and opening documents.
| Area | Description |
|---|---|
| Navigation Tree (left) | Hierarchical folder structure of the DMS. |
| File Overview (right) | Files in the currently selected directory with file type icons. |
| Toolbar (top) | Upload, rename, copy, cut, delete. |
| Search Field | Full-text search in the current directory. |
Business Continuity: DMS Index File¶
Each time the DMS is updated, an index file (contents.csv) is automatically created. This contains metadata for all stored documents and enables manual access to customer certificates in the event of server failures.
The index file contains the following fields:
| Field | Description |
|---|---|
| link_table | Directory or table of the file storage. |
| name | Original file name. |
| hash | Unique DMS storage name (hash). |
| created | Upload date. |
| major_version | Major version number (incremented on release). |
| minor_version | Minor version number (incremented on upload). |
| status | Processing status (e.g., "Upload", "Release"). |
| filename | Actual file name in the system. |
| is_latest | Indicator of the most recent version. |
| created_by | Creator of the file. |
Tip
Back up the contents.csv on a separate server or in the cloud to keep it available even in the event of a complete server failure.