Dokument/Inhalts-Vorschau fehlt oder ist fehlerhaft
Für das Problem kann es mehrere Ursachen geben, angefangen von Zugriffsrechten per URL, Server+Port bis inhaltliche Problematiken.
grober Verlauf der Abfrage für die Vorschau:
< enaio 11.10:
ab enaio 11.10:
Schritte:
Tritt das Problem bei allen Benutzern auf oder auch bei Administratoren?
Ist die Vorschau lt. enaio Editor erlaubt? Dazu die Eigenschaften des Dokumenttypes prüfen.
Ist die alternative Login-Pipe beim enaio Enterprisemanager gefüllt, siehe
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21425967Stimmen die URLs bzw. die Konfiguration im enaio Enterprisemanager? Gültige URLs:
gültige URLs zum Testen bis enaio 11.00:
http://<server-mit-gateway>/dashlets/pdfview/viewer.html?osid={OBJECTIDENT}&pagecount=1
http://<server-mit-gateway>/oscontentviewer/viewer/{OBJECTIDENT}
http://<server-mit-documentviewer>:8070/dashlets/pdfview/viewer.html?osid={OBJECTIDENT}&pagecount=1
http://<server-mit-documentviewer>:8070/osdocumentviewer/app/viewer/{OBJECTIDENT}&pagecount=1
http://<server-mit-documentviewer>:8070/osdocumentviewer/app/viewer/{OBJECTIDENT}
ab enaio 11.10 wird die Vorschau über den Applet-Service realisiert, URL siehe nachgolgend.mögliche URLs:
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21425706
Bei Mehrserversystem: Sind die URLs bei allen Servern hinterlegt?
Dazu den enaio Enterprisemanager starten und bei “Servereigenschaften” die Kategorie “Services” wählen.Die Ansteuerung der Dokumentvorschau hat sich im Laufe der enaio Versionen geändert.
enaio <7.10: In den ersten Versionen waren Events nötig und zwar diese:
AfterLogin
GlobalClientScript
OnContextChanged
ab eniao 7.10: keine Events mehr nötig.
Die vorherigen Events können in den aktuellen Versionen zu Problemen führen, da der enaio Client bereits alle nötigen Schritte ausführt und die Events u.U. eine andere Ansteuerung vornehmen. Daher zuerst prüfen, ob noch alte Events vorhanden sind und falls ja, diese entfernen.Die Events kann man über das Verzeichnis ermitteln:
enaio <10.00: %osecm%\clients\client32\Samples\Eventscripts\InfoView ermitteln.
ab enaio 10.00: Die Events liegen bei den Install-Resourcen unter Samples\client-samples\Eventscripts\InfoView.Bei den Dokumenttypen könnten zusätzliche Events eingefügt sein, die bei OnShow weitere Aktionen ausgeführen.
Es gibt mehrere URLs, die verwendet werden können. Die URLs können im Browser, aber auch im enaio Client getestet werden. URLs: https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21425706
Tipp: Die URL, die man testen möchte, kann bei Dashlets im enaio Enterprisemanager ("Servereigenschaften, Kategorie "Services") hinzufügen, dann ist es nicht sofort als Standard im System.Ist das Dokument im Documentviewer-Cache?
Dazu diese URL aufrufen:
http://<documentviewer-server>:8070/osrenditioncache/app/management/info/<docid>. Auf der Seite steht der Pfad zum Documentviewer-Cache und ob es eine 1.pdf gibt.Ansonsten gelten alle Punkte wie bei https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21426229
Im Browser die URL eintragen (aus dem Client-Flow-Log ermitteln! nicht per "senden an") und prüfen, wie weit es kommt. Vor dem Eingeben der URL die Taste F12 (= Entwicklertools / DEV-Tools) drücken und bei "Netzwerk" auf Aufzeichnen drücken. Dann die URL einfügen.
Bei Netzwerk bzw. network wird der Verlauf dargestellt mit HTTP-Rückgaben. Dies kann exportiert werden. Als Format bitte HAR wählen und an uns senden.
Gibt es Hinweise, wo es nicht weitergeht? Gibt es Meldungen?
Oder kommt eine Login-Aufforderung? Dies kann der Client nicht ausführen. D.h. das Gateway und das Login-Verfahren sowie die URLs des Servers prüfen per enaio Enterprisemanager. Z. Bsp.: https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21427023
Tipp: Das Tool Charles liefert weitere Hinweise, welche URLs wohin gehen und wo es welchen Status oder Fehler gibt.Kommen die Aufrufe beim Gateway und beim Documentviewer an?
Hat der technische Benutzer (Gateway und Documentviewer) Rechte auf den Objekten
Hat der technische Benutzer die Systemrolle für Serverkontext-Wechsel?
Ist die Objectdefinition im SERVER\ETC-Verzeichnis vorhanden und valide, siehe
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21424578 ?Ab enaio 8.x: Haben alle Felder gültige interne Namen?
Ist ein Proxy eingerichtet, der nicht (korrekt) routet? Das kann man mit F12 ermitteln oder dem Tool Charles (Freeware im Internet verfügbar).
Ist eine Firewall aktiv und sind die Ports freigeschaltet?
Verhindert ein Virenscanner oder Add-Blocker die Aufrufe?
Ist beim enaio Server "Verschlüsselung des WORK" eingestellt? Falls ja, bitte in der config.properties des RenditionCache (WebApps-Verzeichnis) prüfen, ob der Schalter auf "true" steht:
sec.decrypt.cc=true
Wenn nicht, bitte umstellen und den Documentviewer-Dienst neu starten.
Falls das Gateway HTTPS / SSL hat:
Wurde das Zertifikat in die cacerts-Datei importiert beim Gateway und falls das Problem im Webclient auftritt: in den Servicemanager? siehe
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21424787Ab enaio 11.00 kann das Zertifikat in den Windows-Speichern konfiguriert werden. Stimmt die Konfiguration? Ist das Zertifikat im ROOT-Speicher?
Ist im Zertifikat CN und SAN enthalten? SAN = alternative Adresse
Wurde diese Adresse auch verwendet?
Des Weiteren kann es am Documentviewer selbst liegen. Die Konvertierung kann z. Bsp. nicht möglich sein (z. Bsp. wegen Dokumentschutz). Dann gibt es keine Daten im Documentviewer-Cache-Verzeichnis. Weitere Details siehe https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21433867 .
Falls es einen bestimmten Dokumenttyp betrifft:
Hat der technische Benutzer Rechte auf diesen Dokumenttyp?
Ist im Editor hinterlegt, dass eine Vorschau erstellt werden darf/soll?
Ist im Documentviewer konfiguriert, dass für diesen Dokumenttypen keine Vorschau erzeugt werden soll?
Aber auch das Format und die eingebettete bzw. konfigurierte Schriftart kann ursächlich sein. Es kann z. Bsp. im Dokument eine Hauseigene-Schriftart hinterlegt sein, die am Client oder Documentviewer-Server nicht installiert ist.
Wir benötigen zur Analyse das Original-Dokument und/oder zumindest diese Daten:Dokument-ID
Gateway-Logs
Documentviewer-Logs (sind mehrere Documentviewer vorhanden, dann bitte von allen Documentviewern)
Document-Infos (im Client F8, im Documentviewer "Dokument/Object-Infos ermitteln" siehe https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21425706 )
Es kann auch am Converter liegen. Bitte ermitteln, welcher Concerter verwendet wurde und ob im RenditionPlus Fehler protokolliert wurden, siehe auch:
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21426333
oder auch https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21424899
Falls es GraphicMagic ist oder ImageMagicks, die Fehler ausgeben, prüfen, ob der jeweils andere Converter es besser kann. Danach den Converter, der es kann, als Custom-Converter einbinden:
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21425812
https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21426627Wurde die Vorschau generell abgeschaltet?
Bitte prüfen, ob es eine elc.ini im Client32-Verzeichnis gibt.
Falls ja, bitte öffnen und prüfen, ob darin einer der Parameter vorhanden ist:
LOADURLS=NO (verhindert das Laden der URLs)
DASHLETS=NO (verhindert nur das Laden der Dashlets)
Die Parameter je auf YES stellen und den Client neu starten.Da alles über das Gateway läuft, kann auch schlicht das Gateway überlastet sein. Standardmäßig ist die parallele zugelassene Anzahl auf 50 Connections begrenzt. Das kann erweitert werden, siehe https://enaiodevelop.atlassian.net/wiki/spaces/PS/pages/21437963 .
Cluster: Wurde eine Cluster-Adresse hinterlegt und stimmen die Routings? Dazu prüfen, ob die URLs beim Gateway und beim Documentviewer ankommen. Im Browser kann man auch F12 (= DEV-Tools) drücken und dann die URL, die der Client generiert, einfügen.
Bei Netzwerk bzw. network wird der Verlauf dargestellt mit HTTP-Rückgaben. Dies kann exportiert werden. Als Format bitte HAR wählen und an uns senden.
Das Tool Charles liefert weitere Hinweise, welche URLs wohin gehen und wo es welchen Status oder Fehler gibt. Eventuell wurde der Proxy oder ein Routing nicht korrekt konfiguriert.Sollte eine Login-Aufforderung des Gateway kommen, kann man zum Test kurzeitig das Login-Verfahren "simple" auf true stellen und das Gateway neu starten. Wird dann die Vorschau korrekt dargestellt, liegt es mit höchster Wahrscheinlichkeit an der Konfiguration des Login-Verfahrens oder der Login-Pipe. "simple" sollte unbedingt wieder deaktiviert werden, da sonst keine Rechteprüfung stattfindet und jeder alles sehen könnte.
Weitere hilfreiche / informative Infos:
3.3.4 Documentviewer (DV): (Dokumentvorschau)
Wie kann man im enaio Client die URLs für die Vorschau ermitteln (Indexdaten und Dokumentvorschau)?
Es empfiehlt sich immer den Versionsfixstand zu prüfen. Beteiligt sind: enaio Client, Gateway und Documentviewer (und natürlich Server, für den Fall, dass das Dokument nicht im Documentviewer-Cache liegt)