Zum Hauptinhalt springen

23.0.0

Voraussetzungen​

  • documents5 >= 5.0i #2322 - mit aktiverter gRPC Schnittstelle, sofern Maildaemon eingesetzt wird
  • Library SDK >= 22.0.1
  • One Unity Documents >= 21.1.0
  • Viewplus Extract >= 20.1.1
  • Maildaemon >= 23.0.0 oder CapturePlus >= 5.3

Was wurde gemacht?​

Zusammenfassung​

  • die Mailboxregel im Zusammenspiel mit Maildaemon wird zukünftig nur noch via maildaemon-api angelegt. Diese Postman Version benötigt also zwingend die Maildaemon Version 23.0.0 oder höher.
  • POM-367
  • Postman Mappen werden zukünftig über die gRPC API von documents durch Maildaemon angelegt, daher muss nun generell die gRPC Schnittstelle von documents aktiv sein
  • POM-368
  • Postman Mailboxes werden zukünftig über die REST API angelegt und verwaltet
  • Man muss einmal dafür entweder die bereits existierende Mailbox Bearbeiten und speichern oder das Skript ou.sp.PostmanMailbox.mad.update.js ausführen, damit die Mailboxregeln dem maildaemon service bekannt sind.
  • POM-244
  • Im Hauptordner "Dokumente Postman" wird nun die Anzahl der Mappen in den Unterordnen übersichtlich dargestellt
  • POM-342
  • Postman benötigt nun keinen Lizenzschlüssel mehr
  • POM-347
  • Script Parameter bei Portalscripten sind nun in JSON Dateien ausgelagert (einfachere Bearbeitung möglich / performanter)
  • POM-334
  • Postman Mappen im Archiv Status 98 können nun nicht mehr bearbeitet werden
  • POM-333
  • Eine E-Mail ohne Anhang wird nun korrekt von der Extraktionsregel verarbeitet
  • POM-340
  • Beim Splitten in einzelne Mappen kam es zu einem Fehler, nun wird korrekterweise der Ordner Erfassung dargestellt
  • POM-350
  • Durch die Implementierung von EWS und der Office365 kam es zu Problemen mit zu langen MailID Feldinhalten, die bei der Archivierung oder dem Original E-Mail Namen auf einen Fehler gelaufen sind, dies wurde nun korrigiert
  • Das Feld MailId wird neu generiert und der ursprüngliche Wert ist im Feld originalMailId gesichert.
  • Hinweis für den Endnutzer: Soweit der Aufbau der echten MailID eine Relevanz für den Folgeprozess hat oder/und im Archiv notwendig ist, dann entsprechend im Archiv als custom Feld anlegen und im Folgeprozess berücksichtigen.

Manuell auszuführende Schritte​

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.

Aktualisierung der Portalskripte​

  • XML/ousp-postman-update.xml über den Documents Manager einspielen

gRPC Schnittstelle aktivieren​

Sofern mit Maildaemon gearbeitet wird muss die gRPC Schnittstelle aktiviert werden - siehe Installation documents.

Mappentypen​

ouspAdministration​

  • Das Mappenfeld ouspPostman_License gibt es nicht mehr, es sollte entfernt werden

ouspPostman_Administration​

  • Neues Feld maildaemonApiUrl nach dem horizontalen Trenner htMaildaemonPath

maildaemonApiUrl

  • Das Feld maildaemonApiUrl auch im Register ConnectionsAndPaths hinzufügen, sonst erscheint es nicht in der Mappenübersicht

maildaemonApiUrl

Anschließend "Mappen ändern" drücken.

ouspPostman_Documents​

  • neues Feld originalMailID

originalMailID

ouspPostman_Mailbox​

neue Felder:

  • htGrpcConfig -- Horizontaler Trenner, unter maildaemonFolders
  • grpcHost -- String
  • grpcPort -- String, selbe Zeile wie Vorgänger anhaken
  • grpcImportUsername -- String, selbe Zeile wie Vorgänger anhaken
  • grpcServerCertPath -- String
  • grpcClientCertPath -- String, selbe Zeile wie Vorgänger anhaken
  • grpcClientKeyPath -- String, selbe Zeile wie Vorgänger anhaken
  • mailboxId -- String, ganz unten einfügen (unter fileid)

alte Felder, welche entfernt werden müssen:

  • htDocumentsSettings
  • documentsHost
  • documentsImportUser
  • documentsImportPassword

gRPC Felder

Anschließend "Mappen ändern" drücken. Achtung, das kann etwas dauern ☕

Mappen überarbeiten​

  • In der Postman Administration muss nun im Register Temporäre Pfade und Verbindungen das neue Feld Maildaemon API URL ausgefüllt werden. Details dazu siehe Konfiguration. Dies muss unbedingt vor dem nächsten Schritt passieren!
  • In allen Mailboxen sind nun folgende Felder auszufüllen: grpcHost, grpcPort, grpcImportUsername, grpcServerCertPath, grpcClientCertPath und grpcClientKeyPath. Details dazu siehe Konfiguration.
  • Nach der Änderung (speichern) der Mailboxen sollte das Feld Mailbox Id gefüllt sein.

Locales​

warnung

Folgende Dateien aus Workflow/server/locale wurden in den "Globalen Eigenschaften" im Documents Manager migriert und müssen nun gelöscht werden.

Workflow/server/locale/

  • 🗑️ ouspPostman_de.properties
  • 🗑️ ouspPostman_en.properties
warnung

Wichtig: Ab sofort sind die locales nicht mehr update-sicher und dürfen in den "Globalen Eigenschaften" nicht geändert werden!

Anpassungen in Locales migrieren / Customizing​

Bei diesem Update sollten alle Sprachdateien überprüft und vorhandene Anpassungen in den oben genannten Locales in eine neue locale Eigenschaft verschoben werden.

Um die Anpassungen zu migrieren, muss im Documents Manager unter Monitoring / Globale Eigenschaften eine neue Eigenschaft hinzugefügt werden:

  • Name: z.B. ouspPostman_cust_de
  • Type: ServerLocale

Example