Traitement personnalisé des documents convertis
Par défaut, Microsoft Office SharePoint Server 2007 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 Office SharePoint Server 2007, voir Documents convertis.
Prétraitement personnalisé des documents convertis
Pour effectuer des actions de prétraitement personnalisé avant qu'Office SharePoint Server 2007 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 **T:Microsoft.SharePoint.**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, Office SharePoint Server 2007 appelle à son tour votre assembly personnalisé à l'aide de la méthode PreProcess. L'assembly peut ensuite exécuter ses actions et retourner un tableau d'octets qui représente le fichier à convertir à Office SharePoint Server 2007. Office SharePoint Server 2007, à 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 Office SharePoint Server 2007 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, Office SharePoint Server 2007 appelle votre assembly personnalisé à l'aide de la méthode PostProcess. L'assembly personnalisé peut effectuer ses actions de post-traitement. Dans ce cas, Office SharePoint Server 2007 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'Office SharePoint Server 2007 a terminé le post-traitement de la copie convertie, écrivez un gestionnaire de code qui écoute l'événement de liste Convert. Office SharePoint Server 2007 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, alors que les propriétés After font référence à la copie convertie.
Pour plus d'informations sur la création de gestionnaires d'événements dans Windows SharePoint Services, voir la documentation de Windows SharePoint Services 3.0 SDK.
Voir aussi
Autres ressources
Vue d'ensemble des convertisseurs de documents
Convertisseurs de documents
Documents convertis