Upgrade auf 26.0.0
Unbedingt die aktuellen Installationsvoraussetzungen vorab prüfen!
Diese Anleitung berücksichtigt immer nur den Sprung von der vorhergehenden Version zu der gerade beschriebenen Version. Bei Upgrades über mehrere Versionen hinweg müssen alle Änderungen der Zwischenversionen ebenfalls beachtet werden! Siehe genereller Ablauf von Upgrades.
Breaking Changes
Funktionen wurden ausgelagert (LIB-529)
Die Funktionen getDatabaseConnectionAndProvider und getDatabaseConnectionAndProviderOrThrow wurden beide aus dem ou.spc.library.dbConnections entfernt und sind nun im ou.sp.library.dbConnections Skript verfügbar. Im Skript ou.spc.library.dbConnections verbleibt nur die databaseConnections.
Daher müssen in allen *.cust.* Skripten die Importe von getDatabaseConnectionAndProvider und getDatabaseConnectionAndProviderOrThrow aus ou.spc.library.dbConnections auf ou.sp.library.dbConnections angepasst werden. Wurde zusätzlich databaseConnections aus demselben Skript importiert, muss der Import aufgeteilt werden: databaseConnections verbleibt in ou.spc.library.dbConnections, während die beiden Funktionen aus ou.sp.library.dbConnections importiert werden.
StartTaskOptions.provider ist jetzt Pflicht (LIB-536)
In ou.sp.SapPublicCloud.startTask wird vor dem Auslösen eines neuen Tasks geprüft, ob für die übergebene configId bereits ein Task läuft. Diese Prüfung benötigt einen DBProvider, daher hat StartTaskOptions ein neues Pflichtfeld provider: DBProvider erhalten. Aufrufe ohne provider führen ab dieser Version zu Fehlern.
Alle Aufrufer von startTask (typischerweise in kundenspezifischen Skripten) müssen provider in den Options mitgeben:
import { startTask } from "@one-unity/library/ou.sp.SapPublicCloud";
import { getDatabaseConnectionAndProviderOrThrow } from "@one-unity/library/ou.sp.library.dbConnections";
const { db, provider } = getDatabaseConnectionAndProviderOrThrow("ousp");
startTask({ db, provider, configId: "myConfig" });
Zusammenfassung
Upgrade
.tmpl.-Skripte werden nun in der Skript-Kompatibilitätsprüfung berücksichtigt und sind Teil der generierten Script-Hash-Map. (OUD-236)- MultiTable: Ist
resizablenicht gesetzt, wirkt die konfigurierte Spalten-widthzusätzlich alsmin-width. Damit halten Spalten ihre Mindestbreite und schrumpfen in breiten Tabellen nicht mehr unter den konfigurierten Wert. (LIB-405)
Manuell auszuführende Schritte
Scriptlibs
Ab dieser Version werden die Scriptlibs nur noch unverschlüsselt ausgeliefert, d.h. es muss zwingend zu jedem Skript in Workflow/server/scriptlibs/ou/sp das zugehörige verschlüsselte Skript (Dateiendung #.js) gelöscht werden.
Portalskripte
Template-Skripte (.tmpl.) (OUD-236)
Da .tmpl.-Skripte bisher nicht in der Script-Hash-Map erfasst wurden, werden sie beim ersten Upgrade nach diesem Update in der Kompatibilitätsprüfung als neu erstellt (New) gemeldet. Darunter können sich sowohl tatsächlich neu hinzugefügte als auch bereits bestehende Skripte befinden – letztere wurden lediglich erstmals in die Hash-Map aufgenommen. Im DiffViewer ist ersichtlich, welche .tmpl.-Skripte in dieser Version neu hinzugekommen sind. Die übrigen gemeldeten Skripte können ignoriert werden.