enhancement
major
minor
major
minor
major
#29560
React view <upload-command>: Fehler beim Upload (Ausnahme in der Aktionskette, überschrittenes Größenlimit) erreichen den Benutzer nicht; Upload-Größenlimit konfigurierbar
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-layout-view / tl-layout-react.
Ausnahme in der Aktionskette wird unterdrückt
ViewUploadCommandModel führt die konfigurierte Aktionskette einmal pro hochgeladener Datei aus. Wenn die Kette eine Ausnahme auslöst – beobachtet mit der TopLogicException „Der Benutzer darf keine Elemente vom Typ Ausgabe erstellen“ aus new(`expenses:Expense`) für ein Konto ohne CREATE-Berechtigung –, schreibt das Modell
ERROR ViewUploadCommandModel – Upload der Datei „receipt-hotel.pdf“ fehlgeschlagen.
com.top_logic.util.error.TopLogicException: Der Benutzer darf keine Elemente vom Typ „Ausgabe“ erstellen.
at com.top_logic.model.search.expr.CreateObject.eval(CreateObject.java:52)
in das Protokoll und fährt mit der nächsten Datei fort. Es wird nichts an den Browser weitergeleitet: keine Snackbar, kein Fehlerdialog, die Tabelle bleibt unverändert. Der Benutzer hat keine Möglichkeit, einen abgelehnten Upload von einem langsamen zu unterscheiden.
Eine „TopLogicException“ ist laut Vertrag eine Meldung für den Benutzer. Erwartet: Die Meldung der Ausnahme wird an den ErrorSink des Fensters weitergeleitet (derselbe Weg, den info() -Einträge über ReactServlet.forwardPendingUpdates nehmen), eine Meldung pro fehlgeschlagener Datei, und der Protokolleintrag bleibt bei einer TopLogicException auf INFO oder WARN – es handelt sich um eine abgelehnte Operation, nicht um einen Fehler.
Anwendungsseitige Abhilfe: keine bei einer von der Engine selbst ausgelösten Ablehnung; einen von der Anwendung selbst erkannten Fehler kann diese über die TL-Script-Funktion info() melden, anstatt eine Ausnahme auszulösen.
Größenlimit: HTTP 500 ohne Hinweis, Limit fest verdrahtet (ehemals #29566)
Betrifft 8.0.0-SNAPSHOT (12.09.2026), tl-layout-react (ReactServlet, META-INF/web-fragment.xml).
Laden Sie eine 57-MB-PDF-Datei über eine React-Ansicht <upload-command> hoch. Jetty lehnt den Multipart-Body ab:
IllegalStateException: maximale Länge überschritten: 52428800 BadMessageException: 400: ungültiger Multipart FEHLER … ReactServlet – Fehler bei der Bearbeitung der React-Anfrage: /upload
Das Servlet antwortet mit HTTP 500 {"success":false,"error":"Interner Fehler."}; der Client protokolliert dies in der Konsole und zeigt nichts an – keine Meldung, kein Dialog, die Upload-Schaltfläche hat aus Sicht des Benutzers einfach keine Wirkung.
Zwei Mängel:
- Die Ablehnung wird dem Benutzer nicht angezeigt. Ein Upload, den der Container aufgrund seiner Größe ablehnt, muss einen Hinweis mit Angabe des Limits („Dateien bis zu 50 MB“) ausgeben, genau wie dies bei einem abgelehnten Befehl der Fall ist.
- Das Limit lässt sich nicht konfigurieren. „max-file-size“ / „max-request-size“ = 52428800 sind Literale in der Datei „META-INF/web-fragment.xml“ von tl-layout-react(metadata-complete="true"), sodass eine Anwendung diese Werte weder erhöhen noch verringern noch gar auslesen kann, um den Nutzer darüber zu informieren. Erwartet wird eine Konfigurationseigenschaft (auf Anwendungsebene), deren Wert auch der Client erhält, damit der Dateiauswähler den Upload frühzeitig ablehnen kann und die Meldung den Wert angibt.
Entdeckt bei der Ermittlung der Größenbeschränkungen für Belege in der Anwendung „Expenses“ (die einen festgelegten Höchstwert für fotografierte Belege benötigt).
Lösung
Gemeinsame Fehlerausgabe. Die Umwandlung einer Ausnahme in ein Fehlerergebnis (INFO-Log für Benutzerfehler, ERROR für interne Fehler, Übernahme des I18N-Schlüssels) und die Darstellung eines fehlgeschlagenen HandlerResult im ErrorSink des Fensters (Überschrift plus Detailliste) liegen im öffentlichen Helfer com.top_logic.layout.react.control.CommandErrors in tl-layout-react, den der Befehls-Dispatch (ReactCommandInvoker), ReactServlet und der Upload-Befehl gemeinsam nutzen.
Fehler in der Aktionskette. ViewUploadCommandModel meldet jede fehlgeschlagene Datei über diesen Helfer im ErrorSink: Überschrift „Upload von „<Datei>“ fehlgeschlagen.“, darunter die Fehlermeldung der Kette; die übrigen Dateien werden weiter verarbeitet. Eine TopLogicException wird mit INFO protokolliert, interne Fehler weiterhin mit ERROR. Der Upload-Endpunkt des ReactServlet zeigt ein Fehlerergebnis oder eine Ausnahme des Upload-Handlers ebenfalls im ErrorSink an, anstatt mit HTTP 500 zu antworten.
Snackbar-Warteschlange. Damit bei mehreren Dateien jede Meldung sichtbar wird, zeigt ReactSnackbarControl eine Meldung, die während einer sichtbaren eintrifft, nicht mehr sofort an deren Stelle an, sondern reiht sie ein und zeigt sie nach dem Ausblenden der vorherigen an (Reihenfolge des Eintreffens, jede mit eigener Generierung und eigenem Timer).
Konfigurierbares Größenlimit. Anwendungskonfiguration com.top_logic.layout.react.control.upload.UploadConfig in tl-layout-react (registriert in den <configs> des Moduls) mit der Eigenschaft max-upload-size (MemorySizeFormat, Standard 50 MB, 0 = unbegrenzt). Sie begrenzt jede einzelne Datei und die gesamte Anfrage. Beispiel:
<configs>
<config config:interface="com.top_logic.layout.react.control.upload.UploadConfig"
max-upload-size="10m"
/>
</configs>
Durchsetzung. Die Datei „web-fragment.xml“ enthält lediglich den Spool-Schwellenwert. Das ReactServlet setzt das konfigurierte Limit selbstständig und containerunabhängig durch: Content-Length vor dem Parsen, Part-Größen nach dem Parsen; zusätzlich wird Jetty das Limit über das Request-Attribut org.eclipse.jetty.multipartConfig mitgeteilt, sodass der Container das Einlesen bei Erreichen des Limits abbricht. Bei einer Ablehnung wird im ErrorSink „Es können Dateien bis zu 10 MB hochgeladen werden.“ angezeigt, mit INFO protokolliert und mit HTTP 413 geantwortet.
Frühe Ablehnung auf dem Client. Jedes Upload-Control speichert das Limit unter dem Zustandsschlüssel maxUploadSize (UploadSupport). useTLUpload() in der React-Bridge prüft die ausgewählten Dateien (einzeln und in der Summe) vor dem Senden und sendet bei Überschreitung anstelle des Uploads das globale Kommando uploadRejected, auf das das Servlet mit demselben Hinweis antwortet. Dies deckt alle Upload-Controls ab (Upload-Button, Datei-Upload, Binärfeld, Foto, Audio).
Demo. Die Fehlerbehandlungs-Demo der React-Demo-Anwendung (demo/error-handling-demo.view.xml) enthält ein <upload-command> „Upload (Kette schlägt fehl)“, dessen Kette einen Fehler auslöst; die Demo-Konfiguration legt max-upload-size="10m" fest.