OS.bee documentation - User contributions [en]

Releasenotes

2023-03-07T10:00:31Z

Kraeling: /* Version 4.5.7-V20230306 */

== nächste Version ==

== Version 4.5.7-V20230307 ==

=== OS.pos ===
* EC-Terminal: Wiederholdruck des Kassenschnitts wieder funktionsfähig gemacht
* EC-Terminal: Sicherstellung, dass auch nach Schließen und Neuöffnen des Browsers das EC-Terminal ansteuerbar bleibt

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens von Positionen mit stornierter Epay-Transaktion
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Terminal-Kommunikation verbessert

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn ein Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager, wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französischen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-03-07T10:00:08Z

Kraeling: /* nächste Version */

== nächste Version ==

== Version 4.5.7-V20230307 ==

=== OS.pos ===
* EC-Terminal: Wiederholdruck des Kassenschnitts wieder funktionsfähig gemacht
* EC-Terminal: Sicherstellung, dass auch nach Schließen und Neuöffnen des Browsers das EC-Terminal ansteuerbar bleibt

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens von Positionen mit stornierter Epay-Transaktion
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Terminal: Sicherstellung, dass auch nach Schließen und Neuöffnen des Browsers das EC-Terminal ansteuerbar bleibt

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn ein Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager, wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französischen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-03-07T09:10:22Z

Kraeling: /* nächste Version */

== nächste Version ==

=== OS.pos ===
* EC-Terminal: Wiederholdruck des Kassenschnitts wieder funktionsfähig gemacht

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens von Positionen mit stornierter Epay-Transaktion
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Terminal: Sicherstellung, dass auch nach Schließen und Neuöffnen des Browsers das EC-Terminal ansteuerbar bleibt

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn ein Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager, wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französischen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-03-06T18:46:32Z

Kraeling: /* OS.pos */

== nächste Version ==

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens von Positionen mit stornierter Epay-Transaktion
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Terminal: Sicherstellung, dass auch nach Schließen und Neuöffnen des Browsers das EC-Terminal ansteuerbar bleibt

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn ein Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager, wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französischen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-03-06T15:32:25Z

Kraeling: /* Version 4.5.7-V20230306 */

== nächste Version ==

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens von Positionen mit stornierter Epay-Transaktion
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Terminal-Kommunikation verbessert.

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn ein Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager, wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französischen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-03-06T15:31:26Z

Kraeling: /* Version 4.5.7-V20230306 */

== nächste Version ==

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens stornierter Transaktionen
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Terminal-Kommunikation verbessert.

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn ein Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager, wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französischen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-03-06T14:55:47Z

Kraeling: /* OS.pos */

== nächste Version ==

== Version 4.5.7-V20230306 ==

===OS.pos===
* Fix: Speicherung des Kundenstamms funktioniert wieder. Betroffen waren folgende Stammdatentabellen: CustomerGroup, CustomerMultiGroup, MBundle, Mcustomer, ProductGroup und StoreGroup. Problem wurde mit der Version 4.5.7-V20230207 eingeführt.
* Epay-Schnittstelle:
** Stornierung bei eigenen Geschenkarten ermöglicht
** Prüfung auf doppelte Seriennummer im aktuellen Bon
** Ermöglichung des Löschens stornierter Transaktionen
** Fehlermeldung, falls Position wegen zugehöriger Epay-Aktivierung nicht gelöscht werden darf
* Entität Firma/MCompany: neues Feld exportAccounting, Import/Exportschnittstelle Company erweitert um das neue Feld.
* EC-Termrinal Kommunikation verbessert.

===OS.Softwarefactory===
* Fix: Generierung aus Entitätsmodell hat bei Selbstreferenz zu Nullpointerexception geführt, wenn eine Satz ohne Referenz gespeichert wurde.
* Verbesserung: Kommunikation mit OS.peripherals serialisiert.
* Fix: Nullpointerexception in Sessionmanager wenn Configurationservice noch nicht verfügbar ist.
* Vorbereitung für Lizenzprüfungsmodul.
* Verbesserung bei Datamartfilter. Wirkt sich in Readonlytable, Chart und Report aus. Es wird ein Filter nur noch einmal auf der Benutzeroberfläsche dargestellt, auch wenn er mehrfach in den verwendeten Datamarts vorkommt.
* Verbesserung bei Readonlytable: wenn ein Satz selektiert ist, dann wird die Tabelle nicht mehr aktualisiert, wenn sich im Hintergrund ein Satz ändert.
* Einführung von datenbankgestützter Verwaltung der Übersetzungen. Neue Perspektive "Administration/Übersetzungen" zur Pflege der deutschen, englischen und französchichen Texte.

== Version 4.5.7-V20230221 ==

===OS.pos===

* Fix: Guthabenzuordnung wird jetzt in den Zahlungsbeleg übernommen, der bei einer Mischung von Kredit- und Nichtkreditzahlungsarten erzeugt wird.
* Fix: Erhöhung der Bonnummer korrigiert.

=== OS.Softwarefactory ===

* Organigramm: Editor für Positionen verbessert.

== Version 4.5.7-V20230216 ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Fix: Bonnachdruck verbessert. Nicht vorhandene Daten bei bestimmten Bontypen stören die Ausgabe nicht mehr
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight> Der Service muss anschließend neu gestartet werden.
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10. Der Service muss anschließend neu gestartet werden.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen. Dies empfiehlt sich bei der Verwendung von EPSON Druckern, welche die Speicherung von Bitmaps unterstützen. Die Geschwindigkeit beim Bondruck wird dadurch erhöht. Der Service muss anschließend neu gestartet werden.
* POSPrinter: wird Text mit eine Länge von mehr als 4000 Zeichen zur Druck übergeben, so wird dieser in Blöcken mit max. 4000 Zeichen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten. Ist der Parameter <syntaxhighlight lang="xml"><prop name="OutputBufferSize" type="String" value="4096"/></syntaxhighlight> in jpos.xml gesetzt, so ist dieser Wert die Blockgröße.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

OS.app System Configuration

2023-02-28T11:09:50Z

Kraeling: /* GLOBAL_PARAMETERS */

== OS.app System Configuration ==

Each application created with the OSbee Software Factory V4.5.5 and later contains the system configuration to manage system wide settings.

The system configuration has two parts:

* Configuration group
* Configuration

The configuration entries belong to a configuration group to bundle related configuration entries.

Configuration entries and groups show up during operation of the application, as soon as the entry is requested by the application. The default value is used as the initial value. As soon as the configuration entry is available, it can be adjusted to the local needs.

Deleting an entry will result in the recreation of the default value, as soon as the application requests the value.

Configuration values will be introduced without seperate notice. The description might contain values, that are not yet available in the OS.app you're using, depending on the version of the software factory used to build the applicatoin.

=== Configuration Attributes ===

There are various attributes used for the configuration.
All entries have
{| class="wikitable" style="margin:auto"
|+ basic attributes
|-
!Attribute !!Type
|-
||configuration group || Reference to the Configuration group
|-
||key || String
|-
||description || String
|-

|}

The follwing types extend this basic attribute set. It can be a simple or a complex type

==== Boolean ====
a simple yes/no value, selected means yes / true, deselected means no / false

==== Integer ====
a simple number with precision 0
eg. 5000

==== Float ====
a simple number with precision > 0
eg. 1.234

==== String ====
a simple text value. Whatever shall be configured as text

==== Textblock ====
a simple text block value. Whatever shall be configured as a larger amount of text. Can be formatted.

==== Datainterchange ====
a complex type to configure datainterchange parameters for import and export

{| class="wikitable" style="margin:auto"
|+ Datainterchange configuration attributes
|-
!Attribute !!Type
|-
||protocol directory || String, the directory, where the import log is stored. empty disables the logging, Default: empty
|-
||import blocksize || Integer, Default 5000
|-
||no superindex creation || Boolean, Default yes
|-
||export blocksize || Integer, Default 1000
|-

|}

==== Notification Template ====
a complex type to configure user email notifications

{| class="wikitable" style="margin:auto"
|+ Notification Template Attributes
|-
!Attribute !!Type
|-
||locale || The language, the template is valid for
|-
||subject || String, used as email subject
|-
||body || String, used as email body
|-

|}

=== Configuration Groups===

==== Datamarts ====

Controls the datamart settings

For each datamart, the settings can be controlled

{| class="wikitable" style="margin:auto"
|+ Datamart settings
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|<datamart fqn>-ResultsetLimit4SQLExpression||sets a limit for the maximum number of lines returned from an SQL Expression Tables, Reports and Charts based on the datamart may eventually not present the whole data. The request return faster, especially if the request delivers a hughe amount of data if unlimited||Integer||0 || 0 = off, no limit > 0
|-

|}

==== DATAINTERCHANGE ====

Controls the datainterchange settings

For each datainterchange, the settings for the import and export can be configured

{| class="wikitable" style="margin:auto"
|+ DATAINTERCHANGE settings
|-
!Attribute !!Description !!Type !!Default !!Possible Values
|-
|key ||the datainterchange, the setting is used for ||String || || (not editable)
|-
|description ||free text ||String || ||
|-
|protocol directory ||the directory, where the camel protocol files shall be saved. Attention: the use of protocol files has a significant impact on the performance ||String || || directory on the server
|-
|no superindex creation ||Do not update the superindex during import. ||Boolean || true || true false
|-
|import blocksize ||the number of records, that are imported in one block. The larger the blocksize, the more memory is needed. ||Integer || 5000 || 0 = no block defined
|-
|export blocksize ||the number of records, that are exported in one block / file. ||Integer || 1000 || 0 = no block defined
|-

|}

==== GLOBAL_PARAMETERS ====

A collection of global configuration parameters

{| class="wikitable" style="margin:auto"
|+ Global Parameters
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|ABSTRACTHYBRIDVAACLIPSEVIEW-NOTIFY-ABOUT-RENDERING||enable tray notification about the rendering of a ui component ||Boolean||false ||false true
|-
|ABSTRACTHYBRIDVAACLIPSEVIEW-REFRESH-TIMEOUT||Time in milliseconds, how long a refresh of a AbstractHybridVaaclipseView shall wait ||Integer||300 || 0 = off
|-
|BEANSERVICELAZYLOADINGCONTAINER-REFRESH-TIMEOUT ||Time in milliseconds, how long a refresh of a BeanServiceLazyLoadingContainer shall wait ||Integer||0 || 0 = off
|-
|BLOB_LOCATION ||In case, blobs shall be stored in the filesystem instead of the database, the path can be configured here Attention: remember to include the directory into the backup in sync with the database backup ||String|| nn || nn: not configured, otherwise eg c:\OS.apps\blobs
|-
|LicenceGenerationPrivateKey||The private SHA384-with-ECDSA key to activate Compex licences. Only for internal use.||String|| None
|| any Base64 encoded key for the algorithm
|-
|LicenceGenerationCertificate||The certificate with the public SHA384-with-ECDSA key to activate Compex licences. ||Textblock|| <nowiki>-----BEGIN CERTIFICATE-----
MIIBTjCB1aADAgECAgRjd3pNMAoGCCqGSM49BAMDMBExDzANBgNVBAMMBmxpemVu
ejAeFw0yMjExMTgxMjI3NTdaFw0yMzExMTgxMjI3NTdaMBExDzANBgNVBAMMBmxp
emVuejB2MBAGByqGSM49AgEGBSuBBAAiA2IABAUrgKWFFtX/Edd3TV6vpsjbCXv/
xPtxHLq/F/b8C/wg4kxdx2w9cTXgOcfevszCAMx3qxxdazEhAk4q5ERBAsD1v2kn
nznZz05r0WyAjCS79MCNGzyCweV73KWj7xLdWDAKBggqhkjOPQQDAwNoADBlAjA5
m7aHNgnZjDfmegDakQHhS+0k8zm029oElvzsV0Eq33fVxeLLhlycJjzAVvYMFZYC
MQCD8mwLazMosZt0xhl/A1//6kZ5MWfvzSvv7wlrxJ/x3tjO5JBjgDHQFCkI1hIg
E1Y=
-----END CERTIFICATE-----</nowiki> || Should not be changed, except to a new key explicitly offered by Compex.
|-
|SINGLEINFOGRIDCOMPONENT-REFRESH-TIMEOUT ||Time in milliseconds, how long a refresh of a SingleInfoGridComponent shall wait ||Integer||0 || 0 = off
|-
|SuperindexCronSchedule ||The schedule to control the superindex rebuild. Default: every Friday at 22:00||String|| 0 0 22 ? * FRI||[http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html Quartz Trigger Samples]
|-
|SuperindexExclusionWords ||a list of words, that will be excluded from the superindex tables ||Textblock|| die, der, und, in, zu, den, das, nicht, von, sie,ist, des, sich, mit, dem, dass, er, es, ein, ich,auf, so, eine, auch, als, an, nach, wie, im, für,man, aber, aus, durch, wenn, nur, war, noch, werden, bei,hat, wir, was, wird, sein, einen, welche, sind, oder, zur,um, haben, einer, mir, über, ihm, diese, einem, ihr, uns,da, zum, kann, doch, vor, dieser, mich, ihn, du, hatte,seine, mehr, am, denn, nun, unter, sehr, selbst, schon, hier,bis, habe, ihre, dann, ihnen, seiner, alle, wieder, meine,gegen, vom, ganz, einzelnen, wo, muss, ohne, eines, können, sei,ja, wurde, jetzt, immer, seinen, wohl, dieses, ihren, würde, diesen,sondern, weil, welcher, nichts, diesem, alles, waren, will, viel,mein, also, soll, worden, lassen, dies, machen, ihrer, weiter,etwas, keine, seinem, ob, dir, allen, großen, Weise, müssen,welches, wäre, erst, einmal, hätte, zwei, dich, allein, während,kein, damit, gar, euch, sollte, konnte, ersten, deren, zwischen,wollen, denen, dessen, sagen, bin, gut, darauf, wurden, gewesen,zwar, wer, ihrem, hatten, solche, eben, andern, beiden, macht,dort, kommen, werde, derselben, ganzen, lässt, vielleicht, meiner || all words, you dont want in the superindex
|-

|}

==== Hardware ====

Control Hardware specific settings. The keys starting with <hostname> define a client computer specific setting.

{| class="wikitable" style="margin:auto"
|+ Monitoring
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|<hostname>-KeyboardLayout ||set the client keyboard layout to an appropriate value The default layout is Windows on Windows Machines and Linux on Linux machines. The information is detected by OS.pos and can be overwritten with this parameter. ||String || default || default Windows Linux
|-

|}

==== Monitoring ====

Controls the system monitoring settings

{| class="wikitable" style="margin:auto"
|+ Monitoring
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|activated ||switch on/off the monitoring in general ||Boolean || true || true false
|-
|daysToKeep ||keep data for x days. Delete older entries to keep database small ||Integer || 7 || 1..365
|-
|monitorCPUUSage ||switch on/off the CPU usage monitoring ||Boolean || false || true false
|-
|monitorDatainterchange ||switch on/off the data interchange monitoring for all datainterchange definitions ||Boolean || false || true false
|-
|monitorDiskspace ||switch on/off the diskspace monitoring for the installation disk drive ||Boolean || false || true false
|-
|monitorMemory ||switch on/off the memory monitoring ||Boolean || false || true false
|-
|monitorMemory intervall (in seconds) ||repeat the measurement every x seconds ||Integer || 60 || 15..500
|-
|...#daysToKeep ||keep data for x days. Delete older entries to keep database small ||Integer || 7 || 1..365
|-

|}

==== Notification Templates ====

Notification templates are use to define the content of system email, that is sent eg. when a user is unlocked.
The templates can be configured for English, German and French or any other language, the application uses.

{| class="wikitable" style="margin:auto"
|+ Notification Templates
|-
!Key !!Description !!Type !!Locale !!Default !!Possible Values
|-
|AccountUnlockedNotification ||used to notify user about the account unlocking ||Templatenotification|| Deutsch || Account #USERNAME# ist jetzt entsperrt! Das Benutzerkonto '#USERNAME#' ist wieder entsperrt. || any text
|-
| || ||Templatenotification|| English || Account #USERNAME# is unlocked now! The user account #USERNAME# is unlocked again. || any text
|-
| || ||Templatenotification|| French || Account #USERNAME# is unlocked now! The user account #USERNAME# is unlocked again. || any text
|-

|}

#USERNAME# is replaced by the name of the user, the notification is send to.

==== PeripheralService ====

Controls the behaviour of the OS.pos peripheral device communication. The keys starting with <hostname> define a client computer specific setting.

{| class="wikitable" style="margin:auto"
|+ PeripheralService
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|checkRemoteHosts ||Activate a cyclic check of all activated connections to OS.peripherals ||Boolen||false|| false, true
|-
|checkRemoteHostsIntervall(in sec) ||the intervall in seconds for the checkRemoteHosts ||Integer ||60||
|-
|comminication-timeout ||Timeout in milliseconds for the communication with the OS.peripherals service ||Integer|| 2000 || 0 = no timeout, 1000..5000
|-
|javaposStatusPollIntervallInMillisec ||the intervall in milliseconds for the status check of the POSPrinter, Cashdrawer and other configured javaPOS devices ||Integer ||1000|| 500..5000
|-
|signatureSlideDelayInMillisec ||the intervall in milliseconds to display the uploaded advertising pictures on the signature pad ||Integer ||1000|| 500..5000
|-
|signatureStatusPollIntervallInMillisec ||the intervall in milliseconds for the status check of the signature pad ||Integer ||1000|| 500..5000
|-
|<hostname>:<port> ||redirect the peripherals communication to another host or port for the <hostname> given in the key this allows to use mobile devices like tablets and redirect to a peripherals server, that has the configuration for the devices Attention! Experimental! ||String|| <hostname>:<port> || <other hostname>:<other port>
|-
|<hostname>-TimeBetweenTwoScanEventsInMilliSec" ||enable the treatment of the special character codes created by a scan. Off by default. ||Integer|| 0 || 0 = special scanner treatment off, recommended 50, max 100
|-
|POSPrinterLogo || a bitmap that can be used on POSPrinters ||Blob || empty || (*)
|-

|}

(*) The POSPrinterLogo is created and used as soon as the slip print parameters setting 'logo' contains the String 'POSPrinterLogo'.
We recommend to use a black/white or grayscale jpg logo with a resolution of 200x80 pixel. Other formats and sizes may work, but may lead to unexpected results. Please consult the printer documentation for further information.
It is possible to use different POSPrinterLogos by using multiple keywords for different logo configurations starting with POSPrinterLogo, e.g POSPrinterLogo1, POSPrinterLogo2, POSPrinterLogoChristmas, POSPrinterLogoEaster.

==== PrintServices ====

Controls the use of the server side system print service in the printservice selection comboboxes
The key contains the name of the print service.

{| class="wikitable" style="margin:auto"
|+ Printservice examples
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|no printer selected ||used to deselect any printer ||Boolean|| true || false true
|-
|Microsoft Print to PDF || ||Boolean|| true || false true
|-
|<the name of the printservice> || ||Boolean|| true || false true
|-
|}

all printservices, that are available on the spplication host machine, will be listet.

new entries will always be enabled by default.

==== Reports ====

Controls the replacement of reports. There are two methods: either the alternate report is part of the application, the the path is similar to the original path and has to be asked from the developer or the rptdesign file is located in the filesystem. Then, the prefix file: has to be used and the location can bei either relative or absolute. The relative location has to start with "file:", the absolute location has to start with "file:////" followed by the path to the rptdesign file.

The original report is used if the alternate report can not be found. The log contains hints about the search and the problem.

{| class="wikitable" style="margin:auto"
|+ Reports examples
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|replacement for org/eclipse/osbp/stubapplication/model/reports/rV1 ||alternate report ||String||org/eclipse/osbp/stubapplication/model/reports/rV2.rptdesign || the path to the alternate report. Default is the path to the original report
|-
|replacement for org/eclipse/osbp/stubapplication/model/reports/rV1 ||alternate report on the filesystem ||String||file:myreports/rV2.rptdesign || the path to the alternate report, located relative to the configuration directory, that contains the application preferences file.
|-
|replacement for org/eclipse/osbp/stubapplication/model/reports/rV1 ||alternate report on the filesystem||String||file:////c:\myreports\rV2.rptdesign || the absolute path to the alternate report.
|-

|}

==== Userinterface ====

The userinterface can be configured to adjust the behaviour to company specific needs. The settings are valid for all users.

{| class="wikitable" style="margin:auto"
|+ Userinterface settings
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|action-Save ||controls the behaviour of the Save Button ||String || action-Save || action-SaveAndAsk action-SaveAndNew
|-
|action-SaveAndAsk ||controls the behaviour of the SaveAndAsk Button ||String || action-SaveAndAsk || action-Save action-SaveAndNew
|-
|action-SaveAndNew ||controls the behaviour of the SaveAndNew Button ||String || action-SaveAndNew || action-Save action-SaveAndAsk
|-
|BalancedDialogLayout ||controls the order of groups in dialogs with more the one columns: left to right / top to bottom ||Boolean || false || false: alternating from left to right true: from top to bottom, then next col
|-
|defaultImageResolution ||controls the size of the images displayed in the dialogs ||Integer || 2 || 0 = Original 1 = small (16x16) 2 = small (32x32) 3 = portrait (64x128) 4 = landscape (128x64) 5 = big (200x<undefined>)
|-
|hideApplicationMenu ||Hide the application menu for all users. The menu is never hidden for Superusers. ||Boolean|| false || false true
|-
|hideMenuForUser <Username> ||Hide the application menu for the user <Username>. The menu is never hidden for Superusers. ||Boolean|| false || false true
|-
|Locale ||The default locale for the application ||String || the locale received from the browser || de-DE en-US fr-FR ...
|-
|MenuAutoCollapseAfterSelect ||Collapse the menu after the selection of a menu entry ||Boolean || false || false true
|-
|MenuAutoCollapseOnExpand ||Collapse the previous selected menu tree the selection of another tree ||Boolean || false || false true
|-
|MenuWidthInPX ||The width of the menu accordeon and tree in Pixel || String || 600px || 300px < Value < 900px
|-
|DatabaseExceptionMessage ||Blocking message about exceptions during database operations Either DatabaseExceptionMessage or DatabaseExceptionNotification can be true ||Boolean || false || false true
|-
|DatabaseExceptionNotification ||Systray notification about exceptions during database operations Either DatabaseExceptionMessage or DatabaseExceptionNotification can be true ||Boolean || false || false true
|-
|TableFilterDecorator-text-change-timeout ||Delay in milliseconds until the refresh of a table starts when a filter value is changed ||Integer|| 500 || 0..1000
|-
|showHelpButton ||Show the help button in the application menu bar ||Boolen || false || false true
|-
|ShowLanguageSelection||Show the language control in the application menu bar ||Boolen || false || false true
|-
|ShowPrinterSelection||Show the printer control in the application menu bar ||Boolen || false || false true
|-
|ShowThemeSelection||Show the theme control in the application menu bar ||Boolen || false || false true
|-
|}

OS.app System Configuration

2023-02-28T11:02:31Z

Kraeling: /* GLOBAL_PARAMETERS */

== OS.app System Configuration ==

Each application created with the OSbee Software Factory V4.5.5 and later contains the system configuration to manage system wide settings.

The system configuration has two parts:

* Configuration group
* Configuration

The configuration entries belong to a configuration group to bundle related configuration entries.

Configuration entries and groups show up during operation of the application, as soon as the entry is requested by the application. The default value is used as the initial value. As soon as the configuration entry is available, it can be adjusted to the local needs.

Deleting an entry will result in the recreation of the default value, as soon as the application requests the value.

Configuration values will be introduced without seperate notice. The description might contain values, that are not yet available in the OS.app you're using, depending on the version of the software factory used to build the applicatoin.

=== Configuration Attributes ===

There are various attributes used for the configuration.
All entries have
{| class="wikitable" style="margin:auto"
|+ basic attributes
|-
!Attribute !!Type
|-
||configuration group || Reference to the Configuration group
|-
||key || String
|-
||description || String
|-

|}

The follwing types extend this basic attribute set. It can be a simple or a complex type

==== Boolean ====
a simple yes/no value, selected means yes / true, deselected means no / false

==== Integer ====
a simple number with precision 0
eg. 5000

==== Float ====
a simple number with precision > 0
eg. 1.234

==== String ====
a simple text value. Whatever shall be configured as text

==== Textblock ====
a simple text block value. Whatever shall be configured as a larger amount of text. Can be formatted.

==== Datainterchange ====
a complex type to configure datainterchange parameters for import and export

{| class="wikitable" style="margin:auto"
|+ Datainterchange configuration attributes
|-
!Attribute !!Type
|-
||protocol directory || String, the directory, where the import log is stored. empty disables the logging, Default: empty
|-
||import blocksize || Integer, Default 5000
|-
||no superindex creation || Boolean, Default yes
|-
||export blocksize || Integer, Default 1000
|-

|}

==== Notification Template ====
a complex type to configure user email notifications

{| class="wikitable" style="margin:auto"
|+ Notification Template Attributes
|-
!Attribute !!Type
|-
||locale || The language, the template is valid for
|-
||subject || String, used as email subject
|-
||body || String, used as email body
|-

|}

=== Configuration Groups===

==== Datamarts ====

Controls the datamart settings

For each datamart, the settings can be controlled

{| class="wikitable" style="margin:auto"
|+ Datamart settings
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|<datamart fqn>-ResultsetLimit4SQLExpression||sets a limit for the maximum number of lines returned from an SQL Expression Tables, Reports and Charts based on the datamart may eventually not present the whole data. The request return faster, especially if the request delivers a hughe amount of data if unlimited||Integer||0 || 0 = off, no limit > 0
|-

|}

==== DATAINTERCHANGE ====

Controls the datainterchange settings

For each datainterchange, the settings for the import and export can be configured

{| class="wikitable" style="margin:auto"
|+ DATAINTERCHANGE settings
|-
!Attribute !!Description !!Type !!Default !!Possible Values
|-
|key ||the datainterchange, the setting is used for ||String || || (not editable)
|-
|description ||free text ||String || ||
|-
|protocol directory ||the directory, where the camel protocol files shall be saved. Attention: the use of protocol files has a significant impact on the performance ||String || || directory on the server
|-
|no superindex creation ||Do not update the superindex during import. ||Boolean || true || true false
|-
|import blocksize ||the number of records, that are imported in one block. The larger the blocksize, the more memory is needed. ||Integer || 5000 || 0 = no block defined
|-
|export blocksize ||the number of records, that are exported in one block / file. ||Integer || 1000 || 0 = no block defined
|-

|}

==== GLOBAL_PARAMETERS ====

A collection of global configuration parameters

{| class="wikitable" style="margin:auto"
|+ Global Parameters
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|ABSTRACTHYBRIDVAACLIPSEVIEW-NOTIFY-ABOUT-RENDERING||enable tray notification about the rendering of a ui component ||Boolean||false ||false true
|-
|ABSTRACTHYBRIDVAACLIPSEVIEW-REFRESH-TIMEOUT||Time in milliseconds, how long a refresh of a AbstractHybridVaaclipseView shall wait ||Integer||300 || 0 = off
|-
|BEANSERVICELAZYLOADINGCONTAINER-REFRESH-TIMEOUT ||Time in milliseconds, how long a refresh of a BeanServiceLazyLoadingContainer shall wait ||Integer||0 || 0 = off
|-
|BLOB_LOCATION ||In case, blobs shall be stored in the filesystem instead of the database, the path can be configured here Attention: remember to include the directory into the backup in sync with the database backup ||String|| nn || nn: not configured, otherwise eg c:\OS.apps\blobs
|-
|LicenceGenerationPrivateKey||The private SHA384-with-ECDSA key to activate Compex licences. Only for internal use.||String|| -----BEGIN CERTIFICATE-----
MIIBTjCB1aADAgECAgRjd3pNMAoGCCqGSM49BAMDMBExDzANBgNVBAMMBmxpemVu
ejAeFw0yMjExMTgxMjI3NTdaFw0yMzExMTgxMjI3NTdaMBExDzANBgNVBAMMBmxp
emVuejB2MBAGByqGSM49AgEGBSuBBAAiA2IABAUrgKWFFtX/Edd3TV6vpsjbCXv/
xPtxHLq/F/b8C/wg4kxdx2w9cTXgOcfevszCAMx3qxxdazEhAk4q5ERBAsD1v2kn
nznZz05r0WyAjCS79MCNGzyCweV73KWj7xLdWDAKBggqhkjOPQQDAwNoADBlAjA5
m7aHNgnZjDfmegDakQHhS+0k8zm029oElvzsV0Eq33fVxeLLhlycJjzAVvYMFZYC
MQCD8mwLazMosZt0xhl/A1//6kZ5MWfvzSvv7wlrxJ/x3tjO5JBjgDHQFCkI1hIg
E1Y=
-----END CERTIFICATE-----
|| Should not be changed, except to a new key explicitly offered by Compex.
|-
|LicenceGenerationCertificate||The certificate with the public SHA384-with-ECDSA key to activate Compex licences. ||Textblock|| nn || nn: not configured, otherwise eg c:\OS.apps\blobs
|-
|SINGLEINFOGRIDCOMPONENT-REFRESH-TIMEOUT ||Time in milliseconds, how long a refresh of a SingleInfoGridComponent shall wait ||Integer||0 || 0 = off
|-
|SuperindexCronSchedule ||The schedule to control the superindex rebuild. Default: every Friday at 22:00||String|| 0 0 22 ? * FRI||[http://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html Quartz Trigger Samples]
|-
|SuperindexExclusionWords ||a list of words, that will be excluded from the superindex tables ||Textblock|| die, der, und, in, zu, den, das, nicht, von, sie,ist, des, sich, mit, dem, dass, er, es, ein, ich,auf, so, eine, auch, als, an, nach, wie, im, für,man, aber, aus, durch, wenn, nur, war, noch, werden, bei,hat, wir, was, wird, sein, einen, welche, sind, oder, zur,um, haben, einer, mir, über, ihm, diese, einem, ihr, uns,da, zum, kann, doch, vor, dieser, mich, ihn, du, hatte,seine, mehr, am, denn, nun, unter, sehr, selbst, schon, hier,bis, habe, ihre, dann, ihnen, seiner, alle, wieder, meine,gegen, vom, ganz, einzelnen, wo, muss, ohne, eines, können, sei,ja, wurde, jetzt, immer, seinen, wohl, dieses, ihren, würde, diesen,sondern, weil, welcher, nichts, diesem, alles, waren, will, viel,mein, also, soll, worden, lassen, dies, machen, ihrer, weiter,etwas, keine, seinem, ob, dir, allen, großen, Weise, müssen,welches, wäre, erst, einmal, hätte, zwei, dich, allein, während,kein, damit, gar, euch, sollte, konnte, ersten, deren, zwischen,wollen, denen, dessen, sagen, bin, gut, darauf, wurden, gewesen,zwar, wer, ihrem, hatten, solche, eben, andern, beiden, macht,dort, kommen, werde, derselben, ganzen, lässt, vielleicht, meiner || all words, you dont want in the superindex
|-

|}

==== Hardware ====

Control Hardware specific settings. The keys starting with <hostname> define a client computer specific setting.

{| class="wikitable" style="margin:auto"
|+ Monitoring
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|<hostname>-KeyboardLayout ||set the client keyboard layout to an appropriate value The default layout is Windows on Windows Machines and Linux on Linux machines. The information is detected by OS.pos and can be overwritten with this parameter. ||String || default || default Windows Linux
|-

|}

==== Monitoring ====

Controls the system monitoring settings

{| class="wikitable" style="margin:auto"
|+ Monitoring
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|activated ||switch on/off the monitoring in general ||Boolean || true || true false
|-
|daysToKeep ||keep data for x days. Delete older entries to keep database small ||Integer || 7 || 1..365
|-
|monitorCPUUSage ||switch on/off the CPU usage monitoring ||Boolean || false || true false
|-
|monitorDatainterchange ||switch on/off the data interchange monitoring for all datainterchange definitions ||Boolean || false || true false
|-
|monitorDiskspace ||switch on/off the diskspace monitoring for the installation disk drive ||Boolean || false || true false
|-
|monitorMemory ||switch on/off the memory monitoring ||Boolean || false || true false
|-
|monitorMemory intervall (in seconds) ||repeat the measurement every x seconds ||Integer || 60 || 15..500
|-
|...#daysToKeep ||keep data for x days. Delete older entries to keep database small ||Integer || 7 || 1..365
|-

|}

==== Notification Templates ====

Notification templates are use to define the content of system email, that is sent eg. when a user is unlocked.
The templates can be configured for English, German and French or any other language, the application uses.

{| class="wikitable" style="margin:auto"
|+ Notification Templates
|-
!Key !!Description !!Type !!Locale !!Default !!Possible Values
|-
|AccountUnlockedNotification ||used to notify user about the account unlocking ||Templatenotification|| Deutsch || Account #USERNAME# ist jetzt entsperrt! Das Benutzerkonto '#USERNAME#' ist wieder entsperrt. || any text
|-
| || ||Templatenotification|| English || Account #USERNAME# is unlocked now! The user account #USERNAME# is unlocked again. || any text
|-
| || ||Templatenotification|| French || Account #USERNAME# is unlocked now! The user account #USERNAME# is unlocked again. || any text
|-

|}

#USERNAME# is replaced by the name of the user, the notification is send to.

==== PeripheralService ====

Controls the behaviour of the OS.pos peripheral device communication. The keys starting with <hostname> define a client computer specific setting.

{| class="wikitable" style="margin:auto"
|+ PeripheralService
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|checkRemoteHosts ||Activate a cyclic check of all activated connections to OS.peripherals ||Boolen||false|| false, true
|-
|checkRemoteHostsIntervall(in sec) ||the intervall in seconds for the checkRemoteHosts ||Integer ||60||
|-
|comminication-timeout ||Timeout in milliseconds for the communication with the OS.peripherals service ||Integer|| 2000 || 0 = no timeout, 1000..5000
|-
|javaposStatusPollIntervallInMillisec ||the intervall in milliseconds for the status check of the POSPrinter, Cashdrawer and other configured javaPOS devices ||Integer ||1000|| 500..5000
|-
|signatureSlideDelayInMillisec ||the intervall in milliseconds to display the uploaded advertising pictures on the signature pad ||Integer ||1000|| 500..5000
|-
|signatureStatusPollIntervallInMillisec ||the intervall in milliseconds for the status check of the signature pad ||Integer ||1000|| 500..5000
|-
|<hostname>:<port> ||redirect the peripherals communication to another host or port for the <hostname> given in the key this allows to use mobile devices like tablets and redirect to a peripherals server, that has the configuration for the devices Attention! Experimental! ||String|| <hostname>:<port> || <other hostname>:<other port>
|-
|<hostname>-TimeBetweenTwoScanEventsInMilliSec" ||enable the treatment of the special character codes created by a scan. Off by default. ||Integer|| 0 || 0 = special scanner treatment off, recommended 50, max 100
|-
|POSPrinterLogo || a bitmap that can be used on POSPrinters ||Blob || empty || (*)
|-

|}

(*) The POSPrinterLogo is created and used as soon as the slip print parameters setting 'logo' contains the String 'POSPrinterLogo'.
We recommend to use a black/white or grayscale jpg logo with a resolution of 200x80 pixel. Other formats and sizes may work, but may lead to unexpected results. Please consult the printer documentation for further information.
It is possible to use different POSPrinterLogos by using multiple keywords for different logo configurations starting with POSPrinterLogo, e.g POSPrinterLogo1, POSPrinterLogo2, POSPrinterLogoChristmas, POSPrinterLogoEaster.

==== PrintServices ====

Controls the use of the server side system print service in the printservice selection comboboxes
The key contains the name of the print service.

{| class="wikitable" style="margin:auto"
|+ Printservice examples
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|no printer selected ||used to deselect any printer ||Boolean|| true || false true
|-
|Microsoft Print to PDF || ||Boolean|| true || false true
|-
|<the name of the printservice> || ||Boolean|| true || false true
|-
|}

all printservices, that are available on the spplication host machine, will be listet.

new entries will always be enabled by default.

==== Reports ====

Controls the replacement of reports. There are two methods: either the alternate report is part of the application, the the path is similar to the original path and has to be asked from the developer or the rptdesign file is located in the filesystem. Then, the prefix file: has to be used and the location can bei either relative or absolute. The relative location has to start with "file:", the absolute location has to start with "file:////" followed by the path to the rptdesign file.

The original report is used if the alternate report can not be found. The log contains hints about the search and the problem.

{| class="wikitable" style="margin:auto"
|+ Reports examples
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|replacement for org/eclipse/osbp/stubapplication/model/reports/rV1 ||alternate report ||String||org/eclipse/osbp/stubapplication/model/reports/rV2.rptdesign || the path to the alternate report. Default is the path to the original report
|-
|replacement for org/eclipse/osbp/stubapplication/model/reports/rV1 ||alternate report on the filesystem ||String||file:myreports/rV2.rptdesign || the path to the alternate report, located relative to the configuration directory, that contains the application preferences file.
|-
|replacement for org/eclipse/osbp/stubapplication/model/reports/rV1 ||alternate report on the filesystem||String||file:////c:\myreports\rV2.rptdesign || the absolute path to the alternate report.
|-

|}

==== Userinterface ====

The userinterface can be configured to adjust the behaviour to company specific needs. The settings are valid for all users.

{| class="wikitable" style="margin:auto"
|+ Userinterface settings
|-
!Key !!Description !!Type !!Default !!Possible Values
|-
|action-Save ||controls the behaviour of the Save Button ||String || action-Save || action-SaveAndAsk action-SaveAndNew
|-
|action-SaveAndAsk ||controls the behaviour of the SaveAndAsk Button ||String || action-SaveAndAsk || action-Save action-SaveAndNew
|-
|action-SaveAndNew ||controls the behaviour of the SaveAndNew Button ||String || action-SaveAndNew || action-Save action-SaveAndAsk
|-
|BalancedDialogLayout ||controls the order of groups in dialogs with more the one columns: left to right / top to bottom ||Boolean || false || false: alternating from left to right true: from top to bottom, then next col
|-
|defaultImageResolution ||controls the size of the images displayed in the dialogs ||Integer || 2 || 0 = Original 1 = small (16x16) 2 = small (32x32) 3 = portrait (64x128) 4 = landscape (128x64) 5 = big (200x<undefined>)
|-
|hideApplicationMenu ||Hide the application menu for all users. The menu is never hidden for Superusers. ||Boolean|| false || false true
|-
|hideMenuForUser <Username> ||Hide the application menu for the user <Username>. The menu is never hidden for Superusers. ||Boolean|| false || false true
|-
|Locale ||The default locale for the application ||String || the locale received from the browser || de-DE en-US fr-FR ...
|-
|MenuAutoCollapseAfterSelect ||Collapse the menu after the selection of a menu entry ||Boolean || false || false true
|-
|MenuAutoCollapseOnExpand ||Collapse the previous selected menu tree the selection of another tree ||Boolean || false || false true
|-
|MenuWidthInPX ||The width of the menu accordeon and tree in Pixel || String || 600px || 300px < Value < 900px
|-
|DatabaseExceptionMessage ||Blocking message about exceptions during database operations Either DatabaseExceptionMessage or DatabaseExceptionNotification can be true ||Boolean || false || false true
|-
|DatabaseExceptionNotification ||Systray notification about exceptions during database operations Either DatabaseExceptionMessage or DatabaseExceptionNotification can be true ||Boolean || false || false true
|-
|TableFilterDecorator-text-change-timeout ||Delay in milliseconds until the refresh of a table starts when a filter value is changed ||Integer|| 500 || 0..1000
|-
|showHelpButton ||Show the help button in the application menu bar ||Boolen || false || false true
|-
|ShowLanguageSelection||Show the language control in the application menu bar ||Boolen || false || false true
|-
|ShowPrinterSelection||Show the printer control in the application menu bar ||Boolen || false || false true
|-
|ShowThemeSelection||Show the theme control in the application menu bar ||Boolen || false || false true
|-
|}

Releasenotes

2023-02-15T08:20:32Z

Kraeling: /* nächste Version */

== nächste Version ==

===OS.pos===

* EC-Terminal-Funktion "Repeat Receipt" flexibler gemacht (zwecks Nachdruck älterer Belege / Synchronisation zwischen Kasse und Terminal)
* Verbesserung: Kundenwechsel beim Kassieren kann nicht mehr versehentlich erfolgen sobald ein Kunde identifiziert ist.
* Fix: Vorzeichenfehler bei OP Zahlung
* Erweiterung: Wahlmöglichkeit zwischen Text und Bild für den Button "backspace". [[File:Button-Backspace.PNG]]
* Erweiterung: Anzeige der Kunden(karten)nummer in 'Zahlen'-Ansicht

=== OS.Softwarefactory ===

* Blob Service: das Speichern von Bildern wurde optimiert. Umgerechnete Versionen von Bildern werden nun beim ersten Abruf erzeugt. Somit werden in der Datenbank nicht benötigte Einträge vermieden.
* Bereichsfilter in Readonly-Tabellen, Berichten und Charts: die Bereichsfilter wurden erweitert. Jetzt können auch Text und numerische Werte in Bereichsfiltern verwendet werden.
* Fix: Modellzugriff bei parallelem Öffnen von Perspektiven sequenzialisiert.

===OS.peripherals Setup===

* erzeuge Datei application.yml-template als Vorlage für die Einstellungen in application.yml
* application.yml: devicetest ist jetzt standardmäßig abgeschaltet.
* aures/bin/CheckHealt.bat: füge Pfad zu aures/bin hinzu.
* schreibe Registrywerte für TcpTimedWaitDelay und MaxUserPort bei der Installation
* führe am Ende der Installation reboot aus nach Benutzerbestätigung

===OS.peripherals===

* Signaturepad: Verbesserung des Statushandlings, Verbesserung bei der Verwaltung der Werbebilder
* zentrale Funktion zur Statusabfrage eingeführt. Reduziert die Zahl der Status- bzw. Fehlerabfragen von 3/Sek auf 1/Sek. Aktuelle OS.pos Version erforderlich. Kompatibilität mit früheren OS.pos Versionen ist gegegeben.
* POSPrinter: Verbesserung des Logodruckmanagements
* POSPrinter: neuer Parameter 'ImageWidth' zur Definition der Zielbreite für den Logodruck in der Datei jpos.xml im Abschnitt für den POSPrinter. Defaultwert für AURES Drucker ist 1/16 der verfübaren Zeilenbreite -> 450. Defaultwert für EPSON und andere Drucker ist 200. <syntaxhighlight lang="xml">'<prop name="ImageWidth" type="Long" value="300"/>'</syntaxhighlight>
* POSPrinter: neuer numerischer Parameter 'performReclaimInSeconds' in application.yml. Steuert, ob und wann ein automatischer erneuter Claim bei den javaPOS Peripheriegeräten gemacht wird. Erleichtert die Erkennung der Geräte nach z.B. dem Aus- und Einschalten eines Geräts. Defaultwert: 'not set', gültige Werte: >= 10.
* POSPrinter: Methode "uploadedBitmaps" hat keine Funktion mehr. Sollen Bitmaps aus dem Druckerspeicher verwendet werden dann ist der entsprechende Schalter in application.yml zu setzen.
* POSPrinter: wird Text mit eine Länge von mehr als 1000 Zeichen zur Druck übergeben, so wird dieser in einzelnen Zeilen an den Drucker gesendet. Dies verhindert einen Absturz des Druckers bei zu langen Texten.

== Version 4.5.7-V20230207 ==

=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlussbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-02-08T11:02:21Z

Kraeling: /* nächste Version */

== nächste Version ==

===OS.pos===

* EC-Terminal setzt nun auch vor Neuregistrierung die Verbindung explizit zurück

== Version 4.5.7-V20230207 ==
=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlußbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-02-08T11:02:12Z

Kraeling: /* nächste Version */

== nächste Version ==

===OS.pos===

[*] EC-Terminal setzt nun auch vor Neuregistrierung die Verbindung explizit zurück

== Version 4.5.7-V20230207 ==
=== OS.pos ===

* Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden
* Korrektur Kassenabschlußbericht
* Korrektur bei Verarbeitung von Anzahlungen
* Fix: bei Verkaufsgebinden kann eine Referenz auf ein anderes Verkaufsgebinde definiert werden. Ist diese Referenz eine Selbstreferenz, dann kommt es durch einen rekursiven Aufruf zu einem Stackoverflow. Das Problem wurde dadurch gefixt, dass im Fall von Selbstreferenz der rekursive Aufruf jetzt prüft, ob es sich um eine Selbstreferenz handelt.

=== OS.Softwarefactory ===

* Update Font Awesome
* Darstellung des fokussierten Parts in Perspektiven in den OS.bee Themes geändert. Neben der Part-Überschrift wird nun ein Symbol eingeblendet, wenn der Fokus sich im Part befindet. [[File:Fokus-notifier.png]]

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-02-03T09:04:09Z

Kraeling: /* nächste Version */

== nächste Version ==

=== OS.pos ===
*Information über Transaktionsart (Zahlung vs. Gutschrift) kann nun von Ingenico-EC-Terminals ausgelesen werden

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-02-03T09:03:30Z

Kraeling: /* nächste Version */

== nächste Version ==

=== OS.pos ===
*Information über Transaktionsart kann nun von Ingenico-EC-Terminals ausgelesen werden

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-02-03T09:02:56Z

Kraeling: /* nächste Version */

== nächste Version ==

=== OS.pos ===

- Information über Transaktionsart kann nun von Ingenico-EC-Terminals ausgelesen werden

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-02-03T08:57:27Z

Kraeling: /* Stand 4.5.7-V20230202 */

== nächste Version ==

== Stand 4.5.7-V20230202 ==

===OS.pos===

* Fehler behoben, durch den gelegentlich ein Speicherüberlauf bei der Verwendung der Kassiersicht aufgetreten ist.
* Prüfung auf Kassenladensperrung bei Anmelden zum Kassieren
* Report für EC-Terminal Daten (Prototyp)
* EC-Terminal-Zahlung wird jetzt auch korrekt verarbeitet, falls während der Abschlussmeldung noch ein Fehler kommt (z.B. "Printer not ready")

===OS.bee Softwarefactory===

* internes Problem in der Kommunikation zwischen Applikationsserver und Arbeitsstationen bei der Statusabfrage der Peripheriegeräte behoben

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-23T10:08:55Z

Kraeling: /* OS.bee Softwarefactory */

== nächste Version ==

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden (Ursache u.a. für Fehler beim Import der invoice.xml)

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-23T10:08:20Z

Kraeling: /* nächste Version */

== nächste Version ==

== Stand 4.5.7-V20230122 ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-23T10:08:04Z

Kraeling:

== nächste Version ==

== Stand 4.5.7-V20230122

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-23T08:37:12Z

Kraeling:

== nächste Version ==

===OS.bee Softwarefactory===

* Fehler behoben, durch den neue Felder nicht mehr zuverlässig in neue Spalten der zugrundeliegenden Datenbank-Tabellen übersetzt wurden

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-17T09:42:34Z

Kraeling:

== nächste Version ==

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-17T09:42:17Z

Kraeling:

== nächste Version ==

== Stand 4.5.7.V20230117 ==

===OS.bee Softwarefactory===

* Verbesserte Fehlerbehandlung im Datenimport: Auch bei während des Datenbankcommits aufgetretene Fehler führen jetzt nicht mehr zu einem Abbruch des gesamten Imports, sondern nur zu dem der im Commit enthaltenen Datensätze.

== Stand 4.5.7.V20230113 ==

===OS.pos===

* EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
* EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert 20msec wird benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-13T14:45:12Z

Kraeling: /* nächste Version */

== nächste Version ==

== Stand 4.5.7.V20220113 ==

===OS.pos===

*EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
*EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert >0msec wird nur benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-12T15:56:45Z

Kraeling: /* nächste Version */

== nächste Version ==

===OS.pos===

*EC-Terminal-Konfiguration jetzt über verständliche Ja-Nein-Werte
*EC-Terminal-Verbindung wird jetzt für jeden Vorgang neu hergestellt

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert >0msec wird nur benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2023-01-11T17:35:10Z

Kraeling: /* OS.bee Softwarefactory */

== nächste Version ==

== Stand 4.5.7.V20230111 ==

===OS.pos===

* neue Spalte mproduct.noInversion
* Bonwiederholdruck: Bon kann ausgewählt werden

===OS.bee Softwarefactory===

* Leerzeichen kann nun in der Statusmaschine eingebbar
* Defaulttimeout für Pausen zwischen dem Verarbeiten von eingegebenen Zeichen auf 0msec gesetzt. Ein Wert >0msec wird nur benötigt, wenn ein Scanner verwendet werden soll, um Groß-/Kleinbuchstaben zu scannen.

* Verbesserung des Dialoglayouts und der Sprungreihenfolge im Dialog.
** Überschriften der Tabellen-Tabs im Dialog werden wieder angezeigt
** Steuerung der Anordnung von Gruppen in Dialogen. Ein Schalter ( Systemkonfiguration Userinterface/BalancedDialogLayout - Ja/Nein ) entscheidet über die Anordnungsreihenfolge der Gruppierungen. Default ist im Wechsel von links nach rechts. Ist der Schalter gesetzt, werden die Gruppen von oben nach unten über die Spalten verteilt.
** Sprungreihenfolgen nun grundsätzlich innerhalb einer Spalte nach unten, dann nach oben in die nächste Spalte. Bislang wurde in die nächste Gruppe in der benachbarten Spalte gesprungen.
** TAB springt nun von Gruppierung zu Gruppierung, RETURN springt wie bisher zum nächsten Feld
** SHIFT TAB und SHIFT RETURN springen rückwärts durch den Dialog

* Verbesserung des Eventhandling, dadurch bessere Performance der Anwendung

* Verbesserungen Systemkonfiguration
** Systemkonfigurationscache verbessert. Mit der Speicherung eines Wertes wird der interne cache gelöscht, so dass der Wert sofort verwendet wird.
** die Inhalte der Systemkonfiguration nun exportierbar und auch wieder importierbar. Der Export kann durch einen Button über der Tabelle Systemkonfigurationsgruppe ausgelöst werden. Die Daten werden in das konfigurierte Exportverzeichnis geschrieben. Wenn eine system-configuration-groups.xml und eine der anderen system-configuration-*.xml Datei im import Verzeichnis abgelegt werden, dann werden diese automatisch importiert.

* Verbesserung im System Monitoring:
** Reihenfolge bei schnell aufeinanderfolgenden Einträge wieder korrekt.
** Entkopplung des Schreibens von Monitoreinträgen in die Datenbank von den Abläufen, die Monitoreinträge schreiben wollen
** Reduktion der Systemevents bei schnell aufeinander folgenden Monitoreinträgen. Dadurch wird der Refresh aufwand insgesamt reduziert.

* BPM: Korrekturen beim Einlesen der Systemkonfigurationsparameter, Erweiterung des Monitoring

* Fix: Speicherverbrauch bei Datenimport, häufige Datenimports verursachten ein Speicherloch

* Änderungen des verwendeten Eclipselink Datenbank caching Verfahrens zur Reduktion des Speicherbedarfs

* Limitiere die Anzahl der angezeigten Datensätze in einem Chart auf Default 500. Der Wert kann über den Schalter CHARTS/<Chartname>-MaxValues eingestellt werden.

===OS.peripherals Setup===

* erzeuge Datei reboot.bat und startperipheralscontrol.bat

===OS.peripherals===

* Systemtrayfunktionalität
** Menu erweitert. Starten der Anwendung, des Kundendisplays, der OS.peripherals Admin Seite, Ausführen System reboot

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge in Dialogen korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-14T12:52:57Z

Kraeling: /* Stand 4.5.7-V202212141101 */

== nächste Version ==

== Stand 4.5.7-V20221214 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-14T12:52:30Z

Kraeling:

== nächste Version ==

== Stand 4.5.7-V202212141101 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-14T12:52:09Z

Kraeling: /* nächste Version */

== Stand 4.5.7-V202212141101 ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-14T12:51:29Z

Kraeling:

== nächste Version ==

===OS.pos===

* Epay-Schnittstelle: bei Aktivierung eigener Geschenkkarten wird nun der unrabattierte Preis als Kartenwert übergeben (statt des rabattierten)

===OS.bee Softwarefactory===

* Tabreihenfolge korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen
* Fix: Übermäßiges Anlegen von Notification Templates in der Systemkonfiguration beim Systemstart verhindert

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-12T16:31:37Z

Kraeling:

== nächste Version ==

===OS.bee Softwarefactory===

* Tabreihenfolge korrigiert: Felder am Ende des Dialogs wurden durch einen Fehler bisher übersprungen

== Stand 4.5.7-V20221212 ==

===OS.pos===

* Verwendung von Barcodes mit Groß-/Kleinschreibung (s.u.)
* Fix: Absicherung gegen ‚Wiederbelebung‘ eines bezahlten Bons durch Kassiererwechsel
* weitere Stabilisierung der EC-terminal Kommunikation

===OS.bee Softwarefactory===

* Parameter in der Systemconfiguration zu Steuerung der Sonderbehandlung von Scannereingaben. [https://download.osbee.org/documentation/index.php/OS.app_System_Configuration Mehr Systemkonfigurationsparameter] Der Scanner sollte eine Verzögerung beim Versand der Zeichen von 20ms eingestellt haben. Ist keine Verzögerung eingestellt, kann das zu einem Fehlverhalten führen. ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' == 0 -> Sonderbehandlung ist ausgeschaltet ( default ) ''"PeripheralService"/"<Rechnername>-TimeBetweenTwoScanEventsInMilliSec"'' > 0 -> Sonderbehandlung ist eingeschaltet. Empfohlene Werte 50..100
* Parameter zur Steuerung des Keyboard layouts in der Statusmachine '"Hardware/<Rechnername>-KeyboardLayout" = "default"' -> die Einstellungen für Windows oder Linux Keyboards werden verwendet, je nach Client Betriebssystem '"Hardware/<Rechnername>-KeyboardLayout" = "Windows"' -> die Einstellungen für Windows Keyboards werden verwendet '"Hardware/<Rechnername>-KeyboardLayout" = "Linux"' -> die Einstellungen für Linux Keyboards werden verwendet Zum Test, ob die Einstellung passt, kann in ein Eingabefeld, z.B. bei der Kassenzuordnung, die Taste '-' (minus Zeichen im Tastenblock) gedrückt werden. Ist die Einstellung korrekt, wird das '-' angezeigt, sonst wird nichts angezeigt.
* zusätzliches Caching der Lesevorgänge in der Systemconfiguration zur Reduktion der Datenbankzugriffe. Der Cache wird alle 5 Min verworfen, d.h. die Änderung eines Konfigurationsparameters wirkt evtl. erst nach 5 Min.
* Fix: fehlende Speicherfreigaben beim Schließen von Perspektiven ergänzt

===OS.peripherals===

* Möglichkeit der Integration von OS.peripherals in das Windows System Tray. Statusmeldungen von OS.peripherals erscheinen dann in den Windows Benachrichtigungen. Die Installation mit einem Setup ab dem 12.12.2022 ist Voraussetzung.
* Anzeige des logs überarbeitet
** der Softwarestand wird bei Aufruf von [http://localhost:9200/getLog] am Anfang des peripheral.log angezeigt
** Ausgabe des Logs auf die Einträge seit dem letzten Start begrenzt. Die Datei peripherals.log enthält nach wie vor das fortlaufenden log.

===OS.peripherals Setup===

* System Tray Funktionalität als Installationsoption. Die Verwendung eines OS.peripherals ab dem 12.12.2022 ist Voraussetzung
* Überarbeitungen
** Es werden keine Einträge mehr in die Systempfade vorgenommen. Dadurch wird das setup beim Installieren und Deinstallieren schneller
** Installation des wacom Verzeichnisse auch ohne Auswahl des Signaturpads. Die darin enthaltenen DLLs werden immer benötigt.
** Auswahl, ob die Kassenanwendung und das Kundendisplay im Kioskmodus gestartet werden sollen oder nicht. (launch application in kiosk mode) / (launch customer display in kiosk mode)
** Auswahl, ob das Kassendisplay links oder rechts vom Hauptbildschirm in der Bildschirmkonfiguration definiert ist (located left). [[File:Setup-Screenshot 2022-12-12 135029.png]]

== Stand 4.5.7-V20221208 ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

* Überarbeitung der Tastatur- und Scannereingaben in der Statusmaschine zur Ermöglichung von Eingaben diverser nicht numerischer Zeichen

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-06T16:38:44Z

Kraeling: /* OS.pos */

== Nächste Version ==

===OS.pos===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

===OS.bee Softwarefactory===

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-06T16:38:36Z

Kraeling: /* OS.bee Softwarefactory */

== Nächste Version ==

===OS.pos===

===OS.bee Softwarefactory===

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-12-06T16:38:28Z

Kraeling: /* OS.bee Softwarefactory */

== Nächste Version ==

===OS.pos===

===OS.bee Softwarefactory===

* EC-Terminal-Kommunikation korrigiert: Bestätigungen von Befehlen an das Terminal werden jetzt nicht mehr rückbestätigt

==Stand 4.5.7-V20221129==

===OS.pos===

* Druck von Beleg ohne Position gefixt
* Tastatureingaben in der Kassierperspektive, den Zählpersepktiven und weiteren auf der Statemachine basierenden Perspektiven verbessert

===OS.bee Softwarefactory===

* Statemachine: Verbesserung des Tastaturhandlings. Unterscheidung von Windows und Linux Arbeitsplätzen. Vervollständigung der verarbeiteten Zeichen. Um Zeichen, die üblicherweise mit der 'Alt Gr' Taste ( z.B. '@' ) zu erhalten, muss die 'Alt' Taste verwendet werden (Bsp. 'Alt' 'q' -> '@' ).

==Stand 4.5.7-V20221128==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
* Entfernung der MwSt aus ShopInShop Belegen. MwSt wird beim Bezahlen berechnet

Version OS:

* Druck von Beleg ohne Position gefixt

===OS.bee Softwarefactory===

* Desekektion in Tabelle leert den zugehörigen Dialog
* Erweiterung Reportverwaltung: alternative Reports können nun über die Systemkonfiguration eingestellt werden
* Vorbereitung Online Hilfe
* Entitygenerierung: abfangen und protokollieren von exceptions in 'derived' Attributen.
* BPM Verarbeitung: fix beim Schliessen einer BPM Perspektive

==Stand 4.5.7-V20221115==

===OS.peripherals===

* Verkürzung der Startzeiten für des Unterschriftenpad

===OS.peripherals Setup===

* Integration der Installation Diebold-Nixdorf TSE

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-11-15T10:37:23Z

Kraeling: /* OS.pos */

== Nächste Version ==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-11-15T10:37:08Z

Kraeling: /* Nächste Version */

== Nächste Version ==

===OS.pos===

* Diebold-Nixdorf-TSE als Alternative zur TSE der Bundesdruckerei nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert
https://download.osbee.org/documentation/index.php?title=Releasenotes&action=edit&section=1

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-11-15T10:31:44Z

Kraeling: /* Stand 4.5.7-V20221115 */

== Nächste Version ==

===OS.pos===

* Diebold-Nixdorf-TSE nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-11-15T10:12:59Z

Kraeling: /* OS.pos */

== Stand 4.5.7-V20221115 ==

===OS.pos===

* Diebold-Nixdorf-TSE nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-11-15T10:12:44Z

Kraeling: /* Stand 4.5.7-V20221115 */

== Stand 4.5.7-V20221115 ==

=OS.pos=

* Diebold-Nixdorf-TSE nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Releasenotes

2022-11-15T10:12:18Z

Kraeling:

== Stand 4.5.7-V20221115 ==

* Diebold-Nixdorf-TSE nutzbar gemacht
* Sortierung und Auswahl in Perspektive "DSFinV-K-Protokolle" reaktiviert

== Stand 4.5.7-V20221107 ==

=== OS.pos ===

* Verbesserung bei der Überprüfung des Zahlbetrags
* Verbesserung der Übersetzungen

=== OS.bee Softwarefactory ===

* Einstellung für "HideUserMenu" von preferences nach Systemkonfiguration verlegt.

== Stand 4.5.7-V20221031 ==

=== OS.pos ===

* Log bei Abweichungen in Positionssummen und Steuerberechnung
* weitere Log-Anpassungen
* Anzeige der Bonvorschau verbessert
* Behandlung der Ladensteuerung verbessert
* Entsorgung: Export der ID des bezahlten Claims im Attribut [[claimSelectionsClaimId]]
* Bezahlterminal: Verbesserung bei der Initialisierung. Warten auf Antwort der CONNECT Anforderung.

Version OS:
* Entsorgung: Export der [[slip.id]] in [[Claim]] entfällt
* Entsorgung: Export der [[claimSelectionsTargetProductId]] in [[CashPosition]] entfällt

=== OS.bee Softwarefactory ===

* Einführung neue TSE, Datenstrukturanpassungen

== Stand 4.5.7-V20221026 ==

=== OS.pos ===

* Fix eines Problems mit der Ansteuerung der TSE. Das Problem wurde durch die Erweiterung der verfügbaren TSE Varianten eingeführt.
* Fix des Logodrucks auf dem Kassenbon. Es wurde nach dem Öffnen der Kassenperspektive nur auf dem ersten Bon das Firmenlogo gedruckt, ab dem zweiten Bon dann nicht mehr.
* Epay Anbindung erweitert um Kartendeaktivierung
* Ergänzung der Übersetzungen
* Anpassung der Buttons für den Bonabschluss. Es wird die jeweilige Aktion auf dem grünen Standardabschluss- und dem roten Sonderabschlussbutton angezeigt. Dies sind z.B. "Bon drucken" und "Beleg drucken"
* Neu: "Entf" Taste löscht die letzte Eingabe in z.B. der Kassiersicht, Lade zählen Sicht, und anderen auf der Statusmaschine basierenden Sichten

=== OS.bee Softwarefactory ===

* Stabilisierung der Kommunikation zwischen Anwendungsclient und -server.
* Beschleunigung des Anwendungsstarts (Perstenceservice, BPM)
* Blockieren der Benutzeranmeldung bis die Anwendung vollständig gestartet ist.
* Fix der "Nullpointer Exception" bei der Auswahl über die Tastatur in den Komboboxen für Perspektivenauswahl, Druckerauswahl, Sprachauswahl.
* Fix einer Exception bei der Anmeldung, die später dazu führte, dass kein Transactionmanager für die Sitzung gefunden wurde.

=== OS.peripherals ===

* Setup: Entfernung der automatischen Installation von Oracle Java. Ein installiertes Java 1.8 64bit wird vorausgesetzt.
* Steuerung der Abspielgeschwindigkeit der Werbebilder über die Systemkonfiguration in OS.pos

Authorization DSL

2019-12-02T10:32:33Z

Kraeling: corrected indentation

==Introduction==

AuthorizationDSL is used to authorize the roles at runtime. For example, when the sales and logistics check the same entity of article, the sales do not need to know how many cases per pallet for an article, so it should be invisible in vision of the sales; the logistics do not need to know how much costs the article, so in vision of the logistics, the price should not be displayed.

==AuthorizationDSL==

The AuthorizationDSL is working at runtime. It's used to define the roles and authorize them. Visibility processor at runtime calculates the authorization of e.g. invisible or editable for the roles; Blips are working for the bpm process at runtime, e.g. starting the user task.

There will be no exported file generated after editing the model. The authorization rules will be store in a hash map at runtime. Each user should have its own position, and the role will be assigned to the positions in [[Organization DSL]], which is also working at runtime.

The authorization at runtime will be done according to the rules which we defined in AuthorizationDSL.

The main semantic elements of the AuthorizationDSL are:

* “package” - the root element that contains all the other elements. A model can contain multiple packages.

* “role” - define the role in the fact, e.g. sales, logistics…It contains further elements such as entity and process.

* "ENTITY” - define which entity should be authorized, and how to authorize it for the roles, the entity is defined in [[Entity DSL]] model.

* "BEAN” - define which bean should be authorized, and how to authorize it for the roles, the bean is defined in [[Entity DSL]] model.

* "DTO” - define which DTO should be authorized, and how to authorize it for the roles, the DTO is defined in [[DTO DSL]] model.

* “attribute” - define the authorization of the entity/bean/DTO attributes for the roles.

* “relation” - define the authorization of the referenced entity/bean/DTO for the roles.

* “PROCESS” - define which process is STARTABLE and if the user task of this process is TASKABLE for the roles. The process is defined in Bilp DSL model.

* “TASK” - define which user task is TASKABLE for the roles.

===Syntax===

====package definition====

► '''Syntax''':
<syntaxhighlight lang="java">
package <package name> {
role <role name> {...}
...
}
</syntaxhighlight>

The package definition of AuthorizationDSL is just like most of the DSL models, you just need to define the package name and in eclipse like other java project press ctrl+shift+o, all necessary models or java classes will be imported automatically. After that, you can define the roles and their authorization rules. One or more roles can be defined in the same package.

► '''Example''':
<syntaxhighlight lang="java">
package org.eclipse.osbp.foodmart.authorizations {
import org.eclipse.osbp.foodmart.entities.*
import org.eclipse.osbp.foodmart.blips.*
. . .
role Sales {. . .}
. . .
}
</syntaxhighlight>

====role====

This is the main part of this model. Either entity or process could be authorized in this part.

► '''Syntax''':
<syntaxhighlight lang="java">
role <role name> {
ENTITY <entity name> ... [{ ... }]
...
| BEAN <bean name> ... [{ ... }]
...
| DTO <dto name> ... [{ ... }]
...
| PROCESS <blip name>{ ... }
...
}
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
role Sales {
ENTITY Mproduct_class ANY
ENTITY Memployee ANY {. . .}
PROCESS ProductMaintenance {. . .}
. . .
}
</syntaxhighlight>

In this example, the authorization rule for <code>role</code> '''''Sales''''' will be defined. The rules are using to <code>ENTITY</code> '''''Mproduct_class''''', <code>ENTITY</code> '''''Memployee''''' and <code>PROCESS</code> '''''ProductMaintenance'''''.

=====ENTITY=====
You can define the authorization rule for the whole entity or for one or more attribute/reference of this entity.

► '''Syntax''':
<syntaxhighlight lang="java">
ENTITY <entity name> RoleEnum [{
attribute <entityAttribute name> INVISIBLE|DISABLED|NONEDITABLE
relation <entityReference name> INVISIBLE|DISABLED|NONEDITABLE
...
}]
</syntaxhighlight>

* <code>RoleEnum</code> is including ANY, CREATABLE, READABLE, UPDATABLE and DELETABLE. It is defined for the whole entity. any means allowed all. Otherwise, only the operation which is listed is allowed, they are CREATABLE, READABLE, UPDATABLE and DELETABLE; it can be one or more operations listed at the same time.

* Entity attribute and reference could be authorized as INVISIBLE, DISABLED and NONEDITABLE. Only the operation which is listed is allowed, it can be one or more operations listed at the same time.

► '''Example''':
<syntaxhighlight lang="java">
ENTITY Mproduct_class ANY
</syntaxhighlight>

<syntaxhighlight lang="java">
ENTITY Memployee ANY{
attribute first_name INVISIBLE
relation position NONEDITABLE
}
</syntaxhighlight>

The following picture is a dialog of <code>ENTITY</code> '''''Memployee''''', you could see for the <code>role</code> '''''sales''''', the attribute '''''first_name''''' is not shown, only '''''full_name''''' and '''''last_name''''' is shown; the reference '''''position''''' is not editable. [[File:AuthorizationDSL_01.png|600px]] 

=====BEAN=====
You can define the authorization rule for the bean or for one or more attribute/reference of this bean.

► '''Syntax''':
<syntaxhighlight lang="java">
BEAN <bean name> RoleEnum [{
attribute <beanAttribute name> INVISIBLE|DISABLED|NONEDITABLE
relation <beanReference name> INVISIBLE|DISABLED|NONEDITABLE
...
}]
</syntaxhighlight>

* <code>RoleEnum</code> is including ANY, CREATABLE, READABLE, UPDATABLE and DELETABLE. It is defined for the bean. any means allowed all. Otherwise, only the operation which is listed is allowed, they are CREATABLE, READABLE, UPDATABLE and DELETABLE; it can be one or more operations listed at the same time.

* Bean attribute and reference could be authorized as INVISIBLE, DISABLED and NONEDITABLE. Only the operation which is listed is allowed, it can be one or more operations listed at the same time.

► '''Example''':
<syntaxhighlight lang="java">
BEAN Address ANY {
attribute country INVISIBLE
}
</syntaxhighlight>

=====DTO=====
You can define the authorization rule for the DTO or for one or more attribute/reference of this DTO.

► '''Syntax''':
<syntaxhighlight lang="java">
DTO <dto name> RoleEnum [{
attribute <dtoAttribute name> INVISIBLE|DISABLED|NONEDITABLE
relation <dtoReference name> INVISIBLE|DISABLED|NONEDITABLE
...
}]
</syntaxhighlight>

* <code>RoleEnum</code> is including ANY, CREATABLE, READABLE, UPDATABLE and DELETABLE. It is defined for the DTO. any means allowed all. Otherwise, only the operation which is listed is allowed, they are CREATABLE, READABLE, UPDATABLE and DELETABLE; it can be one or more operations listed at the same time.

* DTO attribute and reference could be authorized as INVISIBLE, DISABLED and NONEDITABLE. Only the operation which is listed is allowed, it can be one or more operations listed at the same time.

=====PROCESS=====
The process and the user task in this process could be authorized in this part.

► '''Syntax''':
<syntaxhighlight lang="java">
PROCESS <blip name>{
[is STARTABLE]
[all usertasks TASKABLE]
TASK <blipTask name|Task name> TASKABLE
...
}
</syntaxhighlight>

* <code>is STARTABLE</code> means: this process is allowed to be started.
* <code>all usertasks TASKABLE</code> means: all user tasks of this process are allowed to be executed.
* If not all the user tasks are allowed to be executed, you can define here which user task is allowed to be executed using keyword <code>TASK … TASKABLE</code>.

► '''Example''':
<syntaxhighlight lang="java">
PROCESS ProductMaintenance {
is STARTABLE
all usertasks TASKABLE
}
</syntaxhighlight>

== Copyright Notice ==
{{Copyright Notice}}

Datainterchange DSL

2019-09-12T09:33:29Z

Kraeling: Changed keyword "beans" to "path

==Purpose==

The Data Interchange DSL (datainterchange for short) is made for defining data exchange models that can be used to import data from various formats (CSV, XML, EDI, etc.), map the data to entities, store them into database, or export them back into other formats.

You only need to define the ''relationship'' between the file and the bean, not the import / export process themselves. Once defined, these models can be used in e.g. action DSL to define actions which, when triggered, execute the actual import / export process, which are generated automatically by the OSBP based on the model.

==Overview==

As shown on the figure below, the [DSL Inferrer] will generate various views and In/Export component according to model described by datainterchange DSL (and action DSL, in the case of ActionButtons). The action buttons, when clicked, will trigger their corresponding In/Export processes by putting [http://download.osbee.org/downloads/javadoc/osbee-master-clean/org.eclipse.osbp.xtext.datainterchange.feature/apidocs/ WorkerThread (Runnable)] jobs into the executor job pool within the TriggerView (prefixed with datainterchang name), buttons (and toolbar / menus containing them) are further included in the perspective.

[[File:Datainterchange.png|600px|center|frame|''Figure 1: - Data Interchange Structure.'']]

==Data Interchange Model File==

Datainterchange DSL model files end with the <code>.data</code> extension. Data Interchange models may be split into several <code>.data</code> files, as long as they have the same package declaration.

In the following we will dive deeper into the description and the usage of Datainterchange related and reserved keywords.

===import===
In the import section are all entities to be found - as full qualified names – that are currently used in the DSL.

► '''Example''':
<syntaxhighlight lang="java">

import ns net.osbee.sample.foodmart.entities.Mstore
import ns net.osbee.sample.foodmart.entities.Mwarehouse
import ns net.osbee.sample.foodmart.entities.Mregion

</syntaxhighlight>

Note that <code>ns</code> is a mandatory keyword (stands for "namespace") that comes after import for distinguishing the OS.bee internal namespaces and Java library namespaces. Wildcards are not supported, all names should be imported separately. Note that the import section will be imported/added automatically if they are used in the package, so you don't have to manually manage this section.

===package===

Datainterchange DSL model files must start with a package declaration. Packages are the root element of the DSL and should be defined as <code><ApplicationName>.datainterchanges</code>.

► '''Example''':
<syntaxhighlight lang="java">package net.osbee.sample.foodmart.datainterchanges { }</syntaxhighlight>

Data Interchange models may be split into several .data files, as long as they have the same package declaration, the interchanges will be available under this package name.

===title===
With the keyword title you can give a name to the corresponding TriggerView dialog inside your application. For example, the definition of the same datainterchanges package from above with title "Data Interchange Example":

► '''Example''':
<syntaxhighlight lang="java">package net.osbee.sample.foodmart.datainterchanges title "Data Interchange Example" {}</syntaxhighlight>

This title will be translated based on locale.

You can get more details about the TriggerView in the section below.

===interchange===
The <code>interchange</code> keyword defines interchange units for entities in the package, it should be in the form of:

► '''Example''':
<syntaxhighlight lang="java">
interchange <InterchangeUnitName> [describedBy <description>] <EntityManagerMode> file <FileType> [<FileDetails>] path{
...
}
</syntaxhighlight>

Where <code>InterchangeUnitName</code> being the name of the interchange unit; <code>describedBy</code> (optional) can be used to provide a short description string. <code>EntityManagerMode</code> being how the file should be handled (see section "persist, merge, remove" below), and after <code>file</code> keyword, you should specify the type of the source / target data file you would like to import from or export to, then the file path, and other details depends on the type.

The following example specifies an interchange that reads a CSV file under the specified path (note the forward slash as the path separator), delimited by semicolon, skip one line (the header), and treat the content as encoded in UTF-8:

► '''Example''':
<syntaxhighlight lang="java">

interchange CurrencyNames persist file
CSV "C:/data/ISOCurrencyCode20170101.csv" delimiter ";" skipLines 1 encoding "UTF-8"
path {
...
}
</syntaxhighlight>

The <code>path</code> keyword comes after all the file specification and starts a block of entity definitions, which will be covered in section "entity".

===describedBy===
With this keyword you can the optional description of an interchange unit as shown below.

► '''Example''':
<syntaxhighlight lang="java">
interchange Currencies describedBy "european central bank currency exchange rates based on euro" persist ... { ... }
</syntaxhighlight>

===vectorName===
With the optional keyword <code>vectorName</code> followed by a string value you are able to define the name of the root element of both XML configuration files needed by Smooks. Please note that it also means that the first (root-)element of an XML-File you would have exported (file filled with real data) via the application will have the same name.

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file ... { ... }
</syntaxhighlight>

You can view the result of this sample of code like shown below on figure[[#Figure3|''3'']].

===persist, merge, remove===
These keywords define the purpose of the datainterchange unit and has a similar meaning as in the JPA's EntityManager class. Basically, <code>persist</code> will insert the data records into database, <code>merge</code> will update existing data record, or insert new one if necessary, <code>remove</code> will remove the record if it could be found in database.

► '''Example 1''': (persist)
<syntaxhighlight lang="java">
interchange EDIOrders describedBy "Orders" persist file
XML "C:/data/orders.xml"
path {
...
}
</syntaxhighlight>

► '''Example 2''': (merge)
<syntaxhighlight lang="java">
interchange Stores merge file
XML "C:/data/stores.xml"
path {
...
}
</syntaxhighlight>

► '''Example 3''': (remove)
<syntaxhighlight lang="java">
interchange Storesremove remove file
XML "C:/data/stores_remove.xml"
path {
...
}
</syntaxhighlight>

===file===
With the keyword file you are able to set the file format of the files you intent to process with you interchange unit.

► '''Syntax''':
<syntaxhighlight lang="java">interchange <SampleInterchangeUnitName> <EntityManagerMode> file <FileNameFormat> {}</syntaxhighlight>

The current supported file formats are CSV, EDI and XML followed by the name of the file you want to process, given its full path location in the system.
► '''Example 1''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit1 merge file CSV "C:/temp/testFile.csv" {}</syntaxhighlight>
► '''Example 2''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit2 persist file XML "C:/temp/testFile.xml" {}</syntaxhighlight>
► '''Example 3''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit3 merge file EDI "C:/temp/testFile.edi" {}</syntaxhighlight>

After choosing the file format you can either give the file name as a String value in a double quote "..." as shown here above, or press Ctrl+Space to get via the content assist the option of opening a File Chooser/Picker to specify the file you want to work with.

[[File:FileChooser.jpg|center|frame|''Figure 2: File Chooser'']]

Please note that you can also change the path(?) of the file to process on runtime by selecting a new file.

===mapByAttribute===

The <code>mapByAttribute</code> keyword is an XML-specific keyword that turns on the automatic attribute mapping. When enabled, datainterchange will detect if the value being mapped is from an attribute. For example, the 'USD' value in the following XML file comes from the attribute 'currency' of the element 'Cube':

► '''Example''':
<syntaxhighlight lang="xml">
<Cube currency='USD' rate='1.3759'/>
</syntaxhighlight>

while in the following XML file, the same value is encapsulated in the element 'currency':

► '''Example''':
<syntaxhighlight lang="xml">

<Cube>
<currency>USD</currency>
<rate>1.3759</rate>
</Cube>
</syntaxhighlight>

When <code>mapByAttribute</code> is present, datainterchange will automatically decide that a query in the form like <code>'/Cube/currency'</code> will also catch the value from attribute. Without it, the query will have to put a <code>'@'</code> symbol in front of the attribute name, i.e. <code>'/Cube/@currency'</code>.

===elementSize===
With the keyword <code>elementSize</code> followed by an integer, the user can set the estimated average size of the elements in bytes. Since the underlying API cannot know the size of an element before it is processed, this value can be supplied as a guide value to be used for estimating the import / output progress based on how much bytes have been processed.

► '''Example''':
<syntaxhighlight lang="java">
interchange EDIOrders describedBy "edi orders" persist elementSize 50 file EDI "C:/data/orders.edi" path {
...
}
</syntaxhighlight>

Defines an average estimated element size of 50 bytes.

===delimiter===

The <code>delimiter</code> is a CSV format-specific keyword, which defines the character to use in the CSV file to set the delimiter/separation character between different values. Default value is "," (comma).

► '''Example''':
<syntaxhighlight lang="java">
interchange CurrencyNames persist file
CSV "C:/data/ISOCurrencyCodes081507.csv" delimiter ";" ... {
...
}
</syntaxhighlight>

will set the delimiter of the CSV file to ";".

===skipLines===
This is a CSV format-specific keyword. Using <code>skipLines</code> followed by an integer, the user can specify the number of lines to be skipped from the beginning in the processing of the selected file, this can be used to skip headers.

► '''Example''':
<syntaxhighlight lang="java">
interchange CurrencyNames persist file CSV "C:/data/ISOCurrencyCodes081507.csv" ... skipLines 1 encoding "UTF-8" {
...
}
</syntaxhighlight>

will skip the first line of the CSV file.

===report===

If a '''datainterchange''' unit is defined with the <code>report</code> keyword, a report will be generated for data conversions. The report file is generated by Smooks, lies under <code>/smooks</code> output directory of the datainterchange bundle, and has a name in the form like <code><DataInterChangeName>-input.xml</code> for input processes, and <code><DataInterChangeName>-output.xml</code> for output processes. '''Note: turn on report will have an impact performance.'''

===indent===

The <code>indent</code> is a CSV-format specified keyword which adds indentation character data to the generated event stream. This simply makes the generated event stream easier to read in its serialized form and generally should only be used in testing.

===quoteCharacter===

The <code>quoteCharacter</code> is a CSV format-specific keyword, which defines the character to use in the CSV file to identify values.

===encoding===
With the keyword '''enconding''' followed by the encoding name as a string value you are able to specify the valid encoding of the file content.

► '''Example 1''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName merge elementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "UTF-8"{}</syntaxhighlight>
► '''Example 2''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName remove elementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "GB18030"{}</syntaxhighlight>
► '''Example 3''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName persistelementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "ISO-2022-JP"{}</syntaxhighlight>

===mappingModel===

The <code>mappingModel</code> keyword is an EDI-specific keyword which can be used to specify an EDI to XML mapping model in XML format for Smooks.

===validate===

The <code>validate</code> keyword is an EDI-specific keyword that...

===path===

The keyword <code>path</code> starts the series of entities. (Formerly, the keyword was named <code>beans</code>. The name "bean" comes from the internal entities called JavaBean, which act as data containers.)

===entity===

With the <code>entity</code> keyword followed by a fully qualified name, the user can specify the mapping between a source data file and a data-containing entity. The behavior of the mapping can be further fine-tuned with the keywords discussed below. While these keywords can theoretically be combined all together and create very complicated behavior, they are normally used in a simple and straight forward way.

The general form of <code>entity</code> keywords is:

► '''Syntax''':
<syntaxhighlight>
entity <ID>
[nodeName <node-name>]
[createOn <element-map>]
[marker <property-name>]
[expression '{' <expressions> '}']
[lookup '{' <lookup-rules> '}']
[format '{' <formats> '}']
[mapping '{' <mappings> '}']
[keys '{' <lookup-keys> '}']
;
</syntaxhighlight>

The order of the keywords is fixed, i.e. they are all optional, but must appear in the given order.

====nodeName====

With the optional keyword <code>nodeName</code> followed by a string you can specify the name (alias) of corresponding elements inside an (XML) input/output configuration file. This name is used to identify entities within an XML file using the [http://freemarker.org/docs/pgui_datamodel.html NodeModel of Freemarker] instead of using the standard Java Object Model name. For example:

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file XML "C:/.../net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/stores.xml" path {
entity Mregion nodeName "region"
entity Mstore nodeName "store"
entity Mwarehouse nodeName "warehouse"
}
</syntaxhighlight>

The result from this example code is the generation of Smooks configuration files, in which the structure of the output data file (order of elements) will be the same as declared inside the path {...} expression block. The alias you have specified after the keyword will be used as element (entity) name inside the XML files.

<div id="Figure3"> [[File:FreeMarkerNodeModelStoreInEx.png|600px|thumb|center|''Figure 3: Store-import.xml and Store-export.xml with NodeModel'']] </div>

The use of this keyword gives you the flexibility of naming entities using aliases in order to match any third part system description. By omitting the definition of both aliases ''region'' and ''warehouse'' like shown below, we obtain slightly divergent but very different contents than the ones from above.

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file XML "C:/.../net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/stores.xml" path {
entity Mregion
entity Mstore nodeName "store"
entity Mwarehouse
}
</syntaxhighlight>

[[File:FreeMarkerJavaObjectModelStoreInEx.png|600px|thumb|center|''Figure 4: Store-import.xml (normal) and Store-export.xml (normal) with Java Object Model Name'']]

Please note that the declaration order of each node names matters.

====createOn====

The <code>createOn</code> keyword followed by a string specifies on which input element should an entity to be created. For example:

► '''Example''':
<syntaxhighlight lang="java">
entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" ... {
...
}

</syntaxhighlight>

will create an <code>Mcurrency</code> entity when encountering <code>/Envelope/Cube/Cube</code> in the source data file.

====latestImport / latestExport====

With <code>latestImport</code> keyword optionally followed by a property-name, the user can set the data to be imported to have an additional property under the given name whose value set to 1, while updating the existing data to have this property having value 0. This could be useful to identify the most recent import of some periodically updated data. For example:

► '''Example''':
<syntaxhighlight lang="java">

entity McurrencyStream createOn "/Envelope/Cube" latestImport latest expression {
...
}
</syntaxhighlight>

will make the entity <code>McurrencyStream</code> to have a property "<code>latest</code>", which is to be set to 1 for the most recently imported data.

Keyword <code>latestExport</code> works analogous.

====expression====

With an <code>expression { ... }</code> block, the user can define expressions that assign certain value to an entity property. These expressions are of two types, the first one is:

► '''Syntax''':
<syntaxhighlight lang="java">

assign <id> with <value> as <type>

</syntaxhighlight>

this will assign the property <code>id</code> with the value of <code>value</code>, in type of <code>type</code>. The <code>value</code> may be one of the following:

* <code>NowDate</code>: the date of now (the time point of action)
* <code>StartDate</code>: the date when the process started
* <code>UniversallyUniqueIdentifier</code>: an UUID

and <code>type</code> may be one of the following:

* <code>Date</code>: the value of NowDate or StartDate will be in date format
* <code>Milliseconds</code>: the value of NowDate or StartDate will be in millisecond
* <code>Nanoseconds</code>: the value of NowDate or StartDate will be in nanosconds
* <code>Random</code>: the value of UUID will be random
* <code>ExecuteContext</code>: the value of UUID will be unique for the execute context

Note that the <code>Random</code> and <code>ExecuteContext</code> should be only combined with <code>UniversallyUniqueIdentifier</code>, while the other types should be only combined with <code>NowDate</code> or <code>StartDate</code>.

► '''Example''':
<syntaxhighlight lang="java">
entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
assign importDate with NowDate as Date
}
</syntaxhighlight>

will assign the <code>importDate</code> as the current date in <code>Date</code> format.

The other type of expression has the form:

► '''Syntax''':
<syntaxhighlight lang="java">

copy <target-property> from <entity-name> property <from-property>

</syntaxhighlight>

which will copy the value of <code>from-property</code> from the <code>entity-name</code> to <code>target-property</code>.

► '''Example''':
<syntaxhighlight lang="java">

entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" expression {
copy currencyDate from McurrencyDay property ratingDate
}

</syntaxhighlight>

will copy the value of <code>ratingDate</code> from <code>McurrencyDay</code> entity to <code>currencyDate</code>.

====lookup====
<div id="lookup">
With a <code>lookup</code> { ... } block, the user can define a set of '''lookup-rules''' to identify complex data within our persistence layer (DB or In-Memory...). This makes sense when the data in a source file can't be clearly identified by an attribute (id), but moreover when the set data it contains is persisted over several entities.

► '''Syntax''':
<syntaxhighlight lang="java">
lookup {
[<lookup-rules>]*
}
</syntaxhighlight>

Lookup-rule expression:
<syntaxhighlight>
lookup-rule:
'for' .. 'on' .. 'createOn' .. 'with' .. 'cacheSize' .. 'mapTo' .. ['allowNoResult' | 'allowNoResult' | 'markerPath']
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
interchange Currencies describedBy "european central bank currency exchange rates based on euro" persist elementSize 50 file
XML "C:/git/development/net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/eurofxref-hist-90d.xml"

mapByAttribute path {
entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
assign importDate with NowDate as Date
}
entity McurrencyDay createOn "/Envelope/Cube/Cube" format {
for ratingDate coding "yyyy-MM-dd"
}
mapping {
map ratingDate to "time"
}
entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" expression {
copy currencyDate from McurrencyDay property ratingDate
}
lookup {
for currency_name on McurrencyName createOn "/Envelope/Cube/Cube/Cube" with isoCode cacheSize 300 mapTo "currency" allowNoResult
markerPath {
markerEntity McurrencyNameStream markedBy latest
}
}
mapping {
map conversion_ratio to "rate"
}

}

</syntaxhighlight>

</div>

We will provide you in upcoming releases with more information about so called '''locator''' instances, which are generated in the background on the basis of the '''lookups''' you would have defined, in order to query persisted data. This will give you more insights about how the Datainterchange DSL really works at the lower level.

====format====

With a <code>format { ... }</code> block, the user can define the format of the entity property being converted. A <code>format</code> block can have more than one format definitions, in the following format:

► '''Syntax''':
<syntaxhighlight lang="java">

format {
for <property> coding <format-string> [locale <locale-string>]
...
}

</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">

entity McurrencyDay createOn "/Envelope/Cube/Cube" format {
for ratingDate coding "yyyy-MM-dd"
}

</syntaxhighlight>

will convert the <code>"/Envelope/Cube/Cube"</code> data to <code>ratingDate</code> property of <code>McurrencyDay</code> in format <code>"yyyy-MM-dd"</code>, where

► '''Example''':
<syntaxhighlight lang="java">

entity EDIOrderHeader createOn "/Order/header" format {
for hdrDate coding "EEE MMM dd HH:mm:ss zzz yyyy" locale "en_US"
}

</syntaxhighlight>

will format the <code>hdrDate</code> in format <code>"EEE MMM dd HH:mm:ss zzz yyyy"</code> with English locale, i.e. the month and weekday names will be in English.

====expose====

With a <code>expose { ... }</code> block, when and only when exporting an entity, the user can expose properties of its referenced entity. A <code>expose</code> block can have more than one expose definitions, in the following syntax format:

► '''Syntax''':
<syntaxhighlight lang="java">

expose {
ref <EntityReference>
on <EntityAttribute>
| subExpose
...
}

</syntaxhighlight>

'''subExpose''' has the same syntax format as '''expose''', which is:

<syntaxhighlight lang="java">

expose {
ref <EntityReference>
on <EntityAttribute>
| subExpose
...
}

</syntaxhighlight>

► '''Example''':

Entities are defined as following:

<syntaxhighlight lang="java">

entity CashSlip {
...
var boolean payed
ref cascade CashPosition[ * ]positions opposite slip
ref Mcustomer customer opposite slips }

</syntaxhighlight>

<syntaxhighlight lang="java">

entity Mcustomer extends BaseID {
...
var long account_num
var String name
ref Mregion region opposite customers
ref Msales_fact[ * ]sales opposite customer }

</syntaxhighlight>

In datainterchange DSL, when exporting entity "'''CashSlip'''", the user can use "'''expose'''" keyword to export the "'''account_num'''" property of "'''Mcustomer'''" referenced here as "'''customer'''".
And sub-reference of the reference can also be exported. In the following example, the "'''region'''" reference (of entity "'''Mregion'''") in "'''Mcustomer'''" has a property "'''sales_city'''", it is also exported.

<syntaxhighlight lang="java">

interchange CashSlip describedBy "CashSlip" merge vectorName "cashslip" file XML "C:/MC/cashdata.xml" encoding "UTF-8"
path {
entity CashSlip

expose {
customer on account_num
customer expose {
region on sales_city
}
}
}

</syntaxhighlight>

In the generated Smooks config XML, the section will look like this:
<syntaxhighlight lang="java">

<account_num>${(CashSlip.customer.account_num)!}</account_num>

</syntaxhighlight>

And the sub-expose part looks like this:
<syntaxhighlight lang="java">

<sales_city>${(CashSlip.customer.region.sales_city)!}</sales_city>

</syntaxhighlight>

* This recursive-export can go as many levels as the user want.

====mapping====
With a <code>mapping { ... }</code> block, the user can easily '''map''' (or rather '''match''') attributes of the data model to values from external source files.

► '''Syntax''':
<syntaxhighlight lang="java">
mapping {
[map <entity-attribute> to <Data>]*
[mapBlob <entity-attribute> to <Data> [extension <blob-file-extension] [path <blob-path>] mimeType <mine-type> ]*
}
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
mapping{
map conversion_ratio to "rate"
mapBlob currency_icon to "currency_icon" extension "png" path "C:/data/currency_images" mimeType png
}
</syntaxhighlight>

The first map of the above example will map the attribute conversion_ratio of the entity to field "rate".
The second mapBlob does a bit more work, it will:

* generate full file paths by combining the path, the file names specified by "currency_icon" field, and the extension,
* upload the files into database with the given mimeType, and
* assign the UUID of the blob to property currency_icon of the entity.

Please note that the only valid attributes here are the members of the corresponding entity, which the user has chosen prior defining the <code>mapping</code> block itself.

====keys====
With a <code>keys</code> { ... } block, the user can define a set of '''keys''' to identify data within our persistence layer (DB or In-Memory...).
This makes sence when the data in a source file can't be clearly identified by an attribute (id). Therefore a set of attributes (keys) can be defined and then be used as identification parameter set by a [[#lookup|''lookups'']] instance in order to query our data pool and identify data using several criteria.

► '''Syntax''':
<syntaxhighlight lang="java">
keys {
[key <entity-attribute>]*
}
</syntaxhighlight>

Assuming you try to update the address data of an employee from an entity named Employee, but you happen not to have his/her personal id. By setting a <code>keys</code> { ... } block, like shown here below, you allow the Datainterchange unit to look into the database after employee's data based on the key set inside this block, rather than using a personal id, which might have been here unique and more than enough to find the employee right away.

► '''Example''':
<syntaxhighlight lang="java">
keys {
key last_name
key first_name
key age
}
</syntaxhighlight>

Please note that the only valid attributes here are members of the corresponding entity, that you would have chosen prior defining the <code>keys</code> block itself.

==TriggerView==
A TriggerView will be automatically generated by the DataInterchange DSL as soon as you define an interchange unit inside the model file and save it.

You can see on the right side of the figure shown below, the definition of 10 interchange units within the Datainterchange model file (blue rectangles); and on the right side of the figure you can see, how the TriggerView looks like (green rectangle), when it is embedded inside an application page in its entirety.

[[File:TriggerView.png|600px|center|''Figure 5: Datainterchange TriggerView Definition and Application Views''|thumbnail|600px]]

To achieve this result you need to do two simple steps. You need first to either integrate the TriggerView into an existing perspective or create a new perspective and then integrate the view into it, like shown below.

► '''Example 1''':
<syntaxhighlight lang="java">
import ns net.osbee.sample.foodmart.datainterchanges
...

package net.osbee.sample.foodmart.perspectives {

perspective Currencies iconURI "employee" {
sashContainer c1 orientation horizontal {
part imex view dataInterchange datainterchanges spaceVolume "20"
...
}
}
}
</syntaxhighlight>

The most important thing in this example is to notice the use of the keyword '''view''' followed by the keyword '''dataInterchange''' and the name ''datainterchanges'' referring to the package, in which all datainterchange unit definitions have to be found.

The second step would be to create a menu entry for you to be able to access the newly created or altered perspective in the application via the menu bar, like shown in the following example.

► '''Example 2''':
<syntaxhighlight lang="java">
import ns net.osbee.sample.foodmart.perspectives.Currencies
...

package net.osbee.sample.foodmart.menues {
...
entry Menu describedBy "my menu" {
entry Perspectives {
entry MasterData {
entry Company image "company" perspective Company
entry Employees image "employee" perspective Employee
entry Products image "products" perspective Products
entry CashRegisterData image "editor_area" perspective CashMasterDataRegister

entry Currencies image "products" perspective Currencies

entry People image "task_action_delegate" perspective PeopleMock

}
...
... }
}

}
</syntaxhighlight>

[[File:TriggerViewMenuSelection.png|600px|center|''Figure 6: Datainterchange TriggerView Menu Selection''|thumbnail|600px]]

The figure above shows the same menu structure defined in the example 2 and results in showing the application with the TriggerView, as you can see on the left side of the figure 5. You can get and review more information on how to create menu entries and perspectives in both [[Menu DSL]] and [[Perspective DSL]] documentation pages.

Among all the components that are generated for the use of each interchange unit functions are action buttons, you would find inside toolbars in some dialogs. Usually you have to define them by yourself in the corresponding DSL files. This step is not needed here, since it has already been generated for this particular view.

[[File:TriggerViewActionButtons.png|600px|center|''Figure 7: Action Buttons for datainterchange unit functions''|thumbnail|600px]]

Please note that it is '''not mandatory''' to display all available functionalities through the use of the TriggerView like shown here above. It is customary to only use parts of the generated Datainterchange components (e.g. action buttons) where you see them fit; for instance in order to only use each interchange unit functionalities (import and/or export) in separated and dedicated views (dialogs). Therefore, we also recommend you to have a look at the [[Action DSL]] documentation page in order to understand how to create your own toolbars, and so forth creating the buttons using import or export functions of any datainterchange unit you would have created.

==Smooks Configuration and Settings File==
'''Please note that whenever a model is saved''', the '''Datainterchange DSL''' will do three things '''automatically''':

* generate Java classes,
* generate Smooks configuration files for both import and export functions, and
* generate a config file to modify the import and export paths on runtime.

===Smooks Configuration File===

The OS.bee implementation of Data Interchange interface is based on Smooks. Smooks is a Java framework for processing XML and non XML data (CSV, EDI, Java etc) by mapping data to JavaBeans, which can later be persisted, enriched (merge with existing data from other source), or converted and exported into other formats.

Smooks relies on a proper configuration file for the import / export processes. These configuration files are generated by the Datainterchange DSL automatically. Here is a brief introduction of how the generated Smooks configuration files work.

When a data import / export Smooks instance is initiated, it will be supplied with the generated config file. This file defines the actions to be performed upon certain events during the SAX parsing process. Here is an example:
<syntaxhighlight lang="xml" line='line'>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:csv="http://www.milyn.org/xsd/smooks/csv-1.2.xsd" xmlns:dao="http://www.milyn.org/xsd/smooks/persistence-1.2.xsd" xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.2.xsd">
<jb:bean beanId="McurrencyNameStream" class="net.osbee.sample.foodmart.entities.McurrencyNameStream" createOnElement="/csv-set">
<jb:expression property="importDate">PTIME.nowDate</jb:expression>
<jb:wiring beanIdRef="McurrencyName" setterMethod="addToCurrencyNames"/>
</jb:bean>
<jb:bean beanId="McurrencyName" class="net.osbee.sample.foodmart.entities.McurrencyName" createOnElement="/csv-set/csv-record">
<jb:value data="/csv-set/csv-record/isoCode" decoder="String" property="isoCode"/>
<jb:value data="/csv-set/csv-record/name" decoder="String" property="name"/>
<jb:value data="/csv-set/csv-record/countries" decoder="String" property="countries"/>
</jb:bean>
<csv:reader fields="isoCode,name,countries" indent="false" separator=";" skipLines="1"/>
<params>
<param name="stream.filter.type">SAX</param>
<param name="inputType">input.csv</param>
<param name="smooks.visitors.sort">false</param>
<param name="input.csv" type="input.type.actived">C:/git/net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/ISOCurrencyCodes081507.csv</param>
</params>
</smooks-resource-list>
</syntaxhighlight>

Further informations on the Smoooks framework are available and can be reviewed in its [http://www.smooks.org/guide documentation] you will find on the [http://www.smooks.org/index official website].

===Path Config File===

The file is interpreted using the Properties xml im- and export method and looks like this:

<syntaxhighlight lang="java">

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>dataInterchange file URLs</comment>
<entry key="EmployeesDepartment-import">C:/myimports/employeesdepartment.xml</entry>
<entry key="EmployeesDepartment-export">C:/myexports/employeesdepartment.xml</entry>
</properties>

</syntaxhighlight>

By default this file is named like the title in the Data Interchange package and extended by "Config" and has the extension "xml":

<code>package net.osbee.sample.foodmart.datainterchanges title "DataInterchange" {}</code>

leads to the filename:

<code>DataInterchangeConfig.xml</code>

and is stored platform independently in the current user's home directory under the subdirectory ".osbee".

An administrator must receive this configuration file with the application, modify it and place it somewhere on the application server. The path to this configuration file must be supplied in the product's preferences (<code>org.eclipse.osbp.production.prefs</code>):

<code>datainterchange/datainterchangeConfiguration=c\:\\DataInterchangeConfig.xml</code>

The path value obviously depends on the operating system you are developing.

===Further Reading===

There is a lot of information to be found in the internet that describe the formal structure of the smooks configuration in any case. A very good one can be found at [https://access.redhat.com/documentation/en-us/red_hat_jboss_fuse/6.3/html-single/smooks_development_guide/index RedHat].

== Copyright Notice ==
{{Copyright Notice}}

Datainterchange DSL

2019-09-04T15:49:06Z

Kraeling:

==Purpose==

The Data Interchange DSL (datainterchange for short) is made for defining data exchange models that can be used to import data from various formats (CSV, XML, EDI, etc.), map the data to entities, store them into database, or export them back into other formats.

You only need to define the ''relationship'' between the file and the bean, not the import / export process themselves. Once defined, these models can be used in e.g. action DSL to define actions which, when triggered, execute the actual import / export process, which are generated automatically by the OSBP based on the model.

==Overview==

As shown on the figure below, the [DSL Inferrer] will generate various views and In/Export component according to model described by datainterchange DSL (and action DSL, in the case of ActionButtons). The action buttons, when clicked, will trigger their corresponding In/Export processes by putting [http://download.osbee.org/downloads/javadoc/osbee-master-clean/org.eclipse.osbp.xtext.datainterchange.feature/apidocs/ WorkerThread (Runnable)] jobs into the executor job pool within the TriggerView (prefixed with datainterchang name), buttons (and toolbar / menus containing them) are further included in the perspective.

[[File:Datainterchange.png|600px|center|frame|''Figure 1: - Data Interchange Structure.'']]

==Data Interchange Model File==

Datainterchange DSL model files end with the <code>.data</code> extension. Data Interchange models may be split into several <code>.data</code> files, as long as they have the same package declaration.

In the following we will dive deeper into the description and the usage of Datainterchange related and reserved keywords.

===import===
In the import section are all entities to be found - as full qualified names – that are currently used in the DSL.

► '''Example''':
<syntaxhighlight lang="java">

import ns net.osbee.sample.foodmart.entities.Mstore
import ns net.osbee.sample.foodmart.entities.Mwarehouse
import ns net.osbee.sample.foodmart.entities.Mregion

</syntaxhighlight>

Note that <code>ns</code> is a mandatory keyword (stands for "namespace") that comes after import for distinguishing the OS.bee internal namespaces and Java library namespaces. Wildcards are not supported, all names should be imported separately. Note that the import section will be imported/added automatically if they are used in the package, so you don't have to manually manage this section.

===package===

Datainterchange DSL model files must start with a package declaration. Packages are the root element of the DSL and should be defined as <code><ApplicationName>.datainterchanges</code>.

► '''Example''':
<syntaxhighlight lang="java">package net.osbee.sample.foodmart.datainterchanges { }</syntaxhighlight>

Data Interchange models may be split into several .data files, as long as they have the same package declaration, the interchanges will be available under this package name.

===title===
With the keyword title you can give a name to the corresponding TriggerView dialog inside your application. For example, the definition of the same datainterchanges package from above with title "Data Interchange Example":

► '''Example''':
<syntaxhighlight lang="java">package net.osbee.sample.foodmart.datainterchanges title "Data Interchange Example" {}</syntaxhighlight>

This title will be translated based on locale.

You can get more details about the TriggerView in the section below.

===interchange===
The <code>interchange</code> keyword defines interchange units for entities in the package, it should be in the form of:

► '''Example''':
<syntaxhighlight lang="java">
interchange <InterchangeUnitName> [describedBy <description>] <EntityManagerMode> file <FileType> [<FileDetails>] beans {
...
}
</syntaxhighlight>

Where <code>InterchangeUnitName</code> being the name of the interchange unit; <code>describedBy</code> (optional) can be used to provide a short description string. <code>EntityManagerMode</code> being how the file should be handled (see section "persist, merge, remove" below), and after <code>file</code> keyword, you should specify the type of the source / target data file you would like to import from or export to, then the file path, and other details depends on the type.

The following example specifies an interchange that reads a CSV file under the specified path (note the forward slash as the path separator), delimited by semicolon, skip one line (the header), and treat the content as encoded in UTF-8:

► '''Example''':
<syntaxhighlight lang="java">

interchange CurrencyNames persist file
CSV "C:/data/ISOCurrencyCode20170101.csv" delimiter ";" skipLines 1 encoding "UTF-8"
beans {
...
}
</syntaxhighlight>

The <code>beans</code> keyword comes after all the file specification and starts a block of entity definitions, which will be covered in section "entity".

===describedBy===
With this keyword you can the optional description of an interchange unit as shown below.

► '''Example''':
<syntaxhighlight lang="java">
interchange Currencies describedBy "european central bank currency exchange rates based on euro" persist ... { ... }
</syntaxhighlight>

===vectorName===
With the optional keyword <code>vectorName</code> followed by a string value you are able to define the name of the root element of both XML configuration files needed by Smooks. Please note that it also means that the first (root-)element of an XML-File you would have exported (file filled with real data) via the application will have the same name.

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file ... { ... }
</syntaxhighlight>

You can view the result of this sample of code like shown below on figure[[#Figure3|''3'']].

===persist, merge, remove===
These keywords define the purpose of the datainterchange unit and has a similar meaning as in the JPA's EntityManager class. Basically, <code>persist</code> will insert the data records into database, <code>merge</code> will update existing data record, or insert new one if necessary, <code>remove</code> will remove the record if it could be found in database.

► '''Example 1''': (persist)
<syntaxhighlight lang="java">
interchange EDIOrders describedBy "Orders" persist file
XML "C:/data/orders.xml"
beans {
...
}
</syntaxhighlight>

► '''Example 2''': (merge)
<syntaxhighlight lang="java">
interchange Stores merge file
XML "C:/data/stores.xml"
beans {
...
}
</syntaxhighlight>

► '''Example 3''': (remove)
<syntaxhighlight lang="java">
interchange Storesremove remove file
XML "C:/data/stores_remove.xml"
beans {
...
}
</syntaxhighlight>

===file===
With the keyword file you are able to set the file format of the files you intent to process with you interchange unit.

► '''Syntax''':
<syntaxhighlight lang="java">interchange <SampleInterchangeUnitName> <EntityManagerMode> file <FileNameFormat> {}</syntaxhighlight>

The current supported file formats are CSV, EDI and XML followed by the name of the file you want to process, given its full path location in the system.
► '''Example 1''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit1 merge file CSV "C:/temp/testFile.csv" {}</syntaxhighlight>
► '''Example 2''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit2 persist file XML "C:/temp/testFile.xml" {}</syntaxhighlight>
► '''Example 3''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit3 merge file EDI "C:/temp/testFile.edi" {}</syntaxhighlight>

After choosing the file format you can either give the file name as a String value in a double quote "..." as shown here above, or press Ctrl+Space to get via the content assist the option of opening a File Chooser/Picker to specify the file you want to work with.

[[File:FileChooser.jpg|center|frame|''Figure 2: File Chooser'']]

Please note that you can also change the path(?) of the file to process on runtime by selecting a new file.

===mapByAttribute===

The <code>mapByAttribute</code> keyword is an XML-specific keyword that turns on the automatic attribute mapping. When enabled, datainterchange will detect if the value being mapped is from an attribute. For example, the 'USD' value in the following XML file comes from the attribute 'currency' of the element 'Cube':

► '''Example''':
<syntaxhighlight lang="xml">
<Cube currency='USD' rate='1.3759'/>
</syntaxhighlight>

while in the following XML file, the same value is encapsulated in the element 'currency':

► '''Example''':
<syntaxhighlight lang="xml">

<Cube>
<currency>USD</currency>
<rate>1.3759</rate>
</Cube>
</syntaxhighlight>

When <code>mapByAttribute</code> is present, datainterchange will automatically decide that a query in the form like <code>'/Cube/currency'</code> will also catch the value from attribute. Without it, the query will have to put a <code>'@'</code> symbol in front of the attribute name, i.e. <code>'/Cube/@currency'</code>.

===elementSize===
With the keyword <code>elementSize</code> followed by an integer, the user can set the estimated average size of the elements in bytes. Since the underlying API cannot know the size of an element before it is processed, this value can be supplied as a guide value to be used for estimating the import / output progress based on how much bytes have been processed.

► '''Example''':
<syntaxhighlight lang="java">
interchange EDIOrders describedBy "edi orders" persist elementSize 50 file EDI "C:/data/orders.edi" beans {
...
}
</syntaxhighlight>

Defines an average estimated element size of 50 bytes.

===delimiter===

The <code>delimiter</code> is a CSV format-specific keyword, which defines the character to use in the CSV file to set the delimiter/separation character between different values. Default value is "," (comma).

► '''Example''':
<syntaxhighlight lang="java">
interchange CurrencyNames persist file
CSV "C:/data/ISOCurrencyCodes081507.csv" delimiter ";" ... {
...
}
</syntaxhighlight>

will set the delimiter of the CSV file to ";".

===skipLines===
This is a CSV format-specific keyword. Using <code>skipLines</code> followed by an integer, the user can specify the number of lines to be skipped from the beginning in the processing of the selected file, this can be used to skip headers.

► '''Example''':
<syntaxhighlight lang="java">
interchange CurrencyNames persist file CSV "C:/data/ISOCurrencyCodes081507.csv" ... skipLines 1 encoding "UTF-8" {
...
}
</syntaxhighlight>

will skip the first line of the CSV file.

===report===

If a '''datainterchange''' unit is defined with the <code>report</code> keyword, a report will be generated for data conversions. The report file is generated by Smooks, lies under <code>/smooks</code> output directory of the datainterchange bundle, and has a name in the form like <code><DataInterChangeName>-input.xml</code> for input processes, and <code><DataInterChangeName>-output.xml</code> for output processes. '''Note: turn on report will have an impact performance.'''

===indent===

The <code>indent</code> is a CSV-format specified keyword which adds indentation character data to the generated event stream. This simply makes the generated event stream easier to read in its serialized form and generally should only be used in testing.

===quoteCharacter===

The <code>quoteCharacter</code> is a CSV format-specific keyword, which defines the character to use in the CSV file to identify values.

===encoding===
With the keyword '''enconding''' followed by the encoding name as a string value you are able to specify the valid encoding of the file content.

► '''Example 1''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName merge elementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "UTF-8"{}</syntaxhighlight>
► '''Example 2''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName remove elementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "GB18030"{}</syntaxhighlight>
► '''Example 3''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName persistelementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "ISO-2022-JP"{}</syntaxhighlight>

===mappingModel===

The <code>mappingModel</code> keyword is an EDI-specific keyword which can be used to specify an EDI to XML mapping model in XML format for Smooks.

===validate===

The <code>validate</code> keyword is an EDI-specific keyword that...

===beans===

The keyword <code>beans</code> starts the series of entities. The name "bean" comes from the internal entities called JavaBean, which act as data containers.

===entity===

With the <code>entity</code> keyword followed by a fully qualified name, the user can specify the mapping between a source data file and a data-containing entity. The behavior of the mapping can be further fine-tuned with the keywords discussed below. While these keywords can theoretically be combined all together and create very complicated behavior, they are normally used in a simple and straight forward way.

The general form of <code>entity</code> keywords is:

► '''Syntax''':
<syntaxhighlight>
entity <ID>
[nodeName <node-name>]
[createOn <element-map>]
[marker <property-name>]
[expression '{' <expressions> '}']
[lookup '{' <lookup-rules> '}']
[format '{' <formats> '}']
[mapping '{' <mappings> '}']
[keys '{' <lookup-keys> '}']
;
</syntaxhighlight>

The order of the keywords is fixed, i.e. they are all optional, but must appear in the given order.

====nodeName====

With the optional keyword <code>nodeName</code> followed by a string you can specify the name (alias) of corresponding elements inside an (XML) input/output configuration file. This name is used to identify entities within an XML file using the [http://freemarker.org/docs/pgui_datamodel.html NodeModel of Freemarker] instead of using the standard Java Object Model name. For example:

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file XML "C:/.../net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/stores.xml" beans {
entity Mregion nodeName "region"
entity Mstore nodeName "store"
entity Mwarehouse nodeName "warehouse"
}
</syntaxhighlight>

The result from this example code is the generation of Smooks configuration files, in which the structure of the output data file (order of elements) will be the same as declared inside the beans {...} expression block. The alias you have specified after the keyword will be used as element (entity) name inside the XML files.

<div id="Figure3"> [[File:FreeMarkerNodeModelStoreInEx.png|600px|thumb|center|''Figure 3: Store-import.xml and Store-export.xml with NodeModel'']] </div>

The use of this keyword gives you the flexibility of naming entities using aliases in order to match any third part system description. By omitting the definition of both aliases ''region'' and ''warehouse'' like shown below, we obtain slightly divergent but very different contents than the ones from above.

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file XML "C:/.../net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/stores.xml" beans {
entity Mregion
entity Mstore nodeName "store"
entity Mwarehouse
}
</syntaxhighlight>

[[File:FreeMarkerJavaObjectModelStoreInEx.png|600px|thumb|center|''Figure 4: Store-import.xml (normal) and Store-export.xml (normal) with Java Object Model Name'']]

Please note that the declaration order of each node names matters.

====createOn====

The <code>createOn</code> keyword followed by a string specifies on which input element should an entity to be created. For example:

► '''Example''':
<syntaxhighlight lang="java">
entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" ... {
...
}

</syntaxhighlight>

will create an <code>Mcurrency</code> entity when encountering <code>/Envelope/Cube/Cube</code> in the source data file.

====latestImport / latestExport====

With <code>latestImport</code> keyword optionally followed by a property-name, the user can set the data to be imported to have an additional property under the given name whose value set to 1, while updating the existing data to have this property having value 0. This could be useful to identify the most recent import of some periodically updated data. For example:

► '''Example''':
<syntaxhighlight lang="java">

entity McurrencyStream createOn "/Envelope/Cube" latestImport latest expression {
...
}
</syntaxhighlight>

will make the entity <code>McurrencyStream</code> to have a property "<code>latest</code>", which is to be set to 1 for the most recently imported data.

Keyword <code>latestExport</code> works analogous.

====expression====

With an <code>expression { ... }</code> block, the user can define expressions that assign certain value to an entity property. These expressions are of two types, the first one is:

► '''Syntax''':
<syntaxhighlight lang="java">

assign <id> with <value> as <type>

</syntaxhighlight>

this will assign the property <code>id</code> with the value of <code>value</code>, in type of <code>type</code>. The <code>value</code> may be one of the following:

* <code>NowDate</code>: the date of now (the time point of action)
* <code>StartDate</code>: the date when the process started
* <code>UniversallyUniqueIdentifier</code>: an UUID

and <code>type</code> may be one of the following:

* <code>Date</code>: the value of NowDate or StartDate will be in date format
* <code>Milliseconds</code>: the value of NowDate or StartDate will be in millisecond
* <code>Nanoseconds</code>: the value of NowDate or StartDate will be in nanosconds
* <code>Random</code>: the value of UUID will be random
* <code>ExecuteContext</code>: the value of UUID will be unique for the execute context

Note that the <code>Random</code> and <code>ExecuteContext</code> should be only combined with <code>UniversallyUniqueIdentifier</code>, while the other types should be only combined with <code>NowDate</code> or <code>StartDate</code>.

► '''Example''':
<syntaxhighlight lang="java">
entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
assign importDate with NowDate as Date
}
</syntaxhighlight>

will assign the <code>importDate</code> as the current date in <code>Date</code> format.

The other type of expression has the form:

► '''Syntax''':
<syntaxhighlight lang="java">

copy <target-property> from <entity-name> property <from-property>

</syntaxhighlight>

which will copy the value of <code>from-property</code> from the <code>entity-name</code> to <code>target-property</code>.

► '''Example''':
<syntaxhighlight lang="java">

entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" expression {
copy currencyDate from McurrencyDay property ratingDate
}

</syntaxhighlight>

will copy the value of <code>ratingDate</code> from <code>McurrencyDay</code> entity to <code>currencyDate</code>.

====lookup====
<div id="lookup">
With a <code>lookup</code> { ... } block, the user can define a set of '''lookup-rules''' to identify complex data within our persistence layer (DB or In-Memory...). This makes sense when the data in a source file can't be clearly identified by an attribute (id), but moreover when the set data it contains is persisted over several entities.

► '''Syntax''':
<syntaxhighlight lang="java">
lookup {
[<lookup-rules>]*
}
</syntaxhighlight>

Lookup-rule expression:
<syntaxhighlight>
lookup-rule:
'for' .. 'on' .. 'createOn' .. 'with' .. 'cacheSize' .. 'mapTo' .. ['allowNoResult' | 'allowNoResult' | 'markerPath']
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
interchange Currencies describedBy "european central bank currency exchange rates based on euro" persist elementSize 50 file
XML "C:/git/development/net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/eurofxref-hist-90d.xml"

mapByAttribute beans {
entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
assign importDate with NowDate as Date
}
entity McurrencyDay createOn "/Envelope/Cube/Cube" format {
for ratingDate coding "yyyy-MM-dd"
}
mapping {
map ratingDate to "time"
}
entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" expression {
copy currencyDate from McurrencyDay property ratingDate
}
lookup {
for currency_name on McurrencyName createOn "/Envelope/Cube/Cube/Cube" with isoCode cacheSize 300 mapTo "currency" allowNoResult
markerPath {
markerEntity McurrencyNameStream markedBy latest
}
}
mapping {
map conversion_ratio to "rate"
}

}

</syntaxhighlight>

</div>

We will provide you in upcoming releases with more information about so called '''locator''' instances, which are generated in the background on the basis of the '''lookups''' you would have defined, in order to query persisted data. This will give you more insights about how the Datainterchange DSL really works at the lower level.

====format====

With a <code>format { ... }</code> block, the user can define the format of the entity property being converted. A <code>format</code> block can have more than one format definitions, in the following format:

► '''Syntax''':
<syntaxhighlight lang="java">

format {
for <property> coding <format-string> [locale <locale-string>]
...
}

</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">

entity McurrencyDay createOn "/Envelope/Cube/Cube" format {
for ratingDate coding "yyyy-MM-dd"
}

</syntaxhighlight>

will convert the <code>"/Envelope/Cube/Cube"</code> data to <code>ratingDate</code> property of <code>McurrencyDay</code> in format <code>"yyyy-MM-dd"</code>, where

► '''Example''':
<syntaxhighlight lang="java">

entity EDIOrderHeader createOn "/Order/header" format {
for hdrDate coding "EEE MMM dd HH:mm:ss zzz yyyy" locale "en_US"
}

</syntaxhighlight>

will format the <code>hdrDate</code> in format <code>"EEE MMM dd HH:mm:ss zzz yyyy"</code> with English locale, i.e. the month and weekday names will be in English.

====expose====

With a <code>expose { ... }</code> block, when and only when exporting an entity, the user can expose properties of its referenced entity. A <code>expose</code> block can have more than one expose definitions, in the following syntax format:

► '''Syntax''':
<syntaxhighlight lang="java">

expose {
ref <EntityReference>
on <EntityAttribute>
| subExpose
...
}

</syntaxhighlight>

'''subExpose''' has the same syntax format as '''expose''', which is:

<syntaxhighlight lang="java">

expose {
ref <EntityReference>
on <EntityAttribute>
| subExpose
...
}

</syntaxhighlight>

► '''Example''':

Entities are defined as following:

<syntaxhighlight lang="java">

entity CashSlip {
...
var boolean payed
ref cascade CashPosition[ * ]positions opposite slip
ref Mcustomer customer opposite slips }

</syntaxhighlight>

<syntaxhighlight lang="java">

entity Mcustomer extends BaseID {
...
var long account_num
var String name
ref Mregion region opposite customers
ref Msales_fact[ * ]sales opposite customer }

</syntaxhighlight>

In datainterchange DSL, when exporting entity "'''CashSlip'''", the user can use "'''expose'''" keyword to export the "'''account_num'''" property of "'''Mcustomer'''" referenced here as "'''customer'''".
And sub-reference of the reference can also be exported. In the following example, the "'''region'''" reference (of entity "'''Mregion'''") in "'''Mcustomer'''" has a property "'''sales_city'''", it is also exported.

<syntaxhighlight lang="java">

interchange CashSlip describedBy "CashSlip" merge vectorName "cashslip" file XML "C:/MC/cashdata.xml" encoding "UTF-8"
path {
entity CashSlip

expose {
customer on account_num
customer expose {
region on sales_city
}
}
}

</syntaxhighlight>

In the generated Smooks config XML, the section will look like this:
<syntaxhighlight lang="java">

<account_num>${(CashSlip.customer.account_num)!}</account_num>

</syntaxhighlight>

And the sub-expose part looks like this:
<syntaxhighlight lang="java">

<sales_city>${(CashSlip.customer.region.sales_city)!}</sales_city>

</syntaxhighlight>

* This recursive-export can go as many levels as the user want.

====mapping====
With a <code>mapping { ... }</code> block, the user can easily '''map''' (or rather '''match''') attributes of the data model to values from external source files.

► '''Syntax''':
<syntaxhighlight lang="java">
mapping {
[map <entity-attribute> to <Data>]*
[mapBlob <entity-attribute> to <Data> [extension <blob-file-extension] [path <blob-path>] mimeType <mine-type> ]*
}
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
mapping{
map conversion_ratio to "rate"
mapBlob currency_icon to "currency_icon" extension "png" path "C:/data/currency_images" mimeType png
}
</syntaxhighlight>

The first map of the above example will map the attribute conversion_ratio of the entity to field "rate".
The second mapBlob does a bit more work, it will:

* generate full file paths by combining the path, the file names specified by "currency_icon" field, and the extension,
* upload the files into database with the given mimeType, and
* assign the UUID of the blob to property currency_icon of the entity.

Please note that the only valid attributes here are the members of the corresponding entity, which the user has chosen prior defining the <code>mapping</code> block itself.

====keys====
With a <code>keys</code> { ... } block, the user can define a set of '''keys''' to identify data within our persistence layer (DB or In-Memory...).
This makes sence when the data in a source file can't be clearly identified by an attribute (id). Therefore a set of attributes (keys) can be defined and then be used as identification parameter set by a [[#lookup|''lookups'']] instance in order to query our data pool and identify data using several criteria.

► '''Syntax''':
<syntaxhighlight lang="java">
keys {
[key <entity-attribute>]*
}
</syntaxhighlight>

Assuming you try to update the address data of an employee from an entity named Employee, but you happen not to have his/her personal id. By setting a <code>keys</code> { ... } block, like shown here below, you allow the Datainterchange unit to look into the database after employee's data based on the key set inside this block, rather than using a personal id, which might have been here unique and more than enough to find the employee right away.

► '''Example''':
<syntaxhighlight lang="java">
keys {
key last_name
key first_name
key age
}
</syntaxhighlight>

Please note that the only valid attributes here are members of the corresponding entity, that you would have chosen prior defining the <code>keys</code> block itself.

==TriggerView==
A TriggerView will be automatically generated by the DataInterchange DSL as soon as you define an interchange unit inside the model file and save it.

You can see on the right side of the figure shown below, the definition of 10 interchange units within the Datainterchange model file (blue rectangles); and on the right side of the figure you can see, how the TriggerView looks like (green rectangle), when it is embedded inside an application page in its entirety.

[[File:TriggerView.png|600px|center|''Figure 5: Datainterchange TriggerView Definition and Application Views''|thumbnail|600px]]

To achieve this result you need to do two simple steps. You need first to either integrate the TriggerView into an existing perspective or create a new perspective and then integrate the view into it, like shown below.

► '''Example 1''':
<syntaxhighlight lang="java">
import ns net.osbee.sample.foodmart.datainterchanges
...

package net.osbee.sample.foodmart.perspectives {

perspective Currencies iconURI "employee" {
sashContainer c1 orientation horizontal {
part imex view dataInterchange datainterchanges spaceVolume "20"
...
}
}
}
</syntaxhighlight>

The most important thing in this example is to notice the use of the keyword '''view''' followed by the keyword '''dataInterchange''' and the name ''datainterchanges'' referring to the package, in which all datainterchange unit definitions have to be found.

The second step would be to create a menu entry for you to be able to access the newly created or altered perspective in the application via the menu bar, like shown in the following example.

► '''Example 2''':
<syntaxhighlight lang="java">
import ns net.osbee.sample.foodmart.perspectives.Currencies
...

package net.osbee.sample.foodmart.menues {
...
entry Menu describedBy "my menu" {
entry Perspectives {
entry MasterData {
entry Company image "company" perspective Company
entry Employees image "employee" perspective Employee
entry Products image "products" perspective Products
entry CashRegisterData image "editor_area" perspective CashMasterDataRegister

entry Currencies image "products" perspective Currencies

entry People image "task_action_delegate" perspective PeopleMock

}
...
... }
}

}
</syntaxhighlight>

[[File:TriggerViewMenuSelection.png|600px|center|''Figure 6: Datainterchange TriggerView Menu Selection''|thumbnail|600px]]

The figure above shows the same menu structure defined in the example 2 and results in showing the application with the TriggerView, as you can see on the left side of the figure 5. You can get and review more information on how to create menu entries and perspectives in both [[Menu DSL]] and [[Perspective DSL]] documentation pages.

Among all the components that are generated for the use of each interchange unit functions are action buttons, you would find inside toolbars in some dialogs. Usually you have to define them by yourself in the corresponding DSL files. This step is not needed here, since it has already been generated for this particular view.

[[File:TriggerViewActionButtons.png|600px|center|''Figure 7: Action Buttons for datainterchange unit functions''|thumbnail|600px]]

Please note that it is '''not mandatory''' to display all available functionalities through the use of the TriggerView like shown here above. It is customary to only use parts of the generated Datainterchange components (e.g. action buttons) where you see them fit; for instance in order to only use each interchange unit functionalities (import and/or export) in separated and dedicated views (dialogs). Therefore, we also recommend you to have a look at the [[Action DSL]] documentation page in order to understand how to create your own toolbars, and so forth creating the buttons using import or export functions of any datainterchange unit you would have created.

==Smooks Configuration and Settings File==
'''Please note that whenever a model is saved''', the '''Datainterchange DSL''' will do three things '''automatically''':

* generate Java classes,
* generate Smooks configuration files for both import and export functions, and
* generate a config file to modify the import and export paths on runtime.

===Smooks Configuration File===

The OS.bee implementation of Data Interchange interface is based on Smooks. Smooks is a Java framework for processing XML and non XML data (CSV, EDI, Java etc) by mapping data to JavaBeans, which can later be persisted, enriched (merge with existing data from other source), or converted and exported into other formats.

Smooks relies on a proper configuration file for the import / export processes. These configuration files are generated by the Datainterchange DSL automatically. Here is a brief introduction of how the generated Smooks configuration files work.

When a data import / export Smooks instance is initiated, it will be supplied with the generated config file. This file defines the actions to be performed upon certain events during the SAX parsing process. Here is an example:
<syntaxhighlight lang="xml" line='line'>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:csv="http://www.milyn.org/xsd/smooks/csv-1.2.xsd" xmlns:dao="http://www.milyn.org/xsd/smooks/persistence-1.2.xsd" xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.2.xsd">
<jb:bean beanId="McurrencyNameStream" class="net.osbee.sample.foodmart.entities.McurrencyNameStream" createOnElement="/csv-set">
<jb:expression property="importDate">PTIME.nowDate</jb:expression>
<jb:wiring beanIdRef="McurrencyName" setterMethod="addToCurrencyNames"/>
</jb:bean>
<jb:bean beanId="McurrencyName" class="net.osbee.sample.foodmart.entities.McurrencyName" createOnElement="/csv-set/csv-record">
<jb:value data="/csv-set/csv-record/isoCode" decoder="String" property="isoCode"/>
<jb:value data="/csv-set/csv-record/name" decoder="String" property="name"/>
<jb:value data="/csv-set/csv-record/countries" decoder="String" property="countries"/>
</jb:bean>
<csv:reader fields="isoCode,name,countries" indent="false" separator=";" skipLines="1"/>
<params>
<param name="stream.filter.type">SAX</param>
<param name="inputType">input.csv</param>
<param name="smooks.visitors.sort">false</param>
<param name="input.csv" type="input.type.actived">C:/git/net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/ISOCurrencyCodes081507.csv</param>
</params>
</smooks-resource-list>
</syntaxhighlight>

Further informations on the Smoooks framework are available and can be reviewed in its [http://www.smooks.org/guide documentation] you will find on the [http://www.smooks.org/index official website].

===Path Config File===

The file is interpreted using the Properties xml im- and export method and looks like this:

<syntaxhighlight lang="java">

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>dataInterchange file URLs</comment>
<entry key="EmployeesDepartment-import">C:/myimports/employeesdepartment.xml</entry>
<entry key="EmployeesDepartment-export">C:/myexports/employeesdepartment.xml</entry>
</properties>

</syntaxhighlight>

By default this file is named like the title in the Data Interchange package and extended by "Config" and has the extension "xml":

<code>package net.osbee.sample.foodmart.datainterchanges title "DataInterchange" {}</code>

leads to the filename:

<code>DataInterchangeConfig.xml</code>

and is stored platform independently in the current user's home directory under the subdirectory ".osbee".

An administrator must receive this configuration file with the application, modify it and place it somewhere on the application server. The path to this configuration file must be supplied in the product's preferences (<code>org.eclipse.osbp.production.prefs</code>):

<code>datainterchange/datainterchangeConfiguration=c\:\\DataInterchangeConfig.xml</code>

The path value obviously depends on the operating system you are developing.

===Further Reading===

There is a lot of information to be found in the internet that describe the formal structure of the smooks configuration in any case. A very good one can be found at [https://access.redhat.com/documentation/en-us/red_hat_jboss_fuse/6.3/html-single/smooks_development_guide/index RedHat].

== Copyright Notice ==
{{Copyright Notice}}

Datainterchange DSL

2019-09-02T13:08:25Z

Kraeling:

==Purpose==

The Data Interchange DSL (datainterchange for short) is made for defining data exchange models that can be used to import data from various formats (CSV, XML, EDI, etc.), map the data to entities, store them into database, or export them back into other formats.

You only need to define the ''relationship'' between the file and the bean, not the import / export process themselves. Once defined, these models can be used in e.g. action DSL to define actions which, when triggered, execute the actual import / export process, which are generated automatically by the OSBP based on the model.

==Overview==

As shown on the figure below, the [DSL Inferrer] will generate various views and In/Export component according to model described by datainterchange DSL (and action DSL, in the case of ActionButtons). The action buttons, when clicked, will trigger their corresponding In/Export processes by putting [http://download.osbee.org/downloads/javadoc/osbee-master-clean/org.eclipse.osbp.xtext.datainterchange.feature/apidocs/ WorkerThread (Runnable)] jobs into the executor job pool within the TriggerView (prefixed with datainterchang name), buttons (and toolbar / menus containing them) are further included in the perspective.

[[File:Datainterchange.png|600px|center|frame|''Figure 1: - Data Interchange Structure.'']]

==Data Interchange Model File==

Datainterchange DSL model files end with the <code>.data</code> extension. Data Interchange models may be split into several <code>.data</code> files, as long as they have the same package declaration.

In the following we will dive deeper into the description and the usage of Datainterchange related and reserved keywords.

===import===
In the import section are all entities to be found - as full qualified names – that are currently used in the DSL.

► '''Example''':
<syntaxhighlight lang="java">

import ns net.osbee.sample.foodmart.entities.Mstore
import ns net.osbee.sample.foodmart.entities.Mwarehouse
import ns net.osbee.sample.foodmart.entities.Mregion

</syntaxhighlight>

Note that <code>ns</code> is a mandatory keyword (stands for "namespace") that comes after import for distinguishing the OS.bee internal namespaces and Java library namespaces. Wildcards are not supported, all names should be imported separately. Note that the import section will be imported/added automatically if they are used in the package, so you don't have to manually manage this section.

===package===

Datainterchange DSL model files must start with a package declaration. Packages are the root element of the DSL and should be defined as <code><ApplicationName>.datainterchanges</code>.

► '''Example''':
<syntaxhighlight lang="java">package net.osbee.sample.foodmart.datainterchanges { }</syntaxhighlight>

Data Interchange models may be split into several .data files, as long as they have the same package declaration, the interchanges will be available under this package name.

===title===
With the keyword title you can give a name to the corresponding TriggerView dialog inside your application. For example, the definition of the same datainterchanges package from above with title "Data Interchange Example":

► '''Example''':
<syntaxhighlight lang="java">package net.osbee.sample.foodmart.datainterchanges title "Data Interchange Example" {}</syntaxhighlight>

This title will be translated based on locale.

You can get more details about the TriggerView in the section below.

===interchange===
The <code>interchange</code> keyword defines interchange units for entities in the package, it should be in the form of:

► '''Example''':
<syntaxhighlight lang="java">
interchange <InterchangeUnitName> [describedBy <description>] <EntityManagerMode> file <FileType> [<FileDetails>] beans {
...
}
</syntaxhighlight>

Where <code>InterchangeUnitName</code> being the name of the interchange unit; <code>describedBy</code> (optional) can be used to provide a short description string. <code>EntityManagerMode</code> being how the file should be handled (see section "persist, merge, remove" below), and after <code>file</code> keyword, you should specify the type of the source / target data file you would like to import from or export to, then the file path, and other details depends on the type.

The following example specifies an interchange that reads a CSV file under the specified path (note the forward slash as the path separator), delimited by semicolon, skip one line (the header), and treat the content as encoded in UTF-8:

► '''Example''':
<syntaxhighlight lang="java">

interchange CurrencyNames persist file
CSV "C:/data/ISOCurrencyCode20170101.csv" delimiter ";" skipLines 1 encoding "UTF-8"
beans {
...
}
</syntaxhighlight>

The <code>beans</code> keyword comes after all the file specification and starts a block of entity definitions, which will be covered in section "entity".

===describedBy===
With this keyword you can the optional description of an interchange unit as shown below.

► '''Example''':
<syntaxhighlight lang="java">
interchange Currencies describedBy "european central bank currency exchange rates based on euro" persist ... { ... }
</syntaxhighlight>

===vectorName===
With the optional keyword <code>vectorName</code> followed by a string value you are able to define the name of the root element of both XML configuration files needed by Smooks. Please note that it also means that the first (root-)element of an XML-File you would have exported (file filled with real data) via the application will have the same name.

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file ... { ... }
</syntaxhighlight>

You can view the result of this sample of code like shown below on figure[[#Figure3|''3'']].

===persist, merge, remove===
These keywords define the purpose of the datainterchange unit and has a similar meaning as in the JPA's EntityManager class. Basically, <code>persist</code> will insert the data records into database, <code>merge</code> will update existing data record, or insert new one if necessary, <code>remove</code> will remove the record if it could be found in database.

► '''Example 1''': (persist)
<syntaxhighlight lang="java">
interchange EDIOrders describedBy "Orders" persist file
XML "C:/data/orders.xml"
beans {
...
}
</syntaxhighlight>

► '''Example 2''': (merge)
<syntaxhighlight lang="java">
interchange Stores merge file
XML "C:/data/stores.xml"
beans {
...
}
</syntaxhighlight>

► '''Example 3''': (remove)
<syntaxhighlight lang="java">
interchange Storesremove remove file
XML "C:/data/stores_remove.xml"
beans {
...
}
</syntaxhighlight>

===file===
With the keyword file you are able to set the file format of the files you intent to process with you interchange unit.

► '''Syntax''':
<syntaxhighlight lang="java">interchange <SampleInterchangeUnitName> <EntityManagerMode> file <FileNameFormat> {}</syntaxhighlight>

The current supported file formats are CSV, EDI and XML followed by the name of the file you want to process, given its full path location in the system.
► '''Example 1''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit1 merge file CSV "C:/temp/testFile.csv" {}</syntaxhighlight>
► '''Example 2''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit2 persist file XML "C:/temp/testFile.xml" {}</syntaxhighlight>
► '''Example 3''':<syntaxhighlight lang="java">interchange SampleInterchangeUnit3 merge file EDI "C:/temp/testFile.edi" {}</syntaxhighlight>

After choosing the file format you can either give the file name as a String value in a double quote "..." as shown here above, or press Ctrl+Space to get via the content assist the option of opening a File Chooser/Picker to specify the file you want to work with.

[[File:FileChooser.jpg|center|frame|''Figure 2: File Chooser'']]

Please note that you can also change the path(?) of the file to process on runtime by selecting a new file.

===mapByAttribute===

The <code>mapByAttribute</code> keyword is an XML-specific keyword that turns on the automatic attribute mapping. When enabled, datainterchange will detect if the value being mapped is from an attribute. For example, the 'USD' value in the following XML file comes from the attribute 'currency' of the element 'Cube':

► '''Example''':
<syntaxhighlight lang="xml">
<Cube currency='USD' rate='1.3759'/>
</syntaxhighlight>

while in the following XML file, the same value is encapsulated in the element 'currency':

► '''Example''':
<syntaxhighlight lang="xml">

<Cube>
<currency>USD</currency>
<rate>1.3759</rate>
</Cube>
</syntaxhighlight>

When <code>mapByAttribute</code> is present, datainterchange will automatically decide that a query in the form like <code>'/Cube/currency'</code> will also catch the value from attribute. Without it, the query will have to put a <code>'@'</code> symbol in front of the attribute name, i.e. <code>'/Cube/@currency'</code>.

===elementSize===
With the keyword <code>elementSize</code> followed by an integer, the user can set the estimated average size of the elements in bytes. Since the underlying API cannot know the size of an element before it is processed, this value can be supplied as a guide value to be used for estimating the import / output progress based on how much bytes have been processed.

► '''Example''':
<syntaxhighlight lang="java">
interchange EDIOrders describedBy "edi orders" persist elementSize 50 file EDI "C:/data/orders.edi" beans {
...
}
</syntaxhighlight>

Defines an average estimated element size of 50 bytes.

===delimiter===

The <code>delimiter</code> is a CSV format-specific keyword, which defines the character to use in the CSV file to set the delimiter/separation character between different values. Default value is "," (comma).

► '''Example''':
<syntaxhighlight lang="java">
interchange CurrencyNames persist file
CSV "C:/data/ISOCurrencyCodes081507.csv" delimiter ";" ... {
...
}
</syntaxhighlight>

will set the delimiter of the CSV file to ";".

===skipLines===
This is a CSV format-specific keyword. Using <code>skipLines</code> followed by an integer, the user can specify the number of lines to be skipped from the beginning in the processing of the selected file, this can be used to skip headers.

► '''Example''':
<syntaxhighlight lang="java">
interchange CurrencyNames persist file CSV "C:/data/ISOCurrencyCodes081507.csv" ... skipLines 1 encoding "UTF-8" {
...
}
</syntaxhighlight>

will skip the first line of the CSV file.

===report===

If a '''datainterchange''' unit is defined with the <code>report</code> keyword, a report will be generated for data conversions. The report file is generated by Smooks, lies under <code>/smooks</code> output directory of the datainterchange bundle, and has a name in the form like <code><DataInterChangeName>-input.xml</code> for input processes, and <code><DataInterChangeName>-output.xml</code> for output processes. '''Note: turn on report will have an impact performance.'''

===indent===

The <code>indent</code> is a CSV-format specified keyword which adds indentation character data to the generated event stream. This simply makes the generated event stream easier to read in its serialized form and generally should only be used in testing.

===quoteCharacter===

The <code>quoteCharacter</code> is a CSV format-specific keyword, which defines the character to use in the CSV file to identify values.

===encoding===
With the keyword '''enconding''' followed by the encoding name as a string value you are able to specify the valid encoding of the file content.

► '''Example 1''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName merge elementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "UTF-8"{}</syntaxhighlight>
► '''Example 2''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName remove elementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "GB18030"{}</syntaxhighlight>
► '''Example 3''':<syntaxhighlight lang="java">interchange SampleInterchangeUnitName persistelementSize 50 file CSV "C:/temp/testFile.csv" delimiter ";" skipLines 1 encoding "ISO-2022-JP"{}</syntaxhighlight>

===mappingModel===

The <code>mappingModel</code> keyword is an EDI-specific keyword which can be used to specify an EDI to XML mapping model in XML format for Smooks.

===validate===

The <code>validate</code> keyword is an EDI-specific keyword that...

===beans===

The keyword <code>beans</code> starts the series of entities. The name "bean" comes from the internal entities called JavaBean, which act as data containers.

===entity===

With the <code>entity</code> keyword followed by a fully qualified name, the user can specify the mapping between a source data file and a data-containing entity. The behavior of the mapping can be further fine-tuned with the keywords discussed below. While these keywords can theoretically be combined all together and create very complicated behavior, they are normally used in a simple and straight forward way.

The general form of <code>entity</code> keywords is:

► '''Syntax''':
<syntaxhighlight>
entity <ID>
[nodeName <node-name>]
[createOn <element-map>]
[marker <property-name>]
[expression '{' <expressions> '}']
[lookup '{' <lookup-rules> '}']
[format '{' <formats> '}']
[mapping '{' <mappings> '}']
[keys '{' <lookup-keys> '}']
;
</syntaxhighlight>

The order of the keywords is fixed, i.e. they are all optional, but must appear in the given order.

====nodeName====

With the optional keyword <code>nodeName</code> followed by a string you can specify the name (alias) of corresponding elements inside an (XML) input/output configuration file. This name is used to identify entities within an XML file using the [http://freemarker.org/docs/pgui_datamodel.html NodeModel of Freemarker] instead of using the standard Java Object Model name. For example:

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file XML "C:/.../net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/stores.xml" beans {
entity Mregion nodeName "region"
entity Mstore nodeName "store"
entity Mwarehouse nodeName "warehouse"
}
</syntaxhighlight>

The result from this example code is the generation of Smooks configuration files, in which the structure of the output data file (order of elements) will be the same as declared inside the beans {...} expression block. The alias you have specified after the keyword will be used as element (entity) name inside the XML files.

<div id="Figure3"> [[File:FreeMarkerNodeModelStoreInEx.png|600px|thumb|center|''Figure 3: Store-import.xml and Store-export.xml with NodeModel'']] </div>

The use of this keyword gives you the flexibility of naming entities using aliases in order to match any third part system description. By omitting the definition of both aliases ''region'' and ''warehouse'' like shown below, we obtain slightly divergent but very different contents than the ones from above.

► '''Example''':
<syntaxhighlight lang="java">
interchange Stores remove vectorName "stores" elementSize 83 file XML "C:/.../net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/stores.xml" beans {
entity Mregion
entity Mstore nodeName "store"
entity Mwarehouse
}
</syntaxhighlight>

[[File:FreeMarkerJavaObjectModelStoreInEx.png|600px|thumb|center|''Figure 4: Store-import.xml (normal) and Store-export.xml (normal) with Java Object Model Name'']]

Please note that the declaration order of each node names matters.

====createOn====

The <code>createOn</code> keyword followed by a string specifies on which input element should an entity to be created. For example:

► '''Example''':
<syntaxhighlight lang="java">
entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" ... {
...
}

</syntaxhighlight>

will create an <code>Mcurrency</code> entity when encountering <code>/Envelope/Cube/Cube</code> in the source data file.

====marker====

With <code>marker</code> keyword optionally followed by a property-name, the user can set the data to be imported to have an additional property under the given name whose value set to 1, while updating the existing data to have this property having value 0. This could be useful to identify the most recent import of some periodically updated data. For example:

► '''Example''':
<syntaxhighlight lang="java">

entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
...
}
</syntaxhighlight>

will make the entity <code>McurrencyStream</code> to have a property "<code>latest</code>", which is to be set to 1 for the most recently imported data.

====expression====

With an <code>expression { ... }</code> block, the user can define expressions that assign certain value to an entity property. These expressions are of two types, the first one is:

► '''Syntax''':
<syntaxhighlight lang="java">

assign <id> with <value> as <type>

</syntaxhighlight>

this will assign the property <code>id</code> with the value of <code>value</code>, in type of <code>type</code>. The <code>value</code> may be one of the following:

* <code>NowDate</code>: the date of now (the time point of action)
* <code>StartDate</code>: the date when the process started
* <code>UniversallyUniqueIdentifier</code>: an UUID

and <code>type</code> may be one of the following:

* <code>Date</code>: the value of NowDate or StartDate will be in date format
* <code>Milliseconds</code>: the value of NowDate or StartDate will be in millisecond
* <code>Nanoseconds</code>: the value of NowDate or StartDate will be in nanosconds
* <code>Random</code>: the value of UUID will be random
* <code>ExecuteContext</code>: the value of UUID will be unique for the execute context

Note that the <code>Random</code> and <code>ExecuteContext</code> should be only combined with <code>UniversallyUniqueIdentifier</code>, while the other types should be only combined with <code>NowDate</code> or <code>StartDate</code>.

► '''Example''':
<syntaxhighlight lang="java">
entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
assign importDate with NowDate as Date
}
</syntaxhighlight>

will assign the <code>importDate</code> as the current date in <code>Date</code> format.

The other type of expression has the form:

► '''Syntax''':
<syntaxhighlight lang="java">

copy <target-property> from <entity-name> property <from-property>

</syntaxhighlight>

which will copy the value of <code>from-property</code> from the <code>entity-name</code> to <code>target-property</code>.

► '''Example''':
<syntaxhighlight lang="java">

entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" expression {
copy currencyDate from McurrencyDay property ratingDate
}

</syntaxhighlight>

will copy the value of <code>ratingDate</code> from <code>McurrencyDay</code> entity to <code>currencyDate</code>.

====lookup====
<div id="lookup">
With a <code>lookup</code> { ... } block, the user can define a set of '''lookup-rules''' to identify complex data within our persistence layer (DB or In-Memory...). This makes sense when the data in a source file can't be clearly identified by an attribute (id), but moreover when the set data it contains is persisted over several entities.

► '''Syntax''':
<syntaxhighlight lang="java">
lookup {
[<lookup-rules>]*
}
</syntaxhighlight>

Lookup-rule expression:
<syntaxhighlight>
lookup-rule:
'for' .. 'on' .. 'createOn' .. 'with' .. 'cacheSize' .. 'mapTo' .. ['allowNoResult' | 'allowNoResult' | 'markerPath']
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
interchange Currencies describedBy "european central bank currency exchange rates based on euro" persist elementSize 50 file
XML "C:/git/development/net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/eurofxref-hist-90d.xml"

mapByAttribute beans {
entity McurrencyStream createOn "/Envelope/Cube" marker latest expression {
assign importDate with NowDate as Date
}
entity McurrencyDay createOn "/Envelope/Cube/Cube" format {
for ratingDate coding "yyyy-MM-dd"
}
mapping {
map ratingDate to "time"
}
entity Mcurrency createOn "/Envelope/Cube/Cube/Cube" expression {
copy currencyDate from McurrencyDay property ratingDate
}
lookup {
for currency_name on McurrencyName createOn "/Envelope/Cube/Cube/Cube" with isoCode cacheSize 300 mapTo "currency" allowNoResult
markerPath {
markerEntity McurrencyNameStream markedBy latest
}
}
mapping {
map conversion_ratio to "rate"
}

}

</syntaxhighlight>

</div>

We will provide you in upcoming releases with more information about so called '''locator''' instances, which are generated in the background on the basis of the '''lookups''' you would have defined, in order to query persisted data. This will give you more insights about how the Datainterchange DSL really works at the lower level.

====format====

With a <code>format { ... }</code> block, the user can define the format of the entity property being converted. A <code>format</code> block can have more than one format definitions, in the following format:

► '''Syntax''':
<syntaxhighlight lang="java">

format {
for <property> coding <format-string> [locale <locale-string>]
...
}

</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">

entity McurrencyDay createOn "/Envelope/Cube/Cube" format {
for ratingDate coding "yyyy-MM-dd"
}

</syntaxhighlight>

will convert the <code>"/Envelope/Cube/Cube"</code> data to <code>ratingDate</code> property of <code>McurrencyDay</code> in format <code>"yyyy-MM-dd"</code>, where

► '''Example''':
<syntaxhighlight lang="java">

entity EDIOrderHeader createOn "/Order/header" format {
for hdrDate coding "EEE MMM dd HH:mm:ss zzz yyyy" locale "en_US"
}

</syntaxhighlight>

will format the <code>hdrDate</code> in format <code>"EEE MMM dd HH:mm:ss zzz yyyy"</code> with English locale, i.e. the month and weekday names will be in English.

====expose====

With a <code>expose { ... }</code> block, when and only when exporting an entity, the user can expose properties of its referenced entity. A <code>expose</code> block can have more than one expose definitions, in the following syntax format:

► '''Syntax''':
<syntaxhighlight lang="java">

expose {
ref <EntityReference>
on <EntityAttribute>
| subExpose
...
}

</syntaxhighlight>

'''subExpose''' has the same syntax format as '''expose''', which is:

<syntaxhighlight lang="java">

expose {
ref <EntityReference>
on <EntityAttribute>
| subExpose
...
}

</syntaxhighlight>

► '''Example''':

Entities are defined as following:

<syntaxhighlight lang="java">

entity CashSlip {
...
var boolean payed
ref cascade CashPosition[ * ]positions opposite slip
ref Mcustomer customer opposite slips }

</syntaxhighlight>

<syntaxhighlight lang="java">

entity Mcustomer extends BaseID {
...
var long account_num
var String name
ref Mregion region opposite customers
ref Msales_fact[ * ]sales opposite customer }

</syntaxhighlight>

In datainterchange DSL, when exporting entity "'''CashSlip'''", the user can use "'''expose'''" keyword to export the "'''account_num'''" property of "'''Mcustomer'''" referenced here as "'''customer'''".
And sub-reference of the reference can also be exported. In the following example, the "'''region'''" reference (of entity "'''Mregion'''") in "'''Mcustomer'''" has a property "'''sales_city'''", it is also exported.

<syntaxhighlight lang="java">

interchange CashSlip describedBy "CashSlip" merge vectorName "cashslip" file XML "C:/MC/cashdata.xml" encoding "UTF-8"
path {
entity CashSlip

expose {
customer on account_num
customer expose {
region on sales_city
}
}
}

</syntaxhighlight>

In the generated Smooks config XML, the section will look like this:
<syntaxhighlight lang="java">

<account_num>${(CashSlip.customer.account_num)!}</account_num>

</syntaxhighlight>

And the sub-expose part looks like this:
<syntaxhighlight lang="java">

<sales_city>${(CashSlip.customer.region.sales_city)!}</sales_city>

</syntaxhighlight>

* This recursive-export can go as many levels as the user want.

====mapping====
With a <code>mapping { ... }</code> block, the user can easily '''map''' (or rather '''match''') attributes of the data model to values from external source files.

► '''Syntax''':
<syntaxhighlight lang="java">
mapping {
[map <entity-attribute> to <Data>]*
[mapBlob <entity-attribute> to <Data> [extension <blob-file-extension] [path <blob-path>] mimeType <mine-type> ]*
}
</syntaxhighlight>

► '''Example''':
<syntaxhighlight lang="java">
mapping{
map conversion_ratio to "rate"
mapBlob currency_icon to "currency_icon" extension "png" path "C:/data/currency_images" mimeType png
}
</syntaxhighlight>

The first map of the above example will map the attribute conversion_ratio of the entity to field "rate".
The second mapBlob does a bit more work, it will:

* generate full file paths by combining the path, the file names specified by "currency_icon" field, and the extension,
* upload the files into database with the given mimeType, and
* assign the UUID of the blob to property currency_icon of the entity.

Please note that the only valid attributes here are the members of the corresponding entity, which the user has chosen prior defining the <code>mapping</code> block itself.

====keys====
With a <code>keys</code> { ... } block, the user can define a set of '''keys''' to identify data within our persistence layer (DB or In-Memory...).
This makes sence when the data in a source file can't be clearly identified by an attribute (id). Therefore a set of attributes (keys) can be defined and then be used as identification parameter set by a [[#lookup|''lookups'']] instance in order to query our data pool and identify data using several criteria.

► '''Syntax''':
<syntaxhighlight lang="java">
keys {
[key <entity-attribute>]*
}
</syntaxhighlight>

Assuming you try to update the address data of an employee from an entity named Employee, but you happen not to have his/her personal id. By setting a <code>keys</code> { ... } block, like shown here below, you allow the Datainterchange unit to look into the database after employee's data based on the key set inside this block, rather than using a personal id, which might have been here unique and more than enough to find the employee right away.

► '''Example''':
<syntaxhighlight lang="java">
keys {
key last_name
key first_name
key age
}
</syntaxhighlight>

Please note that the only valid attributes here are members of the corresponding entity, that you would have chosen prior defining the <code>keys</code> block itself.

==TriggerView==
A TriggerView will be automatically generated by the DataInterchange DSL as soon as you define an interchange unit inside the model file and save it.

You can see on the right side of the figure shown below, the definition of 10 interchange units within the Datainterchange model file (blue rectangles); and on the right side of the figure you can see, how the TriggerView looks like (green rectangle), when it is embedded inside an application page in its entirety.

[[File:TriggerView.png|600px|center|''Figure 5: Datainterchange TriggerView Definition and Application Views''|thumbnail|600px]]

To achieve this result you need to do two simple steps. You need first to either integrate the TriggerView into an existing perspective or create a new perspective and then integrate the view into it, like shown below.

► '''Example 1''':
<syntaxhighlight lang="java">
import ns net.osbee.sample.foodmart.datainterchanges
...

package net.osbee.sample.foodmart.perspectives {

perspective Currencies iconURI "employee" {
sashContainer c1 orientation horizontal {
part imex view dataInterchange datainterchanges spaceVolume "20"
...
}
}
}
</syntaxhighlight>

The most important thing in this example is to notice the use of the keyword '''view''' followed by the keyword '''dataInterchange''' and the name ''datainterchanges'' referring to the package, in which all datainterchange unit definitions have to be found.

The second step would be to create a menu entry for you to be able to access the newly created or altered perspective in the application via the menu bar, like shown in the following example.

► '''Example 2''':
<syntaxhighlight lang="java">
import ns net.osbee.sample.foodmart.perspectives.Currencies
...

package net.osbee.sample.foodmart.menues {
...
entry Menu describedBy "my menu" {
entry Perspectives {
entry MasterData {
entry Company image "company" perspective Company
entry Employees image "employee" perspective Employee
entry Products image "products" perspective Products
entry CashRegisterData image "editor_area" perspective CashMasterDataRegister

entry Currencies image "products" perspective Currencies

entry People image "task_action_delegate" perspective PeopleMock

}
...
... }
}

}
</syntaxhighlight>

[[File:TriggerViewMenuSelection.png|600px|center|''Figure 6: Datainterchange TriggerView Menu Selection''|thumbnail|600px]]

The figure above shows the same menu structure defined in the example 2 and results in showing the application with the TriggerView, as you can see on the left side of the figure 5. You can get and review more information on how to create menu entries and perspectives in both [[Menu DSL]] and [[Perspective DSL]] documentation pages.

Among all the components that are generated for the use of each interchange unit functions are action buttons, you would find inside toolbars in some dialogs. Usually you have to define them by yourself in the corresponding DSL files. This step is not needed here, since it has already been generated for this particular view.

[[File:TriggerViewActionButtons.png|600px|center|''Figure 7: Action Buttons for datainterchange unit functions''|thumbnail|600px]]

Please note that it is '''not mandatory''' to display all available functionalities through the use of the TriggerView like shown here above. It is customary to only use parts of the generated Datainterchange components (e.g. action buttons) where you see them fit; for instance in order to only use each interchange unit functionalities (import and/or export) in separated and dedicated views (dialogs). Therefore, we also recommend you to have a look at the [[Action DSL]] documentation page in order to understand how to create your own toolbars, and so forth creating the buttons using import or export functions of any datainterchange unit you would have created.

==Smooks Configuration and Settings File==
'''Please note that whenever a model is saved''', the '''Datainterchange DSL''' will do three things '''automatically''':

* generate Java classes,
* generate Smooks configuration files for both import and export functions, and
* generate a config file to modify the import and export paths on runtime.

===Smooks Configuration File===

The OS.bee implementation of Data Interchange interface is based on Smooks. Smooks is a Java framework for processing XML and non XML data (CSV, EDI, Java etc) by mapping data to JavaBeans, which can later be persisted, enriched (merge with existing data from other source), or converted and exported into other formats.

Smooks relies on a proper configuration file for the import / export processes. These configuration files are generated by the Datainterchange DSL automatically. Here is a brief introduction of how the generated Smooks configuration files work.

When a data import / export Smooks instance is initiated, it will be supplied with the generated config file. This file defines the actions to be performed upon certain events during the SAX parsing process. Here is an example:
<syntaxhighlight lang="xml" line='line'>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<smooks-resource-list xmlns="http://www.milyn.org/xsd/smooks-1.1.xsd" xmlns:csv="http://www.milyn.org/xsd/smooks/csv-1.2.xsd" xmlns:dao="http://www.milyn.org/xsd/smooks/persistence-1.2.xsd" xmlns:jb="http://www.milyn.org/xsd/smooks/javabean-1.2.xsd">
<jb:bean beanId="McurrencyNameStream" class="net.osbee.sample.foodmart.entities.McurrencyNameStream" createOnElement="/csv-set">
<jb:expression property="importDate">PTIME.nowDate</jb:expression>
<jb:wiring beanIdRef="McurrencyName" setterMethod="addToCurrencyNames"/>
</jb:bean>
<jb:bean beanId="McurrencyName" class="net.osbee.sample.foodmart.entities.McurrencyName" createOnElement="/csv-set/csv-record">
<jb:value data="/csv-set/csv-record/isoCode" decoder="String" property="isoCode"/>
<jb:value data="/csv-set/csv-record/name" decoder="String" property="name"/>
<jb:value data="/csv-set/csv-record/countries" decoder="String" property="countries"/>
</jb:bean>
<csv:reader fields="isoCode,name,countries" indent="false" separator=";" skipLines="1"/>
<params>
<param name="stream.filter.type">SAX</param>
<param name="inputType">input.csv</param>
<param name="smooks.visitors.sort">false</param>
<param name="input.csv" type="input.type.actived">C:/git/net.osbee.sample.foodmart/net.osbee.sample.foodmart.datainterchange/smooks-resources/ISOCurrencyCodes081507.csv</param>
</params>
</smooks-resource-list>
</syntaxhighlight>

Further informations on the Smoooks framework are available and can be reviewed in its [http://www.smooks.org/guide documentation] you will find on the [http://www.smooks.org/index official website].

===Path Config File===

The file is interpreted using the Properties xml im- and export method and looks like this:

<syntaxhighlight lang="java">

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
<comment>dataInterchange file URLs</comment>
<entry key="EmployeesDepartment-import">C:/myimports/employeesdepartment.xml</entry>
<entry key="EmployeesDepartment-export">C:/myexports/employeesdepartment.xml</entry>
</properties>

</syntaxhighlight>

By default this file is named like the title in the Data Interchange package and extended by "Config" and has the extension "xml":

<code>package net.osbee.sample.foodmart.datainterchanges title "DataInterchange" {}</code>

leads to the filename:

<code>DataInterchangeConfig.xml</code>

and is stored platform independently in the current user's home directory under the subdirectory ".osbee".

An administrator must receive this configuration file with the application, modify it and place it somewhere on the application server. The path to this configuration file must be supplied in the product's preferences (<code>org.eclipse.osbp.production.prefs</code>):

<code>datainterchange/datainterchangeConfiguration=c\:\\DataInterchangeConfig.xml</code>

The path value obviously depends on the operating system you are developing.

===Further Reading===

There is a lot of information to be found in the internet that describe the formal structure of the smooks configuration in any case. A very good one can be found at [https://access.redhat.com/documentation/en-us/red_hat_jboss_fuse/6.3/html-single/smooks_development_guide/index RedHat].

== Copyright Notice ==
{{Copyright Notice}}

Perspective DSL

2019-08-30T15:56:31Z

Kraeling: added description for keyword "synchronized"

==Introduction==

Os.bee Applications which are generated using the OS.bee software factory have by default a front end based on the E4-UI-Model. [[File:PerspectiveDSL_01.png|600px]] 

As you can recognize on the above graphics the main elements of theE4-Model are:

* Perspective. A perspective is a container for a set of UI graphic elements, like sash, part stack, part, area, etc. Perspectives can be used to store different arrangements of UI graphic elements. Each Workbench window contains one or more perspectives. A perspective defines the initial set and layout of views in the Workbench window. Each perspective provides a set of functionality aimed at accomplishing a specific type of task or works with specific types of resources.

* Sash. A sash is a UI graphic elements container, and it displays all its children at the same time either horizontally or vertically aligned. Default is vertically aligned.

* Part. A Part is a container for a view. Parts are user interface components which allow you to navigate and modify data.

* Part stack. A part stack contains a stack of parts showing the content of one part while displaying only the headers of the other parts.

* View. A view is used to work on a set of data, which might be a hierarchical structure. If data is changed via the view, this change is directly applied to the underlying data structure. A predefined view could be a chart, a dialog, a grid, an organigram, a report, a select table, a table or a topology in OS.bee.

==Perspective DSL==

The PerspectiveDSL is used to build the ui for Os.bee Application.

You can find instances of these elements in Os.bee Applications as follows: [[File:PerspectiveDSL_02.png|600px]] 

The main semantic elements of the PerspectiveDSL are:

* “package” - the root element that contains all the other elements. A model can contain multiple packages.

* “perspective” - define the perspective details, e.g. perspective name, the description…

* “sashContainer” - define the main element sash container for the perspective.

* “partStack” - define the main element part stack for the perspective.

* “part” - the main element part for the perspective.

* “view” - define the part view of the perspective, it can be report, dialog, table, chart …

===Syntax===

====package definition====

► '''Syntax''':
<syntaxhighlight lang="java">
package <package name> [{
perspective <perspective name> . . .
. . .
}]
</syntaxhighlight>

One or more than one perspective could be defined in the same package.

► '''Example''':
<syntaxhighlight lang="java">
package net.osbee.sample.foodmart.perspectives {
perspective Employee . . .

perspective Supplier . . .

perspective Products . . .

. . .
}
</syntaxhighlight>

In this example <code>perspective</code> Employee, <code>perspective</code> Supplier, <code>perspective</code> Products and also other perspectives are defined in the same <code>package</code>.

====perspective====

This is the main part of this model. All the perspective details can be defined here.

► '''Syntax''':
<syntaxhighlight lang="java">
perspective <perspective name> [described by <description>]
[process <blip.blip name> usertask <blip.BlipUserTask name>]
([icon <iconURI>]
&
[accessibility <accessibilityPhrase>]
&
[toolbar <action.ActionToolbar>])
{
<PerspectiveElement>
. . .
[eventManager <PerspectiveEventManager>]
}
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this perspective.

* Keyword <code>process. . . usertask. . . </code> is optional, which define the blip process and blip usertask from predefined blipDSL for this perspective.

* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file.

* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

* Keyword <code>toolbar</code> is optional, which define the action tool bar from predefined [[Action DSL]]. Graphical control elements are defined, on which on-screen buttons, icons, menus, or other input or output elements are placed.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
. . .
}

perspective ProductMaintenanceSelect process ProductMaintenance usertask SelectSomeProducts toolbar HandleTask icon "information" {
. . .
}
</syntaxhighlight>

In the next sections, the important elements and keywords of perspective will be introduced one by one.

====PerspectiveElement====

Keyword <code>PerspectiveElement</code> is used to define the main elements of the perspective.

The main elements are sash container, part stack and part.

=====sashContainer=====

Keyword <code>sashContainer</code> is used to define the main element sash container of perspective.

A sash container displays all its children at the same time either horizontally or vertically aligned.

► '''Syntax''':
<syntaxhighlight lang="java">
sashContainer <PerspectiveSashContainer ID>
[orientation horizontal|vertical]
&
[selectedElement <PerspectiveElement ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>orientation</code> is optional, it can be horizontal or vertical, and default value is vertical.
* Keyword <code>selectedElement</code> is optional; you can select one of the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this sash container in screen. A number will be defined to representing the relative size of this container.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
. . .
}
}
}
</syntaxhighlight>

In this example, in the first place, the <code>sash container</code> '''''outer''''' is defined, in this sash container, 2 second level <code>sash containers</code> are defined as horizontal, they are '''''top''''' and '''''bottom'''''.

=====partStack=====

Keyword <code>partStack</code> is used to define the main element part stack of perspective.

A part stack contains a stack of parts showing the contents of one part while displaying only the headers of the other parts.

► '''Syntax''':
<syntaxhighlight lang="java">
partStack <PerspectivePartStack ID>
[selectedElement <PerspectivePart ID>]
&
[synchronize <PerspectivePartStack ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>selectedElement</code> is optional; you can select the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>synchronize</code> is optional; if you have two part stacks in the perspective and want them to show their parts synchronously (i.e. if you open the second part in part stack 1, then you want to also activate the second part in part stack 2), here you can name the ID of the other part stack.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part stack in screen. A number will be defined to representing the relative size of this part stack.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
partStack EmployeeStack spaceVolume "70" {
. . .
}
partStack Payroll spaceVolume "30" {
. . .
}
}
}
}
</syntaxhighlight>

In this example, 2 <code>part stacks</code> are defined under <code>sash container</code> '''''bottom''''', they are '''''EmployeeStack''''' and '''''Payroll'''''. The sizes of them are redefined here, '''''EmployeeStack''''' takes 70% of the screen width and '''''payroll''''' takes the rest 30%.

=====part=====

Keyword part is used to define the main element part of perspective.

► '''Syntax''':
<syntaxhighlight lang="java">
part <PerspectivePart ID>
[described by <description String>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
&
[icon <iconURI string>]
&
[view select <table.Table> | table <table.Table>
| chart <chart.Chart> | report <report.Report>
| organigram <organization.Organization>
| topology <topology.Topology>
| dialog <dialog.Dialog> | grid <table.Table>
]
&
[isClosable]
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this part.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part in screen. A number will be defined to representing the relative size of this part.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.
* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file
* Keyword <code>view</code> is optional, it defines the predefined view of this part, it can be report, dialog, table, chart, organigram, topology.
* Keyword <code>isClosable</code> is optional; it will allow the user to close this part when this keyword is selected.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
part Orga spaceVolume "40" view organigram FoodMart
part Employees spaceVolume "20" view table Employees
part EmployeeDialog spaceVolume "40" view dialog Employee
}
. . .
}
}
</syntaxhighlight>

In this example, 3 <code>parts</code> are defined under <code>sash container</code> '''''top''''', they are '''''Orga''''', '''''Employees''''' and '''''EmployeeDialog'''''. The sizes of them are redefined here, '''''Orga''''' and '''''EmployeeDialog''''' take each 40% of the screen width and '''''Employees''''' takes the remaining 20%. The view of '''''Orga''''' is the predefined <code>organigram</code> '''''FoodMart'''''; the view of '''''Employees''''' is the predefined <code>table</code> '''''Employee'''''; and the view of '''''EmployeeDialog''''' is the predefined <code>dialog</code> '''''Employee'''''.

====PerspectiveEventManager====

Keyword <code>eventManager</code> is used to describe an optional event manager for the perspective. By default (i.e. if no event manager is defined) a change of the data in one perspective part automatically changes the associated data in all other perspective parts (e.g. if one part is a table and another part a dialog to edit this table, then clicking on a line in the table automatically affect the data shown in the dialog). This behaviour can be restricted by using a PerspectiveEventManager

► '''Syntax''':
<syntaxhighlight lang="java">
eventManager <name> {
targetPart <PerspectivePart partName1> allowedSources {
<PerspectivePart sourceName1>
<PerspectivePart sourceName2>
...
}
targetPart <PerspectivePart partName2> allowedSources {
...
}
...
}
</syntaxhighlight>

* Keyword <code>targetPart</code> describes the perspective part for which we want to restrict the changes automatically being made by other parts.
* Keyword <code>allowedSources</code> describes which parts are allowed to affect the target part.

► '''Example''':
<syntaxhighlight lang="java">
perspective My1stApp icon "employee" {
sashContainer My1stApp orientation horizontal {
part My1stAppTable1 spaceVolume "50" view editableTable Persons
part My1stAppView1 spaceVolume "50" view dialog Person
part My1stAppTable2 spaceVolume "50" view editableTable Persons2
part My1stAppView2 spaceVolume "50" view dialog Person2
}
eventManager My1stAppEventManager {
targetPart My1stAppView1 allowedSources {My1stAppTable1}
targetPart My1stAppView2 allowedSources {My1stAppTable1 My1stAppTable2}
}
}
}
</syntaxhighlight>

In this example, there are two perspective parts displaying a table and two parts displaying a dialog corresponding to the table data. By using an <code>eventManager</code> we ensure that

* clicking on a line in the first table part, '''''My1stAppTable1''''', shows the corresponding data in both dialogs
* clicking on a line in the second table part, '''''My1stAppTable2''''', shows the corresponding data only in the second dialog, because the table part '''''My1stAppView1''''', that displays the first dialog, does not have '''''My1stAppTable2''''' in its allowed sources.

== Copyright Notice ==
{{Copyright Notice}}

Perspective DSL

2019-08-28T09:45:11Z

Kraeling: Added example for event managers

==Introduction==

Os.bee Applications which are generated using the OS.bee software factory have by default a front end based on the E4-UI-Model. [[File:PerspectiveDSL_01.png|600px]] 

As you can recognize on the above graphics the main elements of theE4-Model are:

* Perspective. A perspective is a container for a set of UI graphic elements, like sash, part stack, part, area, etc. Perspectives can be used to store different arrangements of UI graphic elements. Each Workbench window contains one or more perspectives. A perspective defines the initial set and layout of views in the Workbench window. Each perspective provides a set of functionality aimed at accomplishing a specific type of task or works with specific types of resources.

* Sash. A sash is a UI graphic elements container, and it displays all its children at the same time either horizontally or vertically aligned. Default is vertically aligned.

* Part. A Part is a container for a view. Parts are user interface components which allow you to navigate and modify data.

* Part stack. A part stack contains a stack of parts showing the content of one part while displaying only the headers of the other parts.

* View. A view is used to work on a set of data, which might be a hierarchical structure. If data is changed via the view, this change is directly applied to the underlying data structure. A predefined view could be a chart, a dialog, a grid, an organigram, a report, a select table, a table or a topology in OS.bee.

==Perspective DSL==

The PerspectiveDSL is used to build the ui for Os.bee Application.

You can find instances of these elements in Os.bee Applications as follows: [[File:PerspectiveDSL_02.png|600px]] 

The main semantic elements of the PerspectiveDSL are:

* “package” - the root element that contains all the other elements. A model can contain multiple packages.

* “perspective” - define the perspective details, e.g. perspective name, the description…

* “sashContainer” - define the main element sash container for the perspective.

* “partStack” - define the main element part stack for the perspective.

* “part” - the main element part for the perspective.

* “view” - define the part view of the perspective, it can be report, dialog, table, chart …

===Syntax===

====package definition====

► '''Syntax''':
<syntaxhighlight lang="java">
package <package name> [{
perspective <perspective name> . . .
. . .
}]
</syntaxhighlight>

One or more than one perspective could be defined in the same package.

► '''Example''':
<syntaxhighlight lang="java">
package net.osbee.sample.foodmart.perspectives {
perspective Employee . . .

perspective Supplier . . .

perspective Products . . .

. . .
}
</syntaxhighlight>

In this example <code>perspective</code> Employee, <code>perspective</code> Supplier, <code>perspective</code> Products and also other perspectives are defined in the same <code>package</code>.

====perspective====

This is the main part of this model. All the perspective details can be defined here.

► '''Syntax''':
<syntaxhighlight lang="java">
perspective <perspective name> [described by <description>]
[process <blip.blip name> usertask <blip.BlipUserTask name>]
([icon <iconURI>]
&
[accessibility <accessibilityPhrase>]
&
[toolbar <action.ActionToolbar>])
{
<PerspectiveElement>
. . .
[eventManager <PerspectiveEventManager>]
}
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this perspective.

* Keyword <code>process. . . usertask. . . </code> is optional, which define the blip process and blip usertask from predefined blipDSL for this perspective.

* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file.

* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

* Keyword <code>toolbar</code> is optional, which define the action tool bar from predefined [[Action DSL]]. Graphical control elements are defined, on which on-screen buttons, icons, menus, or other input or output elements are placed.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
. . .
}

perspective ProductMaintenanceSelect process ProductMaintenance usertask SelectSomeProducts toolbar HandleTask icon "information" {
. . .
}
</syntaxhighlight>

In the next sections, the important elements and keywords of perspective will be introduced one by one.

====PerspectiveElement====

Keyword <code>PerspectiveElement</code> is used to define the main elements of the perspective.

The main elements are sash container, part stack and part.

=====sashContainer=====

Keyword <code>sashContainer</code> is used to define the main element sash container of perspective.

A sash container displays all its children at the same time either horizontally or vertically aligned.

► '''Syntax''':
<syntaxhighlight lang="java">
sashContainer <PerspectiveSashContainer ID>
[orientation horizontal|vertical]
&
[selectedElement <PerspectiveElement ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>orientation</code> is optional, it can be horizontal or vertical, and default value is vertical.
* Keyword <code>selectedElement</code> is optional; you can select one of the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this sash container in screen. A number will be defined to representing the relative size of this container.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
. . .
}
}
}
</syntaxhighlight>

In this example, in the first place, the <code>sash container</code> '''''outer''''' is defined, in this sash container, 2 second level <code>sash containers</code> are defined as horizontal, they are '''''top''''' and '''''bottom'''''.

=====partStack=====

Keyword <code>partStack</code> is used to define the main element part stack of perspective.

A part stack contains a stack of parts showing the contents of one part while displaying only the headers of the other parts.

► '''Syntax''':
<syntaxhighlight lang="java">
partStack <PerspectivePartStack ID>
[selectedElement <PerspectivePart ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>selectedElement</code> is optional; you can select the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part stack in screen. A number will be defined to representing the relative size of this part stack.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
partStack EmployeeStack spaceVolume "70" {
. . .
}
partStack Payroll spaceVolume "30" {
. . .
}
}
}
}
</syntaxhighlight>

In this example, 2 <code>part stacks</code> are defined under <code>sash container</code> '''''bottom''''', they are '''''EmployeeStack''''' and '''''Payroll'''''. The sizes of them are redefined here, '''''EmployeeStack''''' takes 70% of the screen width and '''''payroll''''' takes the rest 30%.

=====part=====

Keyword part is used to define the main element part of perspective.

► '''Syntax''':
<syntaxhighlight lang="java">
part <PerspectivePart ID>
[described by <description String>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
&
[icon <iconURI string>]
&
[view select <table.Table> | table <table.Table>
| chart <chart.Chart> | report <report.Report>
| organigram <organization.Organization>
| topology <topology.Topology>
| dialog <dialog.Dialog> | grid <table.Table>
]
&
[isClosable]
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this part.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part in screen. A number will be defined to representing the relative size of this part.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.
* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file
* Keyword <code>view</code> is optional, it defines the predefined view of this part, it can be report, dialog, table, chart, organigram, topology.
* Keyword <code>isClosable</code> is optional; it will allow the user to close this part when this keyword is selected.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
part Orga spaceVolume "40" view organigram FoodMart
part Employees spaceVolume "20" view table Employees
part EmployeeDialog spaceVolume "40" view dialog Employee
}
. . .
}
}
</syntaxhighlight>

In this example, 3 <code>parts</code> are defined under <code>sash container</code> '''''top''''', they are '''''Orga''''', '''''Employees''''' and '''''EmployeeDialog'''''. The sizes of them are redefined here, '''''Orga''''' and '''''EmployeeDialog''''' take each 40% of the screen width and '''''Employees''''' takes the remaining 20%. The view of '''''Orga''''' is the predefined <code>organigram</code> '''''FoodMart'''''; the view of '''''Employees''''' is the predefined <code>table</code> '''''Employee'''''; and the view of '''''EmployeeDialog''''' is the predefined <code>dialog</code> '''''Employee'''''.

====PerspectiveEventManager====

Keyword <code>eventManager</code> is used to describe an optional event manager for the perspective. By default (i.e. if no event manager is defined) a change of the data in one perspective part automatically changes the associated data in all other perspective parts (e.g. if one part is a table and another part a dialog to edit this table, then clicking on a line in the table automatically affect the data shown in the dialog). This behaviour can be restricted by using a PerspectiveEventManager

► '''Syntax''':
<syntaxhighlight lang="java">
eventManager <name> {
targetPart <PerspectivePart partName1> allowedSources {
<PerspectivePart sourceName1>
<PerspectivePart sourceName2>
...
}
targetPart <PerspectivePart partName2> allowedSources {
...
}
...
}
</syntaxhighlight>

* Keyword <code>targetPart</code> describes the perspective part for which we want to restrict the changes automatically being made by other parts.
* Keyword <code>allowedSources</code> describes which parts are allowed to affect the target part.

► '''Example''':
<syntaxhighlight lang="java">
perspective My1stApp icon "employee" {
sashContainer My1stApp orientation horizontal {
part My1stAppTable1 spaceVolume "50" view editableTable Persons
part My1stAppView1 spaceVolume "50" view dialog Person
part My1stAppTable2 spaceVolume "50" view editableTable Persons2
part My1stAppView2 spaceVolume "50" view dialog Person2
}
eventManager My1stAppEventManager {
targetPart My1stAppView1 allowedSources {My1stAppTable1}
targetPart My1stAppView2 allowedSources {My1stAppTable1 My1stAppTable2}
}
}
}
</syntaxhighlight>

In this example, there are two perspective parts displaying a table and two parts displaying a dialog corresponding to the table data. By using an <code>eventManager</code> we ensure that

* clicking on a line in the first table part, '''''My1stAppTable1''''', shows the corresponding data in both dialogs
* clicking on a line in the second table part, '''''My1stAppTable2''''', shows the corresponding data only in the second dialog, because the table part '''''My1stAppView1''''', that displays the first dialog, does not have '''''My1stAppTable2''''' in its allowed sources.

== Copyright Notice ==
{{Copyright Notice}}

Perspective DSL

2019-08-26T12:20:21Z

Kraeling:

==Introduction==

Os.bee Applications which are generated using the OS.bee software factory have by default a front end based on the E4-UI-Model. [[File:PerspectiveDSL_01.png|600px]] 

As you can recognize on the above graphics the main elements of theE4-Model are:

* Perspective. A perspective is a container for a set of UI graphic elements, like sash, part stack, part, area, etc. Perspectives can be used to store different arrangements of UI graphic elements. Each Workbench window contains one or more perspectives. A perspective defines the initial set and layout of views in the Workbench window. Each perspective provides a set of functionality aimed at accomplishing a specific type of task or works with specific types of resources.

* Sash. A sash is a UI graphic elements container, and it displays all its children at the same time either horizontally or vertically aligned. Default is vertically aligned.

* Part. A Part is a container for a view. Parts are user interface components which allow you to navigate and modify data.

* Part stack. A part stack contains a stack of parts showing the content of one part while displaying only the headers of the other parts.

* View. A view is used to work on a set of data, which might be a hierarchical structure. If data is changed via the view, this change is directly applied to the underlying data structure. A predefined view could be a chart, a dialog, a grid, an organigram, a report, a select table, a table or a topology in OS.bee.

==Perspective DSL==

The PerspectiveDSL is used to build the ui for Os.bee Application.

You can find instances of these elements in Os.bee Applications as follows: [[File:PerspectiveDSL_02.png|600px]] 

The main semantic elements of the PerspectiveDSL are:

* “package” - the root element that contains all the other elements. A model can contain multiple packages.

* “perspective” - define the perspective details, e.g. perspective name, the description…

* “sashContainer” - define the main element sash container for the perspective.

* “partStack” - define the main element part stack for the perspective.

* “part” - the main element part for the perspective.

* “view” - define the part view of the perspective, it can be report, dialog, table, chart …

===Syntax===

====package definition====

► '''Syntax''':
<syntaxhighlight lang="java">
package <package name> [{
perspective <perspective name> . . .
. . .
}]
</syntaxhighlight>

One or more than one perspective could be defined in the same package.

► '''Example''':
<syntaxhighlight lang="java">
package net.osbee.sample.foodmart.perspectives {
perspective Employee . . .

perspective Supplier . . .

perspective Products . . .

. . .
}
</syntaxhighlight>

In this example <code>perspective</code> Employee, <code>perspective</code> Supplier, <code>perspective</code> Products and also other perspectives are defined in the same <code>package</code>.

====perspective====

This is the main part of this model. All the perspective details can be defined here.

► '''Syntax''':
<syntaxhighlight lang="java">
perspective <perspective name> [described by <description>]
[process <blip.blip name> usertask <blip.BlipUserTask name>]
([icon <iconURI>]
&
[accessibility <accessibilityPhrase>]
&
[toolbar <action.ActionToolbar>])
{
<PerspectiveElement>
. . .
[eventManager <PerspectiveEventManager>]
}
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this perspective.

* Keyword <code>process. . . usertask. . . </code> is optional, which define the blip process and blip usertask from predefined blipDSL for this perspective.

* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file.

* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

* Keyword <code>toolbar</code> is optional, which define the action tool bar from predefined [[Action DSL]]. Graphical control elements are defined, on which on-screen buttons, icons, menus, or other input or output elements are placed.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
. . .
}

perspective ProductMaintenanceSelect process ProductMaintenance usertask SelectSomeProducts toolbar HandleTask icon "information" {
. . .
}
</syntaxhighlight>

In the next sections, the important elements and keywords of perspective will be introduced one by one.

====PerspectiveElement====

Keyword <code>PerspectiveElement</code> is used to define the main elements of the perspective.

The main elements are sash container, part stack and part.

=====sashContainer=====

Keyword <code>sashContainer</code> is used to define the main element sash container of perspective.

A sash container displays all its children at the same time either horizontally or vertically aligned.

► '''Syntax''':
<syntaxhighlight lang="java">
sashContainer <PerspectiveSashContainer ID>
[orientation horizontal|vertical]
&
[selectedElement <PerspectiveElement ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>orientation</code> is optional, it can be horizontal or vertical, and default value is vertical.
* Keyword <code>selectedElement</code> is optional; you can select one of the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this sash container in screen. A number will be defined to representing the relative size of this container.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
. . .
}
}
}
</syntaxhighlight>

In this example, in the first place, the <code>sash container</code> '''''outer''''' is defined, in this sash container, 2 second level <code>sash containers</code> are defined as horizontal, they are '''''top''''' and '''''bottom'''''.

=====partStack=====

Keyword <code>partStack</code> is used to define the main element part stack of perspective.

A part stack contains a stack of parts showing the contents of one part while displaying only the headers of the other parts.

► '''Syntax''':
<syntaxhighlight lang="java">
partStack <PerspectivePartStack ID>
[selectedElement <PerspectivePart ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>selectedElement</code> is optional; you can select the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part stack in screen. A number will be defined to representing the relative size of this part stack.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
partStack EmployeeStack spaceVolume "70" {
. . .
}
partStack Payroll spaceVolume "30" {
. . .
}
}
}
}
</syntaxhighlight>

In this example, 2 <code>part stacks</code> are defined under <code>sash container</code> '''''bottom''''', they are '''''EmployeeStack''''' and '''''Payroll'''''. The sizes of them are redefined here, '''''EmployeeStack''''' takes 70% of the screen width and '''''payroll''''' takes the rest 30%.

=====part=====

Keyword part is used to define the main element part of perspective.

► '''Syntax''':
<syntaxhighlight lang="java">
part <PerspectivePart ID>
[described by <description String>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
&
[icon <iconURI string>]
&
[view select <table.Table> | table <table.Table>
| chart <chart.Chart> | report <report.Report>
| organigram <organization.Organization>
| topology <topology.Topology>
| dialog <dialog.Dialog> | grid <table.Table>
]
&
[isClosable]
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this part.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part in screen. A number will be defined to representing the relative size of this part.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.
* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file
* Keyword <code>view</code> is optional, it defines the predefined view of this part, it can be report, dialog, table, chart, organigram, topology.
* Keyword <code>isClosable</code> is optional; it will allow the user to close this part when this keyword is selected.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
part Orga spaceVolume "40" view organigram FoodMart
part Employees spaceVolume "20" view table Employees
part EmployeeDialog spaceVolume "40" view dialog Employee
}
. . .
}
}
</syntaxhighlight>

In this example, 3 <code>parts</code> are defined under <code>sash container</code> '''''top''''', they are '''''Orga''''', '''''Employees''''' and '''''EmployeeDialog'''''. The sizes of them are redefined here, '''''Orga''''' and '''''EmployeeDialog''''' take each 40% of the screen width and '''''Employees''''' takes the remaining 20%. The view of '''''Orga''''' is the predefined <code>organigram</code> '''''FoodMart'''''; the view of '''''Employees''''' is the predefined <code>table</code> '''''Employee'''''; and the view of '''''EmployeeDialog''''' is the predefined <code>dialog</code> '''''Employee'''''.

====PerspectiveEventManager====

Keyword <code>eventManager</code> is used to describe an optional event manager for the perspective. By default (i.e. if no event manager is defined) a change of the data in one perspective part automatically changes the associated data in all other perspective parts (e.g. if one part is a table and another part a dialog to edit this table, then changes in the dialog automatically affect the table data). This behaviour can be restricted by using a PerspectiveEventManager

► '''Syntax''':
<syntaxhighlight lang="java">
eventManager <name> {
targetPart <PerspectivePart partName1> allowedSources {
<PerspectivePart sourceName1>
<PerspectivePart sourceName2>
...
}
targetPart <PerspectivePart partName2> allowedSources {
...
}
...
}
</syntaxhighlight>

* Keyword <code>targetPart</code> describes the perspective part for which we want to restrict the changes automatically being made by other parts.
* Keyword <code>allowedSources</code> describes which parts are allowed to affect the target part.

== Copyright Notice ==
{{Copyright Notice}}

Perspective DSL

2019-08-22T07:50:22Z

Kraeling: Changed keyword "IconURI" to "Icon"

==Introduction==

Os.bee Applications which are generated using the OS.bee software factory have by default a front end based on the E4-UI-Model. [[File:PerspectiveDSL_01.png|600px]] 

As you can recognize on the above graphics the main elements of theE4-Model are:

* Perspective. A perspective is a container for a set of UI graphic elements, like sash, part stack, part, area, etc. Perspectives can be used to store different arrangements of UI graphic elements. Each Workbench window contains one or more perspectives. A perspective defines the initial set and layout of views in the Workbench window. Each perspective provides a set of functionality aimed at accomplishing a specific type of task or works with specific types of resources.

* Sash. A sash is a UI graphic elements container, and it displays all its children at the same time either horizontally or vertically aligned. Default is vertically aligned.

* Part. A Part is a container for a view. Parts are user interface components which allow you to navigate and modify data.

* Part stack. A part stack contains a stack of parts showing the content of one part while displaying only the headers of the other parts.

* View. A view is used to work on a set of data, which might be a hierarchical structure. If data is changed via the view, this change is directly applied to the underlying data structure. A predefined view could be a chart, a dialog, a grid, an organigram, a report, a select table, a table or a topology in OS.bee.

==Perspective DSL==

The PerspectiveDSL is used to build the ui for Os.bee Application.

You can find instances of these elements in Os.bee Applications as follows: [[File:PerspectiveDSL_02.png|600px]] 

The main semantic elements of the PerspectiveDSL are:

* “package” - the root element that contains all the other elements. A model can contain multiple packages.

* “perspective” - define the perspective details, e.g. perspective name, the description…

* “sashContainer” - define the main element sash container for the perspective.

* “partStack” - define the main element part stack for the perspective.

* “part” - the main element part for the perspective.

* “view” - define the part view of the perspective, it can be report, dialog, table, chart …

===Syntax===

====package definition====

► '''Syntax''':
<syntaxhighlight lang="java">
package <package name> [{
perspective <perspective name> . . .
. . .
}]
</syntaxhighlight>

One or more than one perspective could be defined in the same package.

► '''Example''':
<syntaxhighlight lang="java">
package net.osbee.sample.foodmart.perspectives {
perspective Employee . . .

perspective Supplier . . .

perspective Products . . .

. . .
}
</syntaxhighlight>

In this example <code>perspective</code> Employee, <code>perspective</code> Supplier, <code>perspective</code> Products and also other perspectives are defined in the same <code>package</code>.

====perspective====

This is the main part of this model. All the perspective details can be defined here.

► '''Syntax''':
<syntaxhighlight lang="java">
perspective <perspective name> [described by <description>]
[process <blip.blip name> usertask <blip.BlipUserTask name>]
([icon <iconURI>]
&
[accessibility <accessibilityPhrase>]
&
[toolbar <action.ActionToolbar>])
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this perspective.

* Keyword <code>process. . . usertask. . . </code> is optional, which define the blip process and blip usertask from predefined blipDSL for this perspective.

* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file.

* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

* Keyword <code>toolbar</code> is optional, which define the action tool bar from predefined [[Action DSL]]. Graphical control elements are defined, on which on-screen buttons, icons, menus, or other input or output elements are placed.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
. . .
}

perspective ProductMaintenanceSelect process ProductMaintenance usertask SelectSomeProducts toolbar HandleTask icon "information" {
. . .
}
</syntaxhighlight>

In the next sections, the important elements and keywords of perspective will be introduced one by one.

====PerspectiveElement====

Keyword <code>PerspectiveElement</code> is used to define the main elements of the perspective.

The main elements are sash container, part stack and part.

=====sashContainer=====

Keyword <code>sashContainer</code> is used to define the main element sash container of perspective.

A sash container displays all its children at the same time either horizontally or vertically aligned.

► '''Syntax''':
<syntaxhighlight lang="java">
sashContainer <PerspectiveSashContainer ID>
[orientation horizontal|vertical]
&
[selectedElement <PerspectiveElement ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>orientation</code> is optional, it can be horizontal or vertical, and default value is vertical.
* Keyword <code>selectedElement</code> is optional; you can select one of the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this sash container in screen. A number will be defined to representing the relative size of this container.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
. . .
}
}
}
</syntaxhighlight>

In this example, in the first place, the <code>sash container</code> '''''outer''''' is defined, in this sash container, 2 second level <code>sash containers</code> are defined as horizontal, they are '''''top''''' and '''''bottom'''''.

=====partStack=====

Keyword <code>partStack</code> is used to define the main element part stack of perspective.

A part stack contains a stack of parts showing the contents of one part while displaying only the headers of the other parts.

► '''Syntax''':
<syntaxhighlight lang="java">
partStack <PerspectivePartStack ID>
[selectedElement <PerspectivePart ID>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
{
PerspectiveElement
. . .
}
</syntaxhighlight>

* Keyword <code>selectedElement</code> is optional; you can select the next level perspective element here and which is selected will be shown in the first place.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part stack in screen. A number will be defined to representing the relative size of this part stack.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
. . .
}
sashContainer bottom orientation horizontal {
partStack EmployeeStack spaceVolume "70" {
. . .
}
partStack Payroll spaceVolume "30" {
. . .
}
}
}
}
</syntaxhighlight>

In this example, 2 <code>part stacks</code> are defined under <code>sash container</code> '''''bottom''''', they are '''''EmployeeStack''''' and '''''Payroll'''''. The sizes of them are redefined here, '''''EmployeeStack''''' takes 70% of the screen width and '''''payroll''''' takes the rest 30%.

=====part=====

Keyword part is used to define the main element part of perspective.

► '''Syntax''':
<syntaxhighlight lang="java">
part <PerspectivePart ID>
[described by <description String>]
&
[spaceVolume <containerData STRING>]
&
[accessibility <accessibilityPhrase STRING>]
&
[icon <iconURI string>]
&
[view select <table.Table> | table <table.Table>
| chart <chart.Chart> | report <report.Report>
| organigram <organization.Organization>
| topology <topology.Topology>
| dialog <dialog.Dialog> | grid <table.Table>
]
&
[isClosable]
</syntaxhighlight>

* Keyword <code>described by</code> is optional; you can use this keyword to define the description of this part.
* Keyword <code>spaceVolume</code> is optional, it redefine the space volume of this part in screen. A number will be defined to representing the relative size of this part.
* Keyword <code>accessibility</code> is optional, it can be any string; this field is provided as a way to inform accessibility screen readers with extra information. The intent is that the reader should 'say' this phrase as well as what it would normally emit given the widget hierarchy. A screen reader is an essential piece of software for a blind or visually impaired person. Simply put, a screen reader transmits whatever text is displayed on the computer screen into a form that a visually impaired user can process (usually tactile, auditory or a combination of both). While the most basic screen readers will not help blind users navigate a computer, those with additional features can give people with visual impairment much more independence.
* Keyword <code>icon</code> is optional, it defines the identifier for a resource, e.g. icon file
* Keyword <code>view</code> is optional, it defines the predefined view of this part, it can be report, dialog, table, chart, organigram, topology.
* Keyword <code>isClosable</code> is optional; it will allow the user to close this part when this keyword is selected.

► '''Example''':
<syntaxhighlight lang="java">
perspective Employee described by "Employee maintenance" icon "employee" {
sashContainer outer orientation vertical {
sashContainer top orientation horizontal {
part Orga spaceVolume "40" view organigram FoodMart
part Employees spaceVolume "20" view table Employees
part EmployeeDialog spaceVolume "40" view dialog Employee
}
. . .
}
}
</syntaxhighlight>

In this example, 3 <code>parts</code> are defined under <code>sash container</code> '''''top''''', they are '''''Orga''''', '''''Employees''''' and '''''EmployeeDialog'''''. The sizes of them are redefined here, '''''Orga''''' and '''''EmployeeDialog''''' take each 40% of the screen width and '''''Employees''''' takes the remaining 20%. The view of '''''Orga''''' is the predefined <code>organigram</code> '''''FoodMart'''''; the view of '''''Employees''''' is the predefined <code>table</code> '''''Employee'''''; and the view of '''''EmployeeDialog''''' is the predefined <code>dialog</code> '''''Employee'''''.

== Copyright Notice ==
{{Copyright Notice}}