Wiki & Dokumentation


Administratorhandbuch - PreviewExtractor

Administratorhandbuch  - Version  19.2.1.xx

Einleitung

Dieses Handbuch richtet sich an Systemadministratoren und IT-Verantwortliche, die vor der Aufgabe stehen, ein bereits installiertes docuvita Dokumentenmanagement-System auf die speziellen Anforderungen zur Installation des PreviewExtractor anzupassen. Es erläutert die Schritte, die für eine Installation und Konfiguration des PreviewExtractor erforderlich sind. 

Die Verfahren und Beispiele, die in diesem Handbuch dargestellt sind, gehen davon aus, dass Sie mit einem aktuellen Windows mit einem aktuellen Browser arbeiten. Manche Vorgehensweisen können hier von diesem Handbuch abweichen.

Produktbeschreibung

Der PreviewExtractor dient zur Erzeugung einer PDF-Vorschau von Dokumenten und zur Extraktion der Textinformationen für die Volltextsuche. Er ermöglicht eine Reihe von Dateitypen mit fest eingebauten Extraktoren zu verarbeiten. Dazu zählen die meisten Office-Formate, sowie gepackte Archive.

Um die Qualität der Vorschau-Generierung zu verbessern und um weitere Dateitypen zu verarbeiten, können externe Konvertierungsprogramme eingebunden werden.
Beispiel: Zur Erzeugung einer Vorschau aus den Dateiformaten .dxf und .dwg kann eine externes Programm verwendet werden, das per Kommandozeile eine Konvertierung dieser Dateien ins PDF-Format vornimmt.

Werden gepackte Dateien (z.B. .zip) verarbeitet, so erzeugt der dvs.PreviewExtractor ein Inhaltsverzeichnis des Archivs, sodass die darin enthaltenen Dateien und Pfade in den Volltext aufgenommen werden können.

Systemvoraussetzungen

Um mit dem dvs.PreviewExtractor arbeiten zu können, benötigen Sie ein bereits vorhandenes docuvita DMS.

  • docuvita Mindestversion 2.0.975
  • .NET Framework Version ab 4.5.2
  • Eine Internetverbindung für die Aktivierung/Verifizierung der Lizenzen
  • Die Verwendung von externen Konvertierungsprogrammen ist um docuvita.online Umfeld nicht möglich

Symbolerklärung

An verschiedenen Stellen dieses Handbuchs finden sich Hinweis-Boxen, die Sie auf besonders wichtige oder wissenswerte Informationen aufmerksam machen sollen.

Hinweise in dieser Kategorie beinhalten hilfreiche Tipps.

Diese Punkte sollten Sie unbedingt beachten.

Installation

Nachfolgend wird die Installation des dvs.PreviewExtractor beschrieben:

Führen Sie die MSI-Datei aus.

msi


Klicken Sie auf "Wetier" um mit der Installation zu beginenn.


Stimmen Sie den Bedingungen der Lizenezvereinbarung zu und klicken Sie auf "Weiter".

accept-license


Lizenzvertrag

Der Lizenzvertrag ist nach der Installation im Installationsordner zu finden.


Tragen Sie Ihren Lizenzschlüssel in das Feld und klicken Sie auf "Weiter".

license-key


Lizenzdatei

Nach erfolgreicher Installation muss die Lizenzdatei noch direkt in das Installationsverzeichnis .\docuvita Server 2.0\docuvita.DocumentServices\Extractors\dvs.PreviewExtractor abgelegt werden.


Wählen Sie den Installationsordner des docuvita und naviigieren Sie zum Extrators-Ordner, wählen Sie ihn und klicken Sie auf "Weiter"

extractor-folder


Nun ist die Installation bereit ,bestätigen Sie mit "Installieren", um die Installation zu starten.

confirmation


Nach der Bestätigung wird der Installationsvorgang ausgeführt.

install-start


Nach erfolgreichem Installationsvorgang erscheint folgendes Fenster, klicken Sie auf "Fertig stellen" und somit ist die Installation beendet.

install-end

Konfiguration

Die Konfiguration erfolgt über die Datei dvs.PreviewExtractor.config im Installationsverzeichnis. Die bei der Installation mitgelieferte config-Datei geht davon aus, das der externe Konvertierung LibreOffice nicht verwendet wird.
Falls Sie Libre Office verwenden wollen, können Sie es hier herunterladen.

Verzeichnis Konfigurationsdatei

Die Konfigurationsdatei befindet sich nach der Installation in dem Ordner ..\docuvita Server 2.0\docuvita.DocumentServices\Extractors\dvs.PreviewExtractor\Config .

Preview Generatoren

Mit dem nachfolgenden Konfigurationsblock werden die möglichen Preview-Generatoren definiert. Der Preview-Generator "internal" ist optional. Falls dieser nicht vorhanden ist, wird der Eintrag automatisch als vorhanden angenommen.

Preiview-Generatoren
<PreviewGenerator>
  <Name>LibreOffice</Name>
  <PreviewType>PDF</PreviewType>
  <Path>C:\Program Files\LibreOffice 5\program\soffice.exe</Path>
</PreviewGenerator>


FeldnameBeschreibung
NameName des Preview-Generators
PreviewTypeDokumenttyp des Preview-Dokumentes (Extension). Wenn nicht angegeben, wird pdf verwendet
PathPfad zur ausführbaren Datei des Generators. Beim Preview-Generator internal wird Path nicht verwendet

Generator Mapping

Über die Konfigurationsblöcke PreviewGeneratorMapping erfolgt die Zuordnung des zuständigen Generators je Datei-Endung.

Generatoren-Mappings
<PreviewGeneratorMapping>
  <Extension>ODT</Extension>
  <GeneratorName>LibreOffice</GeneratorName>
  <Params>--headless --convert-to pdf:writer_pdf_Export "-env:UserInstallation=file:///C:/tmp/" --outdir @@OUTDIR@@ @@INFILE@@</Params>
</PreviewGeneratorMapping>

FeldnameBeschreibung
ExtensionDateiendung auf die der Generator registriert wird.  z.B. .odt
GeneratorNameZu verwendender Generator - muss als PreviewGenerator definiert sein
ParamsKommandozeilenparameter, die beim Aufruf an die ausführbare Datei des Preview-Generators übergeben werden

Folgende Platzhalter können innerhalb Params verwendet werden:

PlatzhalterBeschreigung
INFILEDateiname der zu bearbeitenden Datei.
OUTFILEDateiname der erwarteten Ausgabedatei
OUTDIRAusgabeverzeichnis für die erzeugte Preview-Datei

Verwendung von Platzhaltern

Platzhalter mussen in @@ eingeschlossen sein.

Speichern der Konfiguration

Die Konfiguration wird beim Starten des  Dienstes docuvita.DocumentServices eingelsen. Dies bedeutet, dass nach einer Änderung der Konfiguration der Dienst neu gestartet werden soll. 

Beispiele für Konfigurationsdateien

DateiBeschreibung
default.configdefault Konfiguration
LibreOffice.configKonfiguration mit externen Konverter LibreOffice

Dateiname der Konfigurationsdatei

Nach dem Download der Datei muss der Name der Datei noch in dvs.PreviewExtractor.config geändert werden.

Verwandte Seiten


Copyright 2013-2020 docuvita solutions GmbH