¶ Produktbeschreibung
Der dvs.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 Vorschaugenerierung 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 Version 20.1.xx bis 21.4.xxs
- .NET Framework ab Version 4.6
- Mindestens 100 MB freier Festplattenspeicher
- Windows Server 2012R2 oder neuer, alternativ Windows 10
- Eine Internetverbindung für die Aktivierung/Verifizierung der Lizenzen
¶ Installation
Nachfolgend wird die Installation des dvs.PreviewExtractor beschrieben:
1 . Führen Sie die MSI-Datei aus.
2 . Klicken Sie auf Weiter um mit der Installation zu beginnen.
3 . Lesesn Sie sich die Lizenzvereinbarungen durch und stimmen Sie diesen zu. Klicken Sie anschließend auf Weiter.
4 . Tragen Sie Ihren Lizenzschlüssel in das Feld ein und klicken Sie auf Weiter.
Lizenzdatei kopieren
Nach erfolgreicher Schlüsseleingabe legen Sie die Lizenzdatei in folgendem Verzeichnis ab:
\docuvita\docuvita Server 2.0\docuvita.DocumentServices\Extractors\dvs.PreviewExtractor
5 . Wählen Sie das Installationsverzeichnis Ihres docuvita und wählen Sie den Ordner dvs.PreviewExtractor aus. Klicken Sie anschließend auf Weiter.
6 . Mit einem Klick auf Installieren können Sie die Installation starten.
7 . Nun wird der Installationsvorgang ausgeführt.
8 . Nach erfolgreichem Installationsvorgang erscheint folgendes Fenster. Klicken Sie auf Fertig stellen, um die Installation zu beenden.
docuvita.DocumentServices neustarten
Nach erfolgreicher Installation benötigt der docuvita.DocumentServices-Dienst einen Neustart.
In der Log-Datei finden Sie einen Hinweis darüber, ob der dvs.PreviewExtractor erfolgreich geladen worden ist.
Bei Updates Dienst beenden
Um ein Update installieren zu können, muss der docuvita.DocumentServices-Dienst beendet sein.
Dienste-User benötigt Schreibzugriff
Wurde die Lizenz erfolgreich aktiviert, wird der Aktivierungsschlüssel in die Konfigurationsdatei geschrieben.
Hierfür benötigt der Dienste-User Schreibzugriff auf die Konfigurationsdatei.
¶ Konfiguration
Die Konfiguration erfolgt über die Datei dvs.PreviewExtractor.config im Installationsverzeichnis. Die bei der Installation mitgelieferte config-Datei verwendet standardmäßig ein internes Konvertierungsprogramm. Durch ein externes Programm wie LibreOffice können Sie aus mehr Dateitypen eine PDF-Vorschau generieren.
Falls Sie Libre Office verwenden wollen, können Sie es hier herunterladen:
https://de.libreoffice.org/download/
Mit einem entsprechenden Konvertierungsprogramm können Sie aus jedem Dateityp eine PDF-Vorschau erzeugen, die Sie dann in docuvita ansehen können. Nachfolgend erfahren Sie am Beispiel LibreOffice, wie Sie einen externen Preview-Generator für docuvita einrichten.
¶ Konfigurationsparameter
¶ Preview-Generatoren
<PreviewGenerator>
<Name>LibreOffice</Name>
<PreviewType>PDF</PreviewType>
<Path>C:\Program Files\LibreOffice\program\soffice.exe</Path>
</PreviewGenerator>
Definiert die möglichen Preview-Generatoren. Der Preview-Generator internal ist optional. Falls dieser nicht vorhanden ist, wird der Eintrag automatisch als vorhanden angenommen.
| Feldname | Beschreibung |
|---|---|
| Name | Name des Preview-Generators |
| PreviewType | Dokumenttyp des Preview-Dokumentes (Extension). Wenn nicht angegeben, wird standardmäßig pdf verwendet. |
| Path | Pfad zur ausführbaren Datei des Generators. Beim Preview-Generator internal wird Path nicht verwendet. |
¶ 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>
Zuordnung des zuständigen Generators je Datei-Endung.
| Feldname | Beschreibung |
|---|---|
| Extension | Dateiendung 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:
| Parameter | Beschreibung |
|---|---|
| INFILE | Dateiname der zu bearbeitenden Datei |
| OUTFILE | Dateiname der erwarteten Ausgabedatei |
| OUTDIR | Ausgabeverzeichnis für die erzeugte Preview-Datei |
Verwendung von Platzhaltern
Platzhalter müssen in@@eingeschlossen sein.
Speichern der Konfiguration
Die Konfiguration wird beim Starten des Dienstes docuvita.DocumentServices eingelesen. Dies bedeutet, dass nach einer Änderung der Konfiguration der Dienst neu gestartet werden muss.
¶ Beipiele für Konfigurationsdateien
| Datei | Beschreinung |
|---|---|
| default | Standard Konfiguration |
| libreoffice | Konfiguration mit externem Konverter für LibreOffice |
Dateiname der Konfigurationsdatei
Nach dem Download der Datei muss der Name der Datei noch in dvs.PreviewExtractor.config geändert werden.
¶ Changelog
docuvita Version ab 20.3.1341
Wenn Sie die docuvita Version 20.3.1341 oder höher verwenden, müssen Sie mindestens die Version 20.8.3.7531 des Preview Extractor verwenden.
docuvita Version ab 19.3.1182
Wenn Sie die docuvita Version 19.3.1182 oder höher verwenden, müssen Sie mindestens die Version 19.8.2.7167 des Preview Extractor verwenden.
| Version | Anmerkung |
|---|---|
| 22.4.49 | Update auf .NET 4.8, Konfiguration auf LibreOffice 7.0 |
| 20.10.0.7597 | Update Konfiguration auf LibreOffice 7.0 |
| 20.8.3.7531 | Anpassung an das neue Interface des docuvita.DocumentSerives (ab Version 20.3.1341). |
| 20.1.6.7313 | * Update der internen Vorschaugenerierung auf Version 19.2.5 * Unterstützung der Dateiendungen .xltm, .xltx, .xml, .htm und .html |
| 19.8.2.7167 | Anpassung an das neue Interface des docuvita.DocumentSerives (ab Version 19.3.1187). |
| 19.2.4.6991 | Der interne Konverter unterstützt jetzt auch die Datenformate csv und epub. |
| 19.2.3.6989 | * Fix: DVSPREV-1: Dienst beendet sich bei verschlüsselten zip Archiven * Update 7Zip auf Version 30.12.2018 |
| 19.2.2.6989 | Update DevExpress auf Version 18.1.6 |
| 18.8.1.6810 | Anpassen der Konfigurationsdatei an den default Konverter (internal) |
| 18.7.3.6762 | * Default Konfigurator ist internal * Keine Log Meldung wenn resources.dll nicht gefunden worden ist. * Update DevExpres 18.1 *Update dvs.License 18.6.3 |