Legacy - Update auf 20.0.0

Voraussetzungen 20.0.0

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

Erste Schritte Vorgehensweise Installation und Update 20.0.0

• Beim Update vorhandenes Skripte sichern

  • WICHTIG Es müssen zuerst alle Postman Mappen mit dem alten Workflow abgearbeitet sein!
  • Capture Mail 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
      • Hinweis: es gibt ab 20.0 ein neues ou.sp.Postman.callback.functions welches wiederum die ou.cust.Postman.callback.functions aufruft
    • 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!

• ou.cust.Postman.callback.function.js muss manuell aktualisiert werden (wenn Postman Version < 3.1 war)

• 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.
    • Hinweis Beim Update von einer Version < 20.0 gibt es noch veraltete Felder für MailExtract in der Mappe ouspPostman_Administration. Diese müssen im Documents Manager entfernt werden.
      • Die drei Felder haben MailExtract in ihrem Bezeichner und können bedenkenlos gelöscht werden.
      • Danach muss man im Manager Mappe ändern ausführen
  • 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)
  • Mit 20.0 wurden im Workflow die Portalskripte umbenannt, da die Namenskonvention falsch war. Die veralteten Dateien können gelöscht werden. Folgende Dateien (alt --> neu)
    • ACHTUNG: Falls noch Mappen mit der alten Workflow Version laufen, dann dürfen die unten genannten Scripte nicht gelöscht werden, erst sobald keine Mappen mehr mit der alten Workflow laufen!
    • ou.sp.Postman.workflow.receivesignal.extract --> ou.sp.Postman.workflow.sendsignal.extract
    • ou.sp.Postman.workflow.receivesignal.workflowstart --> ou.sp.Postman.workflow.sendsignal.workflowstart
    • ou.sp.Postman.workflow.receivesignal.setWorkflowData --> ou.sp.Postman.workflow.sendsignal.setWorkflowData
    • ou.sp.Postman.workflow.receivesignal.rule --> ou.sp.Postman.workflow.sendsignal.rule
    • ou.sp.Postman.workflow.receivesignal.setTargetFields --> ou.sp.Postman.workflow.sendsignal.setTargetFields

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

Update von Version 2.x auf 20.x

• Siehe Erste Schritte Vorgehensweise Installation und Update

• Manuell löschen:

  • öffentliche Odner ouspPostman_50 und ..._100
  • Mappentyp "ouspPostman_Documents" folgendes löschen
  • Feld mailPriority
  • Aktion "Mappe anlegen" Haken entfernen
  • onDelete Skript austragen, falls vorhanden
  • Mappentyp "ouspPostman_Extract" folgende Felder löschen
  • InputField*_Testvalue (Felder 1-10)
  • InputField*_Testresult (Felder 1-10)
  • OutputField*_Testresult (Felder 1-10)
  • Aktion "Mappe löschen" Haken entfernen

• Alle Postman-Mappentypen "Mappen ändern"

• Ordner "ouspPMD_99" am "ouspPostman_Documents" als Unterordner definieren

• Gesicherte Callbacks wieder zurückübertragen

• Konfiguration Postman, alle Einstellungen prüfen/ergänzen

• Mailbox / Extraktion Zugehörigkeit pflegen falls gewünscht!

  • Wird keine Zugehörigkeit festgelegt, werden alle Extraktionen zur Mailbox geladen

• Nacharbeit im Documents Manager

  • Wartungsoperation: BuildAclCache ouspPostman_Documents
  • Documents Log auf Fehler prüfen
  • Tipp: Bei vielen Extraktionsregeln, Mailboxen und/oder Verteilregeln kann die Ansicht im Verknüpfungsregister unübersichtlich werden. Um hier trotzdem schnell die gewünschten Mappen Mappen zu finden, hat es sich als hilfreich erwiesen, die Documents Eigenschaft "LinkRegisterSearch = true" zu setzen. Damit kann in Verknüpfungsregistern gesucht werden. (Die Eigenschaft greift für alle Mappentypen am Server)