enhancement
major
minor
major
minor
major
#29619
TL-Ansichten: Eine Konfigurationsbeschränkung auf Warnstufe wurde entfernt, sodass der Modell-Editor nichts anzeigt
Problem
Eine Konfigurationseigenschaft kann eine Einschränkung deklarieren, die ein Problem meldet, ohne die Ausführung zu blockieren: @Constraint(value = …, asWarning = true). Eine solche Einschränkung wird in einer Form der React-View-Ebene ausgewertet und anschließend verworfen: `ConfigValidation.collectConstraintFailures ` behält nur die Fehler bei, die keine Warnungen sind, da das, was es sammelt, zu einer Verletzung wird, die ` ConfigFormModel.apply()` blockiert.
{{{#!java for (ConstraintFailure failure : checker.getFailures()) {
if (!failure.isWarning()) {
violations.add(
new Violation(failure.getItem(), failure.getContextProperty(), failure.getConstraintName()));
}
} }}}
Das Ergebnis ist, dass eine Warnung, die eine Eigenschaft auslöst, im Boot-Protokoll gemeldet wird, wo die Konfiguration gelesen wird, für die Person, die genau diese Eigenschaft in der Anwendung bearbeitet, jedoch nicht sichtbar ist. Gefunden bei ColorSpec#getToken() (#29606): Ein Design-Token, das von keinem Theme ausgegeben wird, wird gemeldet, wenn es in einer *.model.xml-Datei steht, während dasselbe Token, das im Modell-Editor angezeigt wird, ohne Beanstandung akzeptiert wird – genau dieses Schweigen wollte #29606 beseitigen.
Lösung
Ein Fehler auf Warnungsstufe wird neben dem Feld gemeldet, anstatt unterdrückt zu werden, ohne dass die Übermittlung des Formulars blockiert wird.
Die Übertragung funktionierte bereits: ReactFormFieldControl überträgt den Status „hasWarnings“ an den Client und liest ihn aus dem FieldModel aus; FieldModel.setModelValidationWarnings ist der Schritt, der neben dem Pfad fehlte, um einen Fehler ohne Warnung in eine Verletzung umzuwandeln.
Die Änderung betrifft jede als „Warning“ deklarierte Einschränkung, nicht nur diejenige, die den Fehler offenlegte.
Entwurf
- ConfigValidation.check sammelt beide Arten von Befunden als „Findings“: einen „Warning “-Eintrag neben dem blockierenden „Violation“, wobei jeder Eintrag das Element, die Eigenschaft und die eigene Meldung der Einschränkung enthält. „report“ setzt über „FieldModel.setModelValidationWarnings“ eine Warnung für das jeweilige Feld (alle Warnungen zu einem Feld in einem Aufruf) und macht das Feld sichtbar, genau wie bei einem Verstoß. „refusalFor“ setzt die Warnungen unabhängig davon, ob es zu einer Ablehnung kommt oder nicht; die Ablehnung listet ausschließlich Verstöße auf.
- ConfigFieldIndex.clearFindings (früher clearModelErrors) hebt vor jeder erneuten Überprüfung gesetzte Warnungen auf, und ConfigFieldModel.setValue entfernt die Warnungen zu einem Wert, den das Feld nicht mehr enthält, genau wie bei einem Fehler.
- ConfigValidation.recheck ist der Schritt zum Überprüfen und Platzieren ohne Ablehnungen bei unbestätigten Einträgen und unlesbaren Eingaben; refusalFor nutzt diesen Schritt wieder. Das eigenständige `ConfigFormControl` (das `<config-form> `-Element) führt dies bei jeder Änderung eines Feldwerts im Bearbeitungsmodus aus, sodass Warnungen und Fehler bereits während der Bearbeitung sichtbar sind und nicht erst nach dem Klicken auf „Übernehmen“; beim Aufrufen des Bearbeitungsmodus wird nichts geprüft, sodass ein Formular, das mit leeren Pflichtfeldern geöffnet wird, erst rot markiert wird, wenn es bearbeitet wurde. „Übernehmen“ lehnt weiterhin nur bei Verstößen ab. Der ConfigFieldPush-Helper, der dies steuert, wurde von com.top_logic.layout.view nach com.top_logic.layout.configedit verschoben und wird sowohl vom eigenständigen Formular als auch vom Annotations-Editor der Ansichtsebene gemeinsam genutzt.
- Der Konfigurationseditor der React-Demo (DemoEditorConfig) deklariert @Constraint(value = Positive.class, asWarning = true) für sein „count“-Feld, sodass die Demo neben dem Verstoß gegen die Pflichtangabe ihres Eigentümers eine Warnung anzeigt.
Überprüfung
- Unit-Tests in „TestConfigValidation“ und „TestConfigFormControl“ (tl-layout-configedit): Eine Warnung wird als solche erkannt und blockiert niemals „Apply“; beide Arten werden in einem Bericht in einem eigenen Feld aufgeführt, jede Warnung zu einer Eigenschaft wird angezeigt, eine Warnung wird bei erneuter Überprüfung und bei einer Wertänderung zurückgenommen, eine Warnung und ein Verstoß erscheinen während der Bearbeitung ohne „Apply“, das andere Ende einer elementübergreifenden Einschränkung wird bei der Live-Überprüfung gelöscht, der Wechsel in den Bearbeitungsmodus löst keine Markierung aus, eine Live-Überprüfung markiert keinen unbestätigten Eintrag.
- Browser, tl-demo-react: In der Demo des Konfigurationseditors zeigt der Wert -1 unter dem Zählfeld die Meldung „Der Wert muss positiv sein.“ an, und ein leerer Eigentümer zeigt gleichzeitig seinen Fehler an; das Klicken auf „Übernehmen“ wird allein aufgrund des Eigentümers abgelehnt und wird erst fortgesetzt, sobald dieser ausgefüllt ist, wobei die Warnung weiterhin besteht. Im Modell-Editor zeigt eine <color> -Annotation bei einem Klassifikator, dessen Design-Token kein Theme ausgibt, die Token-Warnung unter dem Feld „Design-Token“ an, sobald der Eintrag bestätigt wird, ohne dass in den umgebenden Annotationsfeldern ein Fehler angezeigt wird; die Auswahl eines ausgegebenen Tokens hebt die Warnung auf.
Hinweis zum Modell-Editor: Das Feld „Design-Token“ bietet die ausgegebenen Token als geschlossene Auswahl an (@Options(fun = ColorTokenOptions.class)), sodass ein Token, das von keinem Theme ausgegeben wird, dort nicht eingegeben werden kann; Die Warnung erscheint für ein Token, das bereits gespeichert ist (aus einer *.model.xml-Datei oder nach einem Theme-Wechsel), wenn die Annotation bearbeitet wird.