Développement de visionneuses de documents mobiles

Article
09/24/2014

Dernière modification : mercredi 2 février 2011

S’applique à : SharePoint Foundation 2010

Cette rubrique explique comment vous pouvez créer des pages mobiles qui hébergent des visionneuses de documents permettant aux utilisateurs d’afficher sur leur appareil mobile des documents dans le format d’applications spécifiques, telles qu’un traitement de texte ou un tableur. Cela permet aux utilisateurs finaux itinérants d’ouvrir les fichiers dans les bibliothèques de documents Microsoft SharePoint Foundation sur leur appareil mobile. Certains appareils mobiles peuvent disposer de leur propre visionneuse pour le type de document. Vous pouvez configurer le système de réponse de manière à ce qu’il vérifie si l’appareil demandeur possède une visionneuse de ce type et, si tel est le cas, permette éventuellement l’ouverture du document demandé dans le navigateur de l’appareil plutôt que dans le vôtre.

Conseil
Les produits qui reposent sur Microsoft SharePoint Foundation, notamment les produits Microsoft tels que Microsoft SharePoint Server, peuvent contenir, et d’ailleurs contiennent déjà des visionneuses de documents mobiles et des pages d’hébergement. Vérifiez ce qui est déjà disponible avant de démarrer un projet de visionneuse de documents.

Vue d’ensemble

La mise à disposition d’une visionneuse de documents mobile aux utilisateurs de votre solution SharePoint Foundation comprend deux étapes majeures :

créer la page qui héberge la visionneuse ;
enregistrer la page de la visionneuse.

Créer la page d’hébergement de la visionneuse

Une page d’hébergement de visionneuse mobile est généralement un fichier aspx que vous déployez dans le dossier %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\Layouts\Mobile sur chaque serveur Web frontal. Aucune généralisation absolue sur le contenu de la page ne peut être faite. Le cœur de la page est généralement une référence à un contrôle qui peut afficher un document du type spécifié. Il peut également y avoir des contrôles permettant d’activer la modification, la pagination ou d’autres fonctionnalités appropriées pour le type de document.

Enregistrer la page

Pour inscrire la page, vous créez un fichier XML nommé mdocview_*.xml, où * représente une chaîne de caractères de nom de fichier valides. Il est recommandé d’utiliser le nom de votre société ou une chaîne qui n’est pas susceptible d’être un doublon du nom utilisé par d’autres fournisseurs de visionneuses de documents. La page est déployée dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config sur tous les serveurs Web frontaux.

Le nœud supérieur du fichier est un élément MobileDocViewers. Ajoutez au moins un élément MobileDocViewer enfant. Voici un exemple d’élément MobileDocViewer :

<MobileDocViewers>
  <MobileDocViewer Name=”xps” FilePath=”/_layouts/mobile/mxps.aspx” QueryId=”doc” AppendSourceUrl=”true” />

</MobileDocViewers>

L’attribut Name identifie l’extension de nom de fichier du type de fichiers que la visionneuse peut afficher. L’attribut FilePath identifie le chemin d’accès relatif de site Web et le nom de fichier du fichier que vous avez créé pour héberger la visionneuse. L’attribut QueryId spécifie la clé de la requête d’URL, en l’occurrence « ?doc= » est ajouté à la fin de l’URL pour votre page d’hébergement de la visionneuse. L’attribut AppendSourceUrl indique si l’URL du document que l’utilisateur souhaite afficher doit être ajoutée à la fin de l’URL. En l’occurrence, dans la mesure où la valeur est true, l’URL est ajoutée. En conséquence, l’URL relative de site Web complète pour afficher un fichier nommé File.xps figurant dans la bibliothèque de documents (http://MyServer/Shared Documents/File.xps) serait /_layouts/mobile/mxps.aspx?doc=http:%2F%2FMyServer%2FShared%20Documents%2FFile%2Exps.

Il est recommandé de créer un package de votre page en tant que fonctionnalité pouvant être activée ou désactivée au niveau de la collection de sites. Si vous procédez ainsi, votre élément MobileDocViewer possède également un attribut FeatureId qui identifie la fonctionnalité d’après son GUID. Ci-après un exemple.

<MobileDocViewers>
  <MobileDocViewer Name=”xps” FilePath=”/_layouts/mobile/mxps.aspx” QueryId=”doc” AppendSourceUrl=”true” 
                   FeatureId=”XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX” />

</MobileDocViewers>

Si la visionneuse peut ouvrir des documents correspondant à plusieurs types d’extensions de nom de fichier, ajoutez un élément MobileDocViewer distinct pour chaque extension.

Si l’appareil demandeur possède sa propre visionneuse pour le type de document pouvant être ouvert par votre visionneuse, le fichier compat.browser situé dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG\Browsers peut posséder une entrée pour le navigateur qui indique cette fonctionnalité. Par exemple, un téléphone Windows Mobile 7.0 possède un client Office Mobile qui peut ouvrir certains types de documents Microsoft Office sur le téléphone mobile. L’entrée pour ce client dans compat.browser est indiquée ci-après.

<browser id="OfficeMobileClient" parentID="default">
  <identification>
    <userAgent match="^Office Mobile Web Access$" /> 
  </identification>
  <capabilities>
    <capability name="isMobileDevice" value="true" />
    <capability name="overrideMobileDocViewerRedirection" value="true" />
  </capabilities>
</browser>

L’élément capability nommé overrideMobileDocViewerRedirection est défini sur true. Cela signifie que ce navigateur peut afficher certains types de documents Microsoft Office.

Vous pouvez permettre à la visionneuse d’un navigateur de se substituer à votre visionneuse, en ajoutant un élément BrowserCondition enfant à l’élément MobileDocViewer. L’élément BrowserCondition vérifie si l’appareil demandeur possède son propre navigateur et, si tel est le cas, redirige la requête depuis votre page d’hébergement de la visionneuse vers un autre gestionnaire de demandes. Par exemple, l’élément MobileDocViewer suivant spécifie que les fichiers .docx sont ouverts dans le fichier mWord.aspx. Toutefois, si le navigateur possède sa propre visionneuse, la requête est acheminée vers MobileDocHandler.ashx.

<MobileDocViewer Name="docx" FilePath="/_layouts/mobile/mWord.aspx" FeatureId="8DFAF93D-E23C-4471-9347-07368668DDAF" QueryId="doc" AppendSourceUrl="true" >
  <BrowserCondition Id="overrideMobileDocViewerRedirection" Value="true">
    <Override FilePath="/_layouts/MobileDocHandler.ashx" AppendSourceUrl="false" />
  </BrowserCondition>
</MobileDocViewer>

Ne réutilisez pas le terme overrideMobileDocViewerRedirection pour le nom de votre fonctionnalité, car cette fonctionnalité fait référence à la visionneuse du client Office Mobile. À la place, créez un terme à utiliser. Par exemple, si un type de navigateur possède une visionneuse XPS, vous pouvez ajouter une entrée pour ce navigateur au fichier compat.browser et lui affecter un élément capability dont l’attribut name a la valeur CanViewXPS. Ensuite, ajoutez un élément enfant BrowserCondition à votre élément MobileDocViewer et affectez la valeur CanViewXPS à l’attribut Id.

Voir aussi

Concepts

Développement mobile avec SharePoint Foundation

Bloc de construction : Pages, contrôles et adaptateurs mobiles

Partager via