agorum core preview

In welcher Version enthalten?

• agorum core open
• agorum core pro

Mithilfe des Moduls agorum core preview erzeugt das System die Vorschau eines Dokuments.

Sie können Excel-Tabellen, PDFs, Word-Dokumente und mehr auch ohne Öffnen der Datei einsehen.
Die Vorschau ist Bestandteil des Detailfensters und begegnet Ihnen an den unterschiedlichsten Orten in agorum core, etwa in der Suche oder im agorum core explorer.
agorum core wandelt die einzelnen Seiten im Hintergrund in Bilder um und speichert sie ab.
Sie können einstellen, wie lange das System diese Bilder speichert und ob es diese überhaupt erstellt.

Anzeige der Vorschau in der Suche

Unterschied zwischen den Registerkarten „Vorschau“ und „Ansicht“

Die Registerkarten Vorschau und Ansicht unterscheiden sich in Ihrer Darstellung und wie lange es sie bereits in agorum core gibt. Sie sehen stets beide Registerkarten.

Ansicht

Die Registerkarte Ansicht ist neuer und zeigt Ordnerinhalte, Adressobjekte und mehr an.

Das System versucht dabei, für ein gewähltes Objekt immer die bestmögliche Darstellung zu wählen.

Vorschau

Die Registerkarte Vorschau existiert länger und ermöglicht es, Notizen auf Dokumente zu setzen.

Das System verändert dabei nicht das Dokument oder überschreibt es.

Notizen in der Registerkarte Vorschau

agorum core preview konfigurieren

Sie können agorum core preview konfigurieren, um etwa zu definieren, wann das System Bilder in der Registerkarte Vorschau erstellt und wie lange diese im System verbleiben.

Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
Wählen Sie links im Menü Preview > Configurations > Preview configuration.
Nehmen Sie die Konfigurationen vor.
Klicken Sie oben auf Save.

agorum core preview konfigurieren

Beschreibung der Konfigurationen

Konfigfuration	Beschreibung
previewEnabled	Aktiviert die Preview-Funktion. Aktivieren Sie diese Konfigurationen, da das System ansonsten keine Preview-Bilder erzeugt und Benutzer eine Fehlermeldung in der Registerkarte Vorschau erhalten.
createPreviewInBackground	Aktiviert die automatische Preview-Erstellung, sobald ein Dokument hochgeladen / aktualisiert wird. Wenn Sie diese Konfiguration aktivieren, dauert die Anzeige des Dokuments länger als üblich. Deaktivieren Sie diese Konfiguration, wenn Sie hauptsächlich die Registerkarte Ansicht verwenden. Sie sparen dadurch Speicherplatz, da das System nur Vorschaubilder erzeugt, wenn ein Benutzer das Dokument in der Registerkarte Vorschau öffnet.
masterPreviewExpirationPeriod	Definiert die Anzahl der Tage, nach denen das System die Preview-Bilder löscht. Im Standard steht diese Konfiguration auf 30, die Preview-Bilder werden nach 30 Tagen gelöscht. Wenn Sie diese Einstellung auf -1 setzen, ist die Funktion deaktiviert, und das System löscht die Preview-Bilder nicht. Verwenden Sie agorum core docform, stellen Sie mindestens 7 Tage ein, damit docform keine Preview-Bilder fehlen und Werte auslesen kann.
thumbPreviewExpirationPeriod	Entspricht der Konfiguration masterPreviewExpirationPeriod, nur gültig für agorum core preview thumbnails.
usePreviewFromOCR	Aktiviert die Nutzung der von der OCR erstellten Preview. Aktivieren Sie diese Konfiguration, damit die OCR eingescannte Seiten horizontal ausrichtet und sich die Qualität der Dokumente verbessert.
previewTimeout	Definiert die Zeit in Millisekunden, bevor die Erstellung einer Preview ins Time-out läuft.
maxPreviewPagesDefault	Definiert die Anzahl der Vorschau-Seiten, die das System maximal speichert. Im Standard steht diese Konfiguration auf -1, d. h. das System speichert alle Seiten. Sie können diesen Standardwert für definierte Objekte überschreiben.
maxPreviewPagesPlaceholderDefault	Definiert ein Bild als Platzhalter für die Vorschau. Das Bild erscheint in der Vorschau, wenn der Wert der Konfiguration maxPreviewPages überschritten wird. In der Vorschau sieht der Benutzer, dass nicht alle Seiten vorhanden sind. Das System verwendet kein Bild als Platzhalter, wenn Sie diesen Wert leer lassen. Sie können diesen Standardwert für definierte Objekte überschreiben.
PreviewErrorPlaceholderDefa	Definiert ein Bild (SVG) als Platzhalter für die Vorschau. Das Bild erscheint in der Vorschau, wenn bei der Konvertierung ein Fehler auftritt. Das System ersetzt die zwei Platzhalter mit der Fehlermeldung ${errorMsg} und der Fehler-Identifikation ${errorIdent}. Mögliche Platzhalter unknown Unbekannter Fehler timeout Konvertierung wegen Time-out abgebrochen. exception Konvertierung wegen eines Fehlers abgebrochen. Das System setzt den errorIdent in folgendes Metadatum auf das Objekt, für das es die Previews erzeugt: agorum_preview_error_identifier Enthält einen einer der oben genannten Platzhalter. agorum_preview_error_message Enthält eine ausführlichere Beschreibung des Fehlers. Prüfen Sie im Falle eines Fehlers im agorum core support tool den Bereich Preview. Sie können etwa gezielt nach dem Metadatum agorum_preview_error_identifier suchen, um dafür die Previews erneut zu erzeugen, etwa über das Tool delete previews.

Die Einstellung „maxPreviewPages“ überschreiben

Anwendungsbeispiel

Ihr Unternehmen erstellt PDFs mit bis zu 200 Seiten und verwendet die Registerkarte Vorschau. Auf den ersten 50 Seiten sind die wichtigsten Informationen zu sehen, die restlichen 150 Seiten sind uninteressant. Sie können daher die maximale Anzahl an Vorschaubildern für diese Dokumente einschränken.

Definieren Sie einen Selektor, damit das System weiß, für welche Dokumente die Einschränkung greift.
Probieren Sie nach Ihrer Einstellung auf einem Testsystem verschiedene Dokumente aus.
Das System schränkt Dokumente ein, die Sie nicht einschränken möchten, wenn Ihr Selektor zu allgemein gehalten ist.

So nehmen Sie die Einschränkung der Seiten vor:

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODULE_MANAGEMENT/preview/control/override

Legen Sie über ein Property-Bundle an, etwa excel.
Legen Sie über folgende Property-Entrys an.

Property-Entrys

Property-Entry	Beschreibung	Wert (Beispiele)
MaxPreviewPages	Definiert die Anzahl der Vorschau-Seiten, die das System maximal speichert.	10
Selector	Definiert, dass für das Property-Entry MaxPreviewPages nur die Dateiformate gelten, die hinter nameextension= stehen.	[nameextension=/xls.\|xlm.\|xlt.\|csv./i]
MaxPreviewPagesPlaceholder	Stellt anstatt der 11. Dokumentenseite ein Bild als Platzhalter dar. Das Bild muss in agorum core gespeichert sein. Sie können neben der Pfadangabe die Bild_ID oder UUID angegeben. Das System verwendet maxPreviewPagesPlaceholderDefault aus der Standardkonfiguration, wenn Sie kein Bild als Platzhalter definieren.	/agorum/roi/preview/preview-more-pages.jpg

Tipps:

Verwenden Sie das Modul agorum core storage mit dedup-Funktion, um den genutzten Speicherplatz generell zu verringern.
Prüfen Sie, wie oft Ihre Benutzer die Vorschaubilder verwenden.
Deaktivieren Sie die Konfiguration createPreviewInBackground, um einen guten Kompromiss zwischen Speicherplatz und Nutzen der Preview zu erhalten.

Die Registerkarte „Vorschau“ ausblenden

Sie können die Registerkarte Vorschau ausblenden, wenn Sie sie nicht benötigen.

Voraussetzungen

Sie verwenden keine aktiven Konfigurationen für die Registerkarte Vorschau.

Wissenswertes zur Vorschau

Zur Erstellung der Vorschau verwendet das System Konverter mit dem Muster convertXXX2PREVIEW (siehe DocumentService).

Das System verwendet agorum core aguila, um die erstellten Previews korrekt unter den Registerkarten Ansicht und Vorschau anzuzeigen.
Nehmen Sie Änderungen am Detailfenster und der Preview-Darstellung in agorum core composite vor.

Beispiele

Word
convertDOC2Preview

PDF
convertPDF2Preview

Wenn Sie Probleme mit agorum core preview haben

Preview konnte nicht erstellt werden

Beschreibung des Problems

Der Fehler Preview konnte nicht erstellt werden erscheint nach Neuinstallation von agorum core.

Ursache

Die Vorschau ist deaktiviert.

Lösung

Aktivieren Sie die Vorschau über das agorum core support tool.