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

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

#29643

TL Views: Anpassung der React-Oberfläche an das Corporate Design eines Kunden mit eigener React-Komponentenbibliothek (Leitfaden und fehlende Erweiterungspunkte)

ReactUI

Kontext

Die React-Oberfläche (com.top_logic.layout.view, .view.xml) setzt Anwendungen deklarativ aus UIElement`s zusammen. Jedes Element erzeugt ein `ReactControl, das Zustand serverseitig hält, an das Modell bindet und ihn per SSE mit einer React-Komponente des Clients synchronisiert.

Ein Kunde bringt häufig eine eigene React-Komponentenbibliothek mit, die sein Corporate Design samt Stylesheets festlegt. Diese Bibliothek kennt TopLogic nicht: Sie synchronisiert keinen Zustand und bindet keine Daten. Das Ticket beschreibt, wie eine solche Bibliothek angebunden wird, damit Anwendungsoberflächen dem Corporate Design des Kunden entsprechen. Zusätzlich schließt es die Lücken in der Engine, die dem heute noch entgegenstehen. Der Beschreibungstext ist als dauerhafter Leitfaden gedacht.

Leitfaden

Grundsatz

Die Kundenbibliothek wird als zusätzliche Darstellungsschicht unterhalb des bestehenden Komponentenvertrags angebunden, nicht als zweiter Baukasten neben ihm. .view.xml, `UIElement`s, Controls, Datenbindung und Zustandssynchronisation bleiben unverändert. Ersetzt wird pro Komponentenname die React-Komponente, die den Zustand eines Controls darstellt. Außerdem werden die Design-Tokens des Kunden auf ein TL-Theme abgebildet. Das Corporate Design ist damit eine Frage der Auslieferung: Dieselben Views erscheinen in der Gestaltung des Kunden.

Die Nahtstelle ist bereits vorhanden: Server und Client verbindet ausschließlich der Komponentenname (drittes Konstruktorargument von ReactControl, z.B. "TLButton") zusammen mit den Zustandsschlüsseln, die das Control per putState veröffentlicht und die die Komponente über useTLState() liest. Gesten meldet die Komponente über useTLCommand() zurück.

Stufe 1: Theme aus den Design-Tokens des Kunden (immer)

Die Tokens des Kunden (Markenfarben, Schriften, Radien, Schatten) werden in einem eigenen Theme abgebildet (<theme name="acme" extends="default"> in einer Konfiguration des UIThemeService, vgl. tl-react-theme.config.xml und docs/faq/react-theme-tokens.md). Wo möglich, verweisen die CSS-Variablen des Kunden und die TL-Tokens auf dieselbe Quelle. Diese Stufe deckt bereits einen großen Teil des Erscheinungsbildes ab, gerade bei den komplexen Komponenten, die nicht ersetzt werden (Tabellen, Bäume, Flussdiagramme, Layout-Panels).

Stufe 2: Adapterkomponenten für Blatt-Widgets

Für jede TL-Komponente, zu der die Kundenbibliothek ein Gegenstück hat (Button, Text-/Zahl-/Datumseingabe, Auswahl, Checkbox/Schalter, Reiter, Dialog-/Fensterrahmen, Menüs, Snackbar), entsteht in einem Kundenmodul ein schlanker Adapter. Er bildet den TL-Zustand auf die Props der Bibliothek ab und die Callbacks der Bibliothek auf TL-Kommandos:

{{{#!js import { React, useTLState, useTLCommand, rootClassName, replace } from 'tl-react-bridge'; import type { ButtonState } from 'tl-react-bridge'; import { Button } from '@acme/ui';

const AcmeButton = ({ controlId }) => {

const s = useTLState<ButtonState>();
const send = useTLCommand();
return <Button id={controlId} className={rootClassName(s)}
disabled={s.disabled}
onClick={() => send('click')}>{s.label}</Button>;

};

replace('TLButton', AcmeButton); }}}

Das Bundle des Kundenmoduls wird über ClientResources als module-script mit requires="tl-react-bridge" angemeldet; das Stylesheet der Bibliothek als stylesheet (Aufbau des Moduls: docs/faq/new-react-module.md, docs/faq/new-ui-element.md, Abschnitt 3). Die Bibliothek muss dafür nichts über TopLogic wissen.

Stufe 3: Neue UIElements nur für Widgets ohne TL-Gegenstück

Hat der Kunde ein Widget, für das es in TL keine Entsprechung gibt (z.B. ein eigener Stepper, eine KPI-Kachel), entsteht ein UIElement + ReactControl + Adapterkomponente nach docs/faq/new-ui-element.md. Das Element wird generisch und über Konfiguration parametrisiert gebaut, nicht für eine einzelne Ansicht.

Was vermieden wird

  • Kein paralleler Elementsatz (<acme-button>, <acme-field>, …): Er verdoppelt die Bindungs- und Synchronisationslogik, macht Views unportabel und zwingt dazu, jede Korrektur in TL doppelt nachzuziehen. Die View beschreibt, was angezeigt wird; das Kundenmodul entscheidet, wie es aussieht.
  • Die komplexen Kompositionen bleiben die von TL: TableViewControl, der Fill-/Layout-Vertrag, Fenstermanager, Drag & Drop und Tastatur-Scopes werden über Tokens und css-class gestaltet und nicht auf ein Fremd-Grid umgebaut. Letzteres wäre ein eigenes Projekt.

Voraussetzungen an die Kundenbibliothek

  • Eine React-Instanz. Die Bibliothek wird gegen das React aus tl-react-bridge gebündelt: Die Aliase auf die Shims für react, react-dom und react/jsx-runtime stehen in vite.config.ts, wie in com.top_logic.layout.react.wysiwyg bzw. …chartjs, und tl-react-bridge ist external. Die React-Peer-Version der Bibliothek muss zur Version der Bridge passen.
  • Nur kontrollierte Komponenten. Der Zustand gehört dem Server. Komponenten, die intern eigenen Zustand halten (unkontrollierte Eingaben, selbstverwaltetes Offen/Ausgewählt), werden im kontrollierten Modus (value + onChange) verwendet, sonst weicht ihr Zustand vom Server ab.
  • Globales CSS. Resets und generische Klassennamen des Kunden können mit den TL-Stylesheets kollidieren. Die Stylesheets werden über ClientResources geladen und frühzeitig auf Seiteneffekte geprüft.
  • Portale, Fokus, Außenklick. Dialoge und Popover der Bibliothek, die in document.body portalen, müssen mit TL-Fokusfalle (focus-trap), Außenklick-Behandlung (outside-press) und Fenstermanager zusammenspielen. Hier sind die meisten Integrationsfehler zu erwarten.

Fehlende Erweiterungspunkte (unter diesem Ticket umzusetzen)

1. Kontext-Provider für Bibliotheken

Jedes Control wird als eigene React-Wurzel eingehängt (createRoot in tl-react-bridge.ts) und nur in TLControlContext.Provider eingebettet. Bibliotheken, die einen ThemeProvider, einen Intl-Provider oder einen CSS-in-JS-Cache benötigen, haben keinen Ort, ihn einzubringen. Benötigt wird ein registrierbarer Wurzel-Wrapper in der Bridge, den ein Kundenbundle anmeldet und der jede eingehängte Control-Wurzel umschließt.

2. Ausdrücklicher Ersetzungsmechanismus

Die Ersetzung einer Komponente funktioniert heute nur, weil registry.ts eine einfache Map ist (die letzte Registrierung gewinnt) und die Skripte in einer bestimmten Reihenfolge geladen werden. Das ist fragil und nicht sichtbar. Benötigt wird eine deklarierte Zuordnung (z.B. ein Komponentensatz in ClientResources: TLButton → AcmeButton) oder ein register, das eine stille Ersetzung meldet, sofern sie nicht ausdrücklich als Ersetzung gekennzeichnet ist.

3. Veröffentlichter Zustandsvertrag der ersetzbaren Komponenten

Die Zustandsschlüssel einer Komponente sind heute String-Konstanten, die über die putState-Aufrufe der Java-Controls verteilt sind. Ein Adapter-Autor braucht sie dokumentiert und stabil: ein typisiertes Zustandsinterface je ersetzbarer Komponente (idealerweise gemeinsam für Java und TypeScript definiert oder generiert) sowie eine Liste der Komponenten, die als ersetzbar vorgesehen sind.

Lösung

Der Leitfaden steht zusammen mit der umgesetzten API als FAQ in docs/faq/customer-component-library.md (verlinkt aus CLAUDE.md).

1. Wurzel-Wrapper

tl-react-bridge bietet registerRootWrapper(wrapper, { order? }) (bridge/root-wrapper.ts). Alle React-Wurzeln der Bridge – die per mount() eingehängten Controls und der Tooltip-Host – rendern ihren Inhalt innerhalb aller registrierten Wrapper; der Wrapper mit der kleinsten order liegt außen, bei gleicher order gilt die Registrierungsreihenfolge. Verschachtelte Controls werden über TLChild im Baum ihres Elternteils gerendert, Portale erben den Kontext ihres Baums; beide sind damit automatisch umschlossen. Ein nach dem Einhängen registrierter Wrapper wirkt sofort: die eingehängten Wurzeln rendern neu, ihr Teilbaum wird dabei neu aufgebaut (lokaler React-Zustand geht verloren, Serverzustand bleibt). Bibliotheken registrieren ihre Wrapper daher beim Laden ihres Skripts.

2. Ausdrückliche Ersetzung

registry.ts bietet replace(name, component). Eine Ersetzung gewinnt unabhängig von der Ladereihenfolge immer gegen register. Ein zweites register für einen belegten Namen und eine zweite Ersetzung desselben Namens werden als Konsolenwarnung gemeldet. Ein eingehängtes Control sucht seine Komponente beim Einhängen, ein verschachteltes bei jedem Rendern; die Kompositionen von TL beziehen ihre Blatt-Komponenten über die Registry, eine Ersetzung wirkt daher auch in Toolbars, Dialogen usw. Ausnahme: Schaltflächen, die eine Komponente selbst zeichnet (z.B. Hilfe/Schließen in der Titelleiste von TLWindow), folgen der Ersetzung von TLWindow, nicht der von TLButton.

3. Zustandsvertrag über msgbuf

Der Zustand aller ersetzbaren Komponenten ist in com.top_logic.layout.react/src/main/java/com/top_logic/layout/react/state/state.proto beschrieben; die Felddokumentation ist der veröffentlichte Vertrag, der Dateikopf listet die Zuordnung Komponentenname → Nachricht:

TLButton (ButtonState), TLToggleButton (ToggleButtonState), TLCheckbox (CheckboxState), TLTextInput (TextInputState), TLPasswordInput (PasswordInputState), TLNumberInput (NumberInputState), TLDatePicker (DatePickerState), TLSelect (SelectState), TLDropdownSelect/`TLOptionChips`/`TLSegmentedChoice` (DropdownSelectState), TLTabBar (TabBarState), TLWindow (WindowState), TLDialog (DialogState), TLMenu (MenuState), TLSnackbar (SnackbarState). Gemeinsame Basen: ControlState, FieldState, TypingFieldState; Kind-Controls im Zustand: ChildControl.

  • Java: Die Controls verwenden die generierten Eigenschaftskonstanten (ButtonState.LABEL__PROP) in putState; die privaten Schlüsselkonstanten entfallen. Die Zustandsverwaltung von ReactControl (Map + Patches) und das übertragene JSON bleiben unverändert. ReactMenuControl.MenuEntry verwendet für den Eintragstyp das Enum MenuState.EntryType; die öffentlichen Zustandsschlüssel-Konstanten von ReactNumberInputControl (INPUT_MODE*), ReactWindowControl, ReactDialogControl und ReactSnackbarControl sind durch die generierten Konstanten ersetzt.
  • TypeScript: msgbuf erzeugt aus derselben Datei reine Typdefinitionen (react-src/state/control-state.ts, per option TypeScript); Enums werden zu String-Unions mit den externen Namen (@Name). Die Typen werden aus tl-react-bridge exportiert, useTLState<T>() liefert den Zustand typisiert (useTLState<ButtonState>()).
  • Absicherung: TestControlStateSchema prüft für jede ersetzbare Komponente, dass jeder Schlüssel im gesendeten Zustand deklariert ist, und dass die externen Namen der Java-Enums mit den Schema-Enums übereinstimmen.
  • Grenze: Der Wert eines Feldes (FieldState.value) bleibt json; seine Form ist je Nachricht dokumentiert (msgbuf kann ein geerbtes Feld nicht verengen). Felder senden kein disabled, sondern editable.

Voraussetzung ist msgbuf mit TypeScript-Ziel (msgbuf.version 1.2.3).

Beispielmodul

com.top_logic.demo.react.corporate ist eine lauffähige Referenz: eine Stellvertreter-Bibliothek ohne TL-Bezug (BrandProvider, BrandButton, BrandCheckbox) und Adapter, die per registerRootWrapper den Provider und per replace die Komponenten TLButton und TLCheckbox einbringen. In tl-demo-react wird es über das Maven-Profil corporate-example zugeschaltet (Build und Start mit dem Profil, z.B. MAVEN_ARGS=-Pcorporate-example); ohne Profil bleibt die Demo unverändert.

  • 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