Breaking Changes

Breaking Changes in Webdesk 4.64

Diese Hinweise richten sich an Customer Admins und sind relevant, wenn IF6020, mehrere Beschäftigungen oder kundenspezifische Skripte, Validatoren, Reports und Velocity-Templates verwendet werden.

1. Java 17 als Systemvoraussetzung

Webdesk 4.64 und der zugehörige IF6020-TA-Connector werden mit Java 17 betrieben. Java 11 ist für diese Version nicht ausreichend. Vor dem Update muss geprüft werden, dass auf dem Webdesk-Server und beim TA-Connector eine unterstützte Java-17-Laufzeit installiert und für den jeweiligen Dienst aktiviert ist.

Prüfen Sie insbesondere bei mehreren Java-Installationen, welche Java-Version der Windows-Dienst beziehungsweise das Startskript tatsächlich verwendet. Kundenspezifische Java-Jobs und Integrationen müssen nach dem Update ebenfalls getestet werden. Eine Übersicht der weiteren Neuerungen finden Sie in Neue Features in Webdesk 4.64.

2. Bean-Namen in kundenspezifischen Skripten prüfen

Die TA-Services wurden für mehrere TA-Systeme systembezogen umbenannt. Dadurch können bestehende Skripte, Validierungen, Reports und Velocity-Templates fehlschlagen.

Für IF6020 müssen insbesondere folgende Namen geprüft und angepasst werden:

• TaJournalService → Ta6020JournalService
• TaPersonService → Ta6020PersonService
• TaAccountService → Ta6020AccountService
• TaBookingService → Ta6020BookingService
• TaCorrectionService → Ta6020CorrectionService
• TaMetadataService → Ta6020MetadataService
• TaOptionsService → Ta6020OptionsService
• TaDefinitionService → Ta6020DefinitionService

Bitte alle kundenspezifischen Verwendungen der alten Namen suchen, auf den passenden systembezogenen Bean-Namen umstellen und anschließend testen. Für systemübergreifende TA-Services ist der neue generische Bean-Name zu verwenden.

3. Änderung von stpersnr in IF6020

stpersnr enthält ab 4.64 nicht mehr automatisch die Webdesk-Personalnummer. Beim Anlegen eines TA-Personensatzes wird dort die TA-ID verwendet. Falls diese bereits vergeben ist, erzeugt Webdesk eine andere eindeutige ID.

Die echte Webdesk-employeeId wird in ein separates, konfiguriertes Infofeld geschrieben. Verwenden Sie stpersnr daher nicht mehr als Webdesk-Personalnummer.

4. Drei Infofelder in IF6020 konfigurieren

Für die neue Zuordnung müssen drei Infofelder eingerichtet und in tacon.properties eingetragen werden:

• TaPersonDAO.nameOfFieldStoringPersonUid – Webdesk-PersonUID
• TaPersonDAO.employeeIdField – echte Webdesk-employeeId
• TaPersonDAO.effectiveEmploymentMarkerField – Kennzeichen der aktuell wirksamen Beschäftigung

Die Feldnamen sind installationsabhängig. Als Beispiel verwendet die 4.64-Dokumentation stpinfo151 für die PersonUID, stpinfo160 für die employeeId und stpinfo30 für das Wirksamkeitskennzeichen. Verwenden Sie die bei Ihnen angelegten Felder. PersonUID und employeeId sollten bis zu 50 Zeichen aufnehmen können, das Wirksamkeitskennzeichen mindestens 5 Zeichen.

Webdesk verwendet für das Kennzeichen J für eine aktuell wirksame Beschäftigung und N für eine nicht wirksame Beschäftigung.

5. Vorhandene Daten migrieren

1. Die drei Infofelder und die zugehörigen Eigenschaften konfigurieren.
2. Vorhandene TA-Personensätze mit dem mitgelieferten TA-Update V48 oder dem Job migrateEmployeeId migrieren. Dabei werden die stabile Webdesk-employeeId und das Wirksamkeitskennzeichen in die konfigurierten Infofelder geschrieben.
3. Die Option zum Überschreiben vorhandener Infofeldwerte nur nach vorheriger Prüfung verwenden.
4. Die vorhandenen PersonUIDs über die Webdesk-Admin-Aktion save_personuids_into_TaPersons in die konfigurierten 6020-Infofelder schreiben. Bei neu angelegten TA-Personensätzen wird die PersonUID nach korrekter Konfiguration automatisch geschrieben.

6. TA-ID in den HRX-Beschäftigungen

Bei mehreren Beschäftigungen benötigt jede HrPersonEmployment den passenden TA-ID-Rückverweis in taId. Eine Webdesk-Person bleibt der zentrale Stammdatensatz; in TA wird für jede Beschäftigung ein eigener TA-Personensatz geführt.

Webdesk 4.64 enthält dafür das Upgrade V122. Es synchronisiert die TA-ID der Person mit der passenden aktuell gültigen Beschäftigung. Da das Upgrade bei einem Fehler nicht vollständig abbricht, müssen die Ergebnisse und Warnungen geprüft werden. Bei mehreren Beschäftigungen muss jede TA-ID eindeutig der richtigen Beschäftigung zugeordnet sein. Fehlende oder falsche Zuordnungen nicht direkt in der Datenbank ändern, sondern über die vorgesehenen Webdesk-Funktionen beziehungsweise mit Workflow-Support korrigieren.

7. Prüfung nach dem Upgrade

• Java-Version des Webdesk-Dienstes und des TA-Connectors prüfen.
• Parallele Beschäftigungen, Beendigung und Wiedereintritt testen.
• Prüfen, dass die aktuell wirksame Beschäftigung mit J und nicht wirksame Beschäftigungen mit N gekennzeichnet sind.
• Prüfen, dass die Webdesk-employeeId im separaten Infofeld stabil bleibt und stpersnr nicht mehr dafür verwendet wird.
• TA-Journal, Korrektur- und Abwesenheitsclient sowie kundenspezifische Skripte, Reports und Validierungen testen.

Wenn keine IF6020-Integration, keine Mehrfachbeschäftigungen und keine kundenspezifischen TA-Referenzen vorhanden sind, besteht für diese Punkte in der Regel kein manueller Anpassungsbedarf.