Convertisseurs de documents
Dernière modification : vendredi 19 novembre 2010
S’applique à : SharePoint Server 2010
Dans cet article
Vue d'ensemble du processus de conversion de documents
Portée du convertisseur de documents
Types de fichiers de la conversion de documents
Conversion de fichiers protégés par la Gestion des droits relatifs à l'information (IRM)
Priorité des conversions
Un convertisseur de documents est un fichier exécutable personnalisé qui prend un document d'un type de fichier et produit une copie de ce fichier dans un autre type de fichier. Par exemple, le convertisseur de documents peut prendre un fichier Microsoft Excel 2010 et l'utiliser pour produire un fichier . Cela vous permet de transformer un contenu en différentes versions en fonction des besoins de l'entreprise. Vous pouvez ainsi convertir des ébauches de documentation dans un autre format final pour l'archivage à long terme ou convertir votre documentation interne dans un format différent afin de la placer sur un site à l'intention des clients.
Microsoft SharePoint Server 2010 comporte une infrastructure extensible qui vous permet d'activer vos propres convertisseurs de documents personnalisés pour les bibliothèques de documents d'une application Web. Les étapes de base du développement d'un convertisseur de documents personnalisé sont les suivantes :
Assurez-vous que la conversion de documents est activée pour votre application Web.
Créez un fichier exécutable pouvant être appelé à l'aide d'une commande de ligne de commande spécifique.
Créez un package avec le fichier exécutable, avec un fichier de définition de convertisseur de documents, sous la forme d'une fonctionnalité pouvant être déployée et activée au niveau de l'application Web.
Installez et activez le convertisseur de documents ; vous pouvez modifier la configuration du convertisseur de documents à l'aide de l'interface utilisateur de l'administration centrale.
Pour plus d'informations sur la commande de ligne de commande à laquelle doivent répondre les convertisseurs de documents, voir Commande d'exécution de convertisseur de document.
Pour plus d'informations sur le déploiement des convertisseurs de documents, voir Déploiement de conversion de document.
Vue d'ensemble du processus de conversion de documents
Étant donné que les conversions de documents peuvent consommer beaucoup de ressources, SharePoint Server 2010 repose sur deux services, DocConvLoadBalancer et DocConvLauncher, pour gérer l'équilibrage de charge, la gestion des priorités et la planification des conversions. Lorsqu'un utilisateur démarre une conversion de documents, que ce soit par le biais de l'interface utilisateur ou du modèle objet, SharePoint Server 2010 transmet cette demande de conversion aux deux services en question. C'est le service DocConvLaunch qui appelle en fait le convertisseur de documents. Une fois appelé, celui-ci prend le fichier original et en produit une copie convertie. SharePoint Server 2010 prend alors la copie convertie et effectue certaines actions de post-traitement. Ces actions incluent :
l’ajout de métadonnées du fichier d’origine à la copie convertie si le post-traitement par défaut pour les convertisseurs de documents est utilisé. Dans d’autres cas, par exemple durant la création de client intelligent, SharePoint Server 2010 utilise un post-traitement autre que celui par défaut pour ajouter les métadonnées du fichier d’origine à la copie convertie.
Les convertisseurs de documents transfèrent tous les champs qui sont sur l’ancien fichier vers le nouveau fichier dans le cadre du post-traitement par défaut.
// Set required properties. foreach (SPField field in file.Item.Fields) { // If we have a field that is not read only, // where the child does not have a value yet // but the parent does, copy that field. if (!field.ReadOnlyField && !field.Hidden && newFile.Item[field.InternalName] == null && file.Item[field.InternalName] != null) { newFile.Item[field.InternalName] = file.Item[field.InternalName]; fUpdateNewFile = true; } }Lors de la création de client intelligent, aucune métadonnée n’est transférée vers des pages, car la création de client intelligent exécute un post-traitement qui renvoie false pour runDefaultPostProcessing.
bool runDefaultPostProcessing = true; if (tp != null) tp.PostProcess(etr, cdti, out runDefaultPostProcessing); if (runDefaultPostProcessing)Pour plus d’informations sur le post-traitement dans SharePoint Server 2010, voir la méthode PostProcess() ;
l'ajout des métadonnées qui identifient le fichier original et le convertisseur de documents utilisé pour produire la copie convertie ;
la notification du fait que la conversion a été effectuée aux personnes spécifiées ;
le placement de la copie convertie dans la même bibliothèque de documents que le fichier d'origine.
Pour plus d'informations sur les services DocConvLoadBalancer et DocConvLaunch, voir Services nécessaires pour la conversion de documents.
Pour plus d’informations sur la commande en ligne de commande à laquelle les convertisseurs de documents doivent répondre, voir Commande d'exécution de convertisseur de document.
Pour plus d'informations sur les actions de post-traitement que SharePoint Server 2010 effectue sur les copies converties, voir Documents convertis.
Portée du convertisseur de documents
Les convertisseurs de documents sont activés au niveau de l'application Web. Une fois qu'un convertisseur de documents est activé pour une application Web, il est disponible pour toutes les bibliothèques de documents de chaque site de cette application Web.
Vous ne pouvez pas désactiver un convertisseur de documents pour un site ou une bibliothèque de documents spécifiques.
Vous pouvez également empêcher un convertisseur de documents de s'afficher dans l'interface utilisateur. Dans ce cas, il est accessible uniquement par le modèle objet SharePoint Server 2010. Par exemple, vous pouvez avoir un convertisseur de documents utilisé uniquement par les administrateurs dans le cadre d'un traitement par lots pour l'archivage des éléments. Dans ce cas, vous ne souhaitez pas que les autres utilisateurs puissent utiliser ce convertisseur de documents par le biais de l'interface utilisateur.
Types de fichiers de la conversion de documents
Pour une application Web, vous pouvez avoir plusieurs convertisseurs qui acceptent des documents originaux avec la même extension de type de fichier et produisent des copies converties de la même extension de type de fichier. Par exemple, vous pouvez avoir plusieurs convertisseurs qui prennent un fichier Excel et le convertissent en un fichier PowerPoint. Chaque convertisseur effectue différentes fonctions de conversion sur le fichier, mais dans chaque cas l'extension de type de fichier finale est la même. De ce fait, vous pouvez avoir plusieurs copies converties du même type de fichier pour le même document d'origine.
SharePoint Server 2010 stocke le GUID du convertisseur utilisé pour créer chaque copie convertie spécifique. Il utilise le GUID, et non pas l'extension de type de fichier, pour déterminer si un convertisseur spécifique a été utilisé pour produire une copie convertie.
Conversion de fichiers protégés par la Gestion des droits relatifs à l'information (IRM)
Si un document est protégé par la Gestion des droits relatifs à l'information (IRM), toutes les copies converties que vous créez sont également protégées par l'IRM. Si vous disposez d'un document dans un format de fichier protégé par l'IRM et que vous sélectionnez un convertisseur qui produit une copie convertie dans un format de fichier qui n'est pas protégé par l'IRM, la conversion entraîne une erreur.
Priorité des conversions
Vous pouvez définir la priorité de chaque conversion de documents à trois niveaux. Le service DocConversionLauncherService considère la priorité de conversion du document lors de la planification de l'ordre de traitement des demandes de conversion.
Les niveaux de priorité sont les suivants.
1 (niveau élevé)
Priorité par défaut pour toutes les conversions de documents lancées par le biais de l'interface utilisateur d'SharePoint Server 2010.
2 (niveau normal)
Priorité par défaut pour toutes les conversions de documents lancées à l'aide du modèle objet Windows SharePoint Services.
3 (niveau faible)
Niveau de priorité conseillé pour des lots volumineux de conversions de documents. Les conversions de documents peuvent consommer des ressources importantes, en particulier lorsque qu'elles sont effectuées par lots.
Vous ne pouvez pas définir explicitement la priorité de conversion de documents par le biais de l'interface utilisateur.
Vous pouvez définir explicitement la priorité d'une demande de conversion de documents à l'aide du modèle objet en définissant l'argument de la priorité de la méthode Convert.