enhancement
major
minor
major
minor
minor
#29555
TL-Script-Labels (<constant>) werden zur Kompilierungszeit umgewandelt: Das Ergebnis wird an die Locale des kompilierenden Threads angepasst und nicht an die des lesenden Benutzers.
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-model-search.
Ein TL-Script-Ausdruck, der aus einer Konstante einen lokalisierten Text berechnet, z. B. im Speicherausdruck eines abgeleiteten tl.core:String -Attributs,
label(#("Offen"@de, "Pending"@en))
wird nicht pro lesendem Benutzer lokalisiert. Der Wert ist für jede Sitzung derselbe Text (oder, wenn der Ausdruck außerhalb einer Sitzung kompiliert wurde, das rohe ResKey-Literal #("Offen"@de, "Pending"@en) wörtlich), während der identische Ausdruck, der in der Skriptkonsole ausgewertet wird, für einen deutschen Benutzer „Offen“ zurückgibt.
Ursache
label() (com.top_logic.model.search.expr.config.operations.Label) erbt von GenericMethod.canEvaluateAtCompileTime(), das standardmäßig „true“ zurückgibt. ConstantFolding wertet daher label(<Literal>) einmal während der Ausdruckkompilierung aus (evalAtCompileTime, ohne Auswertungskontext) und ersetzt den Aufruf durch ein Zeichenfolgenliteral. Ohne ein explizites „lang“-Argument liest label() die Locale aus dem kompilierenden Thread aus, sodass das gefaltete Literal die Übersetzung für die Locale dieses Threads ist (ein Ausdruck mit abgeleiteten Attributen wird einmalig beim Laden des Modells kompiliert) und der ResKey aus dem kompilierten Ausdruck entfernt wird. Dies verstößt gegen die in ` canEvaluateAtCompileTime` dokumentierte Vereinbarung: Eine Methode, die Daten liest, die nicht in ihren Argumenten angegeben sind, darf nicht gefaltet werden.
Dies lässt sich durch die Kompilierung von `label(#("Offen"@de, "Pending"@en))` in einem englischen Kontext reproduzieren: Der kompilierte Ausdruck ist das Literal „Pending“, und die Ausführung in einer deutschen Sitzung liefert weiterhin „Pending“.
Der gleiche Fehler besteht in den anderen TL-Script-Funktionen, die implizit die Sitzungslokalisierung auslesen und die Kompilierungszeit-Prüfung nicht überschreiben:
- localize() (Localize): Löst einen ResKey über die Sitzungsressourcen auf.
- fill() (Fill): formatiert mit einem MessageFormat in der Ländereinstellung der Sitzung.
(translate() ist davon nicht betroffen, da es als nicht nebenwirkungsfrei deklariert ist; dateFormat() gibt bereits „false“ zurück.)
Hinweis: Ein Argument, das kein Literal ist, z. B. label(if ($x.get(`m:T#paidAt`) == null, #(...), #(...))) mit einer vom Objekt abhängigen Bedingung, wird nicht zusammengefasst, da die Konstantenzusammenfassung einen Aufruf über „if“ nicht verteilt; betroffen ist nur die Form mit konstanten Argumenten.
Lösung
Label, Localize und Fill überschreiben canEvaluateAtCompileTime() und geben „false“ zurück, sodass der Aufruf im kompilierten Ausdruck verbleibt und in der Sitzung des lesenden Benutzers ausgewertet wird. Dies gilt auch bei einem expliziten „lang“-Argument, da die Bezeichnung eines Objekts vom aktuellen Zustand des Objekts abhängt und keine Konstante ist.
Regressionstests in „TestSearchExpression“ kompilieren „label(#(...))“ und „localize(#(...))“ einmal und führen den kompilierten Ausdruck unter einer deutschen und einer englischen Locale aus, wobei die jeweilige Übersetzung erwartet wird.
Migration
- Verhalten: label(), localize() und fill() in kompilierten TL-Script-Ausdrücken (abgeleitete Attribute, Modellgeneratoren, konfigurierte Funktionen) lokalisieren nun pro lesendem Benutzer. Anwendungen, die sich auf die bisherige, versehentlich festgelegte Übersetzung stützten (die Locale des Threads, der den Ausdruck kompilierte, typischerweise der Thread zum Laden des Modells), erhalten nun den korrekten benutzerspezifischen Text; eine Codeänderung ist nicht erforderlich.
- Benutzerdefinierte TL-Script-Funktionen, die in Java implementiert sind (Unterklassenvon `GenericMethod` ) und Daten auslesen, die nicht in ihren Argumenten angegeben sind – die Sitzungs-Locale, der aktuelle Benutzer, die Zeitzone, der Request-Status –, müssen `canEvaluateAtCompileTime()` überschreiben und `false` zurückgeben. Andernfalls wertet ConstantFolding einen Aufruf mit konstanten Argumenten einmal zur Kompilierungszeit aus und legt das Ergebnis für jeden Benutzer fest.