Pages de paramètres de conversion personnalisées
Dernière modification : lundi 8 mars 2010
S’applique à : SharePoint Server 2010
Vous pouvez désigner une page .aspx personnalisée à partir de laquelle l'utilisateur peut spécifier des paramètres pour une conversion particulière du document sélectionné, ou utiliser la page de paramètres de conversion par défaut incluse dans Microsoft SharePoint Foundation.
Pour spécifier une page de paramètres de conversion personnalisée, définissez l'élément ConverterUIPage de la définition du convertisseur de documents dans le nom de fichier de votre page aspx personnalisée. Cette page s'affiche lorsque l'utilisateur sélectionne un document à convertir en utilisant votre convertisseur. La définition de l'élément ConverterUIPage est facultative. Si vous ne spécifiez pas de page personnalisée, Microsoft SharePoint Server 2010 affiche la page par défaut, DocTrans.aspx.
La page DocTrans.aspx permet à l'utilisateur de sélectionner le convertisseur à utiliser. Seuls les convertisseurs de documents qui utilisent la page DocTrans.aspx sont affichés dans la page. Elle permet également aux utilisateurs de spécifier les noms de fichiers pour chaque fichier converti, et de préciser également s'ils souhaitent être notifiés lorsque les conversions sont terminées. Une fois soumise, la page appelle la méthode Convert, une fois pour chaque convertisseur sélectionné, et passe les paramètres nécessaires.
La page DocTrans.aspx spécifie que chaque conversion doit être exécutée de façon asynchrone.
Si vous créez une page de paramètres de conversion personnalisée, vous devez inclure un code qui appelle la méthode Convert, en passant les paramètres appropriés. Dans le cas d'un convertisseur qui inclut des paramètres de configuration personnalisés, la page doit inclure le code qui permet les opérations suivantes :
Déterminer le type de contenu du document à convertir.
Accéder à la définition de type de contenu et extraire le nœud qui contient les paramètres de configuration du convertisseur pour ce type de contenu.
Passer ces paramètres de configuration du convertisseur à la méthode Convert comme paramètre configInfo.
Notes
Si vous créez un convertisseur de documents pour publier un contenu Web, il est conseillé d'appeler la méthode PublishingPageCollection.Add, à la place de la méthode Convert. La méthode PublishingPageCollection.Add permet un post-traitement spécialisé pour créer une nouvelle page Web et placer le code HTML généré par le convertisseur dans les champs spécifiés dans cette page. Pour plus d'informations sur les convertisseurs de documents pour publier un contenu Web, voir Publication de pages à l'aide de convertisseurs de documents.
La page DocTrans.aspx ne permet pas les opérations suivantes :
Passer des données de configuration à la méthode Convert. Si vous créez un convertisseur de documents qui inclut des paramètres de configuration personnalisés, n'utilisez pas la page DocTrans.aspx, car ces paramètres ne sont pas passés au convertisseur de documents. Créez plutôt une page de paramètres de conversion personnalisée et spécifiez-la dans la définition du convertisseur de documents.
Spécifier un pré- ou un post-traitement personnalisé du fichier converti. Pour plus d'informations sur la spécification d'un pré- ou post-traitement personnalisé, voir Traitement personnalisé des documents convertis.
Voir aussi
Concepts
Vue d'ensemble des convertisseurs de documents
Déploiement de conversion de document
Schéma de définition du convertisseur de documents
Pages de paramètres de configuration du convertisseur personnalisé