__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== Version 5.2.0.20260209 ==
* Verwendung der aktuellen [[Releasenotes_2025_OS.Softwarefactory|Softwarefactory 5.2.0-20250801]]

* Berichtanzeige
** Fix: Probleme bei der Berichtsanzeige mit schneller Klickfolge in Auswahltabelle behoben.

* Kassenschluss:
** Fix: <code>determineCloseExpectation</code> - Sortierung von CashPaymentTermData nach traceNumber absteigend, um den letzten Eintrag zu erhalten

* Kassenentsorgung:
** Neues Systemprodukt "fee" aktiviert

* Datenmodell:
** Einige Entitäten auf <code>cacheable=false</code> gesetzt
** Entitäten mit escaped Spaltennamen aktualisiert
** Generierte Entitäten und DTOs aktualisiert
** Entitäten mit neuem Service Framework aktualisiert

* Kassiervorgang:
** Fix: <code>canUnparkSelected</code> - Ablehnung eines Slips mit Zahlungen an einer SiS-Kasse
** Fix: PRINT_SLIP - <code>onOK</code> verlässt nicht, wenn Slip änderbar ist
** Neue Eingabeaktion für MODIFY_FLD, setzt <code>cashposiupdate</code> auf ausgewählte Position

* Archivierung:
** <code>archivDescription xml-os</code> für XML-Format der Beschreibungsdatei für Archiv hinzugefügt

2025-10-28T08:14:45Z

Mollik: /* nächste Version */

__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== nächste Version ==

* Datenbankverbindung
** für Verbindungen zu Datenbanken kann konfiguriert werden, ob das NULL Datum ( 28.02.1700 ) beim Einlesen aus der Datenbank als NULL oder als 28.02.1700 behandelt wird. Die Einstellung erfolgt über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "NULL-DATE-CONVERSION-xxxxx". Für Oracledatenbanken ist der default true, für alle anderen false. Ziel ist die Kompatibilität mit Compex Commerce Datenbeständen.
** die Aktualisierung der Datenbankstruktur nach Initialisierung der Persistenceunit kann über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "DDL-GENERATION-xxxx" für jede Persistenceunit ein/ausgeschaltet werden. Default ist eingeschaltet. Der Schalter wirkt nur, wenn die Aktualisierung der Datenbankstruktur in den Preferences eingeschaltet ist.
* Systemmonitoring
** neue Monitoringfunktionalität: es kann die CPU Last überwacht werden. CPU-intenisive Threads werden im Systemmonitor festgehalten. Die Einträge erfolgen parallel zum "MemoryMonitor" unter "CPUMonitor". Der Monitor kann in der Systemkonfiguration konfiguriert werden:
*** Aktivierung: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "enabled" als Ja/Neon Wert. Default: true.
*** Einstellung des Prüfintervalls: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "checkIntervalMs" als ganzzahliger Wert in Millisekunden. Default: 50.
*** Einstellung der Warnschwelle: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "cpuThresholdPercent" als ganzzahliger Wert in Prozent. Default: 2000, entspricht 2 Sekunden.
*** Ignorieren von wartenden Threads: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "skipWaitingThread" als ja/nein Wert. Default: wahr, entspricht "Haken gesetzt"
[[File:/documentation/images/8/8c/ThreadCPUMonitorKonfiguration.PNG]]

== Version 5.2.0-20251010 ==

* Entity:
** Verbesserung bei Verwendung von sequences in multitenant Tabellen
** Erweiterung der Suchmöglichkeiten in Referenzfeldern, Anpassung an Suche in Compex Commerce:
*** Eingabe Suchstring '''"a"''': Suche in Domainkey mit '''"%a%"'''
*** Eingabe von '''"a,"''': Suche mit '''"a%"'''
*** Eingabe von '''"a,b"''': Suche mit '''"a% und %b%"'''
*** Eingabe von '''",b"''': Suche mit '''"%b%"'''
*** Einagbe von '''",a,b"''': Siche mit '''"%a% und %b%"'''

== Version 5.2.0-20250806 ==

* Monitoring:
** Spaltenlängen der DK Spalten in MonitoringCategory und MonitoringSubCategory korrigiert. Es kann notwendig sein, die tables zu löschen, damit die Änderung wirksam wird. Dazu MONITORING_DETAIL, MONITORING_SUBCATEGORY, MONITORING_CATEGORY in dieser Reihenfolge löschen und den Dienst neu starten.
* Report:
** Logausgaben in RuntimeBaseReport ergänzt um Sessionobjekt und Benutzernamen

== Version 5.2.0-20250730 ==

* Grid:
** Verbesserung interner Abläufe bei Selektion eines Datensatzes
** Fix fehlende Tabellenüberschrift beim initialen Öffnen. Neugenerierung mit aktueller Softwarefactory erforderlich.
* Dialog:
** Verbesserung des internen Ablaufs bei Selektion im Fall von multitenancy. Keine Änderung bei bisheriger Verarbeitung.
* Entity:
** Erweiterung für Verwendung von Referenzen über andere als UUID / ID Felder
* Datainterchange:
** Fix für ungültige Pfadnamen. In Windows wurde / nicht als Verzeichnistrenner betrachtet. Dies resultierte in einer Endlosinitialisierung der Watcher Threads.

== Version 5.2.0-20250623 ==

* Fix OSBPServiceAddon:
** java.lang.ArrayIndexOutOfBoundsException: 1 at org.eclipse.osbp.vaaclipse.addons.softwarefactory.service.OSBPServiceAddon$3.run(OSBPServiceAddon.java:341) bei Ausgabe einer Meldung für den Benutzer. Kann zu Abbruch eines DB commit führen
* Fix sessionManager:
** die Verwaltung der transactionHandler wurde für Sessions und batch Betrieb vereinheitlicht. Gleichzeitig wurde der zu durchlaufende Code reduziert, so dass sich ein minimaler Geschwindigkeitsvorteil ergibt.
* Fix AbstractDtoService:
** doppelter Aufruf von transactionBegin bei update(...) entfernt. Es wurde ein TransactionHandler erzeugt, der durch den 2. Aufruf sofort überschrieben wurde. Es ergibt sich ein minimaler Geschwindigkeitsvorteil.
** Vereinheitlichung der update/delete Aufrufe. Doppelimplementierungen zusammengeführt

== Version 5.2.0-V20250604 ==

* Entity-Modellierung:
** Spaltenlängendefinition über Property z.B. name="length" value="20"
* Statemachine-Laufzeit:
** Einführung des Konfigurationsschalters "ApplicationContext" / "statemachineFireAsync-DataControl" mit Defaultwert "true" Mit dem Schalter kann der Ablauf der Statemachine von asynchroner Dateneventverarbeitung ( default, wie bisher ) auf synchrone Eventberarbeitung umgestellt werden.
** Einführung des Konfigurationsschalters "ApplicationContext" / "abstractStatemachine-ProcessEventInQueue" mit Defaultwert "true" Mit den Schalter kann der Ablauf der Statemachine Eventverarbeitung von asynchron ( default ) auf synchron umgestellt werden. Bei synchroner Verarbeitung wirkt die Verarbeitung von Tastatureingaben unter Umständen blockierend auf das Frontend, was die Reaktion der Anwendung auf Benutzereingaben verlangsamen kann.
* Postupdateservice:
** Entfernung des Servicebindings für den Persistenceservice, stattdessen Benutzung von PersistenceServiceBinder.waitForPersistenceService() zur Prüfung, ob der PersistenceService verfügbar ist. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Datainterchange:
** beim Start wird nun auf den PersistenceService gewartet, nicht nur auf den ConfgurationService. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Mandantenfähigkeit:
** Korrektur bei der Berechnung der verwendeten Tenants

== Version 5.2.0-V20250526 ==

* Grid:
** erster neu erstellter Satz in einem leeren Grid wird nun sofort angezeigt
** in einem "scroll to Bottom" Grid wird nicht gescrollt, wenn eine Zeile markiert ist.

== Version 5.2.0-V202504 ==

* '''Mandantenfähigkeit (multitenancy)''': Mit der Softwarefactory besteht nun die Möglichkeit, Anwendungen so zu bauen, dass diese Mandantenfähig sind. Die Mandantenfähigkeit wird auf Basis von mandantenspezifischen Tabellen implementiert. Dies kann durch zwei unterschiedliche Verfahren erreicht werden: mandantenbezogene Tabellennamen oder Schemata. Für die Benutzer der Anwendung wird dann bei der Anmeldung festgelegt, für welchen Mandanten die Anmeldung erfolgt. Dazu werden die zulässigen Mandanten für den Benutzer in der Benutzerverwaltung hinterlegt. 
** '''Erweiterung org.eclipse.osbp.production.prefs''': Für die Persistenceunit kann angegeben werden, welche Tenants verwendet werden. z.B.<syntaxhighlight>persistenceUnit/businessdata/tenants=COMPEX,COMPEX_001,COMPEX_002</syntaxhighlight> 
** '''Erweiterung entity Modell''': es gibt neue Schlüsselworte <syntaxhighlight lang="java"> multitenant [ tableBased | schemaBased ] entity { ... } </syntaxhighlight>Hierdurch wird grundsätzlich die mulitenancy eingeschaltet und der Typ festgelegt. 
** '''Erweiterung Systemkonfiguration''': für jede multitenant Tabelle wird in der Systemkonfiguration ein String-Parameter eingetragen. Gruppe '''Multitenancy''', Schlüssel '''eclipselink.tenant-id.<tablename>'''. Wert: #TENANT#. Mit #TENANT# wird festgelegt, dass die Tabelle mandantenabhängig ist. Soll immer derselbe Mandant verwendet werden, so muss dieser hier eingetragen werden. Die Anwendung muss einmal gestartet werden, um die Einträge anzulegen. Dann können die Einstellungen verändert werden. Nach einer Änderung ist ein Neustart der Anwendung notwendig. 
** '''Erweiterung Benutzerkonfiguration''': Einem Benutzer oder einer Benutzergruppe kann nun ein Tenant oder mehrere Tenants zugeordnet werden, für die der Benutzer berechtigt ist. Damit wird der Benutzer einem oder mehreren Mandanten zugeordnet. 
** '''Erweiterung Datenaustausch''':
*** '''Export''' durch zeitgesteuerte Jobs: Für jeden definierten Tenant wird ein eigener Job konfiguriert. Dazu wird der Tenant in der Jobkonfiguration eingetragen. 
*** '''Import''': Für jeden Tenant wird ein eigener Import Watcher erzeugt. Das für den Tenant verwendete Importverzeichnis ergibt sich aus dem Importverzeichnis + "/#TENANT#. #TENANT# wird durch die konfigurierten Tenants ersetzt. z.B. '''C:\OS.pos\import\COMPEX_001''' und '''C:\OS.pos\import\COMPEX_001'''. 
** '''Erweiterung Login''': beim Login wird für den Fall, dass für einen Benutzer mehrere Tenants konfiguriert sind, eine Auswahlbox für den zu verwendenden Tenant eingeblendet. Falls nur ein Tenant zugeordnet ist, wird dieser automatisch verwendet. 

* '''Änderung bei Anwendungsstart''': die Initialisierung der persistenceUnit "configurationData" wird vor allen anderen ausgeführt, damit die weiteren Initialisierungen auf die Systemkonfiguration zugreifen können. Nach dem ersten Systemstart können die zu verwendenden Tenants in der Systemkonfiguration eingestellt werden. Die Anwendung muss dann nochmals gestartet werden.

* '''Änderung bei Benutzerlogin''': auf dem Loginschirm wird, sofern Tenants verwendet werden, bei einem Benutzer, der für mehr als einen Tenant berechtigt ist, eine Auswahlbox für die berechtigten Tenants angeboten. Vor dem Login kann der entsprechende Tenant ausgewählt werden.

== Version 5.1.0-V20250201 ==

* Berichte:
** Verhindern der Berichtsanzeige, wenn eine Auswahl in einer Tabelle erwartet wird, diese jedoch nicht vorliegt.

File:ThreadCPUMonitorKonfiguration.PNG

2025-10-28T08:13:46Z

Mollik:

Releasenotes 2025 OS.Softwarefactory

2025-10-28T08:12:23Z

Mollik: /* nächste Version */

__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== nächste Version ==

* Datenbankverbindung
** für Verbindungen zu Datenbanken kann konfiguriert werden, ob das NULL Datum ( 28.02.1700 ) beim Einlesen aus der Datenbank als NULL oder als 28.02.1700 behandelt wird. Die Einstellung erfolgt über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "NULL-DATE-CONVERSION-xxxxx". Für Oracledatenbanken ist der default true, für alle anderen false. Ziel ist die Kompatibilität mit Compex Commerce Datenbeständen.
** die Aktualisierung der Datenbankstruktur nach Initialisierung der Persistenceunit kann über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "DDL-GENERATION-xxxx" für jede Persistenceunit ein/ausgeschaltet werden. Default ist eingeschaltet. Der Schalter wirkt nur, wenn die Aktualisierung der Datenbankstruktur in den Preferences eingeschaltet ist.
* Systemmonitoring
** neue Monitoringfunktionalität: es kann die CPU Last überwacht werden. CPU-intenisive Threads werden im Systemmonitor festgehalten. Die Einträge erfolgen parallel zum "MemoryMonitor" unter "CPUMonitor". Der Monitor kann in der Systemkonfiguration konfiguriert werden:
*** Aktivierung: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "enabled" als Ja/Neon Wert. Default: true.
*** Einstellung des Prüfintervalls: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "checkIntervalMs" als ganzzahliger Wert in Millisekunden. Default: 50.
*** Einstellung der Warnschwelle: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "cpuThresholdPercent" als ganzzahliger Wert in Prozent. Default: 2000, entspricht 2 Sekunden.
*** Ignorieren von wartenden Threads: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "skipWaitingThread" als ja/nein Wert. Default: wahr, entspricht "Haken gesetzt"

== Version 5.2.0-20251010 ==

* Entity:
** Verbesserung bei Verwendung von sequences in multitenant Tabellen
** Erweiterung der Suchmöglichkeiten in Referenzfeldern, Anpassung an Suche in Compex Commerce:
*** Eingabe Suchstring '''"a"''': Suche in Domainkey mit '''"%a%"'''
*** Eingabe von '''"a,"''': Suche mit '''"a%"'''
*** Eingabe von '''"a,b"''': Suche mit '''"a% und %b%"'''
*** Eingabe von '''",b"''': Suche mit '''"%b%"'''
*** Einagbe von '''",a,b"''': Siche mit '''"%a% und %b%"'''

== Version 5.2.0-20250806 ==

* Monitoring:
** Spaltenlängen der DK Spalten in MonitoringCategory und MonitoringSubCategory korrigiert. Es kann notwendig sein, die tables zu löschen, damit die Änderung wirksam wird. Dazu MONITORING_DETAIL, MONITORING_SUBCATEGORY, MONITORING_CATEGORY in dieser Reihenfolge löschen und den Dienst neu starten.
* Report:
** Logausgaben in RuntimeBaseReport ergänzt um Sessionobjekt und Benutzernamen

== Version 5.2.0-20250730 ==

* Grid:
** Verbesserung interner Abläufe bei Selektion eines Datensatzes
** Fix fehlende Tabellenüberschrift beim initialen Öffnen. Neugenerierung mit aktueller Softwarefactory erforderlich.
* Dialog:
** Verbesserung des internen Ablaufs bei Selektion im Fall von multitenancy. Keine Änderung bei bisheriger Verarbeitung.
* Entity:
** Erweiterung für Verwendung von Referenzen über andere als UUID / ID Felder
* Datainterchange:
** Fix für ungültige Pfadnamen. In Windows wurde / nicht als Verzeichnistrenner betrachtet. Dies resultierte in einer Endlosinitialisierung der Watcher Threads.

== Version 5.2.0-20250623 ==

* Fix OSBPServiceAddon:
** java.lang.ArrayIndexOutOfBoundsException: 1 at org.eclipse.osbp.vaaclipse.addons.softwarefactory.service.OSBPServiceAddon$3.run(OSBPServiceAddon.java:341) bei Ausgabe einer Meldung für den Benutzer. Kann zu Abbruch eines DB commit führen
* Fix sessionManager:
** die Verwaltung der transactionHandler wurde für Sessions und batch Betrieb vereinheitlicht. Gleichzeitig wurde der zu durchlaufende Code reduziert, so dass sich ein minimaler Geschwindigkeitsvorteil ergibt.
* Fix AbstractDtoService:
** doppelter Aufruf von transactionBegin bei update(...) entfernt. Es wurde ein TransactionHandler erzeugt, der durch den 2. Aufruf sofort überschrieben wurde. Es ergibt sich ein minimaler Geschwindigkeitsvorteil.
** Vereinheitlichung der update/delete Aufrufe. Doppelimplementierungen zusammengeführt

== Version 5.2.0-V20250604 ==

* Entity-Modellierung:
** Spaltenlängendefinition über Property z.B. name="length" value="20"
* Statemachine-Laufzeit:
** Einführung des Konfigurationsschalters "ApplicationContext" / "statemachineFireAsync-DataControl" mit Defaultwert "true" Mit dem Schalter kann der Ablauf der Statemachine von asynchroner Dateneventverarbeitung ( default, wie bisher ) auf synchrone Eventberarbeitung umgestellt werden.
** Einführung des Konfigurationsschalters "ApplicationContext" / "abstractStatemachine-ProcessEventInQueue" mit Defaultwert "true" Mit den Schalter kann der Ablauf der Statemachine Eventverarbeitung von asynchron ( default ) auf synchron umgestellt werden. Bei synchroner Verarbeitung wirkt die Verarbeitung von Tastatureingaben unter Umständen blockierend auf das Frontend, was die Reaktion der Anwendung auf Benutzereingaben verlangsamen kann.
* Postupdateservice:
** Entfernung des Servicebindings für den Persistenceservice, stattdessen Benutzung von PersistenceServiceBinder.waitForPersistenceService() zur Prüfung, ob der PersistenceService verfügbar ist. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Datainterchange:
** beim Start wird nun auf den PersistenceService gewartet, nicht nur auf den ConfgurationService. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Mandantenfähigkeit:
** Korrektur bei der Berechnung der verwendeten Tenants

== Version 5.2.0-V20250526 ==

* Grid:
** erster neu erstellter Satz in einem leeren Grid wird nun sofort angezeigt
** in einem "scroll to Bottom" Grid wird nicht gescrollt, wenn eine Zeile markiert ist.

== Version 5.2.0-V202504 ==

* '''Mandantenfähigkeit (multitenancy)''': Mit der Softwarefactory besteht nun die Möglichkeit, Anwendungen so zu bauen, dass diese Mandantenfähig sind. Die Mandantenfähigkeit wird auf Basis von mandantenspezifischen Tabellen implementiert. Dies kann durch zwei unterschiedliche Verfahren erreicht werden: mandantenbezogene Tabellennamen oder Schemata. Für die Benutzer der Anwendung wird dann bei der Anmeldung festgelegt, für welchen Mandanten die Anmeldung erfolgt. Dazu werden die zulässigen Mandanten für den Benutzer in der Benutzerverwaltung hinterlegt. 
** '''Erweiterung org.eclipse.osbp.production.prefs''': Für die Persistenceunit kann angegeben werden, welche Tenants verwendet werden. z.B.<syntaxhighlight>persistenceUnit/businessdata/tenants=COMPEX,COMPEX_001,COMPEX_002</syntaxhighlight> 
** '''Erweiterung entity Modell''': es gibt neue Schlüsselworte <syntaxhighlight lang="java"> multitenant [ tableBased | schemaBased ] entity { ... } </syntaxhighlight>Hierdurch wird grundsätzlich die mulitenancy eingeschaltet und der Typ festgelegt. 
** '''Erweiterung Systemkonfiguration''': für jede multitenant Tabelle wird in der Systemkonfiguration ein String-Parameter eingetragen. Gruppe '''Multitenancy''', Schlüssel '''eclipselink.tenant-id.<tablename>'''. Wert: #TENANT#. Mit #TENANT# wird festgelegt, dass die Tabelle mandantenabhängig ist. Soll immer derselbe Mandant verwendet werden, so muss dieser hier eingetragen werden. Die Anwendung muss einmal gestartet werden, um die Einträge anzulegen. Dann können die Einstellungen verändert werden. Nach einer Änderung ist ein Neustart der Anwendung notwendig. 
** '''Erweiterung Benutzerkonfiguration''': Einem Benutzer oder einer Benutzergruppe kann nun ein Tenant oder mehrere Tenants zugeordnet werden, für die der Benutzer berechtigt ist. Damit wird der Benutzer einem oder mehreren Mandanten zugeordnet. 
** '''Erweiterung Datenaustausch''':
*** '''Export''' durch zeitgesteuerte Jobs: Für jeden definierten Tenant wird ein eigener Job konfiguriert. Dazu wird der Tenant in der Jobkonfiguration eingetragen. 
*** '''Import''': Für jeden Tenant wird ein eigener Import Watcher erzeugt. Das für den Tenant verwendete Importverzeichnis ergibt sich aus dem Importverzeichnis + "/#TENANT#. #TENANT# wird durch die konfigurierten Tenants ersetzt. z.B. '''C:\OS.pos\import\COMPEX_001''' und '''C:\OS.pos\import\COMPEX_001'''. 
** '''Erweiterung Login''': beim Login wird für den Fall, dass für einen Benutzer mehrere Tenants konfiguriert sind, eine Auswahlbox für den zu verwendenden Tenant eingeblendet. Falls nur ein Tenant zugeordnet ist, wird dieser automatisch verwendet. 

* '''Änderung bei Anwendungsstart''': die Initialisierung der persistenceUnit "configurationData" wird vor allen anderen ausgeführt, damit die weiteren Initialisierungen auf die Systemkonfiguration zugreifen können. Nach dem ersten Systemstart können die zu verwendenden Tenants in der Systemkonfiguration eingestellt werden. Die Anwendung muss dann nochmals gestartet werden.

* '''Änderung bei Benutzerlogin''': auf dem Loginschirm wird, sofern Tenants verwendet werden, bei einem Benutzer, der für mehr als einen Tenant berechtigt ist, eine Auswahlbox für die berechtigten Tenants angeboten. Vor dem Login kann der entsprechende Tenant ausgewählt werden.

== Version 5.1.0-V20250201 ==

* Berichte:
** Verhindern der Berichtsanzeige, wenn eine Auswahl in einer Tabelle erwartet wird, diese jedoch nicht vorliegt.

Releasenotes 2025 OS.Softwarefactory

2025-10-23T13:22:24Z

Mollik: /* nächste Version */

__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== nächste Version ==

* Datenbankverbindung
** für Verbindungen zu Datenbanken kann konfiguriert werden, ob das NULL Datum ( 28.02.1700 ) beim Einlesen aus der Datenbank als NULL oder als 28.02.1700 behandelt wird. Die Einstellung erfolgt über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "NULL-DATE-CONVERSION-xxxxx". Für Oracledatenbanken ist der default true, für alle anderen false. Ziel ist die Kompatibilität mit Compex Commerce Datenbeständen.
** die Aktualisierung der Datenbankstruktur nach Initialisierung der Persistenceunit kann über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "DDL-GENERATION-xxxx" für jede Persistenceunit ein/ausgeschaltet werden. Default ist eingeschaltet. Der Schalter wirkt nur, wenn die Aktualisierung der Datenbankstruktur in den Preferences eingeschaltet ist.
* Systemmonitoring
** neue Monitoringfunktionalität: es kann die CPU Last überwacht werden. CPU-intenisive Threads werden im Systemmonitor festgehalten. Die Einträge erfolgen parallel zum "MemoryMonitor" unter "CPUMonitor". Der Monitor kann in der Systemkonfiguration konfiguriert werden:
*** Einstellung des Prüfintervalls: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "checkIntervalMs" als ganzzahliger Wert in Millisekunden. Default: 50.
*** Einstellung der Warnschwelle: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "cpuThresholdPercent" als ganzzahliger Wert in Prozent. Default: 2000, entspricht 2 Sekunden.
*** Ignorieren von wartenden Threads: durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "skipWaitingThread" als ja/nein Wert. Default: wahr, entspricht "Haken gesetzt"

== Version 5.2.0-20251010 ==

* Entity:
** Verbesserung bei Verwendung von sequences in multitenant Tabellen
** Erweiterung der Suchmöglichkeiten in Referenzfeldern, Anpassung an Suche in Compex Commerce:
*** Eingabe Suchstring '''"a"''': Suche in Domainkey mit '''"%a%"'''
*** Eingabe von '''"a,"''': Suche mit '''"a%"'''
*** Eingabe von '''"a,b"''': Suche mit '''"a% und %b%"'''
*** Eingabe von '''",b"''': Suche mit '''"%b%"'''
*** Einagbe von '''",a,b"''': Siche mit '''"%a% und %b%"'''

== Version 5.2.0-20250806 ==

* Monitoring:
** Spaltenlängen der DK Spalten in MonitoringCategory und MonitoringSubCategory korrigiert. Es kann notwendig sein, die tables zu löschen, damit die Änderung wirksam wird. Dazu MONITORING_DETAIL, MONITORING_SUBCATEGORY, MONITORING_CATEGORY in dieser Reihenfolge löschen und den Dienst neu starten.
* Report:
** Logausgaben in RuntimeBaseReport ergänzt um Sessionobjekt und Benutzernamen

== Version 5.2.0-20250730 ==

* Grid:
** Verbesserung interner Abläufe bei Selektion eines Datensatzes
** Fix fehlende Tabellenüberschrift beim initialen Öffnen. Neugenerierung mit aktueller Softwarefactory erforderlich.
* Dialog:
** Verbesserung des internen Ablaufs bei Selektion im Fall von multitenancy. Keine Änderung bei bisheriger Verarbeitung.
* Entity:
** Erweiterung für Verwendung von Referenzen über andere als UUID / ID Felder
* Datainterchange:
** Fix für ungültige Pfadnamen. In Windows wurde / nicht als Verzeichnistrenner betrachtet. Dies resultierte in einer Endlosinitialisierung der Watcher Threads.

== Version 5.2.0-20250623 ==

* Fix OSBPServiceAddon:
** java.lang.ArrayIndexOutOfBoundsException: 1 at org.eclipse.osbp.vaaclipse.addons.softwarefactory.service.OSBPServiceAddon$3.run(OSBPServiceAddon.java:341) bei Ausgabe einer Meldung für den Benutzer. Kann zu Abbruch eines DB commit führen
* Fix sessionManager:
** die Verwaltung der transactionHandler wurde für Sessions und batch Betrieb vereinheitlicht. Gleichzeitig wurde der zu durchlaufende Code reduziert, so dass sich ein minimaler Geschwindigkeitsvorteil ergibt.
* Fix AbstractDtoService:
** doppelter Aufruf von transactionBegin bei update(...) entfernt. Es wurde ein TransactionHandler erzeugt, der durch den 2. Aufruf sofort überschrieben wurde. Es ergibt sich ein minimaler Geschwindigkeitsvorteil.
** Vereinheitlichung der update/delete Aufrufe. Doppelimplementierungen zusammengeführt

== Version 5.2.0-V20250604 ==

* Entity-Modellierung:
** Spaltenlängendefinition über Property z.B. name="length" value="20"
* Statemachine-Laufzeit:
** Einführung des Konfigurationsschalters "ApplicationContext" / "statemachineFireAsync-DataControl" mit Defaultwert "true" Mit dem Schalter kann der Ablauf der Statemachine von asynchroner Dateneventverarbeitung ( default, wie bisher ) auf synchrone Eventberarbeitung umgestellt werden.
** Einführung des Konfigurationsschalters "ApplicationContext" / "abstractStatemachine-ProcessEventInQueue" mit Defaultwert "true" Mit den Schalter kann der Ablauf der Statemachine Eventverarbeitung von asynchron ( default ) auf synchron umgestellt werden. Bei synchroner Verarbeitung wirkt die Verarbeitung von Tastatureingaben unter Umständen blockierend auf das Frontend, was die Reaktion der Anwendung auf Benutzereingaben verlangsamen kann.
* Postupdateservice:
** Entfernung des Servicebindings für den Persistenceservice, stattdessen Benutzung von PersistenceServiceBinder.waitForPersistenceService() zur Prüfung, ob der PersistenceService verfügbar ist. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Datainterchange:
** beim Start wird nun auf den PersistenceService gewartet, nicht nur auf den ConfgurationService. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Mandantenfähigkeit:
** Korrektur bei der Berechnung der verwendeten Tenants

== Version 5.2.0-V20250526 ==

* Grid:
** erster neu erstellter Satz in einem leeren Grid wird nun sofort angezeigt
** in einem "scroll to Bottom" Grid wird nicht gescrollt, wenn eine Zeile markiert ist.

== Version 5.2.0-V202504 ==

* '''Mandantenfähigkeit (multitenancy)''': Mit der Softwarefactory besteht nun die Möglichkeit, Anwendungen so zu bauen, dass diese Mandantenfähig sind. Die Mandantenfähigkeit wird auf Basis von mandantenspezifischen Tabellen implementiert. Dies kann durch zwei unterschiedliche Verfahren erreicht werden: mandantenbezogene Tabellennamen oder Schemata. Für die Benutzer der Anwendung wird dann bei der Anmeldung festgelegt, für welchen Mandanten die Anmeldung erfolgt. Dazu werden die zulässigen Mandanten für den Benutzer in der Benutzerverwaltung hinterlegt. 
** '''Erweiterung org.eclipse.osbp.production.prefs''': Für die Persistenceunit kann angegeben werden, welche Tenants verwendet werden. z.B.<syntaxhighlight>persistenceUnit/businessdata/tenants=COMPEX,COMPEX_001,COMPEX_002</syntaxhighlight> 
** '''Erweiterung entity Modell''': es gibt neue Schlüsselworte <syntaxhighlight lang="java"> multitenant [ tableBased | schemaBased ] entity { ... } </syntaxhighlight>Hierdurch wird grundsätzlich die mulitenancy eingeschaltet und der Typ festgelegt. 
** '''Erweiterung Systemkonfiguration''': für jede multitenant Tabelle wird in der Systemkonfiguration ein String-Parameter eingetragen. Gruppe '''Multitenancy''', Schlüssel '''eclipselink.tenant-id.<tablename>'''. Wert: #TENANT#. Mit #TENANT# wird festgelegt, dass die Tabelle mandantenabhängig ist. Soll immer derselbe Mandant verwendet werden, so muss dieser hier eingetragen werden. Die Anwendung muss einmal gestartet werden, um die Einträge anzulegen. Dann können die Einstellungen verändert werden. Nach einer Änderung ist ein Neustart der Anwendung notwendig. 
** '''Erweiterung Benutzerkonfiguration''': Einem Benutzer oder einer Benutzergruppe kann nun ein Tenant oder mehrere Tenants zugeordnet werden, für die der Benutzer berechtigt ist. Damit wird der Benutzer einem oder mehreren Mandanten zugeordnet. 
** '''Erweiterung Datenaustausch''':
*** '''Export''' durch zeitgesteuerte Jobs: Für jeden definierten Tenant wird ein eigener Job konfiguriert. Dazu wird der Tenant in der Jobkonfiguration eingetragen. 
*** '''Import''': Für jeden Tenant wird ein eigener Import Watcher erzeugt. Das für den Tenant verwendete Importverzeichnis ergibt sich aus dem Importverzeichnis + "/#TENANT#. #TENANT# wird durch die konfigurierten Tenants ersetzt. z.B. '''C:\OS.pos\import\COMPEX_001''' und '''C:\OS.pos\import\COMPEX_001'''. 
** '''Erweiterung Login''': beim Login wird für den Fall, dass für einen Benutzer mehrere Tenants konfiguriert sind, eine Auswahlbox für den zu verwendenden Tenant eingeblendet. Falls nur ein Tenant zugeordnet ist, wird dieser automatisch verwendet. 

* '''Änderung bei Anwendungsstart''': die Initialisierung der persistenceUnit "configurationData" wird vor allen anderen ausgeführt, damit die weiteren Initialisierungen auf die Systemkonfiguration zugreifen können. Nach dem ersten Systemstart können die zu verwendenden Tenants in der Systemkonfiguration eingestellt werden. Die Anwendung muss dann nochmals gestartet werden.

* '''Änderung bei Benutzerlogin''': auf dem Loginschirm wird, sofern Tenants verwendet werden, bei einem Benutzer, der für mehr als einen Tenant berechtigt ist, eine Auswahlbox für die berechtigten Tenants angeboten. Vor dem Login kann der entsprechende Tenant ausgewählt werden.

== Version 5.1.0-V20250201 ==

* Berichte:
** Verhindern der Berichtsanzeige, wenn eine Auswahl in einer Tabelle erwartet wird, diese jedoch nicht vorliegt.

Releasenotes 2025 OS.Softwarefactory

2025-10-23T12:19:00Z

Mollik: /* nächste Version */

__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== nächste Version ==

* Datenbankverbindung
** für Verbindungen zu Datenbanken kann konfiguriert werden, ob das NULL Datum ( 28.02.1700 ) beim Einlesen aus der Datenbank als NULL oder als 28.02.1700 behandelt wird. Die Einstellung erfolgt über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "NULL-DATE-CONVERSION-xxxxx". Für Oracledatenbanken ist der default true, für alle anderen false. Ziel ist die Kompatibilität mit Compex Commerce Datenbeständen.
** die Aktualisierung der Datenbankstruktur nach Initialisierung der Persistenceunit kann über die Systemkonfiguration mit der Parametergruppe "GLOBAL_PARAMETERS" und dem Parameter "DDL-GENERATION-xxxx" für jede Persistenceunit ein/ausgeschaltet werden. Default ist eingeschaltet. Der Schalter wirkt nur, wenn die Aktualisierung der Datenbankstruktur in den Preferences eingeschaltet ist.
* Systemmonitoring
** neue Monitoringfunktionalität: es kann die CPU Last überwacht werden. CPU-intenisive Threads werden im Systemmonitor festgehalten. Die Einträge erfolgen parallel zum "MemoryMonitor" unter "CPUMonitor". Der Monitor kann konfiguriert werden:
*** Einstellung des Prüfintervalls in der Systemkonfiguration durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "checkIntervalMs" als ganzzahliger Wert in Millisekunden. Default: 50.
*** Einstellung der Warnschwelle in der Systemkonfiguration durch Anpassung des Wertes Gruppe "ThreadCpuMonitor", Wert "cpuThresholdPercent" als ganzzahliger Wert in Prozent. Default: 2000, entspricht 2 Sekunden.

== Version 5.2.0-20251010 ==

* Entity:
** Verbesserung bei Verwendung von sequences in multitenant Tabellen
** Erweiterung der Suchmöglichkeiten in Referenzfeldern, Anpassung an Suche in Compex Commerce:
*** Eingabe Suchstring '''"a"''': Suche in Domainkey mit '''"%a%"'''
*** Eingabe von '''"a,"''': Suche mit '''"a%"'''
*** Eingabe von '''"a,b"''': Suche mit '''"a% und %b%"'''
*** Eingabe von '''",b"''': Suche mit '''"%b%"'''
*** Einagbe von '''",a,b"''': Siche mit '''"%a% und %b%"'''

== Version 5.2.0-20250806 ==

* Monitoring:
** Spaltenlängen der DK Spalten in MonitoringCategory und MonitoringSubCategory korrigiert. Es kann notwendig sein, die tables zu löschen, damit die Änderung wirksam wird. Dazu MONITORING_DETAIL, MONITORING_SUBCATEGORY, MONITORING_CATEGORY in dieser Reihenfolge löschen und den Dienst neu starten.
* Report:
** Logausgaben in RuntimeBaseReport ergänzt um Sessionobjekt und Benutzernamen

== Version 5.2.0-20250730 ==

* Grid:
** Verbesserung interner Abläufe bei Selektion eines Datensatzes
** Fix fehlende Tabellenüberschrift beim initialen Öffnen. Neugenerierung mit aktueller Softwarefactory erforderlich.
* Dialog:
** Verbesserung des internen Ablaufs bei Selektion im Fall von multitenancy. Keine Änderung bei bisheriger Verarbeitung.
* Entity:
** Erweiterung für Verwendung von Referenzen über andere als UUID / ID Felder
* Datainterchange:
** Fix für ungültige Pfadnamen. In Windows wurde / nicht als Verzeichnistrenner betrachtet. Dies resultierte in einer Endlosinitialisierung der Watcher Threads.

== Version 5.2.0-20250623 ==

* Fix OSBPServiceAddon:
** java.lang.ArrayIndexOutOfBoundsException: 1 at org.eclipse.osbp.vaaclipse.addons.softwarefactory.service.OSBPServiceAddon$3.run(OSBPServiceAddon.java:341) bei Ausgabe einer Meldung für den Benutzer. Kann zu Abbruch eines DB commit führen
* Fix sessionManager:
** die Verwaltung der transactionHandler wurde für Sessions und batch Betrieb vereinheitlicht. Gleichzeitig wurde der zu durchlaufende Code reduziert, so dass sich ein minimaler Geschwindigkeitsvorteil ergibt.
* Fix AbstractDtoService:
** doppelter Aufruf von transactionBegin bei update(...) entfernt. Es wurde ein TransactionHandler erzeugt, der durch den 2. Aufruf sofort überschrieben wurde. Es ergibt sich ein minimaler Geschwindigkeitsvorteil.
** Vereinheitlichung der update/delete Aufrufe. Doppelimplementierungen zusammengeführt

== Version 5.2.0-V20250604 ==

* Entity-Modellierung:
** Spaltenlängendefinition über Property z.B. name="length" value="20"
* Statemachine-Laufzeit:
** Einführung des Konfigurationsschalters "ApplicationContext" / "statemachineFireAsync-DataControl" mit Defaultwert "true" Mit dem Schalter kann der Ablauf der Statemachine von asynchroner Dateneventverarbeitung ( default, wie bisher ) auf synchrone Eventberarbeitung umgestellt werden.
** Einführung des Konfigurationsschalters "ApplicationContext" / "abstractStatemachine-ProcessEventInQueue" mit Defaultwert "true" Mit den Schalter kann der Ablauf der Statemachine Eventverarbeitung von asynchron ( default ) auf synchron umgestellt werden. Bei synchroner Verarbeitung wirkt die Verarbeitung von Tastatureingaben unter Umständen blockierend auf das Frontend, was die Reaktion der Anwendung auf Benutzereingaben verlangsamen kann.
* Postupdateservice:
** Entfernung des Servicebindings für den Persistenceservice, stattdessen Benutzung von PersistenceServiceBinder.waitForPersistenceService() zur Prüfung, ob der PersistenceService verfügbar ist. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Datainterchange:
** beim Start wird nun auf den PersistenceService gewartet, nicht nur auf den ConfgurationService. Ziel: Vermeidung von Deadlock Situationen beim Anwendungsstart
* Mandantenfähigkeit:
** Korrektur bei der Berechnung der verwendeten Tenants

== Version 5.2.0-V20250526 ==

* Grid:
** erster neu erstellter Satz in einem leeren Grid wird nun sofort angezeigt
** in einem "scroll to Bottom" Grid wird nicht gescrollt, wenn eine Zeile markiert ist.

== Version 5.2.0-V202504 ==

* '''Mandantenfähigkeit (multitenancy)''': Mit der Softwarefactory besteht nun die Möglichkeit, Anwendungen so zu bauen, dass diese Mandantenfähig sind. Die Mandantenfähigkeit wird auf Basis von mandantenspezifischen Tabellen implementiert. Dies kann durch zwei unterschiedliche Verfahren erreicht werden: mandantenbezogene Tabellennamen oder Schemata. Für die Benutzer der Anwendung wird dann bei der Anmeldung festgelegt, für welchen Mandanten die Anmeldung erfolgt. Dazu werden die zulässigen Mandanten für den Benutzer in der Benutzerverwaltung hinterlegt. 
** '''Erweiterung org.eclipse.osbp.production.prefs''': Für die Persistenceunit kann angegeben werden, welche Tenants verwendet werden. z.B.<syntaxhighlight>persistenceUnit/businessdata/tenants=COMPEX,COMPEX_001,COMPEX_002</syntaxhighlight> 
** '''Erweiterung entity Modell''': es gibt neue Schlüsselworte <syntaxhighlight lang="java"> multitenant [ tableBased | schemaBased ] entity { ... } </syntaxhighlight>Hierdurch wird grundsätzlich die mulitenancy eingeschaltet und der Typ festgelegt. 
** '''Erweiterung Systemkonfiguration''': für jede multitenant Tabelle wird in der Systemkonfiguration ein String-Parameter eingetragen. Gruppe '''Multitenancy''', Schlüssel '''eclipselink.tenant-id.<tablename>'''. Wert: #TENANT#. Mit #TENANT# wird festgelegt, dass die Tabelle mandantenabhängig ist. Soll immer derselbe Mandant verwendet werden, so muss dieser hier eingetragen werden. Die Anwendung muss einmal gestartet werden, um die Einträge anzulegen. Dann können die Einstellungen verändert werden. Nach einer Änderung ist ein Neustart der Anwendung notwendig. 
** '''Erweiterung Benutzerkonfiguration''': Einem Benutzer oder einer Benutzergruppe kann nun ein Tenant oder mehrere Tenants zugeordnet werden, für die der Benutzer berechtigt ist. Damit wird der Benutzer einem oder mehreren Mandanten zugeordnet. 
** '''Erweiterung Datenaustausch''':
*** '''Export''' durch zeitgesteuerte Jobs: Für jeden definierten Tenant wird ein eigener Job konfiguriert. Dazu wird der Tenant in der Jobkonfiguration eingetragen. 
*** '''Import''': Für jeden Tenant wird ein eigener Import Watcher erzeugt. Das für den Tenant verwendete Importverzeichnis ergibt sich aus dem Importverzeichnis + "/#TENANT#. #TENANT# wird durch die konfigurierten Tenants ersetzt. z.B. '''C:\OS.pos\import\COMPEX_001''' und '''C:\OS.pos\import\COMPEX_001'''. 
** '''Erweiterung Login''': beim Login wird für den Fall, dass für einen Benutzer mehrere Tenants konfiguriert sind, eine Auswahlbox für den zu verwendenden Tenant eingeblendet. Falls nur ein Tenant zugeordnet ist, wird dieser automatisch verwendet. 

* '''Änderung bei Anwendungsstart''': die Initialisierung der persistenceUnit "configurationData" wird vor allen anderen ausgeführt, damit die weiteren Initialisierungen auf die Systemkonfiguration zugreifen können. Nach dem ersten Systemstart können die zu verwendenden Tenants in der Systemkonfiguration eingestellt werden. Die Anwendung muss dann nochmals gestartet werden.

* '''Änderung bei Benutzerlogin''': auf dem Loginschirm wird, sofern Tenants verwendet werden, bei einem Benutzer, der für mehr als einen Tenant berechtigt ist, eine Auswahlbox für die berechtigten Tenants angeboten. Vor dem Login kann der entsprechende Tenant ausgewählt werden.

== Version 5.1.0-V20250201 ==

* Berichte:
** Verhindern der Berichtsanzeige, wenn eine Auswahl in einer Tabelle erwartet wird, diese jedoch nicht vorliegt.

Releasenotes 2025 OS.setup

2025-10-17T14:47:56Z

Mollik: /* Setup für OS.app vom 09.09.2025 */

__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== Setup für OS.app vom 17.10.2025 ==

* Korrektur für Linux Setup bei der Paketprüfung

== Setup für OS.app vom 09.09.2025 ==

* Korrektur für Windows Setup bei der Paketprüfung
* Korrektur bei der Erstellung der Konfigurationsdateien

== Setup für OS.app vom 04.08.2025 ==

* erste Version des neuen Setup. Es steht nun dieselbe Funktionalität auf Windows und auf Linux zur Verfügung. Das setup ist von der kundenspezifischen Seite http://helpdesk.compex.de/products/cst/xxxxx herunterladbar. Eine Beschreibung befindet sich ebenfalls dort. Der Zugriff kann nur über den Kunden-VPN-Tunnel erfolgen.

== Installation von Java ==

* wir empfehlen die Verwendung von Eclipse Temurin. Java 8 ist die notwendige Version
* für SLES bitte zuerst das Repo hinzufügen, dann temurin-8-jdk installieren. Siehe [https://adoptium.net/de/installation/linux#opensusesles-instructions temurin auf SLES Installationsanleitung]
* für Windows kann eine Version hier [https://adoptium.net/de/temurin/releases?version=8&os=any&arch=any Adopium Temurin 8] heruntergeladen werden.

Releasenotes 2025 OS.setup

2025-10-17T14:47:44Z

Mollik:

__TOC__

== [[Releasenotes | --> zurück zu Releasenotes ]] ==

== Setup für OS.app vom 09.09.2025 ==

* Korrektur für Linux Setup bei der Paketprüfung

== Setup für OS.app vom 09.09.2025 ==

* Korrektur für Windows Setup bei der Paketprüfung
* Korrektur bei der Erstellung der Konfigurationsdateien

== Setup für OS.app vom 04.08.2025 ==

* erste Version des neuen Setup. Es steht nun dieselbe Funktionalität auf Windows und auf Linux zur Verfügung. Das setup ist von der kundenspezifischen Seite http://helpdesk.compex.de/products/cst/xxxxx herunterladbar. Eine Beschreibung befindet sich ebenfalls dort. Der Zugriff kann nur über den Kunden-VPN-Tunnel erfolgen.

== Installation von Java ==

* wir empfehlen die Verwendung von Eclipse Temurin. Java 8 ist die notwendige Version
* für SLES bitte zuerst das Repo hinzufügen, dann temurin-8-jdk installieren. Siehe [https://adoptium.net/de/installation/linux#opensusesles-instructions temurin auf SLES Installationsanleitung]
* für Windows kann eine Version hier [https://adoptium.net/de/temurin/releases?version=8&os=any&arch=any Adopium Temurin 8] heruntergeladen werden.