Programmation à l'aide de l'espace de noms Microsoft.HtmlTrans

Article
09/24/2014

Dernière modification : mardi 1 février 2011

S’applique à : SharePoint Foundation 2010

Un utilisateur peut afficher un document dans une bibliothèque de documents même si parmi les applications installées sur l'ordinateur client aucune n'est capable d'afficher le document demandé. Microsoft SharePoint Foundation fournit l'espace de noms Microsoft.HtmlTrans comme une infrastructure sur laquelle s'appuyer pour créer des applications de convertisseur personnalisées afin de fournir une version HTML du document demandé à la place du format de fichier binaire non reconnu.

Attention
La fonctionnalité Visionneuse HTML doit être activée dans l'Administration centrale de SharePoint Foundation afin de pouvoir utiliser cette fonctionnalité.

L'espace de noms Microsoft.HtmlTrans.Interface se compose de deux interfaces, IHtmlTrLoadBalancer et IHtmlTrLauncher. Une implémentation de ces interfaces repose également sur un fichier de configuration XML, appelé htmltransinfo.xml, qui réside sur le serveur qui exécute SharePoint Foundation.

L'interface IHtmlTrLoadBalancer vous aide à sélectionner le serveur sur lequel exécuter l'application de convertisseur personnalisée.
L'interface IHtmlTrLauncher lance l'application de convertisseur personnalisée et renvoie les résultats HTML à SharePoint Foundation.
Le fichier htmltransinfo.xml redirige la demande de document vers une page Gestionnaire, qui appelle ensuite le service d'équilibrage de charge et les composants du service de lancement. Une entrée du fichier de configuration htmltransinfo.xml utilise le format suivant :
```
<HtmlTrInfo>
    <Mapping Extension="ext" AcceptHeader="application/vnd.my-app" HandlerUrl="myapphandler.aspx" ProgId=""/>
</HtmlTrInfo>
```

Attention
Les modifications apportées dans le fichier htmltransinfo.xml risquent de ne pas être conservées lorsque vous mettez à jour SharePoint Foundation avec un Service Pack ou un correctif de sécurité.

Utilisation de l'espace de noms Microsoft.HtmlTrans

La séquence suivante d'événements se produit lorsqu'un utilisateur demande un document stocké sur un serveur qui exécute SharePoint Foundation :

SharePoint Foundation identifie l'extension de fichier du document dans le fichier htmltransinfo.xml. Si l'extension est trouvée, SharePoint Foundation récupère l'attribut AcceptHeader correspondant. Si elle est introuvable, SharePoint Foundation invite l'utilisateur à télécharger le document.
SharePoint Foundation vérifie la valeur d'attribut AcceptHeader par rapport à l'Accept-Header HTTP header de la demande pour déterminer si l'ordinateur client reconnaît le type de document demandé. Si tel est le cas, SharePoint Foundation effectue la remise du document dans son format natif.
SharePoint Foundation récupère également l'attribut ProgId à partir du fichier htmltransinfo.xml et essaie d'ouvrir le fichier sur l'ordinateur client à l'aide du composant qui est désigné par le ProgId. Si cette tentative échoue, SharePoint Foundation poursuit le processus de conversion HTML.
Si l'ordinateur client ne reconnaît pas le type de document demandé, SharePoint Foundation invite l'utilisateur à convertir ou non le document à afficher dans le navigateur. Si l'utilisateur choisit de ne pas convertir le document, SharePoint Foundation invite l'utilisateur à télécharger le document.
Si l'utilisateur choisit de convertir le document, SharePoint Foundation transmet la demande à la page Gestionnaire qui est spécifiée par l'attribut HandlerUrl dans le fichier htmltransinfo.xml. Cette page gère le processus de conversion et remet le fichier converti à l'utilisateur pour son affichage dans le navigateur.

Implémentation de la conversion personnalisée de documents

Pour implémenter la conversion personnalisée de documents sur la plateforme SharePoint Foundation, vous devez créer :

Une entrée dans le fichier Htmltransinfo.xml correspondant au type de document.
Une page Gestionnaire qui lance le processus de conversion de documents et renvoie la sortie HTML à l'utilisateur.
Un ensemble de composants de conversion personnalisée.

Vous devez choisir entre trois méthodes pour générer le jeu de composants de conversion personnalisée :

Créer des implémentations personnalisées de l'interface IHtmlTrLoadBalancer et IHtmlTrLauncher qui peuvent être utilisées pour lancer une application de convertisseur personnalisée et renvoyer ses résultats à SharePoint Foundation.
Créer un ensemble de composants de conversion personnalisée qui n'utilise pas les interfaces Microsoft.HtmlTrans.
Appeler les implémentations personnalisées des interfaces IHtmlTrLoadBalancer et IHtmlTrLauncher qui sont fournies dans le cadre du Kit de Ressources Techniques Microsoft Office 2003 et fournir une application de convertisseur personnalisée que l'implémentation de IHtmlTrLauncher doit appeler.

Voir aussi

Concepts

Espaces de noms du modèle objet SharePoint Foundation

Autres ressources

Mise en route de la personnalisation par programme d'un site Web SharePoint dans Visual Studio