Zum Hauptinhalt springen

Upgrade auf 23.0.0

gefahr

Unbedingt die aktuellen Installationsvoraussetzungen vorab prüfen!

tipp

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​

gefahr

Diese Version stellt die Kompatibilität mit documentsOS her. Durch die Vielzahl an Änderungen, die sich sowohl durch das SDK als auch durch alle OUSPs ziehen, wird dringend empfohlen zum Update eine:n Softwareentwickler:in zu Rate zu ziehen!

vorsicht

Bitte unbedingt vorher folgende Punkte durchlesen:

  • Alle Portalscripte wurden von "#import" auf "require" migriert
  • Alle Portalscripte wurden an den modernen PortalScripting-Standard angepasst (kein top-level return mehr, etc.)
  • Es müssen daher alle cust-, spc-, template-Scripte und User-Exit-Scripte angepasst und geprüft werden!

Was wurde gemacht ?​

Zusammenfassung​

  • documentsOS-Kompatibilität wurde hergestellt EFI-116, EFI-117, EFI-118, EFI-119
  • Das Löschen von Unterkategorien prüft nun vorab, ob noch Mappen mit dieser Kategorie vorhanden sind EFI-124
  • Der Cache wird nun beim Anlegen eines neuen Tags gelöscht, damit dieser danach auch auswählbar ist EFI-120

Manuell auszuführende Schritte​

Portalscripts​

eFilesCust​

gefahr

Untenstehender Schritt darf erst angegangen werden, wenn das PowerShell-Skript env.ps1 aus dem aktuellen One Unity Documents Installationspaket ausgeführt und der Documentsserver-Dienst danach neu gestartet wurde. Eine Anleitung zum Ausführen des Skripts findet sich hier.

Im Skript ou.cust.eFiles.settings müssen die hartkodierten Datenbank-Zugangsdaten durch eine Belegung via Umgebungsvariablen (OUSP_DATABASE_USER und OUSP_DATABASE_PASSWORD) ersetzt werden.

Vorher:

module.exports = {
    databases: {
        ousp: {
            connType: "odbc",
            connString: "ousp",
            user: "oucdbadmin",
            password: "!ouc2016",
        },
    },
    ...
};

Nachher:

const dbUser = util.getEnvironment("OUSP_DATABASE_USER");
const dbPassword = util.getEnvironment("OUSP_DATABASE_PASSWORD");

module.exports = {
    databases: {
        ousp: {
            connType: "odbc",
            connString: "ousp",
            user: dbUser,
            password: dbPassword,
        },
    },
    ...
};