TopLogic - the automated application engine
  • Releases
  • Dokumentation
  • Github
  • Discord
  1. Home
  2. Releases
  3. TL_8.0.0-alpha9
  4. #29530

8.0.0-alpha9
TopLogic Release

2026-10-01

enhancement

major
#27490
Historie begrenzen/abschneiden/aufräumen
#29004
Die Verwendung eines Virenscanners für Uploads zulassen
#29006
Eindeutigkeitsbeschränkung
#29421
Fügen Sie ein React-Kalender-Steuerelement und ein deklaratives UIElement „ <calendar> “ hinzu.
#29429
Vervollständigen Sie den View-Designer, damit damit eine Ansicht von Anfang bis Ende erstellt werden kann.
#29462
React: Generisches Formularelement zum Bearbeiten von Konfigurationen
#29487
React-Ansicht: „ <form> “ gibt weder die Spaltenanzahl noch die Position der Beschriftung preis, und es gibt kein „ <group> “-Element.
#29499
Hinweis auf den Wartungsmodus in der React-Oberfläche
#29507
Hinweis auf den bevorstehenden Session-Timeout in der React-Oberfläche
#29523
<sidebar> zeigt zwei der fünf Arten von Sidebar-Elementen an, die ReactSidebarControl rendert, und keines der Badges
#29525
Das Benutzermenü der App-Leiste in der Kernansichtsebene anzeigen
#29528
Das UI-Design soll sich an die Systemeinstellung für „Dunkel“ bzw. „Hell“ anpassen
#29529
Stellvertreter als explizite Sicherheitsaktion im Einstellungsdialog der TL Views benennen (mit Passwortbestätigung, auch für die Passwortänderung)
#29530
URL-Routing in TL Views: Modellobjekte in Routenparametern, Drilldown-Pfad in der URL, Abfragebindungen
#29531
Filterleiste für Tabellen: Presets, Freitextsuche über die sichtbaren Spalten und benutzereigene gespeicherte Filter
#29532
Objektnavigation in TL Views: Anzeigeziele, ein „reveal“-Protokoll für Container und eine „show-object“-Aktion
#29540
Feedback zur Benutzerfreundlichkeit des Benutzermenüs und des Dialogfelds „Persönliche Einstellungen“
#29542
TL Views: Kanalgebundene Werteingaben für jeden Primitiv- und Referenztyp mit einem „Submit“-Hook
#29543
TL-Ansichten: Bedingte Verzweigungen in einer Aktionskette mit generischen Befehlen
#29544
TL-Ansichtstabelle: Zeilenaktivierung per Doppelklick oder Enter sowie eine Gruppierungsoberfläche über dem bestehenden Tabellenmodell
#29545
TL-Ansichtstabelle: Drag &amp; Drop von Zeilen zwischen Tabellen und auf Zeilen
#29546
TL-Ansichten: Farben für Aufzählungsliterale und Klassifikatorobjekte, die als „Pills“ dargestellt werden, sowie ein Fortschrittsbalken
#29547
Generierte React-Bundles nicht mehr einchecken
#29548
React-View-Benutzeroberfläche: Die Attribute „URL“, „E-Mail“ und „Telefon“ werden als Eingabefelder bearbeitet und als Links angezeigt.
#29551
TL-Ansichten: Es dürfen nur registrierte Einstiegspunkte über eine URL auf oberster Ebene geladen werden
#29557
React-View-Befehle: Der „ExecutableState“-Wert eines deaktivierten Befehls wird niemals an den Client übermittelt, und es gibt neben „visible-if“ keine „disabled-if“-Regel.
#29567
TL Views: Mehrfachauswahl für Tabellen und Bäume (selection-mode="multi")
#29575
TL Views: UI-Inspektor – Zustand eines Elements der React-Oberfläche einsehen (z. B. durch Zugriffsrechte ausgeblendete Tabellenzeilen) und als Skript-Zusicherung aufzeichnen
#29596
TL Views: Gestaltungsoptionen für app-spezifische Oberflächen (css-class, Text-Varianten, Layout-Optionen, Anzeigevarianten für Eingaben, Theme-Tokens)
#29597
TL Views: object-list als generischer Repeater (Elemente ohne Container, Raster-Layout, Index für gestaffelte Animation)
#29598
TL Views: image mit URL-/Ressourcen-Quelle, Seitenverhältnis, Füllmodus und überlagerten Inhalten; avatar mit Foto
#29599
TL Views: Wizard-/Stepper-Element für mehrstufige Dialogflüsse (statische und dynamische Schritte, Fortschritt, Übergänge, Auto-Weiter)
#29600
TL Views: Anzeige lang laufender Server-Aufträge (Phasen, Fortschritt, unbestimmter Fortschritt, verstrichene Zeit)
#29601
TL Views: Anzeige von HTML-Inhalten und HTML-Dokumenten (Agenten-Antworten, Exposés) mit Vorschau und Druck/PDF
#29603
Physisches Löschen gelöschter Objekte aus versionierten Tabellen (Purge): Abschlussmenge über Pflichtreferenzen und Inhalte, optionale Verweise werden geleert
#29605
TL-Ansichten-Tabellenfilterleiste: eine anfänglich aktive Voreinstellung sowie die aktive Voreinstellung und der Suchbegriff als Kanäle für Abfrageverknüpfungen
#29607
TL-Ansichten: Ein Anzeigeziel zeigt eine Registerkarte innerhalb eines verschobenen Rahmens an (ein „ <show> “ befindet sich innerhalb der zuvor angezeigten Ansicht).
#29608
TL Views: value-input mit Platzhalter, zugänglicher Name bei verborgenem Label, bedingte Anzeige von Elementen mit visible-if
#29615
TL-Ansichten: Ein seitenübergreifendes „ <form> “ ist nicht am Füllvertrag beteiligt, sodass ein darin enthaltenes geteiltes oder ausfüllendes Panel entsprechend seinem Inhalt dimensioniert wird.
#29617
Designsystem: Tokens und Basisklassen als eigenes Paket (Welle 0)
#29625
TL-Ansichten: Ein Seitenlayout mit gewichteten Spalten (Hauptbereich 2/3, Seitenbereich 1/3), das bei einem schmalen Viewport auf eine Spalte umgebrochen wird; der geteilte Bereich behält seine Trennlinien bei und schneidet den Seitenbereich bei 400 px ab.
#29629
TL-Ansichten: Die Aktionen `<show-view>` und `<show-views>` zeigen eine nach Namen angegebene eingebundene Ansicht an und schreiben deren Kanäle aus einer Befehlskette ohne Modellobjekt
#29630
TL Views: Ein in Blöcke unterteilter, transaktionsbasierter Job-Körper für „ <start-job> “ – skriptgesteuerte Initialisierung / Elemente / Schritte / Abschluss, eine Transaktion pro Block, Wiederholungsversuche und Überspringen auf Elementebene, Phasen und Fortschritt, die sich aus den Schritten ableiten
#29637
Modellbasierte Berechtigungsdefinition: Zugriffselternobjekt (Delegation der Zugriffsentscheidung an Container oder Referenz, Standard für Kompositionsteile, Entscheidungs-Cache je Interaktion), Rollenelternobjekt statt Security-Parent, Vollständigkeitsprüfung und Assistent
#29640
TL Views: Gruppen einer gruppierten Tabelle werden nach dem Komparator der Gruppierungsspalte sortiert, nicht in zufälliger Reihenfolge
#29641
TL Views: Der React-TL-Script-Editor zeigt Hilfetexte zu Funktionen und Modellelementen an (Kontexthilfe zur Vervollständigung, Hover-Tooltips) und springt beim Tippen nicht mehr an den Textanfang
#29643
TL Views: Anpassung der React-Oberfläche an das Corporate Design eines Kunden mit eigener React-Komponentenbibliothek (Leitfaden und fehlende Erweiterungspunkte)
#29671
TL Views: Drag & Drop in Tabellen nach Regeln einschränken, mit Rückmeldung pro Ziel während des Ziehens
#29681
TL-Script modifiedRevision() berücksichtigt Referenz- und Übersetzungsänderungen; Attribut-Storages "touchen" das Besitzerobjekt nicht mehr
#29690
Option zum Deaktivieren des Browserstarts beim Hochfahren
#29706
Langsame Unit-Tests in tl-core und tl-element beschleunigen
minor
#28324
Dokumentation zu Layout Overlays erstellen
#29500
Es gibt keine Möglichkeit, eine Master-Detail-Ansicht als Overlay darzustellen: Die Detailansicht nimmt immer die Hälfte der Breite der Liste ein.
#29506
Eine Dashboard-Kachel kann nicht der Einstiegspunkt sein, nach dem sie aussieht: Weder <tile> noch <card> führen zu einer Aktion.
#29550
React-Kontrollen nutzen die „radius“- und „surface“-Tokens des Themes nicht einheitlich; ein „flat“-Theme erfordert CSS-Überschreibungen auf Komponentenebene
#29553
React-View- <table>: <column> hat keine Breite, jede Spalte ist standardmäßig 150 px breit, sodass eine Tabelle mit mehr als sechs Spalten über den 940 px breiten Bereich hinausragt.
#29611
TL-Ansichten: Die Aktion `<notify>` zeigt einen übersetzten Hinweis in einer generischen Befehlskette an (Snackbar oder OK-Dialog, wobei die Kette optional unterbrochen wird); `<throw-error>` wurde entfernt
#29624
SSO-Login ohne registrierten Benutzeraccount: konfigurierbare Hinweisseite (ApplicationPages.unknownAccountPage) statt Login-Maske, mit Standardseiten für die klassische und die React-Oberfläche
#29670
TL-Script: Funktionen trim, trimStart und trimEnd entfernen Leerraum am Anfang und Ende einer Zeichenkette
#29675
TL Views: Anlegen und Löschen richten sich nach den Modell-Zugriffsrechten, statt erst nach dem Ausfüllen mit „Kopieren nicht erlaubt“ abgelehnt zu werden
#29683
TL-Script: htmlText(html) kann keine Bilder enthalten, daher kann ein HTML-Text mit <img>, der auf Dateien verweist, nicht in strukturierten Text umgewandelt werden.

defect

critical
#29665
TL Views: Ein Klick in ein Rich-Text-Feld mit versteckter Beschriftung setzt die Schaltfläche „Fett“ im Editor in den Fokus, wodurch der eingegebene Text verloren geht.
#29682
TL Views: Bei einer Seite-Neuladung tritt die Ausnahme „ConcurrentModificationException“ in „ReactToolbarControl.replaceGroups“ auf, woraufhin die Seite „Interner Fehler“ angezeigt wird.
major
#25723
Fehlende Prüfung gegen Attribut-Name-Clashes bei Vererbung
#29438
Die React-View-Ebene zeigt Datumsattribute in einem fest vorgegebenen Format anstelle des kommentierten Formats an.
#29474
Keiner der beiden React-Ziehgriffe schirmt die Seite ab (oder sperrt den Cursor), während gezogen wird.
#29502
<tree> berücksichtigt keine Modelländerungen: Ein „delete“ wird nie ausgeführt, ein „create“ lässt den gesamten Baum zusammenbrechen
#29504
Zwangsabmeldung erreicht die React-Oberfläche nicht
#29509
Die Cookie-Prüfung weist den erneuten Aufruf ihrer eigenen URL ab und meldet dabei die Sitzung ab
#29512
Attribute in tl.model, die de-facto mandatory sind, auch als mandatory deklarieren
#29533
TL-Ansichten: Ausführbarkeitsregeln und abgeleitete Kanäle müssen Änderungen des Objekts auf einem Kanal berücksichtigen, nicht nur Änderungen des Kanalwerts.
#29534
TL Views „Tile-Stack“: Frames erhalten keine feste Höhe, und ein Frame, der wieder freigelegt wird, wird von Grund auf neu aufgebaut.
#29535
TL-Ansichtstabelle: Ein Auswahlkanalwert, der nicht in den Zeilen enthalten ist, darf von der Tabelle nicht gelöscht werden
#29541
Einwertiges Dropdown-Auswahlfeld zeigt zwei Schaltflächen mit der Aufschrift „Löschen“ an
#29554
React view <table>: Spalten für beliebige Zeilenobjekte – berechnete Spalten, eingebettete Spalten referenzierter Objekte, dynamische Spalten; transiente Zeilen
#29556
react-api/tooltip läuft ohne TLSubSessionContext: Ein Zell-Tooltip über einem abgeleiteten Attribut, das mit label() verwendet wird, liefert den HTTP-Status 500 (NullPointerException in Label.eval)
#29560
React view <upload-command>: Fehler beim Upload (Ausnahme in der Aktionskette, überschrittenes Größenlimit) erreichen den Benutzer nicht; Upload-Größenlimit konfigurierbar
#29562
Die in der Datei „security.xml“ für den Bereich „SecurityScopeService“ erteilten Berechtigungen gehen beim Start, bei dem der Bereich eingeführt wird, verloren: Der „AccessConfigurationSetupService“ importiert die Datei, bevor der Bereich existiert, und speichert den Datei-Hash trotzdem.
#29564
SecurityConfigurationService: Eine Anwendung kann einer Berechtigung eines Framework-Typs keine Rolle hinzufügen – eine „ <class> “-Berechtigung ist nach Operation indiziert und ersetzt den früheren Eintrag, wodurch die Rollen des Frameworks stillschweigend widerrufen werden.
#29568
TL Views: Eine ohne Anmeldung aufgerufene Route geht beim Login verloren
#29573
„TestReactStylesheetTokens“ schlägt auf dem Master-Zweig fehl: Die Regeln für „pill“ und „progress“ in tlReactControls.css halten den Theme-Token-Vertrag nicht ein.
#29574
TL Views: Veto eines verschachtelten Channel-Schreibzugriffs bricht die Benachrichtigung des äußeren Channels ab (Tabelle und Detailbereich bleiben nach "Verwerfen" auf dem alten Objekt)
#29576
React-Controls-Bundle enthält eine zweite React-Instanz (createPortal-Import in TLDropdownSelect)
#29586
Die Kompilierung von „tl-layout-react“ scheitert auf dem Master-Zweig: „TestSelectValueObservation“ und „TestResourceCellObservation“ verwenden den Konstruktor „DefaultReactContext“, der durch #29552 entfernt wurde.
#29590
React view: Mehrwertige String-Werte werden in Tabellenzellen und Anzeigefeldern ohne Trennzeichen aneinandergehängt
#29602
TL-Ansichten: Eine in eine bestehende Sitzung übernommene URL behält den Inhalt des Sidebar-Elements bei, das zuvor aktiv war.
#29604
ElementSecurityUpdateManager: Der quadratische Vergleich beim Commit (AbstractSet.removeAll auf eine Liste angewendet) führt dazu, dass das Anhängen an eine große Referenz mehrere Sekunden dauert.
#29609
TL Views: Ein `<progress>` (ChannelObjectObserver) wertet seinen Ausdruck für ein gelöschtes Objekt aus und protokolliert einen FEHLER, wenn ein beobachtetes Objekt gelöscht wird.
#29610
TL-Ansichten: Eine Tabelle auf einer inaktiven Registerkarte zeigt veraltete Zellwerte an, nachdem sich die angezeigten Objekte geändert haben, bis ihre Zeilen aktualisiert werden.
#29613
TL-Ansichten: Eine Kachel vom Typ „<dashboard> “ erhält keine feste Höhe, sodass eine Tabelle in einer Kachel mit ihren Zeilen mitwächst, anstatt gescrollt zu werden.
#29618
TL-Ansichten: Eine URL blendet die Seitenleiste bei einem Eintrag mit ungespeicherten Änderungen aus, ohne nachzufragen.
#29619
TL-Ansichten: Eine Konfigurationsbeschränkung auf Warnstufe wurde entfernt, sodass der Modell-Editor nichts anzeigt
#29620
TL Views: Ein Baumknoten ist niemals ein Link zu der Stelle, an der sein Objekt angezeigt wird, obwohl die Anzeigeziele einen solchen deklarieren.
#29622
TL-Ansichten: Ein `<flow-diagram selection="ch">` schreibt seinen Kanal, folgt ihm jedoch nicht, sodass ein an anderer Stelle ausgewählter Knoten im Diagramm nicht markiert wird.
#29623
Build: Das „translate“-Ziel übersetzt festgeschriebene deutsche Meldungen nach einem Pull oder einem Wechsel des Zweigs neu, wenn das Doclet nicht im selben Build ausgeführt wurde.
#29626
TL-Ansichten: Eine Panel-Symbolleiste verfügt über keinen Überlaufmodus; bei einer Breite von 400 px erstrecken sich die sechs Befehle der Ticket-Seite über eine Breite von 908 px, wobei drei davon nicht erreichbar sind und der Panel-Titel nach außen verschoben wird.
#29627
Tabelle „TL Views“: Eine Zelle vom Typ „I18NString“ bricht den Text um und wird durch die 36-px-Zeile mitten im Glyphenabschnitt abgeschnitten, anstatt mit drei Punkten zu enden; Kopfzeilenbezeichnungen werden ohne drei Punkte abgeschnitten.
#29631
TL-Ansichten: Mit „Escape“ wird ein „ <window> “-Dialogfeld geschlossen, während ein damit gestarteter „ <start-job> “ noch ausgeführt wird; der Job läuft weiter, ohne dass es noch etwas gibt, das angezeigt oder abgebrochen werden könnte.
#29634
TL Views: Der Konfigurationseditor erstellt ein Textfeld für eine Eigenschaft, deren Format nur zur Analyse bestimmt ist. Daher schlägt die Auswahl eines abgeleiteten Attributs im Modell-Editor mit der Fehlermeldung „Es gibt keine normgerechte Möglichkeit, eine Locator-Konfiguration zu serialisieren“ fehl.
#29635
TL-Ansichten: Ein „ <tree> “ stellt jeden Knoten als Link dar, sodass ein Klick auf die Beschriftung zu einer anderen Seite führt, anstatt nur den Knoten auszuwählen.
#29639
TL-Script objectResolve(id, typeOrTable): Auflösung über einen Typ einschließlich seiner Untertypen oder über einen Tabellennamen; objectTable liefert die Tabelle eines Objekts, und ein Objekt, auf das der aktuelle Benutzer keinen Lesezugriff hat, wird nicht aufgelöst
#29644
Inkrementelle Security unvollständig bei Verwendung von scripted-steps
#29645
TL-Script: @SideEffectFree an Funktionen aus TLScriptFunctions wird ignoriert, da der Annotation die Laufzeit-Retention fehlt
#29648
TL Views: Die über ClientResources ausgelieferten Skripte und Stylesheets tragen keine Version in der URL, der Browser verwendet nach einer Aktualisierung veraltete Client-Dateien
#29649
TL Views: Der Endstatus eines Jobs wird durch einen veralteten „Running“-Snapshot überschrieben, sodass unter „ <job-status> “ ein abgeschlossener Job als „Running“ angezeigt wird.
#29666
TL-Ansichten: Das Verlassen eines Frames über „Breadcrumb“, „Zurück“, „navigate-pop“, „show-object“ oder „Abmelden“ löscht die nicht gespeicherten Änderungen eines Formulars, ohne den Benutzer zu fragen.
#29667
TL Views: Ein Formular im Bearbeitungsmodus zeigt weiterhin veraltete Werte an, nachdem ein Befehl eine Änderung an demselben Objekt übernommen hat
#29672
TL-Ansichten: „initial-edit-mode“, ein Objektumschalter und der Kanal „edit-mode“ wechseln ohne Rückfrage in den Bearbeitungsmodus <edit-executability>
#29674
TL-Ansichten: Nach dem Laden einer Seite werden die Befehlsbezeichnungen in der App-Leiste in der Sprache des Browsers statt in der Sprache des Benutzers angezeigt („Aufzeichnen“ in einer deutschen Sitzung).
#29677
TL-Ansicht: Eine Karte in einem Spaltenstapel in Inhaltsgröße schrumpft unter ihre Inhaltshöhe; eine Tabelle daneben nimmt mehr Höhe ein, als angegeben ist.
#29678
BoundHelper: Einstellung use-default-security-parent entfernen – ohne konfigurierte Security-Parent-Regel hat ein Objekt keinen Security-Parent
#29680
Klassische Benutzeroberfläche: Der anonymen Sitzung werden die Entwickleroptionen angeboten, und sie kann „Ressourcen neu laden“ ausführen.
#29698
CollectionUtil.removeDuplicates() verliert die Reihenfolge der Elemente
#29705
Workspace/PathInfo: web-fragment.war eines Moduls wird nicht gefunden, wenn Jar und Fragment aus verschiedenen lokalen Maven-Repositories aufgelöst werden (maven.repo.local.tail)
minor
#27889
Switch auf SNAPSHOT-Version funktioniert nicht
#28474
Hintergrundfarben der Knöpfe sind nicht konsistent
#29496
React-Tabelle: Eine Spaltengrößenänderung wird mit der Meldung „Integer value expected“ abgelehnt, und die neue Breite geht verloren, wenn der Client eine Bruchzahl als Breite übermittelt.
#29497
React-UI-Tooltips: Abgeschnittene Tabellenzellen und Spaltenüberschriften, kompakte Symbolleisten-Schaltflächen und Attributbeschreibungen erhalten Tooltips; native Titelattribute werden durch Bridge-Tooltips ersetzt
#29503
TLResourceCell liefert kein CSS aus: Symbol und Beschriftung überlappen sich überall dort, wo eine Ressourcenzelle beides anzeigt
#29505
Die Höhe der Panel-Kopfzeile ändert sich, wenn die zugehörige Symbolleiste keine Befehle enthält, sodass die Kopfzeilen von Master-Detail-Ansichten nicht bündig liegen
#29508
Weitere QueryExecutor bedürfen keiner Security
#29552
TLPhotoViewer ruft sein Bild ab, nachdem das Steuerelement entsorgt wurde, wenn es durch ein „ <switch> “ ersetzt wird (404 bei react-api/data, Warnung „Command target NOT FOUND“).
#29555
TL-Script-Labels (<constant>) werden zur Kompilierungszeit umgewandelt: Das Ergebnis wird an die Locale des kompilierenden Threads angepasst und nicht an die des lesenden Benutzers.
#29558
XMLInstanceImporter importiert ein internationalisiertes Attribut, das als „value=“…“ angegeben ist, stillschweigend als leer, selbst wenn das Attribut obligatorisch ist.
#29561
TL Views: Die Anzeige eines referenzierten Objekts passt sich nicht an eine Änderung seiner Beschriftung an (Tabellenzelle, Formularfeld)
#29563
Standardgruppe: das persistierte Gruppen-Flag "defaultGroup" wird aus der Konfiguration abgeleitet statt in der Datenbank gespeichert; Semantik der Standardgruppe dokumentiert
#29591
ResKey.decode akzeptiert in #(…)-Literalen nur doppelt gequotete Übersetzungen — #('Travel'@en) schlägt fehl, obwohl TL-Script beide Quote-Arten erlaubt
#29606
TL Views: Ein `<color token>`, das ein Token benennt, das das React-Theme nicht ausgibt, führt dazu, dass die Pill ohne Farbgebung und ohne Fehlermeldung gerendert wird.
#29628
TL-Hinweis: Mit „Persönliche Einstellungen zurücksetzen“ wird die gespeicherte Konfiguration gelöscht, die laufende Sitzung behält jedoch ihren Tabellenstatus bei und schreibt ihn zurück; die festgelegten Spaltenbreiten werden erst nach einer erneuten Anmeldung wiederhergestellt.
#29636
TL-Ansichten: Ein Klick auf einen „ <tree> “-Knoten löscht den Auswahlkanal, bevor er festgelegt wird, sodass jede davon abhängige Anzeige und jeder Befehl auf leer umschaltet und wieder zurückkehrt.
#29663
TL-Ansichten: Ein „ <form> “ wird nicht mehr eingebettet; bei einem „ <fields> “-Raster innerhalb eines Formulars wurde die Seite zweimal eingebettet
#29664
TL-Ansichten: Die Befehle „Bearbeiten“, „Speichern“, „Abbrechen“ und „Übernehmen“ des Formulars sind mit einem abschließenden Punkt gekennzeichnet („Bearbeiten.“, „Speichern.“)
#29668
TL-Ansicht: Die Symbolleiste des Rich-Text-Editors ragt über ein schmales Feld hinaus; die Schaltflächen für Tabellen sowie „Rückgängig“ und „Wiederherstellen“ werden abgeschnitten
#29669
Eine Anfrage mit einem fehlerhaften Abfrage-String („?q=50%“) wird mit einer „Interner Fehler“-Seite (HTTP 500) statt mit einem 400-Fehler beantwortet.
#29673
TL-Ansichten: Personalisierungsbefehle („Layout bearbeiten“, „Diesen Filter speichern“) werden der anonymen Sitzung angeboten
#29676
TL Views-Admin: Beim Löschen eines Kontos wird im weiterhin geöffneten Kontoformular die Meldung „Zielobjekt wurde gelöscht“ angezeigt; für den Löschvorgang ist keine Bestätigung erforderlich.
#29679
TL Views: Ein Befehl, der aufgrund seiner Ausführbarkeitsregel abgelehnt wird, wird mit dem Titel „Interner Fehler“ gemeldet.

task

minor
#29612
FAQ: Migrationsleitfaden für das Upgrade einer Anwendung von TL 7.11 auf 8.0
#29702
Mindestversion von Maven im Build auf 3.8.9 anheben
enhancement

major

#29530

URL-Routing in TL Views: Modellobjekte in Routenparametern, Drilldown-Pfad in der URL, Abfragebindungen

ReactUI

Problem

Die Ansichtsebene (com.top_logic.layout.view) spiegelt einen Teil ihres UI-Zustands in der Browser-URL wider: Der RouteManager setzt die Adresse aus den Segmenten der RoutingParticipants zusammen , die die Ansicht enthält, übermittelt Änderungen über SSE (`RouteChangeEvent`) an den Client und wandelt die Zurück-/Vorwärts-Funktionen des Browsers (Popstate) in einen „navigateToRoute“-Befehl um. Teilnehmer sind die Seitenleiste (ReactSidebarControl, ein Segment pro <nav-item>), die Registerkartenleiste (ReactTabBarControl) und die <param-bindings> auf Ansichtsebene (ParamBindingParticipant).

Was verhinderte, dass eine URL den Zustand beschrieb, den ein Benutzer tatsächlich sieht:

1. Routenparameter konnten keine Modellobjekte übertragen

„ParamBindingParticipant“ schreibt das URL-Segment in den gebundenen Kanal und den Kanalwert zurück in die URL, beides als Text. Ein Modellobjekt benötigte daher einen Text, der es identifiziert, und TL-Script bot keinen: Die registrierten Funktionen decken Modellteile (resolveModelPart), Enum-Literale (resolveEnum) und Aliase (resolveAlias) ab, aber keine liefert den Bezeichner eines Objekts oder findet ein Objekt anhand eines solchen wieder. Ein Objekt konnte nur über einen Geschäftsschlüssel in eine URL eingefügt werden, den ein Ausdruck nachschlagen konnte, z. B. `all(`demo.tickets:Ticket).filter(t -> $t.get(demo.tickets:Ticket#name) == $key).firstElement()“, allerdings auf Kosten der Eindeutigkeit und URL-Sicherheit, die ein solcher Schlüssel aufweisen muss.

Die klassische Benutzeroberfläche identifiziert Objekte in URLs über den BookmarkService und die Argumente #object=<id> seiner pluggbaren BookmarkHandler (aufgelöst durch den DefaultBookmarkHandler); nichts davon ist von der Ansichtsebene aus erreichbar.

2. Der Drilldown-Pfad des Kachelstapels ist nicht in der URL enthalten

<tile-stack> (com.top_logic.layout.view.tiles) speichert seinen Drilldown-Pfad als ` List<TileFrame> ` auf einem Kanal, und sowohl `<navigate-push>` als auch `<navigate-pop>` sind Schreibvorgänge auf diesen Kanal – dies ist beabsichtigt, damit „die URL-Persistenz zu einem normalen <param-bindings> -Anliegen außerhalb der Kachel-Infrastruktur wird“. Diese Anforderung ist jedoch nicht umgesetzt: Ein `TileFrame` besteht aus einer Ansichtsreferenz, einer Beschriftung sowie einem Snapshot der gebundenen Kanalwerte (typischerweise Modellobjekte), während ein Routenparameter lediglich einen einzelnen Text enthält. ReactTileStackControl ist ebenfalls kein RoutingParticipant. Der Drilldown-Zustand der Kachel-Demo (ein Konto auswählen, dessen Detailrahmen öffnen) bleibt daher weder nach einem Neuladen noch beim Klicken auf die Zurück-Schaltfläche erhalten.

Der Stack ist zudem nur über einen Java-ViewCommand erreichbar: <navigate-push>, <navigate-pop> und <navigate-pop-to> sind ViewCommands, die ihre eigene Beschriftung, ihr eigenes Bild, ihre eigene Platzierung und ihre eigene Ausführbarkeit mitbringen, sodass keiner von ihnen ein Glied in der Aktionskette eines `<generic-command>` sein kann, bei der das Ergebnis jeder ViewAction in die nächste einfließt (<execute-script>, <with-transaction>, <write-channel>, <open-dialog>). Eine Schaltfläche, die ein Objekt löscht und anschließend den Frame verlässt, in dem es angezeigt wurde, lässt sich daher nicht realisieren; aus diesem Grund befindet sich die Löschschaltfläche der Objektlisten-Demo in der Liste statt auf der Detailseite. Der Stack selbst benötigt keinen Namen – ein Frame erreicht ihn automatisch über den ` TileStackScope` in seinem `ViewContext` –, aber es gibt auch keinen deklarativen Zugriff auf den Pfad, sodass ein Befehl nicht von der Tiefe abhängen kann, in der er ausgeführt wird (beispielsweise eine Zurück-Schaltfläche, die sich im Start-Frame selbst deaktiviert).

3. Abfragebindungen existieren zur Laufzeit nicht

QueryBindingConfig und ViewElement.Config.getQueryBindings() sind zwar deklariert, aber die Eigenschaft wird nie gelesen: Es wird kein Teilnehmer erstellt, und es wird niemals eine Abfragezeichenfolge geschrieben oder geparst. Der Filterstatus (der dokumentierte Anwendungsfall: ?type=...&rooms=..., geschrieben mit `replaceState`, damit die Filtereingaben den Verlauf nicht überfluten) kann überhaupt nicht gebunden werden.

4. Die Funktion war undokumentiert und ungenutzt

<param-bindings> wurde von keiner Ansicht in der Engine oder in den Demo-Anwendungen verwendet, sodass der Codepfad außerhalb der Unit-Tests des RouteManagers nicht durchlaufen wurde. Weder die Routenbindung noch der Kachelstapel tauchten in docs/faq/react-view-layer.md auf; der Kachelstapel wurde lediglich in seiner „package-info“ und in einem Entwurfsplan beschrieben, weshalb er leicht übersehen werden kann, obwohl <tile-stack>, <tile-breadcrumb> und <navigate-push> @InApp sind und somit im Konfigurationseditor angeboten werden.

5. Fehler in der Routing-Laufzeitumgebung

Festgestellt bei der Objektlisten-Demo von com.top_logic.demo.react, die das ausgewählte Ticket an einen Routenparameter bindet:

  • Segmente eines nicht angezeigten Teilbaums gelangten in die URL. Nachdem ein Deep-Link die Seitenleiste auf die Objektliste umgeschaltet hatte, lautete die Adresse „tickets/deeplink-demo/table“: „table“ ist das Tab-Segment der Attributansicht, also das zuvor aktive Element der Seitenleiste. Das Drücken der Zurück-Taste erzeugte daraufhin „table/tickets/deeplink-demo“ und „table/tickets“ – dasselbe Segment an unterschiedlicher Position. RouteManager.currentUrl() verkettete die Segmente in der Reihenfolge ihrer Registrierung, und Teilnehmer registrieren sich, wenn ihr Steuerelement angehängt wird, was bei einem Tab verzögert zum Zeitpunkt des Renderns geschieht (ReactTabBarControl.onBeforeWrite()). Die Reihenfolge der Registrierung folgte weder der Anzeigehierarchie noch wurde das verworfen, was die Anzeige verlassen hatte.
  • Eine durch den Verlauf ausgelöste Routenänderung fügte einen Verlaufseintrag hinzu. Beim Zurückblättern wurde ein „RouteChangeEvent“ mit „replace = false“ ausgelöst, während der Browser bereits navigierte; dies fügt einen Eintrag an, anstatt einen zu verbrauchen, und führt dazu, dass wiederholtes Drücken der Zurück-Taste nicht monoton verläuft.
  • Eine URL wurde nur von einer Anzeige übernommen, die noch nicht existierte. Eine ausstehende URL wird von Teilnehmern bei ihrer Registrierung verarbeitet – genau das geschieht, wenn eine Anzeige zum ersten Mal aufgebaut wird. Eine neu geladene Seite wird in den Steuerungsbaum gerendert, den das Fenster bereits enthält, dessen Teilnehmer registriert sind, bevor die zu übernehmende URL bekannt ist – daher ließ ein Deep Link in einen bestehenden Browser-Tab die Anzeige unverändert, und die Adressleiste behielt entweder eine URL bei, die nichts anzeigte, oder wurde mit dem Zustand überschrieben, den der Tab noch anzeigte. Ein Klick auf ein Element in der Seitenleiste fügte dessen Segment an einen solchen veralteten Pfad an, was zu /view/tickets/tickets führte.
  • Eine ohne Route geladene Seite ließ die Adressleiste unvollständig. Die zusammengesetzte URL wurde zurückgehalten, da sich der Manager daran erinnerte, sie an den Client der vorherigen Seite gesendet zu haben, die die frisch geladene Seite jedoch noch nie gesehen hatte.
  • Ein Routenparameter behielt ein Segment bei, das zu nichts führte. Der Teilnehmer meldete den konsumierten Text als sein Segment, selbst wenn die Bindung ihn zu keinem Objekt auflöste, sodass eine URL, die ein gelöschtes oder unbekanntes Objekt benannte, in der Adressleiste neben einer Ansicht verblieb, die kein solches Objekt anzeigte.
  • Eine Navigation innerhalb der App erzeugte keinen Verlaufseintrag. Der Austausch der Anzeige ist die Art und Weise, wie eine Navigation durchgeführt wird, und die Teilnehmer, die auf dem Weg verschwanden und wieder auftauchten, meldeten ihre eigenen Korrekturen der Adressleiste. Eine solche Korrektur traf ein, bevor die Navigation sich selbst melden konnte, sodass die Adressleiste bereits das Ziel anzeigte – und der Nutzer keinen Eintrag hatte, zu dem er zurückkehren konnte. Das Umschalten des Seitenleistenelements in eine Ansicht mit Registerkarten zerstörte sogar den Eintrag der zurückgelassenen Ansicht.
  • Eine verzögerte Auswahl erreichte die Hervorhebung, aber nicht die Anzeige. Die Auswahl eines Seitenleistenelements oder einer Registerkarte, bevor irgendetwas gerendert wurde, aktualisierte den Status, der die Auswahl benannte, ließ jedoch den Inhalt des vorherigen Elements an Ort und Stelle.
  • Eine URL, zu der der Browser navigierte, wurde ohne Sitzungskontext übernommen. Der Befehl „navigateToRoute“ umging die Subsession- und Aktualisierungsphase, die jeder andere Befehl durchläuft, sodass ein an einen Routenparameter gebundener Kanal das durch die URL benannte Objekt nicht nachschlagen konnte: Durch Drücken der Zurück-Taste auf /view/tickets/<id> blieb die Liste ohne Auswahl, und die Adressleiste wurde auf den Zustand korrigiert, der noch angezeigt wurde.
  • Eine URL, deren Bezeichnung weniger umfasste als die Anzeige, ließ die Anzeige unverändert. Eine URL, die in eine Sitzung übernommen wurde, die bereits einen Drilldown enthielt – die reine Ansichts-URL, die eingegeben wurde, während ein Frame geöffnet war, oder ein Deep-Link mit einer Kennung, die kein Objekt enthält –, behielt den Frame bei und schrieb die Adressleiste entsprechend um: Nichts wies den Teilnehmer darauf hin, dass die URL keine Route für ihn benannte. Eine durch ein „Dirty-Form“-Veto abgelehnte URL beendete ihre Übernahme ebenfalls nie, sodass die nächste Navigation des Benutzers als Ersatz statt als Verlaufseintrag gemeldet wurde.
  • Ein Wert, der in einen Kanal geschrieben wurde, bevor dessen Tabelle angehängt wurde, wurde ignoriert. RowSourceObserver (hinter <table>, <object-list>, <calendar>) wertete die Zeilen einmalig bei der Erstellung aus und begann erst dann, seine Eingabekanäle abzuhören, wenn sein Steuerelement angehängt war, ohne erneut zu lesen. Ein Kanal, in den ein URL-Parameter beim Anfügen der Root schreibt – was dem Anfügen der darunterliegenden Tabelle vorausgeht –, erreichte daher den Filtereingang, aber nicht die Zeilen, bis der Benutzer den Filter bearbeitete. Dieselbe Lücke verschluckte jede Änderung, die vorgenommen wurde, während eine Anzeige abgetrennt war.
  • Die beiden Stapel der Multi-Tab-Kachel-Demo teilten sich einen Pfad. Der Inhalt eines Tabs nutzt die Kanäle der umgebenden Ansicht, und die verschachtelten `<view>`-Elemente beider Tabs deklarierten `navPath`, sodass der zweite den Kanal des ersten übernahm: Ein Drilldown in einem Tab führte zu einem Drilldown in beiden.

Lösung

  • `objectId ` und `objectResolve ` (ObjectFunctions, @ScriptPrefix("object")): die Kennung eines Objekts als Text für eine URL und das Objekt eines Typs mit einer bestimmten Kennung. Nichts für ein temporäres Objekt und nichts für eine Kennung, die kein Objekt des Typs trägt – ein gelöschtes Objekt, ein falsch eingegebener Link –, sodass ein unbrauchbarer Link kein Segment hinterlässt.
  • Routenparameter, die ein Modellobjekt transportieren, über einen bidirektionalen abgeleiteten Kanal über diese beiden Funktionen.
  • Eine URL, die aus dem Steuerbaum anstelle der Registrierungssequenz zusammengesetzt wird, ohne Beiträge von Teilnehmern, die die Anzeige verlassen haben.
  • Ein Ersetzungsflag, das der Ursache einer Änderung folgt: Die Übernahme einer URL, die der Client bereits anzeigt, meldet keinen Verlaufseintrag, eine In-App-Navigation meldet genau einen, und eine Anzeigeänderung, die eine Navigation auslöst, wird als eine einzige Navigation und nicht als eine Reihe von Korrekturen behandelt. Eine Übernahme endet immer – mit `finishAdoption()`, wenn die URL übernommen wurde, oder mit `cancelAdoption()`, wenn sie durch ein Veto abgelehnt wurde – und nur ihr Ende wird in der Adressleiste gemeldet; daher melden Teilnehmer, die die Anzeige unterwegs verlassen und wieder betreten, nichts (ViewServlet, ReactServlet, AgentServlet).
  • Eine vom Display übernommene URL, die bereits existiert – nicht nur eine, die gerade erstellt wird –, unterliegt demselben Kontext wie jeder andere Befehl. Ein Segment, das die Anzeige nicht reproduzieren kann, wird verworfen und in der Adressleiste korrigiert, und ein Teilnehmer, der eine Route anzeigt, in der die URL weder benannt noch eingebracht wurde, wird aufgefordert, resetRoute() auszuführen – auf diese Weise kehrt die reine URL einer Ansicht zu ihrem ursprünglichen Rahmen zurück.
  • Eine URL, bei der ein Routenparameter nicht angegeben ist, behält den von der Ansicht festgelegten Wert bei – das Element, das eine Tabelle standardmäßig auswählt, oder die Auswahl, die die Sitzung enthält – und die Adressleiste wird damit vervollständigt.
  • Routenparameterwerte sind prozentkodierte Pfadsegmente (RFC 3986, RouteEncoding, das von ` RoutePattern.produce ` angewendet und von ` RoutePattern.match` rückgängig gemacht wird), sodass ein Wert, der einen Schrägstrich, ein Leerzeichen oder ein Prozentzeichen enthält, das eine Segment bleibt, das er ausfüllt; die Server übernehmen eine URL in der Form, in der der Browser sie sendet (ViewServlet liest die Route aus der rohen Anfrage-URI). Ein kodierter Schrägstrich benötigt einen Container, der mehrdeutige Pfade akzeptiert: Das eingebettete Jetty von tl-ide-jetty erlaubt AMBIGUOUS_PATH_SEPARATOR und dekodiert mehrdeutige URIs; ein Produktionscontainer benötigt die entsprechende Einstellung (dokumentiert in docs/faq/react-view-layer.md; Objektbezeichner enthalten niemals einen Schrägstrich, daher betrifft dies nur Geschäftsschlüssel). Ein statisches Präfix in „ParamBindingConfig“ adressiert einen Parameter als „ticket/:ticket“ statt positionsabhängig.
  • Der Drilldown-Pfad eines <tile-stack> in der URL: Der Stack deklariert seine Frames als <frame view="..." route="person/:person"> mit einer <param name expr reverse> -Konvertierung pro Parameter (Objekt zu Text, Text zu Objekt) und einem <label> -Provider, der den Frame benennt. Ein „TileFrameRouteParticipant“ pro eingebundenem Frame setzt die Routen jedes Frames auf dem Pfad zusammen und übernimmt die URL Frame für Frame (RoutingParticipant.acceptsRouteSequence), sodass ein Neuladen den Drilldown wiederherstellt und das Vor- und Zurücknavigieren ermöglicht. Ein Parameter, der zu nichts aufgelöst wird, beendet den Pfad, und ein Frame, der ohne Bezeichnung auf den Stack geschoben wird, übernimmt die Bezeichnung, die der Stack für seine Ansicht festlegt.
  • <navigate-pop> und <navigate-pop-to> als ViewActions (`NavigatePopAction, NavigatePopToAction), einsetzbar in der Kette eines <generic-command> neben <execute-script>, <with-transaction> und <write-channel>, sodass ein Befehl seine Arbeit abschließen und anschließend den Frame verlassen kann, in dem er ausgeführt wurde. Die gleichnamigen Befehle delegieren an die Aktionen; ` TileStackScope.lookup ` ist die einzige Bereichsauflösung, die alle verwenden.
  • „bind-path-to“ auf <tile-stack> benennt den Kanal, über den jeder Frame den Pfad sieht, sodass ein abgeleiteter Kanal die Tiefe angibt und eine <visible-if> -Regel eine Zurück-Schaltfläche im Start-Frame ausblendet.
  • Eine Laufzeitumgebung für <query-bindings>: ein „QueryBindingParticipant“ pro Bindung, wobei die Abfragezeichenfolge aus einer übernommenen URL herausgelöst und jedem Teilnehmer angeboten wird (RoutingParticipant.activateQuery), und die Abfrageparameter aus den angezeigten Teilnehmern zusammengesetzt werden. Eine Änderung der Abfrage allein wird mit `replaceState` geschrieben, eine Änderung des Pfads mit `pushState`. `RowSourceObserver` liest seine Elemente neu ein, wenn er mit der Beobachtung beginnt, sodass ein Wert angezeigt wird, den eine URL vor dem Anhängen der Tabelle geschrieben hat.
  • <text-input value="channel"> (TextInputElement): Ein Eingabefeld, das den Textwert eines Kanals in beide Richtungen schreibt und aus dem vorhandenen Text-Input-Steuerelement und dem Feldmodell zusammengesetzt ist – das Gegenstück zu einem <field> für einen Wert, der eher zur Ansicht als zu einem Modellobjekt gehört, wie beispielsweise ein Filterbegriff.
  • Dokumentation zum URL-Routing und zum Drilldown im Kachelstapel in docs/faq/react-view-layer.md. Die Demos von com.top_logic.demo.react: Die Objektliste enthält das ausgewählte Ticket (/view/tickets/ticket/<id>) und den Filterbegriff (?q=) in der Adressleiste; die Kachel-Demo enthält ihren Drilldown (/view/tiles-demo/person/<id>) und zeigt einen tiefensicheren „Zurück“-Befehl an; die Multi-Tab-Kachel-Demo hält ihre beiden Stapel auf eigenen Kanälen.
  • Get Started
  • Github
  • Discord
  • Das Unternehmen hinter TopLogic
  • Softwareentwicklung heute
  • Kontakt

© Copyright – Business Operation Systems GmbH

  • top-logic.com
  • Nutzungsbedingungen
  • Impressum
  • Rechtlicher Hinweis
  • Datenschutz
  • EN
  • Login