Traitement personnalisé des documents convertis
Dernière modification : lundi 8 mars 2010
S’applique à : SharePoint Server 2010
Dans cet article
Prétraitement personnalisé des documents convertis
Post-traitement personnalisé des documents convertis
Post-traitement supplémentaire des documents convertis
Par défaut, Microsoft SharePoint Server 2010 exécute plusieurs fonctions de post-traitement sur la copie convertie envoyée par le convertisseur de documents, telles qu'ajouter des métadonnées du fichier d'origine à la copie et replacer la copie dans la même bibliothèque de documents que celle de l'original. Cependant, vous pouvez remplacer ces actions de post-traitement par les vôtres ou en ajouter. Vous pouvez aussi exécuter un traitement personnalisé avant que le convertisseur de documents ne soit appelé.
Pour plus d'informations sur le post-traitement effectué par défaut par SharePoint Server 2010, voir Documents convertis.
Prétraitement personnalisé des documents convertis
Pour effectuer des actions de prétraitement personnalisé avant qu'SharePoint Server 2010 ne transmette le fichier d'origine au convertisseur de documents, créez un assembly qui implémente l'interface ISPConversionProcessor. La méthode PreProcess de cette interface accepte deux arguments :
Un tableau d'octets qui représente le flux d'octets du fichier d'origine.
Un objet SPExecutingConversionRequest, qui contient des propriétés en lecture seule représentant les arguments transmis à la méthode Convert, tels que des informations de configuration personnalisée à passer au convertisseur de documents, le nom de fichier de la copie convertie, la priorité de conversion, les adresses électroniques des personnes à avertir, ainsi qu'une valeur indiquant si la copie convertie doit être incluse en tant que pièce jointe dans l'alerte.
Pour invoquer votre assembly de prétraitement personnalisé, définissez deux paramètres de la méthode Convert :
Affectez une chaîne qui représente l'emplacement de votre assembly personnalisé au paramètre handlerAssembly.
Affectez une chaîne qui représente le nom de la classe à appeler pour le prétraitement dans votre assembly au paramètre handlerClass.
Lorsque vous appelez la méthode Convert avec ces paramètres ainsi définis, SharePoint Server 2010 appelle à son tour votre assembly personnalisé en utilisant la méthode PreProcess. L'assembly peut ensuite exécuter ses actions et retourner un tableau d'octets qui représente le fichier à convertir à SharePoint Server 2010. SharePoint Server 2010, à son tour, passe ce tableau d'octets au convertisseur de documents.
Post-traitement personnalisé des documents convertis
Pour remplacer les actions de post-traitement effectuées par SharePoint Server 2010 par les vôtres, créez un assembly qui implémente l'interface ISPConversionProcessor. La méthode PostProcess de cette interface accepte deux arguments :
Un objet SPExecutingConversionRequest, qui contient des propriétés en lecture seule représentant les arguments transmis à la méthode Convert, tels que des informations de configuration personnalisée à passer au convertisseur de documents, le nom de fichier de la copie convertie, la priorité de conversion, les adresses électroniques des personnes à avertir, ainsi qu'une valeur indiquant si la copie convertie doit être incluse en tant que pièce jointe dans l'alerte. En outre, l'objet intègre un tableau d'octets qui représente le fichier converti.
Un type inconnu qui représente le résultat.
Pour invoquer votre assembly de post-traitement personnalisé, définissez deux paramètres de la méthode Convert :
Affectez une chaîne qui représente l'emplacement de votre assembly personnalisé au paramètre handlerAssembly.
Affectez une chaîne qui représente le nom de la classe à appeler pour le post-traitement dans votre assembly au paramètre handlerClass.
Lorsque vous appelez la méthode Transform avec ces paramètres ainsi définis après que le convertisseur de documents a généré une copie convertie du fichier d'origine, SharePoint Server 2010 appelle votre assembly personnalisé à l'aide de la méthode PostProcess. L'assembly personnalisé peut effectuer ses actions de post-traitement. Dans ce cas, SharePoint Server 2010 n'exécute pas de post-traitement, et ne déplace pas la copie convertie vers la même bibliothèque de documents que celle de l'original.
Post-traitement supplémentaire des documents convertis
Pour exécuter des actions de post-traitement supplémentaires après qu'SharePoint Server 2010 a terminé le post-traitement de la copie convertie, écrivez un gestionnaire de code qui écoute l'événement de liste Convert. SharePoint Server 2010 déclenche cet événement lorsqu'un document est converti, traité et replacé dans la même bibliothèque de documents que celle du fichier d'origine à partir duquel il a été généré.
Notes
Les propriétés Before de l'événement font référence au fichier d'origine, tandis que les propriétés After font référence à la copie convertie.