Ein Dokument hochladen und Dateigrößenlimits

Dieser Artikel zeigt Ihnen, wie Sie eine Datei an einen Datensatz in MobilityManager hochladen, und erläutert die Regeln, die die Plattform durchsetzt, einschließlich der Größenbeschränkung von 50 MB und der verpflichtenden Kategorie.

Bevor Sie beginnen

Das Hochladen erfordert die Berechtigung documents:manage, die üblicherweise FleetManager und SystemAdmin innehaben. Sie benötigen außerdem ein aktives Unternehmen (Mandant) in Ihrer Sitzung, und der übergeordnete Datensatz, an den Sie anhängen, muss bereits existieren.

Ein Dokument hochladen

Öffnen Sie den Datensatz, an den Sie die Datei anhängen möchten – zum Beispiel ein Fahrzeug, einen Beleg, einen Schadensfall oder ein Strafmandat.
Wählen Sie im Dokumentbereich dieses Datensatzes die Datei von Ihrem Gerät aus.
Wählen Sie eine Dokument-Kategorie aus. Dies ist erforderlich.
Bestätigen Sie den Upload. Die Plattform speichert die Datei, erfasst ihre Metadaten und legt den Inhalt als Version 1 ab.

Im Hintergrund wird die Datei mit dem Zuordnungstyp und der ID des Datensatzes an das gemeinsam genutzte DocumentModule gesendet, sodass Sie diese Werte nicht manuell wählen – sie stammen aus dem Datensatz, den Sie geöffnet haben.

Die Größenbeschränkung von 50 MB

Uploads sind auf 50 MB pro Datei begrenzt. Diese Grenze wird frameworkweit auf dem Anfragetext durchgesetzt, sodass eine Datei oberhalb der Grenze vom Server abgelehnt wird, bevor sie verarbeitet wird. Ist Ihre Datei zu groß, verkleinern Sie sie zuerst – scannen Sie beispielsweise mit niedrigerer Auflösung oder teilen Sie ein mehrseitiges PDF auf.

Tipp: Fotos direkt von einer Handykamera liegen in der Regel deutlich unter 50 MB, doch hochauflösende mehrseitige Scans können sie überschreiten. Schlägt ein Upload sofort ohne Kategoriefehler fehl, ist die Dateigröße die wahrscheinlichste Ursache.

Was die Plattform validiert

Regel	Was passiert, wenn sie fehlschlägt
Eine Datei ist ausgewählt und nicht leer	„File is required."
Eine Kategorie ist ausgewählt	„Please select a document category"
Die Kategorie ist eine aktive Systemkategorie	„Category is required and must match an active system document category."
Der Datensatztyp wird unterstützt	„Document operation unavailable"
Ein Unternehmenskontext ist aktiv	„Tenant context is required for document operations."

Kategoriewerte werden vor dem Abgleich in Kleinbuchstaben normalisiert, sodass die Groß- und Kleinschreibung keine Rolle spielt.

Sichere Wiederholungen und Duplikatvermeidung

Stößt ein Upload auf ein vorübergehendes Problem – eine abgebrochene Verbindung, eine Zeitüberschreitung oder einen kurzzeitigen Speicher-Aussetzer –, wiederholt die Plattform ihn automatisch mit zunehmender Wartezeit, bis zu fünf Versuche. Schlagen alle Versuche fehl, sehen Sie „Upload failed. Please retry." Validierungsprobleme (eine fehlende Kategorie, ein falscher Datensatztyp) werden nicht wiederholt, weil eine Wiederholung sie nicht beheben kann.

Der Upload-Pfad unterstützt außerdem einen Idempotenzschlüssel, der es einer wiederholten Übermittlung derselben Anfrage ermöglicht, das ursprüngliche Ergebnis zurückzugeben, anstatt ein doppeltes Dokument zu erstellen. Ihr Client erledigt dies automatisch; Sie müssen nichts einstellen.

Hinweis: Ein erfolgreicher Upload erstellt eine neue Version. Ein erneutes Hochladen überschreibt die frühere Datei nicht – es fügt Version 2, Version 3 und so weiter hinzu, und Downloads geben die neueste Version zurück.