enhancement
major
minor
major
minor
major
#29535
TL-Ansichtstabelle: Ein Auswahlkanalwert, der nicht in den Zeilen enthalten ist, darf von der Tabelle nicht gelöscht werden
Problem
TableElement bindet seinen Auswahlkanal bidirektional: Die Tabelle schreibt die ausgewählte Zeile in den Kanal, und ein Wert, der von einer anderen Stelle in den Kanal geschrieben wird, wird als Auswahl der Tabelle übernommen (reapplySelection → control.selectRow(value)). Befindet sich der Wert nicht unter den Zeilen der Tabelle, hat die Tabelle am Ende keine ausgewählte Zeile und meldet über ihren Auswahl-Listener eine leere Auswahl, der wiederum null zurück an den Kanal schreibt – die Tabelle überschreibt einen Wert, den sie lediglich nicht anzeigen kann.
Zwei beobachtete Konsequenzen:
- Mehrere Tabellen können sich keinen Auswahlkanal teilen. Ein Board mit drei Spalten (Tabellen über die Tickets eines Projekts, unterteilt nach Statuskategorien) mit selection="selectedTicket" in allen drei Spalten: Ein Klick auf eine Zeile in einer Spalte führt dazu, dass die beiden anderen Spalten, die dieses Ticket nicht enthalten, „null“ zurückschreiben, sodass keine Zeile ausgewählt bleibt und ein einzelner „Open“-Befehl über den gemeinsamen Kanal niemals aktiviert wird. Die Anwendung musste jeder Spalte einen eigenen Kanal und einen eigenen „Open“-Befehl zuweisen.
- Ein erstelltes Objekt ist nicht ausgewählt. Ein Erstellungsdialog schreibt das neue Objekt in den Auswahlkanal (<write-channel name="selectedProject"/>), bevor die Tabelle ihre Zeilen aktualisiert hat; die Tabelle, die das Objekt noch nicht enthält, löscht den Kanal, und die anschließende Aktualisierung wählt nichts aus. Der Benutzer muss nach dem Erstellen auf die Zeile klicken. (Der Befehl „reapplySelection“ nach der Aktualisierung ist genau für diesen Fall vorgesehen, wird jedoch durch das Löschen des Kanals zunichte gemacht.)
Lösung
Die Tabelle schreibt den Auswahlkanal nur noch in zwei Fällen:
- Benutzerinteraktion in der Tabelle: Das Auswählen oder Abwählen einer Zeile schreibt das Objekt (bzw. die Menge oder null) in den Kanal – wie bisher.
- Eine zuvor in dieser Tabelle als ausgewählt angezeigte Zeile ist nach einer Aktualisierung der Zeilen verschwunden (Objekt gelöscht, durch geänderten Eingabekanal herausgefiltert oder es erfüllt das Zeilenkriterium nicht mehr): Die Tabelle setzt den Kanal auf null, damit ein benachbartes Formular kein Objekt mehr anzeigt, das die Tabelle nicht mehr enthält (Verhalten aus #29462, beschränkt auf Zeilen, die die Tabelle tatsächlich als ausgewählt angezeigt hat).
Ein Kanalwert, der nicht unter den Zeilen der Tabelle liegt, bedeutet hingegen lediglich „hier ist keine Zeile ausgewählt“: Die Tabelle zeigt keine Auswahl an und lässt den Kanal unverändert. Dadurch können sich mehrere Tabellen einen Auswahlkanal teilen (die Tabelle, die das Objekt enthält, zeigt es als ausgewählt an, die anderen nicht), und ein neu angelegtes Objekt, das vor der Aktualisierung der Zeilen einen Eintrag in den Kanal schreibt, wird nach der Aktualisierung ausgewählt. Wandert ein Objekt durch eine Änderung von einer Tabelle in eine andere am selben Kanal, ist danach nichts ausgewählt (die Tabelle, die es angezeigt hat, leert den Kanal).
Technisch:
- Die Zwei-Wege-Bindung zwischen TableViewControl und ViewChannel liegt in der wiederverwendbaren Klasse com.top_logic.layout.view.model.TableSelectionBinding, die sowohl TableElement (nicht editierbare Tabelle) als auch RowSetTableControl (editierbare Tabelle in einem <form>) verwenden; die zuvor dort doppelt vorhandene Bindungslogik entfällt. Der Eigentümer ruft nach TableViewControl.refreshData() die Methode rowsRefreshed() auf.
- TableViewControl benachrichtigt beliebig viele Auswahl-Listener (addSelectionListener / removeSelectionListener), sodass die bearbeitbare Tabelle neben der Kanalbindung ihren eigenen Listener für die Bearbeitbarkeit der Zellen beibehalten kann.
- Test: TestTableSelectionBinding (zwei Tabellen über disjunkte Zeilenmengen an einem Kanal).
- Demo: tickets.view.xml in tl-demo-react (Navigationseintrag „Objektliste“) zeigt zwei Tabellen (Tickets ohne / mit Kommentaren) an einem gemeinsamen Auswahlkanal an.