Urlaubsverwaltung 4.0 Migration Guide

Inhaltsverzeichnis

4.0 Milestone 1 Migration
4.0 Milestone 2 Migration
4.0 Milestone 3 Migration
4.0 Milestone 4 Migration
4.0 Milestone 5 Migration
4.0 Milestone 6 Migration
4.0 Milestone 7 Migration
4.0 Migration

Before you start

The 'Urlaubsverwaltung' needs Java 11 or later and a MariaDB 10.5 or later.

4.0.0 Milestone 1 Migration

Spring Boot

We upgraded the Urlaubsverwaltung to Spring Boot 2.2.x - see migration guide

Deprecation's from Urlaubsverwaltung 3.x

Classes, methods and properties that were deprecated in Urlaubsverwaltung 3.x have been removed in this release. Please ensure that you aren’t calling deprecated methods before upgrading.

• Mail Configuration GUI

Test Data

The testdata profile will be renamed to demodata, because this profile should only be used
to easily create a demo application with demo data in it and is absolutely not recommended to use in production!

Change:

• uv.development.testdata.create to uv.development.demodata.create

Logging

Change:

• logging.file to logging.file.name

Availability API

Change:

• HOLIDAY to PUBLIC_HOLIDAY as TimeAbsence type

Deprecations in Urlaubsverwaltung 4.0.0.M1

The google and exchange calendar Calendar synchronization feature will be deprecated in favor of the share calendar feature with iCal support. See https://demo.urlaubsverwaltung.cloud/web/calendars/share/persons/4 (office/secret)

4.0.0 Milestone 2 Migration

Spring Boot

We upgraded the Urlaubsverwaltung to Spring Boot 2.3.x - see migration guide

Active Directory

Change:

• Add uv.security.directory-service.active-directory.search-filter to override the search filter.

API Changes

• Removed sensitive TimedAbsence Type data from the availability api.
• Rename from list to overviews in /api/vacationoverview
• Move /api/vacations to /api/persons/{id}/vacations?from={yyyy-MM-dd}&to={yyyy-MM-dd} with optional ofDepartmentMembers

Logging

Change:

• Remove file logging by default. This can be enabled with the spring boot logging features

4.0.0 Milestone 3 Migration

Configuration changes

Change:

• Replace uv.security.oidc.logout-path with uv.security.oidc.logout-uri which holds the complete uri and not only a path.

Deprecations in Urlaubsverwaltung 4.0.0.M3

• api/vacationoverview

4.0.0 Milestone 4 Migration

Internal person management

Change:

• remove "add person" in internal person management
• remove uv.person.can-be-manipulated

API Changes

• Move /api/absences to /api/persons/{id}/absences?from={yyyy-MM-dd}&to={yyyy-MM-dd} with optional type instead of month and year
• Move /api/sicknotes to /api/persons/{id}/sicknotes?from={yyyy-MM-dd}&to={yyyy-MM-dd} instead of month and year
• Move /api/holidays to /api/persons/{id}/public-holidays?from={yyyy-MM-dd}&to={yyyy-MM-dd} instead of month and year
• Move /api/workdays to /api/persons/{id}/workdays?from={yyyy-MM-dd}&to={yyyy-MM-dd} with optional length instead of month and year

4.0.0 Milestone 5 Migration

No breaking changes.

4.0.0 Milestone 6 Migration

Configuration changes

Change:

• Remove uv.mail.application-url this will be determined automatically.

4.0.0 Milestone 7 Migration

No breaking changes.

4.0.0 Migration

Database

We test the 'Urlaubsverwaltung' against MariaDB 10.5 so it is the recommended Database.

Configuration changes

Change:

• readded the uv.mail.application-url because the automatic detection did not work for every case. Especially when no request was involved.
• To expose prometheus endpoint additionally configuration is needed management.endpoints.web.exposure.include=prometheus and management.endpoint.prometheus.enabled=true, see Spring Docs for further information.