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!
  • Es wurden alle alten Gentable-User-Exits entfernt. Auch die Datenbankkonfiguration über Workflow-ext/jsp/ou/cust/db_connect_ousp_invoice.jsp muss entfernt werden.
  • Die Zahlungsfreigabelogik (Fachliche Prüfung und Freigabe) wurde vollständig überarbeitet und unterstützt jetzt verschiedene Customizing-Szenarien, inkl. temporären Freigaberollen. Für die Anwendung muss jedoch, sofern hier bereits customized wurde, der Prozess (Scripting) überarbeitet werden. Siehe Dokumentation: Prüf- und Freigabelogik

Was wurde gemacht ?​

Zusammenfassung​

  • documentsOS-Kompatibilität wurde hergestellt INV-500
  • Die Zahlungsfreigabelogik (Fachliche Prüfung und Freigabe) wurde vollständig überarbeitet und unterstützt jetzt verschiedene Customizing-Szenarien, inkl. temporären Freigaberollen. Dokumentation: Prüf- und Freigabelogik INV-526, INV-497

Verschiedene Bugfixes und Verbesserungen​

  • Funktion validatePositionsMandatoryColumns verbessern INV-512
  • Auswahlliste von Invoice User zeigt auch gesperrte Logins (ou.cust.ptpINV.enumval.ptpInvoiceUser) INV-519
  • cfgEnumerationValue - onSave bereinigt Cache nicht korrekt INV-514
  • Cockpit - Nettobeträge ohne Steuerbetrag werden nicht angezeigt INV-468
  • Datumsfelder von Zahlungsinformationen werden in Portalscripts nicht berechnet INV-525
  • Cover zeigt vergangene Rechnungsprüfer nicht an, wenn AutoIndex-Algo auf nicht vorschlagen steht INV-530
  • Nächste Mappe wird nicht aktiviert, wenn man einen weiteren fachlichen Freigeber nimmt INV-424
  • Zurück zur Indexierung frägt nicht mehr nach "Bemerkung" INV-426

Manuell auszuführende Schritte​

  • Siehe genereller Ablauf von Upgrades
  • Im Anschluss müssen alle cust-, spc-, template-Scripte und User-Exit-Scripte angepasst und geprüft werden!
  • Alte Gentable-User-Exits müssen entfernt und auf die neuen MultiTable-Funktionen umgeschrieben werden. Anschließend muss die Datei Workflow-ext/jsp/ou/cust/db_connect_ousp_invoice.jsp entfernt werden.
  • Der Workflow muss an zwei Stellen angepasst werden: INV-424, INV-426
  • Die Scriptlibs wurden vollständig aufgelöst und in Portalscripts migriert. Daher muss der komplette Ordner Workflow/server/scriptlibs/ou/sp/invoice gelöscht werden

Portalscripts​

ptpINVcust​

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.ptpINV.settings müssen die hartkodierten Datenbank-Zugangsdaten durch eine Belegung via Umgebungsvariablen (OUSP_DATABASE_USER und OUSP_DATABASE_PASSWORD) ersetzt werden.

Vorher:

const databaseConnections = {
    ptpData: {
        dbType: "odbc",
        dbName: "ptpData",
        dbUser: "oucdbadmin",
        dbPassword: "!ouc2016",
    },
    ousp: {
        dbType: "odbc",
        dbName: "ousp",
        dbUser: "oucdbadmin",
        dbPassword: "!ouc2016",
    },
};
...

Nachher:

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

const databaseConnections = {
    ptpData: {
        dbType: "odbc",
        dbName: "ptpData",
        dbUser: dbUser,
        dbPassword: dbPassword,
    },
    ousp: {
        dbType: "odbc",
        dbName: "ousp",
        dbUser: dbUser,
        dbPassword: dbPassword,
    },
};
...