22.x.x

Voraussetzungen

• Documents5 (Build #5.0e-xx) oder höher
• OUSP Library v20.1 (PDFHelper wird benötigt) oder höher
• Viewplus Extract 20.1.1 oder höher

Erste Schritte Vorgehensweise Installation und Update von < 22.0.0

• Beim Update vorhandenes Skripte sichern

  • WICHTIG Es müssen zuerst alle Postman Mappen mit dem alten Workflow abgearbeitet sein!
  • Maildaemon Dienst stoppen oder wenn Capture Mail, diesen beenden und Mail Queue abarbeiten lassen
  • Sicherung eigener Skripte im Rahmen Postman
    • im Speziellen: ou.sp.Postman.callback.functions
      • prüfen ob es eine ou.sp.Postman.callback.functions gibt (die ein eigentliches kundenspezifisches Portalscript ist ), diese sichern und später wieder als ou.cust.Postman.callback.functions importieren
    • ggf. eigenes "Erlaubte Aktionen" Skript am ouspPostman_Documents Mappentyp, nach Update in die ou.cust.Postman.callback.function mit aufnehmen ACHTUNG: Blick im speziellen auf unverschlüsselte Postman-Skripte und Prüfung es bietet sich an, für diese Skripte einen XML-Export zu machen

• Dateien aus files/1_Documents/Workflow und files/1_Documents/Workflow-ext ins Zielverzeichnis kopieren.

• Den Inhalt der Workflow-ext/jsp/script_ousp_postman.jsp in die vorhandene Workflow-ext/jsp/script.jsp kopieren, bzw. Inhalte prüfen ob etwas hinzugefügt werden muss.

• Als Admin am Documents Manager anmelden

  • XML Import ausführen mit folgender Datei
    • bei Neuinstallation: ousp-postman-install.xml
    • bei Update: ousp-postman-update.xml
  • Workflow an Mappentyp ouspPostman_Documents eintragen bzw. aktualisieren, falls nicht bereits automatisch geschehen
    • Durch ein Update wird die neue Workflow Datei installiert --> ACHTUNG die alte Workflow Datei darf nur gelöscht werden, wenn alle aktiven Mappen auch von anderen Prozessen durchgelaufen sind - besser alte Workflow Datei beibehalten

• Viewplus Extract Installation S:\Produkte\Middleware\Viewplus Extract\01_Full Install

  • Die Ordnerstruktur der Zip Datei ist publish/<<os_system>>\ unter Linux lautet die Datei lediglich viewplus-extract.cli unter Windows logischerweise viewplus-extract.cli.exe - die -.pdb Datei muss nicht mit kopiert werden
    • Windows: In den Ordner ..\OUC-Tools\viewplus-extract kopieren
    • Linux: In den Ordner /opt/ouc-tools/viewplus-extract kopieren > In beiden Fällen muss eine Datei darin liegen die mit viewplus-extract.cli beginnt!

• files\2_Datenbank SQL Datei einspielen - bitte beachten, dass standardmäßig die Datenbank ousp ausgewählt ist und gegebenenfalls geändert werden muss

  • Je nach Kundenumgebung entweder mssql oder mariadb ausführen

• WebClient starten

  • Unter One Unity Solution auf Allgemein gehen (OUSP Administrationsmappe / ouspAdministration) und diese Bearbeiten und erneut abspeichern, damit die Werte in die neuen Datenbanktabellen gespielt werden können
    • Es gibt hier ein onsave Script, welches die Datenbank aktualisiert, sofern noch keine Datensätze vorhanden sind
  • Anpassung von Viewplus-Extract (ehemals MailExtract)
    • Unter One Unity Solutions auf Postman (ouspPostman_Administration) gehen und unter dem Register Temporäre Pfade und Verbindungen den Pfad des Ablageortes und optional des temporären Ablageortes anpassen.
  • Anpassen des Workflow Postman in der Postman Administrationsmappe

• Zurück im Documents Manager

  • Initiales Script für Modifikationen ausführen ou.sp.PostmanModification.install.values (nur bei Installation notwendig oder bei update falls keine Modifikationen beim Kunden vorhanden waren)

• Am Schluss den Capture Mail oder Maildaemon natürlich wieder starten bzw. kompletten Dienst neu starten

Update von 22.0.x auf 22.1.0

• ousp-postman-update.xml einspielen
• Dateien in ..\Workflow\server\locale\ aktualisieren
• ouspPostman_Documents Mappe bzgl. Archivierung (bei EAS) prüfen (siehe letztes Kapitel in diesem Dokument)

Update 22.1.0 ERNEUTE ÄNDERUNG AN DER ARCHIVIERUNG

WICHTIG Findet das Update von einer Version < 22.0.0 auf eine Version 22.1.+ statt, muss nach dem Update das Update Script ou.sp.Postman.doUpdate.MailboxArchiveValues welches die voreingestellten Werte aus der Admin-Mappe in die Mailbox Mappe kopiert, ausgeführt werden. --> Das ist NICHT notwendig, wenn die installierte Version bereits >= 22.0.+ ist.

• In der Postman Administrationsmappe gibt es ab sofort keine Einstellungen mehr für die Archivierung
• Ob eine Postman-Mappe archiviert werden soll, entscheidet allein die zugehörige Mailbox-Mappe (dort wird es konfiguriert)
• Standardmäßig (bei Neu-Installation) ist die Archivierung auf aktiv
• Somit sind die Felder in der ouspPostman_Administration Mappe nach dem Update zu löschen
  • htArchivierung
  • archiving
  • archiveUser
  • deleteBlobsAfterArchiving
• Der definierte Job-User benötigt Archivierungsberechtigungen im ouspPostman Archiv
• In der Mappe ouspPostman_Mailbox sind folgende Felder nach dem Update zu löschen
  • archiveUser
  • deleteBlobsAfterArchiving
  • archivingIgnoreGlobalSetting
• es gibt einen neuen Job ou.sp.Postman.job.archive98ers, der alle Mappen im Status 98 (Archivieren) archiviert und bei Erfolg anschließend löscht
  • Hierbei gibt es Parameter die entsprechend des genutzten Archivierungsserver zu konfigurieren sind, diese sind folgende:
    • System (EEX oder EAS) default: EAS
    • Bei EEX sind folgende Felder auszufüllen:
      • TargetView
      • TargetSchema
      • ArchiveServer
      • ArchiveStatus default: 0 (false)
      • ArchiveMonitor default: 0 (false)

Ab 22.0.0 EAS Archivierung - Wichtiger Hinweis bei Updates von 22.0.0 auf 22.x.x und höher

• Wie bereits beim Update geschildert, gibt es seit Version 22.0.0 die Möglichkeit Postman Mappen auch mit Hilfe von EAS zu archivieren.
• ACHTUNG Findet ein Update statt auf eine bereits bestehende EAS Archivierung, wird beim Update die Archiv-Konfiguration der ouspPostman_Documents Mappe gelöscht und muss anschließend neu eingetragen werden!
• ACHTUNG Wird eine EEx/EDA Archivierung genutzt, müssen unbedingt die konfigurierten Parameter des Scripts ou.sp.Postman.job.archive98ers gesichert werden und nach dem Update wieder konfiguriert werden

Update von 22.1.0 auf 22.x.x

• ousp-postman-update.xml einspielen
• ACHTUNG Da die Archivierung in 22.1.0 umgestellt worden ist, muss bei jedem Update auch die Konfiguration bei dem hinterlegten Script ou.sp.Postman.job.archive98ers gesichert werden und nach dem Update entsprechend wieder konfiguriert wird
• NUR BEI EAS Archivierung ouspPostman_Documents Mappe bzgl. Archivierung prüfen, da dies nach einem Update immer gelöscht wird

Ab 22.2.0 neues Feld Barcodekennzeichen

NEUES Feld in der ouspPostman_Extract Mappe anlegen:

info

Das Feld ist im Mappentyp unterhalb des Feldes splittetBarcodeLength anzuordnen

• splittedBarcodePrefix
  • Bezeichner pf:filetype.ouspPostman_Mailbox.splittedBarcodePrefix
  • Typ: String
  • selbe Zeile wie Vorgänger
  • Exits-Register Tooltip Pflichtfeld, wenn via Office365 angebunden wird

Ab 22.3.0 Office 365 Integration

NEUE Felder in der ouspPostman_Mailbox Mappe anlegen:

info

Die Felder sind im Mappentyp unterhalb des Feldes maildaemonPassword anzuordnen

• maildaemonClientId
  • Bezeichner pf:filetype.ouspPostman_Mailbox.maildaemonClientId
  • Typ: String
  • Exits-Register Tooltip Pflichtfeld, wenn via Office365 angebunden wird
• maildaemonTenantId
  • Bezeichner pf:filetype.ouspPostman_Mailbox.maildaemonTenantId
  • Typ: String
  • selbe Zeile wie Vorgänger
  • Exits-Register Tooltip Pflichtfeld, wenn via Office365 angebunden wird
• maildaemonClientSecret
  • Bezeichner pf:filetype.ouspPostman_Mailbox.maildaemonClientSecret
  • Typ: String
  • selbe Zeile wie Vorgänger
  • Exits-Register Tooltip Pflichtfeld, wenn via Office365 angebunden wird