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 führt das neue One Unity Standard-DMS ein und ist ausschließlich mit den Versionen der OUSPs kompatibel, die ebenfalls bereits das Standard-DMS implementiert haben. Demnach müssen direkt anschließend an das OUD-Update auch alle installierten OUSPs auf eine kompatible Version geupdatet werden.

Was wurde gemacht ?

Zusammenfassung

• OUD enthält nun das Standard-DMS, wodurch die Struktur der Outbars und Ordner grundlegend verändert wurde (OUD-100, OUD-105):
  • Eine neue Outbar Input Management wurde hinzugefügt.
  • Die Maildaemon Ordner befinden sich nun in der neuen Outbar Input Management (vorher: 'One Unity Solutions') und der Oberordner wurde von 'Maildaemon' in Postfachimport umbenannt.
  • Die Outbar 'One Unity Solutions' wurde in One Unity Administration umbenannt.
• Die Module 'E-Mail Vorlagen' und 'Aufzählungswerte' werden nun mit OUD ausgeliefert (OUD-111). Sie befinden sich in der Outbar One Unity Administration unter dem Punkt Allgemein. Zum Anlegen der Mailvorlagen wird nun ein Wizard-Gadget verwendet und die Felder 'An', 'CC' und 'Sender-Mail' verfügen nun über eine Auto-Vervollständigung, welche bei einer Eingabe von mindestens 3 Zeichen passende E-Mail Adressen der Benutzer vorschlägt.
• Ein Dialog zum Konfigurieren verschiedener Benutzereinstellungen wurde implementiert (OUD-101)
• Für den Menüpunkt "Benutzerkonfiguration" wird nun korrekt das Label aus den Locales verwendet OUD-150

Manuell auszuführende Schritte

• Siehe genereller Ablauf von Upgrades

Portalskripte

ou.cust.client.settings

Statt das Label des ersten Eintrags als String zu definieren, wird der Wert nun aus den Locales gezogen:

Vorher:

var entries = [{
  name: "runScriptUserConfiguration",
  /* Diese Zeile muss entfernt werden */
  label: "Benutzerkonfiguration",
  /* Ende Anpassung */
  tooltip: "Öffnet die Benutzerkonfiguration",
  action: "runScript:ou.sp.client.action.openUserConfiguration"
}, {
  name: "RULER",
  label: ""
}];

Nachher:

var entries = [{
  name: "runScriptUserConfiguration",
  /* Diese Zeile muss hinzu gefügt werden */
  label: context.getFromSystemTable("userconfig.form.title"),
  /* Ende Anpassung */
  label: "Benutzerkonfiguration",
  tooltip: "Öffnet die Benutzerkonfiguration",
  action: "runScript:ou.sp.client.action.openUserConfiguration"
}, {
  name: "RULER",
  label: ""
}];

Datenbank

• Je nach DBMS entweder die Database/mssql.sql oder die Database/mariadb.sql ausführen.
• Sofern OUSP Invoice auf dem System installiert ist, muss nun die bestehende Datenbanktabelle cfgEnumerationValue aus der Datenbank ptpData in die Datenbank ousp verschoben werden. Das zuvor ausgeführte SQL-Skript sollte die Tabelle bereits neu in der Datenbank ousp angelegt haben. Es müssen nun alle bestehenden Tabelleneinträge in diese neue Tabelle eingefügt werden.

mariadb:

INSERT INTO `ousp`.`cfgEnumerationValue` SELECT * FROM `ptpData`.`cfgEnumerationValue`;

mssql:

INSERT INTO [ousp].[dbo].[cfgEnumerationValue] SELECT * FROM [ptpData].[dbo].[cfgEnumerationValue];

Wenn sichergestellt wurde, dass alle Einträge übertragen wurden, kann die Tabelle cfgEnumerationValue in der Datenbank ptpData gelöscht werden.

mariadb:

DROP TABLE `ptpData`.`cfgEnumerationValue`;

mssql:

DROP TABLE [ptpData].[dbo].[cfgEnumerationValue];

Ordner

Sofern OUSP Invoice auf dem System installiert ist, müssen die Ordner ouMailtemplate und cfgEnumerationValue aus der Outbar cfg entfernt werden.

Portalscripts

• Zuerst die ousp-documents-update.xml importieren.
• Folgende cust-Skripte sind neu dazugekommen und müssen manuell angelegt werden (die Skriptinhalte finden sich in der XML/files/1_Portalscripts.install.xml Datei im Installationsverzeichnis):
  • ou.cust.global.filetype.field.eMailAddress.autoComplete in der Portalskript-Kategorie globalCust. Am Skript muss die Eigenschaft clientExecutable auf true gesetzt werden.
  • ou.cust.oud.job.removeCache in der Portalskript-Kategorie globalCust. Das Skript muss als Job eingerichtet werden und sollte täglich laufen
  • ou.cust.oud.settings in der Portalskript-Kategorie globalCust. Hier müssen ggf. die Datenbankeinstellungen angepasst werden.

Nachfolgende Schritte müssen nur abgearbeitet werden, wenn OUSP Invoice auf dem System installiert ist

• Portalskript-Kategorie configuration sollte nun keine Skripte mehr enthalten und kann entfernt werden.
• Es müssen folgende cust-Skripte aus der Portalskript-Kategorie globalcust in die Kategorie globalCust verschoben werden:
  • Gadget_ou.cust.global.filetype.register.timeline.sentMails
  • ou.cust.global.filetype.action.getMailTemplate
  • ou.cust.global.filetype.action.sendMail
  • ou.cust.global.filetype.field.attachments
  • ou.cust.global.filetype.field.body
  • ou.cust.global.filetype.field.recipient
  • ou.cust.global.filetype.field.recipientCopy
  • ou.cust.global.filetype.field.sender
  • ou.cust.global.filetype.field.signatur
  • ou.cust.global.filetype.field.subject
  • ou.cust.global.filetype.userexit.unsetMailIndicator
  • ou.cust.global.loadMailTemplate
• Es müssen folgende cust-Skripte aus der Portalskript-Kategorie mail in die Kategorie mailCust verschoben werden:
  • ou.cust.MAIL.filetype.action.copy
  • ou.cust.MAIL.filetype.action.delete
  • ou.cust.MAIL.filetype.action.help
  • ou.cust.MAIL.filetype.action.onDelete
  • ou.cust.MAIL.filetype.action.onSave
  • ou.cust.MAIL.filetype.field.assignedRegister
  • ou.cust.MAIL.filetype.field.fileType
  • ou.cust.MAIL.filetype.userexit.assignedRegister
  • ou.cust.MAIL.lib
• Folgende Anpassungen an cust-Skripten sind notwendig:
  • ou.cust.global.filetype.action.sendMail: Hier muss das require("ou.sp.ptpINV.settings") durch ein require("ou.sp.oud.settings") ersetzt werden, da die Einstellung mailTemplateHandlebars ins Skript ou.sp.oud.settings gewandert ist. Außerdem muss bei den Skriptparametern recipient, sender und recipientCopy jeweils die Eigenschaft autoCompleteConfig auf den Wert {scriptName:"ou.cust.global.filetype.field.eMailAddress.autoComplete", minQueryChars: 3, queryDelay: 0.5,maxResults:35, autoFocusResult: true} gesetzt werden.
  • ou.cust.MAIL.lib: Auch hier muss das require("ou.sp.ptpINV.settings") durch ein require("ou.sp.oud.settings") ersetzt werden. Außerdem muss im gesamten Skript ptpConnections durch dbConnections ersetzt werden.

Nachfolgende Schritte müssen nur abgearbeitet werden, wenn OUSP Invoice aktuell NICHT auf dem System installiert ist

• Einmalig das Skript ou.sp.oud.doUpdate.OUD-111 ausführen und danach die Logs überprüfen.

Weitere Anpassungen

Im Skript ou.cust.client.settings muss die Variable entries angepasst werden. Den Ansichtsmodus kann man nun über die neue Benuzterkonfiguration verändern.

• Vorher:

  var entries = [
      {
          name: "runScriptViewMode",
          label: "Ansichtsmodus ändern",
          tooltip: "Ändert den Ansichtsmodus (Neuanmeldung erforderlich)",
          action: "runScript:ou.sp.client.UserViewMode",
      },
      {
          name: "RULER",
          label: "",
      },
  ];

• Nachher:

  var entries = [
      {
          name: "runScriptUserConfiguration",
          label: "Benutzerkonfiguration",
          tooltip: "Öffnet die Benutzerkonfiguration",
          action: "runScript:ou.sp.client.action.openUserConfiguration",
      },
      {
          name: "RULER",
          label: "",
      },
  ];