enhancement
major
minor
major
minor
major
#29502
<tree> berücksichtigt keine Modelländerungen: Ein „delete“ wird nie ausgeführt, ein „create“ lässt den gesamten Baum zusammenbrechen
Gemeldet über die „Consulting“-Anwendung in Version 8.0.0-alpha7 (React-View-Benutzeroberfläche, Issue #94), im Browser am 31.08.2026 überprüft.
Wir haben eine Master-Detail-Struktur mit zwei Tabellen (Aufgaben und die Aktionen der ausgewählten Aufgabe) durch ein einzelnes <tree> -Element über „consulting:Project#tasks“ / „consulting:Task#actions“ ersetzt. Das Lesen funktioniert einwandfrei. Das Schreiben hingegen nicht: Das <tree>-Element und das Modell weichen voneinander ab, und keine Einstellung in der Konfiguration des Elements kann diese Diskrepanz beheben.
1. Ein Löschvorgang wird nie im Baum übernommen
Das Entfernen des Geschäftsobjekts des ausgewählten Knotens aus seiner Zusammensetzung innerhalb eines <with-transaction> -Tags wird korrekt bestätigt – das Detailformular wird geleert, das Objekt ist aus der Datenbank verschwunden –, aber **der Knoten bleibt im Baum erhalten**. Er verschwindet erst später, wenn etwas Unabhängiges die Wurzel neu aufbaut. Bis dahin zeigt der Baum ein Objekt an, das nicht mehr existiert, und es kann weiterhin ausgewählt werden.
„observed-types“ ist auf beide Typen gesetzt:
{{{#!xml <tree observed-types="consulting:Task, consulting:Action" selection="selected">
<inputs><input channel="project"/></inputs>
<root>project -> $project</root>
<children>project -> node -> ...</children>
</tree> }}}
Der Klassenkommentarvon `ObservableTreeModel` besagt, dass es „den vollständigen Baum für Erstellungsvorgänge neu aufbaut“, sodass das Entfernen aus einer Komposition offenbar kein Fall ist, den es überhaupt behandelt.
2. Ein Erstellungsvorgang klappt jeden erweiterten Knoten zusammen
Das Erstellen eines Objekts eines beobachteten Typs wirkt sich zwar auf den Baum aus, jedoch nur in Form eines vollständigen Neuaufbaus der Wurzel. Die Folgen, die für den Benutzer in einem Schritt sichtbar werden:
- Jede erweiterte Aufgabe wird zusammengeklappt – in unserem Projekt sind das 39 Knoten der obersten Ebene, und der Benutzer muss den Knoten, an dem er gerade gearbeitet hat, suchen und erneut öffnen;
- der neue Knoten wird **nicht angezeigt**: Er befindet sich unter einem zusammengeklappten übergeordneten Knoten;
- der neue Knoten ist **im Baum nicht ausgewählt**, obwohl der Befehl zum Erstellen ihn in den Auswahlkanal schreibt. Das Detailformular neben dem Baum zeigt das neue Objekt an, während der Baum überhaupt keine Auswahl anzeigt – die beiden Darstellungen stimmen auf dem Bildschirm nicht überein.
3. Es gibt keine Möglichkeit, dies zu beheben
der Javadocvon *TreeElement* selbst:
Hinweis: Die optionalen Konfigurationseigenschaften `isLeaf`, `supportsNode`, `modelForNode`, `parents` und `nodesToUpdate` sind für zukünftige Verwendung deklariert und derzeit nicht in die Laufzeitumgebung eingebunden. Sie werden korrekt geparst, haben aber keine Wirkung. … Unterstützung für inkrementelle Aktualisierungen wird hinzugefügt, sobald das Ansichtsystem eine Modellereignis-Integration erhält.
Die beiden Eigenschaften, die genau diese Funktion übernehmen würden – „parents“ (um von einem neuen Objekt zu den Knoten zu gelangen, die erweitert werden müssen) und „nodesToUpdate“ (um einen Teilbaum anstelle des Stamms zu aktualisieren) – werden zwar parst, haben aber keine Wirkung. Eine Anwendung kann das Baummodell auch nicht von außerhalb des Elements erreichen.
Was wir erwarten würden
- Ein Entfernen aus einer Komposition entfernt den Knoten, so wie ein Erstellen einen hinzufügt.
- Eine inkrementelle Aktualisierung, sofern das Modellereignis dies zulässt, anstatt eines Neuaufbaus der Wurzel.
- Der Erweiterungszustand bleibt auch nach einem unvermeidbaren Neuaufbau erhalten.
- Das Schreiben eines Objekts in den Auswahlkanal des Baums, wodurch dieser Knoten ausgewählt (und sichtbar gemacht) wird, sodass sich ein erstelltes Objekt genau dort befindet, wo der Benutzer hinschaut. Derzeit wird der Kanal zwar vom Baum beschrieben, aber nicht von ihm zurückgelesen.
Was wir stattdessen getan haben
Nichts – keine Umgehungslösung. Die Ansicht wird mit der dokumentierten Lücke ausgeliefert, und beim Neuladen der Seite wird immer der korrekte Zustand angezeigt. Hier gemeldet statt umgangen, in Übereinstimmung mit #29500, #29501, #29491.
Verwandte Themen
- #29501 – Aktivieren einer Zeile aus der Liste; gleicher Bereich, die Interaktionsseite.
- #29500 – Detailansicht als Overlay.
Lösung
Inkrementelle Baumaktualisierungen. Der Modellbeobachter des Baums (ObservableTreeModel) behält sein Baummodell über Modellereignisse hinweg bei, anstatt es von der Wurzel aus neu aufzubauen. Bei einem Modellereignis gleicht er die untergeordnete Liste jedes Knotens ab, dessen untergeordnete Elemente materialisiert sind, sortiert nach Geschäftsobjekt: Knoten, deren Objekt sich noch in der neu berechneten Liste befindet, bleiben erhalten, sodass ihre Erweiterung und Identität bestehen bleiben; neue Objekte erhalten einen Knoten an ihrer Position; verschwundene Objekte verlieren ihren. Ein einziger Abgleich deckt alle Ereignistypen ab: Ein Löschvorgang entfernt den Knoten und gleicht den Knoten ab, in dem er sich befand; eine Aktualisierung eines beobachteten Objekts gleicht die Kinder dieses Knotens und die Kinderliste des Knotens ab, in dem er sich befindet (das Entfernen aus einer Komposition sowie das Entfernen über eine Rückwärtsreferenz wie Milestone#Tickets, bei denen nur das Kind als geändert gemeldet wird) sowie – sofern Eltern konfiguriert sind – den Knoten, der das Objekt nun enthält, sodass eine Verschiebung an der Zielposition landet; eine Erstellung eines beobachteten Typs gleicht jeden materialisierten Knoten ab. Nur eine Änderung eines Eingangskanals ersetzt das Modell; dort wird die Erweiterung über Baumknoten-Helfer (TreeNodes) gespeichert und wiederhergestellt, die mit dem Baum des Ansichtsdesigners geteilt werden. Wenn der Baum die Beobachtung wieder aufnimmt, nachdem er ausgeblendet war (inaktiver Reiter), gleicht er alles ab, so wie es der Zeilenbeobachter von Tabellen und Listen seit #29610 tut.
Bidirektionaler Auswahlkanal. TreeSelectionBinding liest den Kanal ebenfalls, ähnlich wie die Tabellenbindung seit #29535: Ein in den Kanal geschriebener Wert wird im Baum ausgewählt, seine Vorfahren werden erweitert, sodass der Knoten sichtbar wird, und der Client scrollt ihn in den sichtbaren Bereich. Der Wert wird nach jeder Strukturänderung erneut angewendet, sodass ein Objekt, das ein Befehl erstellt und in den Kanal schreibt, ausgewählt wird, sobald sein Knoten existiert. Wenn ein ausgewählter Knoten verschwindet, wird die verbleibende Auswahl zurück in den Kanal geschrieben – null, wenn nichts mehr übrig ist. Ein Wert, für den der Baum keinen Knoten hat, lässt sowohl den Kanal als auch die Auswahl des Baums unberührt. Ein gelöschtes Objekt wird niemals an die Knotensuche übergeben (es kann nichts darüber berechnet werden), sodass es aus der Auswahl fällt, anstatt die abgeleiteten Werte des Kanals zu unterbrechen. Der Knoten für ein Objekt wird von einem NodeLocator gefunden: zunächst unter den materialisierten Knoten, dann durch eine Suche, die Kinder auf dem Weg nach unten materialisiert; wenn der optionale Eltern-Ausdruck (node -> parent) konfiguriert ist – dem „reveal“-Helper für große oder unbegrenzte Bäume – durchläuft der Baum den Pfad vom Objekt bis zur Wurzel und erweitert sich entlang dieses Pfades, anstatt zu suchen.
Konfiguration. „parents“ wird wie beschrieben verdrahtet. Die ungenutzten Eigenschaften „isLeaf“, „supportsNode“, „modelForNode“ und „nodesToUpdate“ werden zusammen mit dem Javadoc-Hinweis entfernt; „nodesToUpdate“ wird durch das vom Modellereignis gesteuerte „reconcile“ ersetzt.
Ressourcenzelle. „ReactResourceCellControl“, das seine eigene Darstellung bei einer Änderung des angezeigten Objekts neu auflöst, lässt ein gelöschtes Objekt unberührt, anstatt eine Farbe für ein Objekt zuzuweisen, das keinen Typ mehr hat.
Verifizierung. Die Baum-Demo von tl-demo-react überwacht ihre Typen, benennt die übergeordneten Knoten ihrer Knoten und verfügt über Befehle zum Erstellen eines Meilensteins im ausgewählten Projektumfang (über einen Dialog), zum Erstellen eines Tickets im ausgewählten Meilenstein (ohne Dialog), zum Trennen des ausgewählten Tickets von seinem Meilenstein (Entfernen ohne Löschen) und zum Löschen der Auswahl. Im Browser überprüft: Erstellte Knoten erscheinen unter dem noch erweiterten übergeordneten Knoten und sind ausgewählt, ein abgetrennter oder gelöschter Knoten verschwindet an Ort und Stelle, wobei die Auswahl aufgehoben wird, und eine in einer anderen Ansicht vorgenommene Änderung wird angezeigt, wenn der Baum erneut angezeigt wird. Die in Anmerkung 2 beschriebene Tabellenbeobachtung wurde am Löschbefehl der Ticket-Demo überprüft: Die Zeile verschwindet sofort; der Zeilenbeobachter der Tabelle liest ihre Zeilen bereits bei jedem Ereignis einer angezeigten Zeile neu ein, sodass dort keine Änderung erforderlich war.
Migration
Die <tree> -Attribute `isLeaf`, `supportsNode`, `modelForNode ` und `nodesToUpdate` existieren nicht mehr; eine Ansicht, die eines davon deklariert, kann nicht geladen werden und muss es entfernen (sie hatten keine Auswirkung). „ObservableTreeModel“ nimmt die Funktion „parents“ als zusätzliches Konstruktorargument entgegen, und „TreeSelectionBinding“ wird mit dem Baum-Control, dessen Auswahlmodell, dem aktuellen Baummodell, einem „NodeLocator“ und dem Kanal instanziiert.
Ein „parents “-Ausdruck auf <tree>, der bisher keine Wirkung hatte, wird nun ausgewertet; überprüfen Sie dies.