Erstellen einer einfachen PDF-Vorschau für Suchergebnisse in SharePoint 2013
Veröffentlichung des Originalartikels: 21.12.2012
Diese Frage ist mir vor einigen Tagen begegnet und hat mein Interesse geweckt. Jemand hat nach den coolen neuen Miniaturansichten für Suchergebniselemente in SharePoint 2013 gefragt. Dieser Benutzer arbeitet sehr gern mit Microsoft Office-Dokumenten und wünschte sich vergleichbare Funktionen für PDF-Dateien. In einer guten Antwort darauf wurde vorgeschlagen, eine benutzerdefinierte WOPI-Erweiterung zu erstellen, um PDF-Dateien mithilfe von Office Web Apps darzustellen. Der Nachteil dieser Methode besteht darin, dass einiges an Codieren und Testen erforderlich ist (mit voll vertrauenswürdigem Code), die Datei anschließend in Ihrer OWA-Farm bereitgestellt und schließlich eine neue WOPI-Bindung in der SharePoint-Farm erstellt werden muss. Eine vollkommen plausible Antwort, wenn Ihre Ansprüche diese Methode erfordern.
Ich dagegen bin eher für einfache und möglichst bequeme Lösungen zu haben, daher versuchte ich es mit einem anderen Ansatz. Ohne zu sehr ins Detail zu gehen, erfolgt eine Suchergebnisvorschau für Office einfach über ein iFrame. Warum also sollte dies nicht auch bei PDF-Dokumenten funktionieren? Genau das habe ich letztendlich versucht. Lesen Sie nach, wie ich diese Lösung erfolgreich einsetzte:
- Ich öffnete meine Suchcenter-Website und lud eine Kopie der Datei "Item_PDF.html" herunter die sofort verwendbare Anzeigevorlage für ein PDF-Element in SharePoint 2013. An der Datei habe ich folgende Änderungen vorgenommen:
- Ändern des Titels in "PDF von Steve"
- Ändern der hoverUrl-Variablen in Javascript in "~sitecollection/_catalogs/masterpage/Display Templates/Search/Item_Site_HoverPanel.js"
- Ich speicherte die Datei als "PDF_Default.html", wechselte wieder zu meiner SharePoint-Suchcenter-Website und navigierte zu Websiteeinstellungen...Gestaltungsvorlagen und Seitenlayouts...Anzeigevorlagen...Suche und lud dort die Datei hoch.
- Ich wechselte wieder zu den Websiteeinstellungen und wählte unter "Websitesammlungsverwaltung" die Option "Suchergebnistypen".
- Ich erstellte einen Suchergebnistyp, den ich wie folgt konfigurierte:
- Name: PDF Viewer
- Nach welchen Inhaltstypen soll gesucht werden? : PDF
- Wie sollen diese Ergebnisse angezeigt werden? : PDF von Steve
Das war's – jetzt können Sie es selbst versuchen. Eines sollte noch erwähnt werden – in Schritt 1b konfigurierte ich die Anzeigevorlage für die Verwendung des Vorschaubereichs, der für Websites bereitgestellt wird. Die Anzeigevorlage ist für die Verwendung eines iFrames konfiguriert und stellt es ordnungsgemäß dar, daher musste ich keinen extra Vorschaubereich dafür erstellen. Am Rande erwähnt, ich habe dies tatsächlich ausprobiert, aber die verwendungsbereiten Vorlagen sahen um einiges besser aus, also warum sollte ich sie nicht verwenden? Das Erstellen von tollen Grafiken ist einfach nicht mein Ding. Als ich fertig war, hatte ich eine schöne Vorschau auf PDF-Dokumente in den Suchergebnissen, die Sie hier bewundern können:
Das ist alles. Meine Anzeigevorlage finden Sie hier als Anhang, nur für den Fall, dass Sie sich genau wie ich gerne Arbeit sparen. :-) Ich hoffe, Sie hatten schöne Weihnachten und wünsche Ihnen ein gutes neues Jahr.
UPDATE: Bei dieser Methode ist mir mittlerweile eine erhebliche Einschränkung aufgefallen – sie funktioniert nur dann, wenn sich Ihre PDF-Dokumente auf demselben Host wie Ihr Suchcenter befinden, d. h. dass Sie sich beispielsweise einfach in derselben Webanwendung befinden. Befindet sich Ihr Suchcenter auf https://www.foo.com, Ihre PDFs jedoch auf https://www.bar.com, können Sie nicht als Vorschauelemente angezeigt werden. Dies liegt an einigen von uns bereitgestellten Headern für X-Frame-Optionen, die wir jetzt mit SharePoint bereitstellen. Wenn Sie gemäß unseren neuen Empfehlungen für SharePoint 2013 eine einzelne Webanwendung für Ihre Farm verwenden, haben Sie keine Probleme. Verwenden Sie jedoch mehrere Webanwendungen oder durchforsten Inhalte auf SharePoint-fremden Websites, werden die Ergebnisse nicht in der Vorschau angezeigt.
Weitere häufige Probleme, die Sie berücksichtigen sollten: 1) Stellen Sie sicher, dass auf dem Computer, auf dem die Vorschau angezeigt werden soll, Adobe Reader installiert ist. 2) Mir liegt mindestens ein Bericht vor, dass diese Methode nur mit Internet Explorer funktioniert.
Es handelt sich hierbei um einen übersetzten Blogbeitrag. Sie finden den Originalartikel unter Create An Easy PDF Preview for Search Results in SharePoint 2013