enhancement
major
minor
major
minor
major
#29554
React view <table>: Spalten für beliebige Zeilenobjekte – berechnete Spalten, eingebettete Spalten referenzierter Objekte, dynamische Spalten; transiente Zeilen
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-layout-view.
Entdeckt beim Erstellen einer Aggregationsansicht (eine Zeile pro Monat, mit Anzahl und Summe) in der Anwendung „Expenses“. Drei Einschränkungen zusammen machen das Element <table> für berechnete Zeilen unbrauchbar:
1. Vorübergehende Zeilen führen zum Absturz der Ansicht
RowSourceObserver.registerObjectListeners() ruft für jede TLObject-Zeile key(object) → object.tHandle() auf, und zwar bedingungslos und unabhängig von den beobachteten Typen. TransientObject.tHandle() löst eine „UnsupportedOperationException“ aus, sodass ein <rows> -Ausdruck, der new(`m:T`, transient: true) -Objekte liefert, die Ansicht nicht anhängen kann (TableElement:898 → RowSourceObserver:130/211/261). <object-list> verwendet denselben Beobachter (ObjectListElement:295).
2. Map-Zeilen werden leer dargestellt
ColumnProviderService.attributeValue(row, attr) gibt null zurück, sofern row nicht von Typ TLObject ist; daher liefert ein <rows> -Ausdruck, der eine Liste von Maps zurückgibt, eine Tabelle mit der richtigen Anzahl an Zeilen, in der jedoch jede Zelle leer ist. Kein Fehler, kein Hinweis.
3. Eine Spalte benennt nur ein flaches Attribut
TableElement.ColumnConfig verfügt über die Attribute „attribute“, „filter“, „readonly“ und „sort“ – jedoch keinen Wertausdruck und keine a.b -Navigation. Ein pro Zeile berechneter Wert (Anzahl der zugehörigen Objekte, eine Summe, eine Bezeichnung eines zugehörigen Objekts) erfordert daher ein abgeleitetes Attribut des Zeilentyps, was unmöglich ist, wenn der Zeilentyp zur Engine gehört (z. B.`tl.accounts:Person ` als Zeile einer „pro Mitarbeiter“-Übersicht).
„group-by“ existiert und gruppiert, aber der ColumnProviderService setzt niemals .aggregate(...), sodass Gruppenzellen CellContent.empty() sind – es gibt auch keine Summen.
Lösung
Die Spaltenkonfiguration <columns> des React-<table>-Elements (und der <composition-table>) ist eine Liste von Spaltendeklarationen. Jede Deklaration ist ein eigenes Tag und liefert null bis n Spalten für den Zeilentyp der Tabelle:
- <column attribute="x"/> – unverändert: Beschriftung, Typ, Anzeige, Filter, Sortierung und Editor werden aus dem Modellattribut abgeleitet. Neu sind eine optionale Überschreibung von <label> und ein optionales <aggregate> (siehe unten). Bestehende Ansichten bleiben gültig.
- <computed-column name="…" type="tl.core:Double" [multiple] [label] [readonly] [sort] [width]> mit <value>row -> …</value> – berechnete Spalte über beliebigen Zeilenobjekten (Maps, transiente Objekte, Engine-Typen). Der Zelltyp wird explizit angegeben; Filter, Sortierung, Breite, Suchtext und Anzeige werden wie bei einem Attribut aus dem Typ abgeleitet (ohne type: Anzeige über die Bezeichnung). Mit <update>row -> value -> …</update> und optional <can-update>row -> …</can-update> ist die Spalte im Bearbeitungsmodus (row-edit) editierbar; der Editor ist das typbasierte Formularfeld. <inputs><input channel="…"/></inputs> übergibt Kanalwerte als führende Argumente aller Funktionen.
- <embedded-columns reference="assignee"> bzw. reference="account.contact" (Referenzpfad, schrittweise gegen den Zeilentyp aufgelöst) – bettet Spalten des referenzierten Objekts ein. Der Inhalt besteht aus normalen Spaltendeklarationen jeglicher Art, die gegen den Zieltyp aufgelöst werden; ohne Inhalt werden die „main-properties“ des Zieltyps (ansonsten alle nicht ausgeblendeten Attribute) angezeigt. Die übrigen Attribute des Zieltyps werden in der Spaltenauswahl angeboten (zunächst ausgeblendet). Spaltennamen sind Pfade (assignee.name), Beschriftungen werden mit den Bezeichnungen der Referenzen vorangestellt („Bearbeiter / Name“); ein <label> an der Einbettung ersetzt das Präfix. Ein mehrwertiger Schritt liefert die gesammelten Werte. Variante mit berechnetem Zielobjekt: <embedded-columns name="…" type="m:Contact" [multiple]><label>…</label><object>row -> …</object>. Eingebettete Spalten sind schreibgeschützt.
- <dynamic-columns name="…" [type|<column-type>] [multiple] [width] [readonly]> mit <columns>…</columns>, optional <column-name>, <column-label>, <value>row -> col -> …</value>, <update>row -> col -> value -> …</update>, <can-update>, <aggregate>rows -> Spalte -> …</aggregate> – eine Spalte pro Element der berechneten Menge, mit den Argumentkonventionen des DynamicColumnProviderByExpression der klassischen Oberfläche. Spaltennamen lauten <name>.<column-name>; es handelt sich um die Spalten, die die Funktion beim Aufbau der Tabelle liefert.
- Aggregate in Gruppenzeilen: <aggregate>Zeilen -> …</aggregate> berechnet für <column> und <computed-column> aus den Zeilen einer Gruppe (group-by) den Wert, der in der Gruppenkopfzeile über die Typanzeige der Spalte dargestellt wird.
- Standardspalten: Eine <table> ohne <columns> zeigt die Haupt-Eigenschaften ihres Zeilentyps an (ansonsten alle nicht ausgeblendeten Attribute); die übrigen Attribute der konfigurierten Typen werden in der Spaltenauswahl angeboten.
Technisch: ColumnSetup enthält eine Typbeschreibung (ColumnType: Typ, Multiplizität, Annotationsquelle, optional das Attribut), einen Wertzugriff, eine optionale Bearbeitungsstrategie (CellEditing) und eine optionale Aggregatfunktion; ColumnProviderService leitet Spaltenart, Breite, Filter, Suchtext und Anzeige aus der Typbeschreibung ab und verwendet den übergebenen Wertzugriff. FieldControlService zeigt Werte auch typbasiert ohne Attribut an. RowSetTableControl liest Zellen über den Spaltenzugriff und bearbeitet sie über die Bearbeitungsstrategie der Spalte (AttributeCellEditing für Attribute, ValueCellEditing mit FunctionFieldModel für berechnete Spalten). RowSourceObserver registriert für transiente Zeilen (tTransient()) keine Listener.
Nebenbei behoben: Die Testquellen von tl-layout-react ließen sich auf „master“ nicht kompilieren (die Tests aus #29561 riefen den in #29552 geänderten Konstruktor von DefaultReactContext auf).
Demo: Seite „Tabellenspalten“ in tl-demo-react.