Anzeige weiterer Formate in jadice web toolkit über die jadice flow Anbindung

Optionales Feature

Die Anbindung von jadice flow ist ein optionales Zusatzmodul für das jadice web toolkit, welches separat lizenziert werden muss. Nehmen Sie hierfür bitte Kontakt mit uns auf.

Hintergrund

Das jadice web toolkit ist ein Multi-Format-Dokumentenbetrachter. Jedoch können nicht alle Dokumenten-Formate angezeigt werden. Dies liegt daran, dass wir natürlich nicht alle denkbaren Format implementiert haben und es auch für manche Formate keine geeignete Java-Library gibt (z.B. HEIC). Darüberhinaus kann es auch erforderlich sein, die Dokumente sehr exakt anzeigen zu wollen, was durch eine Eigen- oder Fremdimplementierung nicht möglich ist (beispielsweise stellt Libreoffice eine DOCX-Datei oft anders da als Microsoft Word dies tut).

Über jadice flow ist es möglich, beliebige und auch native Anwendungen in einem Container zu verwenden und diese zur Anzeige zu verwenden, sofern diese Anwendungen eine API und einen Export in ein von uns unterstütztes Format unterstützen. Sehr viele Dokumente lassen sich mit den folgenden von uns bereitgestellten Workern konvertieren, Details finden Sie hier: Unterstütze Formate für die Anzeige im jadice web toolkit - jadice knowledge base - levigo info center

Der Ablauf dabei sieht dann in etwa so aus:

1. Format-Erkennung mit dem filetype-analyzer
2. Wenn der erkannte Mime-Type in jadice web toolkit konfiguriert ist, Upload des Datenstroms nach S3/eureka
3. Konvertierung über jadice flow
4. Anzeige des konvertierten Datenstroms
   • Dies geschieht ohne lokale Ablage als temporäre Datei!

Beachten Sie hierbei folgendes: Die flow-Anbindung ist als jadice Format realisiert. Das bedeutet, dass erst die jadice Format-Erkennung in der konfigurierten Reihenfolge versucht einen Datenstrom anzuzeigen. In allen jadice Produkten ist das Plain-Text-Format das letzte Format, wenn das jadice also mit einem Datenstrom nichts anfangen kann, wird die Datei als Textdokument angezeigt. Ist die flow-Anbindung aktiviert, ist dieses spezielle "flow Format" in der Reihenfolge das zweit-letzte Format. Wenn Sie also die flow-Anbindung so konfiguriert haben, dass beispielsweise AFP-Datenströme über flow konvertiert werden sollen, gleichzeitig aber das jadice AFP Format aktiv ist, dann hat das jadice AFP Format eine höhere Priorität und wird daher die Anzeige übernehmen und nicht die flow-Anbindung

Demo

Installation

Viewer

Die pom.xml (Maven) muss um folgendes Modul ergänzt werden

<dependency>
   <groupId>com.levigo.jadice.webtoolkit</groupId>
   <artifactId>webtoolkit-format-flow</artifactId>
</dependency>

Konfiguration Über die application.yml / application.properties des jadice web toolkit wird jadice flow konfiguriert.

note

Alle Werte liegen unter webtoolkit.flow (also z.B. webtoolkit.flow.auth-token)

Es kann wahlweise neverpile eureka oder S3 als Storage konfiguriert werden. Dies muss einheitlich zu der Konfiguration von jadice flow sein.

Allgemein

Key	Beschreibung	Default-Wert
controller-url	Die URL des jadice flow controllers
auth-token	Das Auth-Token für die Authentifizierung gegenüber flow

Verwendung von eureka

Key	Beschreibung	Default-Wert
eureka-url	Die URL des eureka endpoints
eureka-username	Der eureka User
eureka-password	Das eureka Passwort

Verwendung von S3

Key	Beschreibung	Default-Wert
s3-url	Die URL des S3 endpoints
s3-bucket	Der S3 Bucket
s3-access-key	Der S3 Access-Key
s3-secret-key	Der S3 Secret-Key
s3-protocol	Das S3-Protokoll	https
s3-region	Die S3 Region

jadice flow

Optionales Feature

Falls Sie jadice flow noch nicht separat lizenziert haben, nehmen Sie bitte Kontakt mit uns auf. Der Download der Komponenten benötigt entsprechende Berechtigungen, die nur gegeben sind, wenn eine gültige Lizenz vorliegt.

Installation

Zuerst muss eine values.yaml-Datei erstellt werden:

secrets:
  imageRegistry:
     server: registry.jadice.com
     username: myJadiceRegistryUser
     password: myJadiceRegistryPassword

Anschließend können Sie unser HELM-Chart installieren:

$ helm repo add levigo https://artifacts.jadice.com/repository/helm-charts/ --username <username>
Password: <enter your password>
$ helm install --values my-values.yaml my-release levigo/jf-web-toolkit-addon

note

Für die HEIC/HEIF Bild Verarbeitung mit jadice flow wird ImageMagick Studio LLC eingesetzt. Weitere Informationen zu ImageMagick können Sie unter folgendem Link finden: ImageMagick software

Verwendung

Wenn flow konfiguriert ist, muss nun noch definiert werden, welche Dateiformate über jadice flow konvertiert werden sollen. Dies geschieht ebenfalls über die application.yml / application.properties des jadice web toolkit.

Anbei ein Beispiel, wie Office-Dokumente über Libreoffice konvertiert werden können:

webtoolkit:
   format:
      flow:
         formats:
            - workflow-name: x-to-pdf
               # the mime-types here can be extended by whatever you need and jadice supports
              mime-types-input: "application/vnd.openxmlformats-officedocument.wordprocessingml.document\
         application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\
         application/vnd.openxmlformats-officedocument.presentationml.presentation"
              mime-type-output: application/pdf
              format-output: pdf
            - workflow-name: mail-to-pdf
              mime-types-input: "message/rfc822,application/msoutlook,application/ms-tnef"
              mime-type-output: application/pdf
              format-output: pdf
            - workflow-name: heic-to-png
              mime-types-input: "image/heic,image/heif"
              mime-type-output: image/png
              format-output: png