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

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

#29532

Objektnavigation in TL Views: Anzeigeziele, ein „reveal“-Protokoll für Container und eine „show-object“-Aktion

ReactUI

Problem

In der klassischen Benutzeroberfläche wird ein Link zu einem Geschäftsobjekt auf dem Server aufgelöst: GotoHandler empfängt das Objekt, sucht nach der Komponente, die Objekte dieses Typs anzeigt (mit WithGotoConfiguration.getGotoTargets(), einer Zuordnung von TLType zu ComponentName mit einem globalen Standardwert), und „LayoutComponent.makeVisible()“ durchläuft den Komponentenbaum, sodass jeder übergeordnete Knoten – Registerkarte, Dialogfeld, Layout – das untergeordnete Element auf dem Weg zu dieser Komponente anzeigt. Objektverknüpfungen innerhalb von strukturiertem Text sind tlObject-Anker, die von TLObjectLinkUtil geschrieben werden; ein Klick führt den Steuerbefehl „OpenTLObjectLink“ aus, der das Objekt serverseitig auflöst und entweder dorthin navigiert oder es in einem Dialogfeld öffnet. Es ist nirgendwo eine clientseitige URL beteiligt.

Die Ansichtsebene (com.top_logic.layout.view) hat kein Gegenstück:

  • Keine Anzeigeziele. Nichts legt fest, welche Ansicht ein Objekt eines bestimmten Typs anzeigt. Ein <form input="ticket">, ein <table selection="…"> oder ein <tile-stack> -Frame ist mit allen Anzeigeobjekten über „bind-input-to“ verknüpft, doch die Zuordnung „Objekte vom Typ T werden hier auf Kanal C angezeigt“ existiert nur implizit in TL-Script-Ausdrücken.
  • Kein Reveal-Protokoll. Es gibt keine Operation, die ein bestimmtes Element sichtbar macht, indem sie jeden Container auf dem Weg von der Wurzel auffordert, das richtige untergeordnete Element anzuzeigen – das Äquivalent zu makeVisible(). Jeder Container verfügt über einen eigenen Statuskanal (das aktive Element der Seitenleiste, die aktive Registerkarte der Registerkartenleiste, der Pfad des Kachelstapels, der Dialogstapel), aber keiner von ihnen stellt „dieses untergeordnete Element anzeigen“ bereit.
  • Keine Aktion zum Anzeigen von Objekten. Eine <generic-command> -Kette kann Kanäle beschreiben, Dialoge öffnen und Skripte ausführen, aber sie kann nicht anweisen: „Zeige dieses Objekt an, wo immer es angezeigt wird“. Die einzigen Navigationsaktionen sind <navigate-push>/`<navigate-pop>`, bei denen es sich um Befehle handelt (siehe #29530) und die voraussetzen, dass sich der Aufrufer bereits im richtigen Stapel befindet.
  • Die clientseitigen Hooks hängen in der Luft. ReactResourceCellControl sendet einen goto-Befehl, wenn eine verlinkte Zelle angeklickt wird, und bietet setGotoListener(GotoListener) mit handleGoto(ReactContext, Object) an, aber nichts in der Engine ruft setGotoListener auf, und der einzige Ersteller (MetaResourceControlProvider) übergibt useLink = false. Strukturierter Text (I18NHtml) wird in der React-Benutzeroberfläche angezeigt, ohne dass tlObject -Anker verarbeitet werden.

Die Folge für eine Anwendung wie den auf der Ansichtsebene aufgebauten Issue-Tracker: Ein Ticket-Verweis in einer Beschreibung, eine Zuweisungszelle in einer Tabelle oder ein „Blockiert durch“-Eintrag in einem Formular können nicht verfolgt werden. Jeder solche Link müsste pro Website manuell eingerichtet werden, wobei man das konkrete Seitenleistenelement und den Stapel kennen müsste, was sich nicht verallgemeinern lässt – eine Anwendung muss ja gar keine Seitenleiste haben.

Eine weitere Anforderung: Die Anzeige eines Objekts kann mehrere aufeinanderfolgende Auswahlen erfordern. Ein Ticket eines Meilensteins eines Projekts, das in drei Ebenen tief angezeigt wird, ist nur durch die Auswahl des Projekts, dann des Meilensteins und schließlich des Tickets erreichbar – in einem Kachelstapel sogar über drei Frames mit separaten Kanal-Namensräumen hinweg. Eine einzelne Deklaration vom Typ „Typ T auf Kanal C“ kann dies nicht ausdrücken, und eine Tabelle, die ihr eigenes Modell austauscht, wenn sie nach einer Auswahl gefragt wird, die sie nicht enthält (der klassische Ansatz), führt zu instabilen Auswahl-/Modellschleifen.

Lösung

Drei generische Komponenten in com.top_logic.layout.view.navigation, von denen keine speziell Seitenleisten, Registerkartenleisten oder Kachelstapel kennt.

Anzeigeziele: der `DisplayTargetService`

Anzeigeziele werden global in der Konfiguration eines Dienstes deklariert und entsprechen den klassischen „goto“-Zielen. Die Anwendung entscheidet, an welcher der Stellen, an denen ein Typ angezeigt wird, ein Objekt dieses Typs dargestellt werden soll; eine Ansichtsdatei bleibt wiederverwendbar und weiß nicht, dass sie ein Navigationsziel ist; ein Bibliotheksmodul stellt in seinem Konfigurationsfragment Ziele für seine eigenen Typen bereit.

Ein Ziel benennt einen Typ und eine geordnete Liste der anzuzeigenden Ansichten, jeweils mit den festzusetzenden Kanalwerten (aus der React-Demo):

{{{#!xml <config service-class="com.top_logic.layout.view.navigation.DisplayTargetService">

<instance>
<targets>
<target type="tl.demo.projectManagement:Ticket">
<show view="projects/overview.view.xml">
<bind channel="project" expr="t -> $t.container()"/>
</show>
<show view="projects/milestones.view.xml"
label-expr="t -> $t.container().get(tl.demo.projectManagement:ProjectScope#name)">
<bind channel="project" expr="t -> $t.container()"/>
</show>
<show view="projects/tickets.view.xml"
label-expr="t -> $t.get(tl.demo.projectManagement:Ticket#milestone).get(tl.demo.projectManagement:Milestone#name)">
<bind channel="milestone" expr="t -> $t.get(tl.demo.projectManagement:Ticket#milestone)"/>
</show>
<show view="projects/ticket-detail.view.xml" label-expr="t -> $t.get(tl.demo.projectManagement:Ticket#title)">
<bind channel="ticket"/>
</show>
</target>
<target type="tl.demo.projectManagement:Mitwirkender">
<show view="projects/contributor-dialog.view.xml" dialog="true">
<bind channel="contributor"/>
</show>
</target>
</targets>
</instance>

</config> }}}

Ein <show> -Eintrag wird auf eine von drei Arten ausgeführt, je nachdem, wie die Ansicht aufgerufen wird:

  • Die Ansicht wird an einer beliebigen Stelle in der Anwendung eingebunden (ein Seitenleistenelement, eine Registerkarte, ein <view-ref>, ein <adaptive-detail> -Fenster, die Startansicht eines <tile-stack>): Die Einbindung wird offengelegt (siehe unten) und die Bindungen werden in der deklarierten Reihenfolge in die Kanäle der Ansicht geschrieben.
  • Die Ansicht wird nicht eingebunden: Sie wird als Frame auf den Kachelstapel geschoben, der die zuvor angezeigte Ansicht enthält, wobei die Bindungen als gebundene Werte des Frames und label/`label-expr` als Breadcrumb-Bezeichnung dienen. Eine Kette solcher Einträge bildet einen Drilldown-Pfad nach; Frames, die sich bereits auf dem Stapel befinden und dieselbe Ansicht, dieselben Werte und dieselbe Bezeichnung aufweisen, werden beibehalten (Pop bis zum längsten übereinstimmenden Präfix, Push für den Rest), sodass ein Ziel, das einen Frame erreicht, in den der Benutzer manuell eingedrillt ist, diesen wiederverwendet.
  • dialog="true": Die Ansicht wird als Dialogfeld geöffnet, wobei die Bindungen als anfängliche Kanalwerte dienen (genau wie bei <open-dialog> ); dies muss der letzte Eintrag sein.

Ein <bind> -Ausdruck ist eine TL-Script-Funktion des angezeigten Objekts; standardmäßig ist dies das Objekt selbst. Der spezifischste Typ hat Vorrang (eine exakte Klasse hat Vorrang vor einer Verallgemeinerung); bei mehreren Zielen für einen Typ wird dasjenige bevorzugt, dessen erste Ansicht am nächsten an der Ansicht liegt, die die Navigation ausgelöst hat, dann dasjenige mit der Kennzeichnung default="true" und schließlich das zuerst deklarierte. hasTarget(type) gibt an, ob Objekte eines Typs überhaupt angezeigt werden können – dies entscheidet darüber, ob ein Wert als Link dargestellt wird. Beim Start überprüft der Dienst jeden <bind channel> anhand der Kanäle, die seine Ansicht deklariert, und protokolliert bei einer Nichtübereinstimmung einen Konfigurationsfehler.

Wo eine Ansicht eingebunden wird, wird durch einen statischen Scan der Ansichtskonfiguration bestimmt, die von der Stammansicht der Anwendung aus erreichbar ist: UIElement.getChildGroups() meldet den Inhalt eines Elements ohne Sitzung – indiziert nach Inhalt, den ein Container über einen Schlüssel adressiert (Sidebar-Element-ID, Registerkarten-ID, adaptives Detailfenster, Startansicht des Kachelstapels), andernfalls unindiziert und als eingebettete Ansicht für ein <view-ref> – und ViewMounts leitet daraus die Einbindepfade jeder Ansichtsdatei ab, die zusammen mit den Ansichtsdateien zwischengespeichert und ungültig gemacht werden. Seitenleistenelemente und Registerkarten erzeugen ihren Inhalt verzögert, weshalb diese Informationen nicht aus dem Steuerbaum stammen können.

Ein Reveal-Protokoll für Container

Jedes Steuerelement, das eines von mehreren untergeordneten Elementen anzeigt, implementiert ` ChildRevealer.revealChild(key)`: Die Seitenleiste aktiviert das Element, die Registerkartenleiste wählt die Registerkarte aus, <adaptive-detail> wechselt zu seinem Bereich, der Kachelstapel springt in den Rahmen, ein Dialog schließt die darüber liegenden Dialoge; <switch> benötigt nichts (es folgt seiner Eingabe). Container speichern ihre Position, wenn sie die Kontexte ihrer untergeordneten Elemente erstellen (ein „RevealPath“- Gültigkeitsbereich im „ViewContext“, analog zum Slot-Pfad), und ein „RevealRegistry“ pro Browserfenster ordnet eingebundene Ansichten und Container ihren Laufzeitinstanzen zu. Das Einblenden einer eingebundenen Ansicht durchläuft ihren Einbindungspfad von der Wurzel aus und fordert jeden Container auf dem Weg auf, das nächste untergeordnete Element einzublenden – wodurch Inhalt erstellt wird, der verzögert generiert wird – und schreibt dann die Bindungen in die am Ende gefundene Ansichtsinstanz. Dies entspricht makeVisible() für Ansichtselemente. Ungespeicherte Änderungen verhindern das Anzeigen genau so, wie sie das Schreiben in einen Kanal verhindern (Bestätigungsdialog, dann erneuter Versuch; ein Abbruch beendet die Befehlskette). Die Routing-Teilnehmer von #29530 sind dieselben Container, sodass die Adressleiste den angezeigten Zustand ohne zusätzlichen Aufwand widerspiegelt.

Eine `show-object`-Aktion und automatische Links

<show-object/> ist eine ViewAction, die in einer <generic-command> -Kette neben <execute-script>, <with-transaction> und <open-dialog> verwendet werden kann: Sie zeigt das von der Kette übergebene Objekt an und leitet es weiter; <generic-command input="selection"><show-object/></generic-command> ist die vollständige Konfiguration einer „Gehe zu“-Schaltfläche. Der Java-Code ruft `ObjectNavigation.show` auf. Steuerelemente von com.top_logic.layout.react erreichen denselben Vorgang über ReactContext.getObjectNavigator() (canShow, show), worauf die Ansichtsebene reagiert, sodass als schreibgeschützt angezeigte Objektwerte automatisch zu Links werden, sofern für ihren Typ ein Anzeigeziel vorhanden ist:

  • ReactResourceCellControl – Baumknoten (über MetaResourceControlProvider) und jede mit useLink erstellte Zelle; ein GotoListener hat, sofern gesetzt, weiterhin Vorrang.
  • Die schreibgeschützten Werte von „ReactDropdownSelectControl“, mit dem Referenzattribute in <table> -Zellen und in Feldern im Ansichtsmodus <form> angezeigt werden – so kann man einem Zuweisungsempfänger in einer Tabelle oder einem „Blockiert durch“-Eintrag in einem Formular folgen.
  • tlObject -Anker in strukturiertem Text, der vom React-WYSIWYG-Steuerelement schreibgeschützt angezeigt wird: Ein Klick wird an den Server gesendet (showObjectLink), das Objekt wird mit TLObjectLinkUtil wie beim klassischen OpenTLObjectLink aufgelöst und angezeigt; ein Link zu einem gelöschten Objekt oder zu einem Typ ohne Ziel wird dem Benutzer gemeldet.

Die TL-Script-Funktionen htmlObjectLink(object, label), htmlSource(content) und htmlText(source) (HtmlFunctions, com.top_logic.layout.wysiwyg) schreiben einen solchen Anker und lesen bzw. schreiben den HTML-Quelltext eines Strukturtext-Attributs, sodass ein Befehl eine Objektreferenz an einen Kommentar anhängen kann.

Befehle in der Symbolleiste des WYSIWYG-Editors und das Steuerelement, mit dem ein Feld bearbeitet wird

Zwei allgemeine Ergänzungen ermöglichen es einem Editor, eine Schaltfläche „Auf ein Objekt verweisen“ anzubieten, so wie es das klassische Editor-Plugin „CreateTLObjectLink“ tut, ohne dass der Editor etwas über Objekte wissen muss:

  • Ein Feld wählt sein Eingabesteuerelement in der Ansicht aus. <field attribute="content"><input-control class="…Provider" …/></field> (FieldElement.Config) benennt den ReactFieldControlProvider, der dieses Feld an der Stelle bearbeitet, an der es angezeigt wird, und überschreibt dabei die <input-control> -Annotation des Modells, die Auswahlregel und die Typzuordnung (FieldControlService.createFieldControl mit einem expliziten Provider). Ein Steuerelement, das zu einer bestimmten Stelle in der Benutzeroberfläche gehört – ein Editor, dessen Symbolleiste einen Dialog genau dieser Ansicht öffnet –, wird in der Ansicht konfiguriert, sodass das Modell weiterhin festlegt, was das Attribut ist, und die Ansicht, wie es dargestellt wird.
  • Die Symbolleiste des WYSIWYG-Editors enthält konfigurierte Ansichtsbefehle. WysiwygControlProvider akzeptiert <commands> – gewöhnliche ViewCommands mit Label, Icon, Ausführbarkeit, `input=, <open-dialog>, <execute-script> und so weiter – sowie ein optionales insert-channel="<name>". Die Befehle werden in einem untergeordneten `ViewContext` des Ansichtskontexts des Feldes ausgeführt: Sie erkennen die Kanäle der umgebenden Ansicht (das ausgewählte Ticket, das Projekt) und leiten diese an die von ihnen geöffneten Dialoge weiter. Wird ein Einfügekanal deklariert, existiert dieser in diesem Kontext neben den Kanälen der Ansicht, und ein darin geschriebener String wird an der Cursorposition eingefügt: Das Steuerelement sendet eine einmalige Einfügeanforderung {seq, html}, der Client fügt diese einmal pro seq an der aktuellen Auswahl ein und meldet den resultierenden Text zurück, wodurch die Anforderung zurückgenommen wird (ein neu eingebundener Client wiederholt dies niemals). Die Befehle werden von ToolbarBuilder in ein ReactToolbarControl eingebunden (standardmäßig nur mit Symbolen, wie die Formatierungsschaltflächen), das als untergeordnetes Steuerelement der Symbolleiste bereitgestellt und vom Client neben seinen eigenen Schaltflächen gerendert wird. ViewCommands enthält den Code für den Modellaufbau und den Lebenszyklus, der mit den Elementen geteilt wird, die <commands> deklarieren.

Der Kommentar-Editor der React-Demo konfiguriert dies in tickets/comment-composer.view.xml:

{{{#!xml <field attribute="content" label-position="hide-label">

<input-control class="com.top_logic.layout.react.wysiwyg.WysiwygControlProvider" insert-channel="insert">
<commands>
<generic-command image="css:ri-links-line" input="ticket">
<label><en>Ticket referenzieren...</en><de>Ticket referenzieren...</de></label>
<executability><null-input-disabled/></executability>
<open-dialog dialog-view="tickets/reference-ticket.view.xml">
<bind channel="context" to="ticket"/>
<bind channel="result" to="insert"/>
</open-dialog>
</generic-command>
</commands>
</input-control>

</field> }}}

Der Dialog erhält das Ticket, zu dem der Kommentar gehört, als Kontext, und seine Einfügeaktion lautet <execute-script function="t -> htmlObjectLink($t)"/><write-channel name="result"/><close-dialog/> – der gesamte Vertrag zwischen einem Selektor und dem Editor. Der frühere Befehl „Ticket referenzieren“ des Composers fügte den Link am Ende des Textes ein, indem er den Entwurf umschrieb, und war deaktiviert, solange das Pflichtfeld einen Fehler anzeigte, da seine Aktion „store-form-state“ die Regel „FormValid“ darauf anwendete. Der eingefügte Link enthält die Attribute „target“ und „rel“, die die TipTap-Link-Erweiterung jedem Anker hinzufügt; sie haben keinen Einfluss auf das Folgen des Links.

Ebenfalls nebenbei behoben

  • Ein <table> zeigte keine Auswahl an, deren Kanal bereits bei der Erstellung der Tabelle benannt war (ein Drilldown-Frame erhält seine Auswahl als Parameter): Die Zeile blieb unmarkiert. Nun wird die ursprüngliche Auswahl übernommen.
  • TLObjectLinkUtil.getLink/`getLinkDestination` akzeptieren jedes TLObject, nicht nur einen Wrapper.
  • OpenDialogAction.openDialog gibt das DialogHandle des geöffneten Dialogs zurück; DialogManager kann die Dialoge oberhalb eines bestimmten Dialogs schließen.

Dokumentation und Demo

docs/faq/react-view-layer.md beschreibt Anzeigeziele, den Mount-Scan, das Reveal-Protokoll, die Einstiegspunkte, die Auswahlsteuerung auf Feldebene und die Befehlsleiste des Editors. com.top_logic.demo.react enthält einen „Projects“-Drilldown (Projekt, Meilenstein, Ticket, Detail), deren Typen Anzeigeziele haben, ein Mitwirkenden-Dialogziel, tl.accounts:Person, das in der Kachel-Demo gezeigt wird (dessen Anfangsansicht dreimal gemountet wird, wodurch die „Nearest-Mount“-Regel angewendet wird), und der Kommentar-Editor der Objektliste verweist über einen Befehl in der Befehlsleiste des Editors auf ein Projekt-Ticket; der gerenderte Kommentar, die Zuteilungszelle, das Meilenstein-Feld und die Konto-Werte sind navigierbar.

  • 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