critical
#29108
Lightweight UI definition layer (TL Views) based on React UI-Components
Problem
Das derzeitige LayoutComponent-System vereint Layout, Modellbindung, Datenfluss, Sicherheit, Befehle, Lebenszyklus und Darstellung in einer einzigen schwerfälligen Abstraktion. Jedes konfigurierbare UI-Element muss eine vollständige LayoutComponent sein, selbst wenn es nur eine dieser Funktionen benötigt. Das Layout ist auf horizontale und vertikale Trennleisten beschränkt.
Dies macht das System unflexibel, schwer zu kombinieren und für einfache UI-Definitionen unnötig schwerfällig.
Lösung: TL-Ansichten
Einführung einer neuen, auf UIElement basierenden Ansicht-Definitionsschicht auf der bestehenden Control- Infrastruktur. Das Designprinzip ist „progressive Capability“: Das Basiselement verursacht nahezu keine Kosten, und Funktionen (Modellbindung, Kanäle, Sicherheit, Befehle) werden deklarativ erst bei Bedarf hinzugefügt.
UIElement (Basis – rendert lediglich) + model-builder → fügt Modellbindung hinzu (opt-in) + channel(...) → fügt reaktiven Datenfluss hinzu (optional) + secure(...) → fügt Zugriffskontrolle hinzu (optional) + commands(...) → fügt Aktionsverarbeitung hinzu (optional)
Ansichten werden über den Dateipfad identifiziert (customers/masterDetail.view.xml), wodurch Namenskonflikte vermieden werden. Der Datenfluss nutzt ein einheitliches Kanal-Konzept sowohl für die Kommunikation innerhalb einer Ansicht als auch zwischen verschiedenen Ansichten. Befehle sind auf Panels beschränkt, die über eine platzierungsbasierte Darstellung sowie ein Clique-System zur Anordnung und Gruppierung verfügen.
Eine „ViewHostComponent“-Brücke und ein <legacy-component> -Adapter gewährleisten die Koexistenz mit dem bestehenden „LayoutComponent“-System während der schrittweisen Migration.
Migration
Die Ansichtsebene selbst ist additiv, doch einige dafür vorgenommene Änderungen an der Engine wirken sich auf bestehende Anwendungen aus:
- Pfad zum Font-Awesome-Stylesheet. Das Stylesheet wurde von /style/fontawesome/css/all.css (all.min.css) nach /style/fontawesome.css (fontawesome.min.css) verschoben; das Kern-Theme listet den neuen Pfad auf. Anwendungsthemen, die das Kern-Theme nicht erweitern und das Stylesheet selbst auflisten, sowie JSPs, die auf den alten Pfad verweisen, müssen aktualisiert werden. Die Namen der Icon-Klassen bleiben unverändert.
- com.top_logic.basic.graph.ExplicitGraph wurde nach com.top_logic.basic.shared.graph.ExplicitGraph verschoben (Modul tl-basic-shared, eine Abhängigkeit von tl-basic): Ändern Sie den Import.
- Die Klassen „TechnicalNamesLabelProvider“, „DefaultNodePortCoordinateAssigner“, „DefaultNodeSizer“, „JSONDefaultLayoutGraphExporter“, „DiagramTextRenderingConstants“ und „DiagramTextRenderingUtil“ behalten ihr Paket „com.top_logic.graph.layouter“ bei… werden jedoch vom Modul „tl-graph-layouter“ in das Modul „tl-graph-diagramjs-server“ verschoben. Eine Anwendung, die über eine direkte Abhängigkeit von „tl-graph-layouter“ auf diese Klassen zugreift, muss lediglich „tl-graph-diagramjs-server“ hinzufügen.
- ModeSelector.traceDependencies(...) und ConstraintCheck.traceDependencies(...) nehmen als letzten Parameter ein „OverlayLookup“ anstelle eines „FormContext“ entgegen (ein „AttributeUpdateContainer“ ist ein „OverlayLookup“); ebenso ScriptTracer.execute(...).
- OrientationAware.Orientation ist „ExternallyNamed“: Konfigurationseigenschaften dieses Typs werden als „horizontal“ / „vertical“ geschrieben und gelesen; XML mit „HORIZONTAL“ / „VERTICAL“ wird nicht mehr geparst.
- ExternalAuthenticationServlet verwendet keine bestehende anonyme Sitzung mehr, sondern nur noch eine authentifizierte.