TopLogic - the automated application engine
  • Releases
  • Dokumentation
  • Github
  • Discord
  1. Home
  2. Releases
  3. TL_8.0.0-alpha9
  4. #27490

8.0.0-alpha9
TopLogic Release

2026-10-01

enhancement

major
#27490
Historie begrenzen/abschneiden/aufräumen
#29004
Die Verwendung eines Virenscanners für Uploads zulassen
#29006
Eindeutigkeitsbeschränkung
#29421
Fügen Sie ein React-Kalender-Steuerelement und ein deklaratives UIElement „ <calendar> “ hinzu.
#29429
Vervollständigen Sie den View-Designer, damit damit eine Ansicht von Anfang bis Ende erstellt werden kann.
#29462
React: Generisches Formularelement zum Bearbeiten von Konfigurationen
#29487
React-Ansicht: „ <form> “ gibt weder die Spaltenanzahl noch die Position der Beschriftung preis, und es gibt kein „ <group> “-Element.
#29499
Hinweis auf den Wartungsmodus in der React-Oberfläche
#29507
Hinweis auf den bevorstehenden Session-Timeout in der React-Oberfläche
#29523
<sidebar> zeigt zwei der fünf Arten von Sidebar-Elementen an, die ReactSidebarControl rendert, und keines der Badges
#29525
Das Benutzermenü der App-Leiste in der Kernansichtsebene anzeigen
#29528
Das UI-Design soll sich an die Systemeinstellung für „Dunkel“ bzw. „Hell“ anpassen
#29529
Stellvertreter als explizite Sicherheitsaktion im Einstellungsdialog der TL Views benennen (mit Passwortbestätigung, auch für die Passwortänderung)
#29530
URL-Routing in TL Views: Modellobjekte in Routenparametern, Drilldown-Pfad in der URL, Abfragebindungen
#29531
Filterleiste für Tabellen: Presets, Freitextsuche über die sichtbaren Spalten und benutzereigene gespeicherte Filter
#29532
Objektnavigation in TL Views: Anzeigeziele, ein „reveal“-Protokoll für Container und eine „show-object“-Aktion
#29540
Feedback zur Benutzerfreundlichkeit des Benutzermenüs und des Dialogfelds „Persönliche Einstellungen“
#29542
TL Views: Kanalgebundene Werteingaben für jeden Primitiv- und Referenztyp mit einem „Submit“-Hook
#29543
TL-Ansichten: Bedingte Verzweigungen in einer Aktionskette mit generischen Befehlen
#29544
TL-Ansichtstabelle: Zeilenaktivierung per Doppelklick oder Enter sowie eine Gruppierungsoberfläche über dem bestehenden Tabellenmodell
#29545
TL-Ansichtstabelle: Drag &amp; Drop von Zeilen zwischen Tabellen und auf Zeilen
#29546
TL-Ansichten: Farben für Aufzählungsliterale und Klassifikatorobjekte, die als „Pills“ dargestellt werden, sowie ein Fortschrittsbalken
#29547
Generierte React-Bundles nicht mehr einchecken
#29548
React-View-Benutzeroberfläche: Die Attribute „URL“, „E-Mail“ und „Telefon“ werden als Eingabefelder bearbeitet und als Links angezeigt.
#29551
TL-Ansichten: Es dürfen nur registrierte Einstiegspunkte über eine URL auf oberster Ebene geladen werden
#29557
React-View-Befehle: Der „ExecutableState“-Wert eines deaktivierten Befehls wird niemals an den Client übermittelt, und es gibt neben „visible-if“ keine „disabled-if“-Regel.
#29567
TL Views: Mehrfachauswahl für Tabellen und Bäume (selection-mode="multi")
#29575
TL Views: UI-Inspektor – Zustand eines Elements der React-Oberfläche einsehen (z. B. durch Zugriffsrechte ausgeblendete Tabellenzeilen) und als Skript-Zusicherung aufzeichnen
#29596
TL Views: Gestaltungsoptionen für app-spezifische Oberflächen (css-class, Text-Varianten, Layout-Optionen, Anzeigevarianten für Eingaben, Theme-Tokens)
#29597
TL Views: object-list als generischer Repeater (Elemente ohne Container, Raster-Layout, Index für gestaffelte Animation)
#29598
TL Views: image mit URL-/Ressourcen-Quelle, Seitenverhältnis, Füllmodus und überlagerten Inhalten; avatar mit Foto
#29599
TL Views: Wizard-/Stepper-Element für mehrstufige Dialogflüsse (statische und dynamische Schritte, Fortschritt, Übergänge, Auto-Weiter)
#29600
TL Views: Anzeige lang laufender Server-Aufträge (Phasen, Fortschritt, unbestimmter Fortschritt, verstrichene Zeit)
#29601
TL Views: Anzeige von HTML-Inhalten und HTML-Dokumenten (Agenten-Antworten, Exposés) mit Vorschau und Druck/PDF
#29603
Physisches Löschen gelöschter Objekte aus versionierten Tabellen (Purge): Abschlussmenge über Pflichtreferenzen und Inhalte, optionale Verweise werden geleert
#29605
TL-Ansichten-Tabellenfilterleiste: eine anfänglich aktive Voreinstellung sowie die aktive Voreinstellung und der Suchbegriff als Kanäle für Abfrageverknüpfungen
#29607
TL-Ansichten: Ein Anzeigeziel zeigt eine Registerkarte innerhalb eines verschobenen Rahmens an (ein „ <show> “ befindet sich innerhalb der zuvor angezeigten Ansicht).
#29608
TL Views: value-input mit Platzhalter, zugänglicher Name bei verborgenem Label, bedingte Anzeige von Elementen mit visible-if
#29615
TL-Ansichten: Ein seitenübergreifendes „ <form> “ ist nicht am Füllvertrag beteiligt, sodass ein darin enthaltenes geteiltes oder ausfüllendes Panel entsprechend seinem Inhalt dimensioniert wird.
#29617
Designsystem: Tokens und Basisklassen als eigenes Paket (Welle 0)
#29625
TL-Ansichten: Ein Seitenlayout mit gewichteten Spalten (Hauptbereich 2/3, Seitenbereich 1/3), das bei einem schmalen Viewport auf eine Spalte umgebrochen wird; der geteilte Bereich behält seine Trennlinien bei und schneidet den Seitenbereich bei 400 px ab.
#29629
TL-Ansichten: Die Aktionen `<show-view>` und `<show-views>` zeigen eine nach Namen angegebene eingebundene Ansicht an und schreiben deren Kanäle aus einer Befehlskette ohne Modellobjekt
#29630
TL Views: Ein in Blöcke unterteilter, transaktionsbasierter Job-Körper für „ <start-job> “ – skriptgesteuerte Initialisierung / Elemente / Schritte / Abschluss, eine Transaktion pro Block, Wiederholungsversuche und Überspringen auf Elementebene, Phasen und Fortschritt, die sich aus den Schritten ableiten
#29637
Modellbasierte Berechtigungsdefinition: Zugriffselternobjekt (Delegation der Zugriffsentscheidung an Container oder Referenz, Standard für Kompositionsteile, Entscheidungs-Cache je Interaktion), Rollenelternobjekt statt Security-Parent, Vollständigkeitsprüfung und Assistent
#29640
TL Views: Gruppen einer gruppierten Tabelle werden nach dem Komparator der Gruppierungsspalte sortiert, nicht in zufälliger Reihenfolge
#29641
TL Views: Der React-TL-Script-Editor zeigt Hilfetexte zu Funktionen und Modellelementen an (Kontexthilfe zur Vervollständigung, Hover-Tooltips) und springt beim Tippen nicht mehr an den Textanfang
#29643
TL Views: Anpassung der React-Oberfläche an das Corporate Design eines Kunden mit eigener React-Komponentenbibliothek (Leitfaden und fehlende Erweiterungspunkte)
#29671
TL Views: Drag & Drop in Tabellen nach Regeln einschränken, mit Rückmeldung pro Ziel während des Ziehens
#29681
TL-Script modifiedRevision() berücksichtigt Referenz- und Übersetzungsänderungen; Attribut-Storages "touchen" das Besitzerobjekt nicht mehr
#29690
Option zum Deaktivieren des Browserstarts beim Hochfahren
#29706
Langsame Unit-Tests in tl-core und tl-element beschleunigen
minor
#28324
Dokumentation zu Layout Overlays erstellen
#29500
Es gibt keine Möglichkeit, eine Master-Detail-Ansicht als Overlay darzustellen: Die Detailansicht nimmt immer die Hälfte der Breite der Liste ein.
#29506
Eine Dashboard-Kachel kann nicht der Einstiegspunkt sein, nach dem sie aussieht: Weder <tile> noch <card> führen zu einer Aktion.
#29550
React-Kontrollen nutzen die „radius“- und „surface“-Tokens des Themes nicht einheitlich; ein „flat“-Theme erfordert CSS-Überschreibungen auf Komponentenebene
#29553
React-View- <table>: <column> hat keine Breite, jede Spalte ist standardmäßig 150 px breit, sodass eine Tabelle mit mehr als sechs Spalten über den 940 px breiten Bereich hinausragt.
#29611
TL-Ansichten: Die Aktion `<notify>` zeigt einen übersetzten Hinweis in einer generischen Befehlskette an (Snackbar oder OK-Dialog, wobei die Kette optional unterbrochen wird); `<throw-error>` wurde entfernt
#29624
SSO-Login ohne registrierten Benutzeraccount: konfigurierbare Hinweisseite (ApplicationPages.unknownAccountPage) statt Login-Maske, mit Standardseiten für die klassische und die React-Oberfläche
#29670
TL-Script: Funktionen trim, trimStart und trimEnd entfernen Leerraum am Anfang und Ende einer Zeichenkette
#29675
TL Views: Anlegen und Löschen richten sich nach den Modell-Zugriffsrechten, statt erst nach dem Ausfüllen mit „Kopieren nicht erlaubt“ abgelehnt zu werden
#29683
TL-Script: htmlText(html) kann keine Bilder enthalten, daher kann ein HTML-Text mit <img>, der auf Dateien verweist, nicht in strukturierten Text umgewandelt werden.

defect

critical
#29665
TL Views: Ein Klick in ein Rich-Text-Feld mit versteckter Beschriftung setzt die Schaltfläche „Fett“ im Editor in den Fokus, wodurch der eingegebene Text verloren geht.
#29682
TL Views: Bei einer Seite-Neuladung tritt die Ausnahme „ConcurrentModificationException“ in „ReactToolbarControl.replaceGroups“ auf, woraufhin die Seite „Interner Fehler“ angezeigt wird.
major
#25723
Fehlende Prüfung gegen Attribut-Name-Clashes bei Vererbung
#29438
Die React-View-Ebene zeigt Datumsattribute in einem fest vorgegebenen Format anstelle des kommentierten Formats an.
#29474
Keiner der beiden React-Ziehgriffe schirmt die Seite ab (oder sperrt den Cursor), während gezogen wird.
#29502
<tree> berücksichtigt keine Modelländerungen: Ein „delete“ wird nie ausgeführt, ein „create“ lässt den gesamten Baum zusammenbrechen
#29504
Zwangsabmeldung erreicht die React-Oberfläche nicht
#29509
Die Cookie-Prüfung weist den erneuten Aufruf ihrer eigenen URL ab und meldet dabei die Sitzung ab
#29512
Attribute in tl.model, die de-facto mandatory sind, auch als mandatory deklarieren
#29533
TL-Ansichten: Ausführbarkeitsregeln und abgeleitete Kanäle müssen Änderungen des Objekts auf einem Kanal berücksichtigen, nicht nur Änderungen des Kanalwerts.
#29534
TL Views „Tile-Stack“: Frames erhalten keine feste Höhe, und ein Frame, der wieder freigelegt wird, wird von Grund auf neu aufgebaut.
#29535
TL-Ansichtstabelle: Ein Auswahlkanalwert, der nicht in den Zeilen enthalten ist, darf von der Tabelle nicht gelöscht werden
#29541
Einwertiges Dropdown-Auswahlfeld zeigt zwei Schaltflächen mit der Aufschrift „Löschen“ an
#29554
React view <table>: Spalten für beliebige Zeilenobjekte – berechnete Spalten, eingebettete Spalten referenzierter Objekte, dynamische Spalten; transiente Zeilen
#29556
react-api/tooltip läuft ohne TLSubSessionContext: Ein Zell-Tooltip über einem abgeleiteten Attribut, das mit label() verwendet wird, liefert den HTTP-Status 500 (NullPointerException in Label.eval)
#29560
React view <upload-command>: Fehler beim Upload (Ausnahme in der Aktionskette, überschrittenes Größenlimit) erreichen den Benutzer nicht; Upload-Größenlimit konfigurierbar
#29562
Die in der Datei „security.xml“ für den Bereich „SecurityScopeService“ erteilten Berechtigungen gehen beim Start, bei dem der Bereich eingeführt wird, verloren: Der „AccessConfigurationSetupService“ importiert die Datei, bevor der Bereich existiert, und speichert den Datei-Hash trotzdem.
#29564
SecurityConfigurationService: Eine Anwendung kann einer Berechtigung eines Framework-Typs keine Rolle hinzufügen – eine „ <class> “-Berechtigung ist nach Operation indiziert und ersetzt den früheren Eintrag, wodurch die Rollen des Frameworks stillschweigend widerrufen werden.
#29568
TL Views: Eine ohne Anmeldung aufgerufene Route geht beim Login verloren
#29573
„TestReactStylesheetTokens“ schlägt auf dem Master-Zweig fehl: Die Regeln für „pill“ und „progress“ in tlReactControls.css halten den Theme-Token-Vertrag nicht ein.
#29574
TL Views: Veto eines verschachtelten Channel-Schreibzugriffs bricht die Benachrichtigung des äußeren Channels ab (Tabelle und Detailbereich bleiben nach "Verwerfen" auf dem alten Objekt)
#29576
React-Controls-Bundle enthält eine zweite React-Instanz (createPortal-Import in TLDropdownSelect)
#29586
Die Kompilierung von „tl-layout-react“ scheitert auf dem Master-Zweig: „TestSelectValueObservation“ und „TestResourceCellObservation“ verwenden den Konstruktor „DefaultReactContext“, der durch #29552 entfernt wurde.
#29590
React view: Mehrwertige String-Werte werden in Tabellenzellen und Anzeigefeldern ohne Trennzeichen aneinandergehängt
#29602
TL-Ansichten: Eine in eine bestehende Sitzung übernommene URL behält den Inhalt des Sidebar-Elements bei, das zuvor aktiv war.
#29604
ElementSecurityUpdateManager: Der quadratische Vergleich beim Commit (AbstractSet.removeAll auf eine Liste angewendet) führt dazu, dass das Anhängen an eine große Referenz mehrere Sekunden dauert.
#29609
TL Views: Ein `<progress>` (ChannelObjectObserver) wertet seinen Ausdruck für ein gelöschtes Objekt aus und protokolliert einen FEHLER, wenn ein beobachtetes Objekt gelöscht wird.
#29610
TL-Ansichten: Eine Tabelle auf einer inaktiven Registerkarte zeigt veraltete Zellwerte an, nachdem sich die angezeigten Objekte geändert haben, bis ihre Zeilen aktualisiert werden.
#29613
TL-Ansichten: Eine Kachel vom Typ „<dashboard> “ erhält keine feste Höhe, sodass eine Tabelle in einer Kachel mit ihren Zeilen mitwächst, anstatt gescrollt zu werden.
#29618
TL-Ansichten: Eine URL blendet die Seitenleiste bei einem Eintrag mit ungespeicherten Änderungen aus, ohne nachzufragen.
#29619
TL-Ansichten: Eine Konfigurationsbeschränkung auf Warnstufe wurde entfernt, sodass der Modell-Editor nichts anzeigt
#29620
TL Views: Ein Baumknoten ist niemals ein Link zu der Stelle, an der sein Objekt angezeigt wird, obwohl die Anzeigeziele einen solchen deklarieren.
#29622
TL-Ansichten: Ein `<flow-diagram selection="ch">` schreibt seinen Kanal, folgt ihm jedoch nicht, sodass ein an anderer Stelle ausgewählter Knoten im Diagramm nicht markiert wird.
#29623
Build: Das „translate“-Ziel übersetzt festgeschriebene deutsche Meldungen nach einem Pull oder einem Wechsel des Zweigs neu, wenn das Doclet nicht im selben Build ausgeführt wurde.
#29626
TL-Ansichten: Eine Panel-Symbolleiste verfügt über keinen Überlaufmodus; bei einer Breite von 400 px erstrecken sich die sechs Befehle der Ticket-Seite über eine Breite von 908 px, wobei drei davon nicht erreichbar sind und der Panel-Titel nach außen verschoben wird.
#29627
Tabelle „TL Views“: Eine Zelle vom Typ „I18NString“ bricht den Text um und wird durch die 36-px-Zeile mitten im Glyphenabschnitt abgeschnitten, anstatt mit drei Punkten zu enden; Kopfzeilenbezeichnungen werden ohne drei Punkte abgeschnitten.
#29631
TL-Ansichten: Mit „Escape“ wird ein „ <window> “-Dialogfeld geschlossen, während ein damit gestarteter „ <start-job> “ noch ausgeführt wird; der Job läuft weiter, ohne dass es noch etwas gibt, das angezeigt oder abgebrochen werden könnte.
#29634
TL Views: Der Konfigurationseditor erstellt ein Textfeld für eine Eigenschaft, deren Format nur zur Analyse bestimmt ist. Daher schlägt die Auswahl eines abgeleiteten Attributs im Modell-Editor mit der Fehlermeldung „Es gibt keine normgerechte Möglichkeit, eine Locator-Konfiguration zu serialisieren“ fehl.
#29635
TL-Ansichten: Ein „ <tree> “ stellt jeden Knoten als Link dar, sodass ein Klick auf die Beschriftung zu einer anderen Seite führt, anstatt nur den Knoten auszuwählen.
#29639
TL-Script objectResolve(id, typeOrTable): Auflösung über einen Typ einschließlich seiner Untertypen oder über einen Tabellennamen; objectTable liefert die Tabelle eines Objekts, und ein Objekt, auf das der aktuelle Benutzer keinen Lesezugriff hat, wird nicht aufgelöst
#29644
Inkrementelle Security unvollständig bei Verwendung von scripted-steps
#29645
TL-Script: @SideEffectFree an Funktionen aus TLScriptFunctions wird ignoriert, da der Annotation die Laufzeit-Retention fehlt
#29648
TL Views: Die über ClientResources ausgelieferten Skripte und Stylesheets tragen keine Version in der URL, der Browser verwendet nach einer Aktualisierung veraltete Client-Dateien
#29649
TL Views: Der Endstatus eines Jobs wird durch einen veralteten „Running“-Snapshot überschrieben, sodass unter „ <job-status> “ ein abgeschlossener Job als „Running“ angezeigt wird.
#29666
TL-Ansichten: Das Verlassen eines Frames über „Breadcrumb“, „Zurück“, „navigate-pop“, „show-object“ oder „Abmelden“ löscht die nicht gespeicherten Änderungen eines Formulars, ohne den Benutzer zu fragen.
#29667
TL Views: Ein Formular im Bearbeitungsmodus zeigt weiterhin veraltete Werte an, nachdem ein Befehl eine Änderung an demselben Objekt übernommen hat
#29672
TL-Ansichten: „initial-edit-mode“, ein Objektumschalter und der Kanal „edit-mode“ wechseln ohne Rückfrage in den Bearbeitungsmodus <edit-executability>
#29674
TL-Ansichten: Nach dem Laden einer Seite werden die Befehlsbezeichnungen in der App-Leiste in der Sprache des Browsers statt in der Sprache des Benutzers angezeigt („Aufzeichnen“ in einer deutschen Sitzung).
#29677
TL-Ansicht: Eine Karte in einem Spaltenstapel in Inhaltsgröße schrumpft unter ihre Inhaltshöhe; eine Tabelle daneben nimmt mehr Höhe ein, als angegeben ist.
#29678
BoundHelper: Einstellung use-default-security-parent entfernen – ohne konfigurierte Security-Parent-Regel hat ein Objekt keinen Security-Parent
#29680
Klassische Benutzeroberfläche: Der anonymen Sitzung werden die Entwickleroptionen angeboten, und sie kann „Ressourcen neu laden“ ausführen.
#29698
CollectionUtil.removeDuplicates() verliert die Reihenfolge der Elemente
#29705
Workspace/PathInfo: web-fragment.war eines Moduls wird nicht gefunden, wenn Jar und Fragment aus verschiedenen lokalen Maven-Repositories aufgelöst werden (maven.repo.local.tail)
minor
#27889
Switch auf SNAPSHOT-Version funktioniert nicht
#28474
Hintergrundfarben der Knöpfe sind nicht konsistent
#29496
React-Tabelle: Eine Spaltengrößenänderung wird mit der Meldung „Integer value expected“ abgelehnt, und die neue Breite geht verloren, wenn der Client eine Bruchzahl als Breite übermittelt.
#29497
React-UI-Tooltips: Abgeschnittene Tabellenzellen und Spaltenüberschriften, kompakte Symbolleisten-Schaltflächen und Attributbeschreibungen erhalten Tooltips; native Titelattribute werden durch Bridge-Tooltips ersetzt
#29503
TLResourceCell liefert kein CSS aus: Symbol und Beschriftung überlappen sich überall dort, wo eine Ressourcenzelle beides anzeigt
#29505
Die Höhe der Panel-Kopfzeile ändert sich, wenn die zugehörige Symbolleiste keine Befehle enthält, sodass die Kopfzeilen von Master-Detail-Ansichten nicht bündig liegen
#29508
Weitere QueryExecutor bedürfen keiner Security
#29552
TLPhotoViewer ruft sein Bild ab, nachdem das Steuerelement entsorgt wurde, wenn es durch ein „ <switch> “ ersetzt wird (404 bei react-api/data, Warnung „Command target NOT FOUND“).
#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.
#29558
XMLInstanceImporter importiert ein internationalisiertes Attribut, das als „value=“…“ angegeben ist, stillschweigend als leer, selbst wenn das Attribut obligatorisch ist.
#29561
TL Views: Die Anzeige eines referenzierten Objekts passt sich nicht an eine Änderung seiner Beschriftung an (Tabellenzelle, Formularfeld)
#29563
Standardgruppe: das persistierte Gruppen-Flag "defaultGroup" wird aus der Konfiguration abgeleitet statt in der Datenbank gespeichert; Semantik der Standardgruppe dokumentiert
#29591
ResKey.decode akzeptiert in #(…)-Literalen nur doppelt gequotete Übersetzungen — #('Travel'@en) schlägt fehl, obwohl TL-Script beide Quote-Arten erlaubt
#29606
TL Views: Ein `<color token>`, das ein Token benennt, das das React-Theme nicht ausgibt, führt dazu, dass die Pill ohne Farbgebung und ohne Fehlermeldung gerendert wird.
#29628
TL-Hinweis: Mit „Persönliche Einstellungen zurücksetzen“ wird die gespeicherte Konfiguration gelöscht, die laufende Sitzung behält jedoch ihren Tabellenstatus bei und schreibt ihn zurück; die festgelegten Spaltenbreiten werden erst nach einer erneuten Anmeldung wiederhergestellt.
#29636
TL-Ansichten: Ein Klick auf einen „ <tree> “-Knoten löscht den Auswahlkanal, bevor er festgelegt wird, sodass jede davon abhängige Anzeige und jeder Befehl auf leer umschaltet und wieder zurückkehrt.
#29663
TL-Ansichten: Ein „ <form> “ wird nicht mehr eingebettet; bei einem „ <fields> “-Raster innerhalb eines Formulars wurde die Seite zweimal eingebettet
#29664
TL-Ansichten: Die Befehle „Bearbeiten“, „Speichern“, „Abbrechen“ und „Übernehmen“ des Formulars sind mit einem abschließenden Punkt gekennzeichnet („Bearbeiten.“, „Speichern.“)
#29668
TL-Ansicht: Die Symbolleiste des Rich-Text-Editors ragt über ein schmales Feld hinaus; die Schaltflächen für Tabellen sowie „Rückgängig“ und „Wiederherstellen“ werden abgeschnitten
#29669
Eine Anfrage mit einem fehlerhaften Abfrage-String („?q=50%“) wird mit einer „Interner Fehler“-Seite (HTTP 500) statt mit einem 400-Fehler beantwortet.
#29673
TL-Ansichten: Personalisierungsbefehle („Layout bearbeiten“, „Diesen Filter speichern“) werden der anonymen Sitzung angeboten
#29676
TL Views-Admin: Beim Löschen eines Kontos wird im weiterhin geöffneten Kontoformular die Meldung „Zielobjekt wurde gelöscht“ angezeigt; für den Löschvorgang ist keine Bestätigung erforderlich.
#29679
TL Views: Ein Befehl, der aufgrund seiner Ausführbarkeitsregel abgelehnt wird, wird mit dem Titel „Interner Fehler“ gemeldet.

task

minor
#29612
FAQ: Migrationsleitfaden für das Upgrade einer Anwendung von TL 7.11 auf 8.0
#29702
Mindestversion von Maven im Build auf 3.8.9 anheben
enhancement

major

#27490

Historie begrenzen/abschneiden/aufräumen

ClusterServicesPersistencyLayer

Die Persistenzschicht einer TopLogic-Anwendung versioniert normalerweise (wenn nichts anderes konfiguriert ist). D.h. es gibt keine Möglichkeit, Daten von versionierten Tabellen echt zu löschen. Alle vergangenen Versionen von aktuellen Objekten als auch alle Stände von gelöschten Objekten bleiben (für immer) verfügbar.

Es kann die Anforderung geben, dass eine Anwendung Informationen nach einer gewissen Mindest-Aufbewahrungszeit tatsächlich physikalisch löscht.

Verbesserung

Wartungsfunktion compactHistory(beforeDate), die den Datenbestand so modifiziert, dass

  • alle Versionen von Objekten, die vor dem angegebenen Zeitpunkt durch eine Änderung ersetzt wurden, tatsächlich gelöscht wurden.
  • Dies impliziert, dass Objekte, die vor dem angegebenen Zeitpunkt gelöscht wurden, mit all ihren Versionen komplett aus dem Datenbestand gelöscht werden.
  • Versionen von Objekten, die vor dem angegebenen Zeitpunkt erzeugt wurden aber noch nach dem Zeitpunkt gültig waren, sollen so geändert werden, dass die Version mit einer künstlichen Revision "Compact-Revision" (zum Zeitpunkt beforeDate) erstellt wurde.
  • Die Create-Revision von Objekten, die vor dem angegebenen Zeitpunkt liegt, soll auf die "Compact-Revision" geändert werden.

Design

Kompaktierungsrevision

Die Kompaktierungsrevision C` ist die '''älteste erhaltene Revision''': die neueste Revision, deren Datum nicht nach `beforeDate liegt. Der Datenstand zu Revision C` bleibt exakt lesbar; alle Revisionen vor `C fallen in C` zusammen. Zeilen sind gültig für `REV_MIN <= R <= REV_MAX; gelöscht werden daher Zeilen mit REV_MAX < C (nicht <= C, sonst fehlten zu C` sichtbare Zeilen). Revisionsnummern werden nicht umnummeriert; in Anwendungsdaten gehaltene Revisionsnummern `>= C bleiben gültig.

Intern wird die Operation als Bereichsform compactRevisions(Y, X) (Revisionen Y < R < X fallen in X`) umgesetzt; die globale Kompaktierung ist der Fall `Y = 0. Die Statements unterscheiden sich nur um ein Prädikat (Zeilen vollständig innerhalb des Bereichs werden gelöscht, REV_MIN im Bereich wird auf X` angehoben, `REV_MAX im Bereich wird auf X - 1 gesetzt, vgl. comment:6). Die Bereichsform ermöglicht später eine mit dem Alter abnehmende Versionsdichte (comment:5); nach außen wird zunächst nur die globale Form angeboten.

Schritte

Jeder Schritt ist idempotent und einzeln committierbar, so dass ein abgebrochener Lauf einfach wiederholt werden kann. Große Tabellen werden in Batches gelöscht (vgl. das PostgreSQL-Problem in #28053).

  1. Referenz-Pins umschreiben: Jede _REV-Spalte einer Referenz mit history-type="historic" oder "mixed" mit Wert < C wird auf C` gesetzt. Dies geschieht vor dem Löschen, damit zu jedem Zeitpunkt entweder die alten Zeilen noch existieren oder die Referenz bereits auf `C zeigt. Ein gepinntes Objekt, das zu C` nicht mehr existiert, ergibt einen ins Leere zeigenden Verweis; das ist in der Anforderung enthalten, der Resolver in `KnowledgeReferenceStorageImpl muss dann null liefern statt zu scheitern (zu prüfen).
  2. Pro Item-Tabelle: DELETE ... WHERE REV_MAX < C; danach REV_MIN und REV_CREATE auf C anheben, wo sie kleiner sind.
  3. FLEX_DATA: gleiches Löschen und Anheben von REV_MIN.
  4. BRANCH: BASE_REV und REV_CREATE auf C anheben, wo sie kleiner sind.
  5. REVISION / REVISION_XREF: Zeilen mit rev < C löschen; die Metadaten der Revision C` durch eine synthetische System-Revision (Autor system, Log "compacted") ersetzen, da ihr nun alle angehobenen Zeilen zugeschrieben werden; XRef-Einträge für `C aus allen (BRANCH, Typ)-Paaren mit REV_MIN = C einfügen.

Unversionierte Tabellen werden vom bestehenden HistoryCleanup bereits aufgeräumt; die Kompaktierung behandelt sie identisch (das Anheben von REV_MIN ist dort unschädlich).

Grenzen

Von Anwendungen als einfache Zahl gespeicherte Revisionsnummern < C (z.B. aus TL-Script) können nicht gefunden und umgeschrieben werden. Dies ist eine dokumentierte Einschränkung.

Ausführung

Die Knowledge-Base cached Items und Revisionen im Speicher, auf jedem Cluster-Knoten. Die Kompaktierung läuft daher im Wartungsfenster; anschließend wird die Persistenzschicht auf allen Knoten neu gestartet. Bereitstellung als Administrationsaktion sowie optional als geplanter Task mit konfigurierter Aufbewahrungsdauer.

Gemeinsame Infrastruktur mit #29603

Das gezielte physische Löschen gelöschter Objekte (#29603) und die Kompaktierung benötigen denselben Kern: einen Durchlauf über das Typ-Repository, der alle Item-Tabellen, deren Referenzspalten (_ID, _REV, _BRC, _TYPE gemäß AbstractMOReference; fehlende _BRC/`_TYPE`-Spalten werden aus dem BRANCH der verweisenden Zeile bzw. dem konfigurierten monomorphen Zieltyp aufgelöst) und FLEX_DATA aufzählt und daraus dialektneutrale Statements über SQLFactory erzeugt. Vorbild ist HistoryCleanup.

Tests

Tests über AbstractDBKnowledgeBaseTest: Objekte anlegen, mehrfach ändern, teilweise löschen, historische und gemischte Referenzen auf alte Versionen setzen, Branch anlegen; nach compactHistory muss die historische Sicht zu C` dem Stand vor der Kompaktierung entsprechen, Revisionen `< C dürfen nicht mehr auflösbar sein, Referenz-Pins müssen auf C` zeigen. Invariante: ein `KnowledgeBaseDumper-Dump ab Revision C` ist bis auf die synthetische Revision `C unverändert.

Lösung

SQL-Kern `HistoryCompaction`

Klasse HistoryCompaction in com.top_logic.knowledge.service.db2, nach dem Vorbild von HistoryCleanup: erzeugt aus ConnectionPool, Typ-Repository und SQL-Dialekt alle Statements über SQLFactory und führt sie auf einer Schreibverbindung des Pools ohne Knowledge-Base-Transaktion aus. Operationen:

  • resolveCompactionRevision(beforeDate): die neueste Revision, deren Datum nicht nach dem Stichtag liegt (dieselbe Abfrage wie die Revisionssuche nach Datum der Knowledge-Base).
  • compactRevisions(Y, X) als allgemeine Bereichsform, compactHistory(beforeDate) als Fall Y = 0.
  • analyzeRevisions(Y, X) / analyzeHistory(beforeDate): Trockenlauf, der mit denselben Prädikaten nur zählt.
  • Ergebnis ist ein Report mit Kompaktierungsrevision und Zeilenzahlen je Tabelle (gelöscht, umgeschrieben, verschobene Pins, geleerte Pins).

Die Aufzählung der Item-Tabellen (alle konkreten Item-Untertypen mit REV_MIN/`REV_MAX`, versioniert wie unversioniert; die Systemtabellen Revision, RevisionXref, Branch, BranchSwitch, FlexData sind keine Item-Untertypen und damit ausgeschlossen), ihrer revisionspinnenden Referenzen und der FLEX_DATA-Tabelle liegt in der eigenständigen Klasse ItemTables, auf der #29603 aufsetzen kann. Für den Trockenlauf wurde die Aggregatfunktion count in SQLFactory/`SQLFun` ergänzt.

Bereichssemantik gemäß comment:6, je Schritt idempotent und einzeln committiert, in dieser Reihenfolge:

  1. Referenz-Pins: _REV-Spalten historischer und gemischter Referenzen innerhalb (Y, X) werden X`. Die Marker `Long.MAX_VALUE (gemischte Referenz auf den aktuellen Stand) und 0` (leere Referenz) liegen konstruktionsbedingt außerhalb jedes Bereichs. Anschließend werden '''ins Leere zeigende Pins geleert''': Ein auf `X zeigender Pin, dessen Zielobjekt zu X` keine Zeile hat (Zielobjekt innerhalb des Bereichs gelöscht), wird auf die Null-Darstellung einer Referenz gesetzt (`_ID Null-ID, _TYPE null, _REV/`_BRC` 0). Die Existenzprüfung liest die Kandidaten (nur Zeilen, die den Lauf überleben) und prüft je Zieltyp mit IN-Mengen; das Leeren erfolgt als Batch-Update über den Primärschlüssel. Ein solcher Verweis liefert danach null.
  2. Pro Item-Tabelle: Zeilen vollständig innerhalb (Y, X) werden gelöscht, in Fenstern über REV_MAX mit einem Commit je Fenster (#28053); danach REV_MIN und REV_CREATE innerhalb des Bereichs auf X`, `REV_MAX innerhalb des Bereichs auf X - 1.
  3. FLEX_DATA: gleiches Löschen und Umschreiben von REV_MIN/`REV_MAX`.
  4. BRANCH: BASE_REV und Erzeugungsrevision innerhalb des Bereichs auf X.
  5. REVISION / REVISION_XREF: Revisionen innerhalb des Bereichs werden gelöscht; Revision X` erhält den System-Autor und die Meldung "History compacted". XRef-Einträge innerhalb des Bereichs werden gelöscht, die Einträge für `X werden aus allen Item-Tabellen mit REV_MIN = X oder REV_MAX = X - 1 neu aufgebaut (Löschen und INSERT ... SELECT DISTINCT wie in MigrationContext.revalidateXRef; eine Änderung nur an Flex-Attributen schreibt ebenfalls eine neue Item-Zeile, so dass die Item-Tabellen dafür ausreichen).
Ausführung

HistoryCompactionOperation (com.top_logic.knowledge.service.compact) führt die Kompaktierung auf der Standard-Knowledge-Base der laufenden Anwendung aus:

  • Voraussetzungen für die echte Kompaktierung: aktives Wartungsfenster; im Cluster-Betrieb muss dieser Knoten der einzige aktive Knoten sein (andere Knoten würden veraltete Caches behalten, ein entfernter Neustart existiert nicht). Bei Verletzung bricht die Operation mit einer Meldung ab. Die Analyse (Trockenlauf) hat keine Voraussetzungen.
  • Die Kompaktierung läuft bei laufender Knowledge-Base innerhalb des Wartungsfensters (keine Benutzersitzungen; der Datenstand der aktuellen Revision wird nicht verändert). Anschließend wird das Modul KnowledgeBaseFactory neu gestartet, damit die Caches für Items, Revisionen und Branches verworfen werden. Der Neustart beendet alle Sitzungen und alle abhängigen Dienste (auch den Scheduler) und wird deshalb über den SchedulerService wenige Sekunden später ausgeführt, nie auf dem auslösenden Thread. Das Wartungsfenster ist eine Cluster-Eigenschaft, die beim Start neu gelesen wird, und überdauert den Neustart.
Administrationsaktion

Wartungsseite CompactHistory.jsp (jsp/administration/maintenance/, Administration > Technik > Wartung) nach dem Muster der Export-/Import-Seiten: CompactHistoryCommand öffnet CompactHistoryDialog mit dem Stichtag (Vorgabe: ein Jahr zurück). "Analysieren" zeigt den Bericht des Trockenlaufs (Kompaktierungsrevision, Zeilenzahlen je Tabelle) in einem Fortschrittsdialog. "Komprimieren" prüft die Voraussetzungen, fragt nach Bestätigung, führt die Kompaktierung aus und zeigt den Bericht; mit dem Schließen des Berichts wird die Persistenzschicht neu gestartet und die Sitzung beendet. Das Wartungsfenster wird vom Administrator vorher manuell betreten und nachher verlassen.

Geplanter Task

CompactHistoryTask (TaskImpl, @InApp) mit konfigurierter Aufbewahrungsdauer (retention-period); kompaktiert die Historie vor "jetzt minus Aufbewahrungsdauer" und stößt danach den Neustart der Persistenzschicht an. needs-maintenance-mode ist für diesen Task standardmäßig aktiv, d.h. der Scheduler betritt das Wartungsfenster vor dem Lauf (mit der konfigurierten Verzögerung) und verlässt es danach; run-on-startup ist standardmäßig aus, damit ein verpasster Termin die Kompaktierung nicht beim Systemstart auslöst. Ein manuell ohne Wartungsfenster gestarteter Lauf scheitert mit der Voraussetzungsmeldung. Die Demo-Anwendung registriert den Task deaktiviert zum manuellen Auslösen.

Tests

TestHistoryCompaction (AbstractDBKnowledgeBaseTest, mit Branches): Objekte mit mehreren Versionen, vor dem Schnitt gelöschte Objekte, historische und gemischte Pins (monomorph, polymorph mit Untertyp, branch-global), Branch; nach der Kompaktierung: aktueller Stand und Stand zu C` unverändert, Revisionen und Zeilen unterhalb `C gelöscht, Erzeugungsrevision C`, überlebende Pins auf `C, ins Leere zeigende Pins geleert und null, Branch-Revisionen angehoben, XRef für C` (auch für einen nur in Flex-Attributen geänderten Typ), Revision `C als System-Commit, zweiter Lauf leer, Trockenlauf gleich dem echten Lauf, kleines Löschfenster, Bereichsform mit Y > 0, Stichtagsauflösung. Manuell verifiziert in der Demo-Anwendung: Analyse, Voraussetzungsfehler ohne Wartungsfenster, echte Kompaktierung mit Neustart und erneuter Anmeldung, leerer zweiter Lauf, manuell ausgelöster Task.

Grenzen
  • Von Anwendungen als einfache Zahl gespeicherte Revisionsnummern < C können nicht umgeschrieben werden.
  • Andere Cluster-Knoten werden nicht neu gestartet; die Operation verweigert den Lauf, solange sie aktiv sind.
  • Das gezielte Purge gelöschter Objekte (#29603) ist nicht enthalten; nur ItemTables ist gemeinsam.
  • Lokal wurde nur H2 getestet; die neuen Statements (IN-Mengen, Batch-Update, INSERT ... SELECT DISTINCT mit Literalen, count) sind auf Oracle/PostgreSQL/MySQL/MSSQL nicht ausgeführt worden.
  • Get Started
  • Github
  • Discord
  • Das Unternehmen hinter TopLogic
  • Softwareentwicklung heute
  • Kontakt

© Copyright – Business Operation Systems GmbH

  • top-logic.com
  • Nutzungsbedingungen
  • Impressum
  • Rechtlicher Hinweis
  • Datenschutz
  • EN
  • Login