Wie Dokumente plattformweit funktionieren

MobilityManager speichert jede angehängte Datei über eine einzige gemeinsam genutzte Komponente namens DocumentModule. Dieser Artikel erläutert, wie dieses Modul funktioniert, damit Sie die gemeinsamen Regeln verstehen, die gelten, wo immer Sie eine Datei hochladen, ansehen oder löschen.

Eine Dokument-Engine für die gesamte Plattform

Anstatt dass jeder Bereich seinen eigenen Dateispeicher unterhält, laufen Fahrzeuge, Schadensfälle, Strafmandate, Belege, Führerscheine und Compliance-Berichte allesamt über dasselbe DocumentModule. Was auch immer Sie hochladen, wird auf dieselbe Weise erfasst, auf dieselbe Weise verschlüsselt und auf dieselbe Weise auf Ihr Unternehmen (Mandant) isoliert. Das Modul stellt einen kleinen Satz von Vorgängen bereit: Hochladen, Metadaten auflisten, Vorschau/Herunterladen und Löschen.

Zuordnungen: wie eine Datei weiß, wohin sie gehört

Ein Dokument wird niemals für sich allein gespeichert. Jede Datei wird über zwei Werte an einen übergeordneten Datensatz angehängt:

Zuordnungstyp – die Art des Datensatzes. Unterstützte Typen sind Vehicle, DamageCase, Beleg, Mandate (Strafmandat), driver-license und license-compliance-report.
Zuordnungs-ID – die numerische ID dieses bestimmten Datensatzes.

Wenn Sie einen Zuordnungstyp senden, den das Modul nicht erkennt, wird der Upload mit „Document operation unavailable" abgelehnt. Deshalb hängen Sie Dokumente aus einem Datensatz heraus an (einem Fahrzeug, einem Beleg, einem Schadensfall) und nicht an eine frei stehende Bibliothek.

Was die Plattform für jedes Dokument erfasst

Feld	Bedeutung
Dateiname	Ursprünglicher Dateiname, bis zu 256 Zeichen.
Inhaltstyp	MIME-Typ, gespeichert so, wie er von Ihrem Browser gesendet wird.
Dateigröße	Größe in Bytes.
Kategorie	Eine erforderliche System-Dokumentkategorie (zum Beispiel Rechnung, Foto, Beleg).
Quelltyp	`upload` für Dateien, die Sie hochladen, oder `url_ingestion` für Dateien, die aus einer externen URL abgerufen werden.
Hochladender	Ihre Benutzer-ID und E-Mail, für den Prüfpfad aufbewahrt.

Versionierung

Jedes Dokument bewahrt seinen Dateiinhalt als nummerierte Version auf. Der erste Upload wird zu Version 1; das Hochladen eines Ersatzes fügt eine neue Version hinzu, anstatt die vorherige zu überschreiben. Downloads geben stets die neueste Version zurück, sodass der Verlauf erhalten bleibt, ohne die Liste zu überfrachten.

Berechtigungen

Zwei Berechtigungen steuern die gesamte Dokumentarbeit: documents:view (Auflisten und Herunterladen) und documents:manage (Hochladen und Löschen). Diese haben üblicherweise die Rollen FleetManager und SystemAdmin inne und können benutzerdefinierten Rollen gewährt werden. Berechtigungen werden serverseitig über [RequirePermission] durchgesetzt, sodass das Ausblenden einer Schaltfläche niemals die einzige Verteidigungslinie ist.

Hinweis: Jeder Dokumentvorgang erfordert außerdem einen gültigen Mandantenkontext. Hat Ihre Sitzung kein aktives Unternehmen, gibt die Plattform „Tenant context is required for document operations" zurück, und die Aktion wird abgebrochen, bevor eine Datei gelesen oder geschrieben wird.