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.
Klicken Sie auf "Wetier" um mit der Installation zu beginenn.
Stimmen Sie den Bedingungen der Lizenezvereinbarung zu und klicken Sie auf "Weiter".
Lizenzvertrag
Der Lizenzvertrag ist nach der Installation im Installationsordner zu finden.
Tragen Sie Ihren Lizenzschlüssel in das Feld und klicken Sie auf "Weiter".
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"
Nun ist die Installation bereit ,bestätigen Sie mit "Installieren", um die Installation zu starten.
Nach der Bestätigung wird der Installationsvorgang ausgeführt.
Nach erfolgreichem Installationsvorgang erscheint folgendes Fenster, klicken Sie auf "Fertig stellen" und somit ist die Installation beendet.
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.
<PreviewGenerator> <Name>LibreOffice</Name> <PreviewType>PDF</PreviewType> <Path>C:\Program Files\LibreOffice 5\program\soffice.exe</Path> </PreviewGenerator>
Feldname | Beschreibung |
---|---|
Name | Name des Preview-Generators |
PreviewType | Dokumenttyp des Preview-Dokumentes (Extension). Wenn nicht angegeben, wird pdf verwendet |
Path | Pfad 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.
<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>
Feldname | Beschreibung |
---|---|
Extension | Dateiendung auf die der Generator registriert wird. z.B. .odt |
GeneratorName | Zu verwendender Generator - muss als PreviewGenerator definiert sein |
Params | Kommandozeilenparameter, die beim Aufruf an die ausführbare Datei des Preview-Generators übergeben werden |
Folgende Platzhalter können innerhalb Params verwendet werden:
Platzhalter | Beschreigung |
---|---|
INFILE | Dateiname der zu bearbeitenden Datei. |
OUTFILE | Dateiname der erwarteten Ausgabedatei |
OUTDIR | Ausgabeverzeichnis 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
Datei | Beschreibung |
---|---|
default.config | default Konfiguration |
LibreOffice.config | Konfiguration 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