Office Web Apps Server 2013: Gestion des fichiers PDF (Word Web App, Prévisualisation) (fr-FR)
Nous avons vu dans des précédents articles :
- Comment installer les OWA Server,
- Comment installer une mise à jour sur une ferme OWA.
Dans ce dernier article, j’y avais expliqué que la KB2760445 permettait aux OWA Server de prendre en charge les documents PDF.
Vous pouvez jetez un oeil ici pour voir une partie des fonctionnalités modifiées (c’est la description du correctif de février, mais les correctifs sont inclus dans celui de mars) :
http://spasipe.files.wordpress.com/2013/03/161.png?w=595&h=131
Nous allons voir dans cet article :
- L’ouverture d’un PDF dans "Word Web App",
- Les 2 façons d’obtenir la prévisualisation des fichiers PDF dans les résultats de recherche (largement inspiré par cet article de Wictor Wilen et cet autre article de Steve Mann).
Création du nouveau binding
Comme l’indique la partie encadrée ci-dessus, vous devez utilisez la commande New-SPWOPIBinding pour permettre aux OWA de savoir quoi faire quand elles doivent traiter l’application "WordPDF".
On remarque d’ailleurs que la page Technet de la commande n’a pas encore été mise à jour :
http://spasipe.files.wordpress.com/2013/03/171.png?w=595&h=63
Lancez la commande encadrée en rouge dans l’image de la KB (2 images au-dessus) (n’oubliez pas le paramètre "-AllowHTTP" si vous n’êtes pas en HTTPS).
Dans mon cas : New-SPWOPIBinding -ServerName owa -Applicationtype WordPDF -AllowHTTP
La liste des bindings associés au PDF s’affiche alors :
http://spasipe.files.wordpress.com/2013/03/131.png?w=306&h=488
Note : La commande Get-SPWOPIBinding permet de lister tous les bindings.
Ouverture d’un PDF dans "Word Web App"
1. Cliquez sur un document PDF (ou cliquez sur "…" puis sur "View in Browser")
http://spasipe.files.wordpress.com/2013/05/131.png?w=595&h=180
2. Le PDF s’ouvre alors correctement dans le navigateur, via "Word Web App"
http://spasipe.files.wordpress.com/2013/05/122.png?w=595&h=430
Prévisualisation des fichiers PDF dans les résultats de recherche
Par défaut, le comportement est le suivant :
http://spasipe.files.wordpress.com/2013/05/14.png?w=595&h=380
Comme l’explique Wictor Wilen dans son article, vous avez 2 manières pour activer la prévisualisation des PDF :
- En créant un nouveau "Result Type",
- En modifiant le "Display Template" existant.
Vous ne savez pas ce que sont ces 2 éléments ? Allez donc voir cet article, j’y explique le fonctionnement de ces 2 éléments, ainsi qu’un exemple d’implémentation.
Çà vous sera utile pour la suite.
Cas 1 : Création d’un nouveau "Result Type"
L’idée est de copier le "Result Type" existant, en lui faisant utiliser le modèle "Word".
1. Cliquez sur "Site Settings / Result Types"
http://spasipe.files.wordpress.com/2013/03/34.png?w=595
2. Descendez dans la liste jusqu’à trouver le nom "PDF" – Cliquez dessus si vous voulez voir ses propriétés.
Cliquez dans le menu contextuel sur "Copy".
http://spasipe.files.wordpress.com/2013/03/44.png?w=595&h=65
3. L’idée est de modifier dans ce nouveau "Result Type" le "Display Template" utilisé.
Par défaut pour les PDF c’est le template "PDF Item" qui est utilisé; nous allons modifier ce comportement en lui faisant utiliser le template associé aux documents Word : "Word Item".
Donnez à ce nouveau "Result Type" un nom, et sélectionnez "Word Item" dans la liste déroulante.
http://spasipe.files.wordpress.com/2013/03/53.png?w=595&h=268
4. Le "Result Type" est bien créé
http://spasipe.files.wordpress.com/2013/03/64.png?w=595&h=68
5. Lancez un full crawl de votre ou vos source(s) de contenu.
6. La prévisualisation fonctionne alors pour les fichiers PDF !
http://spasipe.files.wordpress.com/2013/05/15.png?w=595&h=366
Cas 2 : Modification du "Display Template" existant
Le but ici, c’est d’aller modifier le "Display Template" utilisé pour les fichiers PDF, nommé "Item_PDF_HoverPanel.html" ou "Item_PDF_HoverPanel.js", selon que vous utilisez (par exemple pour cet article) un search center ou un site d’équipe.
- Pour un search center vous avez les fichiers .html et leurs pendants .js (mis à jour automatiquement lors de la modification du .html associé) :
http://spasipe.files.wordpress.com/2013/05/20.png?w=595
- Pour un site d’équipe vous n’avez que les points .js :
http://spasipe.files.wordpress.com/2013/05/24.png?w=595&h=212
1. Insérez, dans le cas d’un fichier .html, la section ci-dessous. (Si vous passez par un .js, je vous renvoie à l’ article de Steve Mann).
http://spasipe.files.wordpress.com/2013/05/21.png?w=595&h=219
Pour se faire, vous pouvez utiliser SharePoint Designer, le Design Manager ou passer par les "Site Settings"; pour ces 2 dernières possibilités, je vous encourage à aller lire mon articleUtiliser les Display Templates avec le Design Manager, il s’y trouve le même principe, pour customiser le Display Template utilisé pour les fichiers Word.
2. Une fois la modification faite (la modification du .html met automatiquement à jour le .js) :
http://spasipe.files.wordpress.com/2013/05/22.png?w=595&h=33
3. Et une fois Acrobe Reader installé sur le poste client – Sinon vous obtenez ceci :
http://spasipe.files.wordpress.com/2013/05/261.png?w=595&h=345
4. La prévisualisation fonctionne, avec la taille saisie dans le .html (500 * 630 px) :
http://spasipe.files.wordpress.com/2013/05/23.png?w=595&h=386
Conclusion
En courte conclusion (parcequ’il est tard), vous avez à votre disposition 2 manières de procéder pour rendre opérationnel l’affichage des documents PDF dans les résultats de recherche.
Références
- SharePoint 2013: Enabling PDF Previews with Office Web Apps 2013 March 2013 update [By Wictor Wilen],
- SharePoint 2013: PDF Preview in Search Results [By Steve Mann],
- SharePoint 2013 : Design Manager – Utiliser les Display Templates,
- Installer les OWA Server,
- Installer une mise à jour sur une ferme OWA,
- New-SPWOPIBinding,
- Update for Microsoft Office Web Apps Server 2013 (KB2760445).