enhancement
major
minor
major
minor
major
#29533
TL-Ansichten: Ausführbarkeitsregeln und abgeleitete Kanäle müssen Änderungen des Objekts auf einem Kanal berücksichtigen, nicht nur Änderungen des Kanalwerts.
Problem
Zwei Mechanismen der Ansichtsebene (com.top_logic.layout.view) reagieren ausschließlich auf eine Änderung des Werts eines Kanals. Wenn das Objekt auf dem Kanal unverändert bleibt, sich jedoch eines seiner Attribute ändert – was häufig nach einem Befehl oder dem Speichern eines Formulars der Fall ist –, werden sie nicht neu ausgewertet, obwohl ihr Ergebnis von diesem Attribut abhängt.
1. Ausführbarkeitsregeln für Befehle
ViewCommandModel registriert sich ausschließlich als ChannelListener auf dem Eingabekanal des Befehls (_inputChannel.addListener(this)) und wertet seine ViewExecutabilityRule im Listener neu aus. Eine Regel wie
{{{#!xml <generic-command input="ticket" ...>
<executability>
<visible-if expr="t -> $t.get(tl.dev:Ticket#status).get(tl.dev:TicketStatus#category) == tl.dev:StatusCategory#Open"/>
</executability>
...
</generic-command> }}}
wird daher ausgewertet, wenn ein neues Ticket auf dem Kanal eintrifft, jedoch nicht, wenn der Befehl selbst (oder etwas anderes) den Status des Tickets ändert. Eine Workflow-Schaltfläche „Akzeptieren“ bleibt nach ihrer Ausführung sichtbar.
Die in der Praxis gefundene Abhilfe: Deklarieren Sie die Befehle innerhalb des <form input="ticket"> anstelle des umschließenden <panel>, da FormElement die von ihm bereitgestellten Befehlsmodelle bei jeder Änderung des Formularzustands neu validiert und FormControl einen Befehl auslöst, wenn das angezeigte Objekt aktualisiert wird. Dadurch wird die Platzierung eines Befehls an eine zufällige Eigenschaft des Formulars gekoppelt, was bei einem Befehl in einem Panel ohne Formular (z. B. einer Tabellen-Symbolleiste oder einer App-Leiste) keine Hilfe darstellt.
2. Abgeleitete Kanäle
DerivedViewChannel fügt ausschließlich seinen Eingabekanälen einen Aktualisierungs-Listener hinzu und führt bei Änderungen ihrer Werte (überprüft durch `Objects.equals`) eine Neuberechnung durch. Ein abgeleiteter Kanal, dessen Ausdruck ein Attribut des Eingabeobjekts ausliest –
{{{#!xml <derived-channel name="draft" inputs="target"
expr="x -> new(tl.dev:Ticket, context: $x.get(tl.dev:TicketTarget#project), transient: true)"/>
}}}
- – wird niemals neu berechnet, wenn ein Formularfeld ` TicketTarget#project` schreibt, da der Kanal weiterhin dasselbe Zielobjekt enthält. Die Elemente, die auf Modelländerungen reagieren (<table>, <switch>, <tree>, <object-list>), verfügen jeweils über eine eigene Handhabung der beobachteten Typen; Kanäle weisen keine solche Schnittstelle auf, und ein Formularfeld kann seinen Wert ebenfalls nicht an einen Kanal veröffentlichen.
Die in der Praxis gefundene Abhilfe: Ein Dialog, der seinen Entwurf nicht neu erstellen kann, wenn sich das Projektfeld ändert, wird in zwei Dialoge aufgeteilt (zuerst das Projekt auswählen, dann den Entwurf bearbeiten).
Lösung
Gemeinsame Beobachtungsschnittstelle
Eine einzige Klasse ` ChannelObjectObserver ` (com.top_logic.layout.view.model) beobachtet im ` ModelScope` des Fensters die TLObjects, die derzeit von einer Liste von Kanälen gehalten werden (ein einzelnes Objekt oder eine Sammlung von Objekten), zusammen mit einer optionalen Menge von „beobachteten Typen“. Wenn sich ein Kanalwert ändert, richtet der Beobachter seine Objekt-Listener auf den neuen Wert aus; jede Modelländerung eines beobachteten Objekts oder Typs wird an einen Callback weitergeleitet. Lebenszyklus: `attach(ModelScope) / detach() `, wie bei RowSourceObserver. Die Hilfsfunktion `ObservedTypes.resolve ` wandelt eine Konfiguration der beobachteten Typen in die beobachteten `TLStructuredType`s um und ersetzt die identischen privaten Kopien in den Elementen „Tabelle“, „Baum“, „Schalter“, „Objektliste“ und „Kalender“. `ReactSwitchControl` und die Zielbeobachtung des Scroll-Links nutzen den gemeinsamen Beobachter anstelle ihrer eigenen Verwaltung.
Befehle
ViewCommandModel.attach(ModelScope) beobachtet die Objekte auf dem Eingabekanal des Befehls über den gemeinsamen Beobachter und wertet die Ausführbarkeitsregel neu aus, sobald sich ein beobachtetes Objekt ändert oder ein neuer Kanalwert vorliegt; Jeder Befehlsträger (Panel- und Menü-Symbolleisten, Schaltflächen, App-Leiste, durch Formulare bereitgestellte Befehle) übergibt den Modellbereich des Fensters, wenn sein Steuerelement angehängt wird. TLObject-Eingaben werden immer beobachtet; das optionale Attribut `observed-types` eines Befehls fügt Typen für Regeln hinzu, die über das Eingabeobjekt hinausgehen (z. B. zu dessen Container):
{{{#!xml <generic-command input="ticket" observed-types="my.module:Project">
<executability>
<visible-if expr="t -> ..."/>
</executability>
</generic-command> }}}
Ein auf einem Panel oder in der Symbolleiste der App-Leiste deklarierter Workflow-Befehl wird nun ausgeblendet oder eingeblendet, wenn seine eigene Ausführung den Zustand des Eingabeobjekts verändert.
Abgeleitete Kanäle
<derived-channel> überwacht die Objekte auf seinen Eingangskanälen auf dieselbe Weise und führt eine Neuberechnung durch, wenn sich eines davon ändert; Listener werden weiterhin nur benachrichtigt, wenn sich der neu berechnete Wert unterscheidet. Das optionale Attribut „observed-types“ ist auch hier verfügbar. Die Beobachtung folgt der Darstellung: „DerivedViewChannel“ implementiert die Schnittstelle „ObservingChannel“ (attach(ModelScope) / detach()), und „ViewElement“ fügt die von ihm instanziierten Kanäle hinzu, wenn sein Stammsteuerelement angefügt wird, und trennt sie wieder, wenn es verschwindet; ein Kanal gleicht den Stand an, indem er bei seiner Anbindung einmal neu berechnet wird.
Tests
Auf einer Wissensbasis basierende Tests in tl-layout-view (TestChannelObjectObserver, TestViewCommandModelObservation, TestDerivedViewChannelObservation, basierend auf AbstractDBKnowledgeBaseTest mit einem GlobalModelEventForwarder als Modellbereich): Eine Ausführbarkeitsregel und ein abgeleiteter Kanal über ein Attribut werden neu ausgewertet, nachdem das Attribut in einer Transaktion gesetzt wurde, während der Kanalwert unverändert bleibt; ein getrennter Beobachter, eine Änderung eines nicht verwandten Objekts, eine Neuberechnung auf denselben Wert sowie das vorherige Objekt nach dem Wechsel des Kanals zu einem anderen lösen keine Neubewertung aus; das Anfügen gleicht eine Änderung aus, die während der Trennung vorgenommen wurde. Das Modul wurde um die für die Ausführung von Wissensbasis-Tests erforderliche „test-webapp“-Konfiguration (src/test/webapp/WEB-INF/conf) erweitert.
Demo
tl-demo-react, Ansicht „Objektliste“ (tickets.view.xml): demo.tickets: Ein Ticket erhält einen Status (Enumeration TicketStatus: offen, geschlossen), die Symbolleiste des Ticket-Panels erhält die Befehle „Schließen“ / „Erneut öffnen“, die durch <visible-if> in Abhängigkeit vom Status gesteuert werden, und ein abgeleiteter Kanal „ticketState“ zeigt den Status als Text oberhalb des Filters an. Beim Schließen eines Tickets wird „Schließen“ ausgeblendet, „Erneut öffnen“ angezeigt und der Text angepasst, während die Auswahl unverändert bleibt.