enhancement
major
minor
major
minor
minor
#29561
TL Views: Die Anzeige eines referenzierten Objekts passt sich nicht an eine Änderung seiner Beschriftung an (Tabellenzelle, Formularfeld)
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-layout-view / tl-layout-react.
Überall dort, wo eine TL-Views-Benutzeroberfläche ein referenziertes Objekt anhand seiner Bezeichnung anzeigt – eine Referenzspalte eines <table>, ein Referenzfeld eines <form> im Ansichtsmodus, die Chips eines Auswahlfelds im Bearbeitungsmodus –, bleibt die Bezeichnung so, wie sie zum Zeitpunkt der Erstellung der Ansicht war. Eine Änderung des Namens des referenzierten Objekts (ein I18NString-Name wie im folgenden Beispiel, aber genauso gut ein einfacher String-Name) wird erst berücksichtigt, wenn die gesamte Benutzeroberfläche neu aufgebaut wird, z. B. durch Umschalten der Sprache der Sitzung. Ein Neuladen des Browsers hilft nicht.
Reproduktion
Definieren Sie „expenses:ExpenseCategory“ mit einem obligatorischen Namen vom Typ „tl.model.i18n:I18NString“ (keine TLLabel-Annotation; der Label-Provider löst den Namensteil auf und lokalisiert den ResKey). Der Typ „expenses:Expense“ verfügt über eine Referenzkategorie, die in einer anderen Ansicht als Spalte eines <table> angezeigt wird.
- Bearbeiten Sie in der Kategorieansicht die Kategorie „travel“: Name „Reise“ → „Reisen“ (Deutsch), „Travel“ → „Trips“ (Englisch), speichern. Die Kategorietabelle selbst zeigt sofort „Reisen“ an.
- Öffnen Sie die Ausgabenansicht: In der Kategoriezelle einer Ausgabe, die sich auf diese Kategorie bezieht, steht weiterhin „Reise“ – auch nach einem vollständigen Neuladen der Seite im Browser. Der gespeicherte Wert ist bereits „Reisen“ (in der Skriptkonsole überprüft).
- Wechseln Sie die UI-Sprache auf Englisch: In der Zelle steht „Trips“; wechseln Sie zurück auf Deutsch: „Reisen“. Nur der Sprachwechsel (der die Benutzeroberfläche der Sitzung neu aufbaut) aktualisiert die Bezeichnung.
Erwartet: Die Bearbeitung des Label-Attributs eines Objekts sollte sich überall dort widerspiegeln, wo das Objekt angezeigt wird, spätestens beim nächsten Rendern der Zelle.
Analyse
Es gibt keinen Label-Cache zwischen Modell und Zelle: I18NAttributeStorage erstellt bei jedem Lesevorgang ein neues ResKey-Literal, die Ressourcenbündel cachen nichts pro Schlüssel, und der Label-Provider des Typs (IDColumnLabelProvider für den Namensteil ) liest bei jedem Aufruf den Attributwert.
Veraltet ist der React-Steuerelementbaum:
- Ein Referenzattribut wird von einem `ReactDropdownSelectControl` angezeigt (über `FieldControlService.createDisplayControl` in Tabellenzellen, über das Formularfeld in Formularen). Das Steuerelement berechnet die Beschriftung der ausgewählten Objekte einmalig, wenn es die an den Client gesendeten Wertdeskriptoren erstellt, und berechnet sie nur dann neu, wenn sich der Feldwert ändert. Nichts beobachtet die angezeigten Objekte. Die Tabelle aktualisiert ihre Zeilen nur bei Änderungen ihrer beobachteten Typen (des Zeilentyps), nicht bei Änderungen der Objekte, auf die sich ihre Zellen beziehen; deshalb wird die Kategorietabelle ( die „ExpenseCategory“ beobachtet) aktualisiert, die Ausgabentabelle ( die „Expense“ beobachtet) jedoch nicht.
- Ein Neuladen des Browsers baut den Baum nicht neu auf: ReactWindowRegistry behält den Steuerelementbaum und den Modellbereich des Fensters über ein Entladen/Neuladen hinweg bei und rendert den bestehenden Baum neu. Nur ein Sprachwechsel baut die Fenster der Sitzung ab.
- ReactResourceCellControl löst die Bezeichnung seines Objekts einmalig auf dieselbe Weise auf.
Lösung
Ein Steuerelement, das Modellobjekte anhand ihrer Bezeichnung anzeigt, beobachtet diese Objekte, solange es angehängt ist, und aktualisiert seine Anzeige, wenn sich eines davon ändert.
- com.top_logic.model.listen.ObservedObjects (tl-core): Eine sich ändernde Menge von TLObjects, die ein einzelner ModelListener in einem ModelScope beobachtet. attach(scope) / detach() folgen dem Lebenszyklus der Anzeige (die Menge bleibt nach einem detach erhalten und wird beim nächsten attach erneut registriert), observe(objects) / observeValue(value) richten die Beobachtung neu auf die Differenz aus (Registrierung über tId(), Objekte ohne Identität werden übersprungen). ChannelObjectObserver in der Ansichtsebene verwendet dies anstelle seines eigenen Registrierungscodes.
- ReactDropdownSelectControl beobachtet die Objekte seines Werts, solange es angehängt ist (Anhängen/Trennen von Listenern des Steuerelements, Bereich von ReactContext.getModelScope() über ReactControl.modelScope()), verfolgt eine Wertänderung – auch eine, die vom Client stammt – und sendet bei einer Änderung eines beobachteten Objekts seine Wertdeskriptoren erneut und löscht die geladene Optionsliste, sodass der Client sie beim nächsten Öffnen neu lädt. Dies gilt für Tabellenzellen, Formularfelder im Anzeigemodus und die Chips eines Auswahlfelds im Bearbeitungsmodus.
- ReactResourceCellControl beobachtet das angezeigte Objekt auf dieselbe Weise und ermittelt bei einer Änderung erneut die Beschriftung, das Symbol, den Tooltip, die CSS-Klasse und den Link.
- DefaultReactContext.getModelScope() gibt für einen Kontext ohne Fensterregistrierung den Wert null zurück (ein außerhalb eines Browserfensters erstelltes Steuerelement beobachtet nichts), anstatt einen Fehler zu melden; ReactControl.modelScope() ist der Zugriffsmethod, den Steuerelemente verwenden.
- Demo (tl-demo-react): Der Mitwirkenden-Dialog des Projekt-Drilldowns (projects/contributor-dialog.view.xml) bearbeitet den Mitwirkenden mit einem transaktionalen Speichern, sodass beim Umbenennen eines Mitwirkenden oberhalb der Ticket-Tabelle die Zellen für die Zuordnung sowie das Zuordnungsfeld in den Ticketdetails in Echtzeit aktualisiert werden.
Tests: TestObservedObjects (tl-core), TestSelectValueObservation und TestResourceCellObservation (tl-layout-react, auf der Wissensdatenbank basierend: Benennen Sie das angezeigte Objekt in einer Transaktion um und stellen Sie sicher, dass der Status des Steuerelements die neue Bezeichnung enthält; ein nie angezeigtes oder losgelöstes Steuerelement wird nicht aktualisiert; die Beobachtung folgt einem neuen Wert).
Nicht abgedeckt: Klartextzellen von Zeilen ohne Modellteil sowie die Zeilenaktualisierungsrichtlinie der Tabelle (beobachtete Typen), die unverändert bleibt.