Procédure : ajouter un modèle de document, un type de fichier et une application d'édition à une définition de site

Windows SharePoint Services 3

Cette tâche de programmation constitue les étapes de personnalisation de Windows SharePoint Services pour que des documents puissent être créés ou modifiés dans une application tierce. Cette tâche implique la création d'un fichier de modèle de document pour compléter le fichier Onet.xml de la définition de site, la modification du fichier DocIcon.xml et la création d'une DLL qui fournit la même fonctionnalité que celle qui est décrite pour le OpenDocuments, contrôle.

L'ajout de la capacité à créer ou modifier des documents au sein d'une application implique les sous-tâches suivantes :

  • La création d'un fichier de modèle de document, qui ajoute un élément DocumentTemplate au fichier Onet.xml de la définition de site

  • L'ajout d'un élément Mapping à DocIcon.xml pour une icône de type fichier et pour l'identification du contrôle à utiliser pour ouvrir le fichier

  • La création d'une DLL qui fournit les fonctions permettant de créer ou de modifier des documents dans l'application

Ajout d'un modèle de document

Pour ajouter un document d'application en tant que modèle pouvant être utilisé dans les bibliothèques de documents, vous pouvez soit spécifier l'élément DocumentTemplate dans un Composant fonctionnel de type de contenu (voir Déploiement de types de contenus à l'aide de Composants fonctionnels), soit spécifier l'élément DocumentTemplate dans le fichier Onet.xml d'une définition de site personnalisé (voir Procédure : créer une définition de site personnalisée et une configuration).

L'exemple suivant montre comment utiliser l'élément DocumentTemplate dans un fichier Onet.xml.

<DocumentTemplates>
   <DocumentTemplate DisplayName="Blank Document" Type="105" 
      Default="FALSE" Description="A blank document.">
      <DocumentTemplateFiles>
         <DocumentTemplateFile 
            Name="doctemp/Template_Folder/psdtmp1.psd" 
            TargetName="Forms/template.psd" Default="True"/>
      </DocumentTemplateFiles>
   </DocumentTemplate>
</DocumentTemplates>

L'attribut DisplayName de l'élément DocumentTemplate spécifie le texte qui est affiché dans la liste déroulante pour sélectionner un type de modèle de document lors de la création d'une bibliothèque de documents. L'attribut Type, qui identifie de manière unique le type de document, peut être un nombre entier qui n'est pas déjà utilisé pour un autre modèle de document. L'attribut Default indique si le modèle est sélectionné par défaut dans la liste déroulante. L'attribut Name de l'élément DocumentTemplateFile spécifie le chemin d'accès physique du fichier de modèle sur l'ordinateur serveur, et l'attribut TargetName spécifie l'adresse du modèle par rapport à la bibliothèque de documents.

Réinitialisez Microsoft Internet Information Services (IIS) pour que les modifications soient prises en compte.

Ajout d'une définition de mappage pour un type de fichier

Pour mapper une extension de fichier sur un type de document et identifier le contrôle à utiliser lors de l'ouverture d'un document portant cette extension, ajoutez un élément Mapping au fichier DocIcon.xml. DOCICON.XML situé dans le répertoire \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\XML.

L'ajout de la ligne suivante dans la chaîne ByExtension du fichier DocIcon.xml mappe l'extension .psd sur un fichier image nommé icpsd.gif qui fournit l'icône qui est affichée dans les bibliothèques de document pour les fichiers de ce type :

<Mapping Key="psd" Value="icpsd.gif"/>

Pour permettre la modification au sein d'une application, l'élément Mapping doit également inclure les attributs EditText et OpenControl, comme suit :

<Mapping Key="psd" Value="icpsd.gif" EditText="Application" OpenControl="ProgID"/>

L'attribut EditText spécifie le nom de l'application qui est affichée dans le menu déroulant lorsqu'un utilisateur clique sur la flèche Edit d'un document. L'attribut OpenControl spécifie la valeur ProgID du contrôle à utiliser pour ouvrir les fichiers du type spécifié.

Le fichier image spécifié par l'attribut Value doit résider dans le répertoire \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\IMAGES. Si le fichier image spécifié est absent du répertoire, une icône « image manquante » apparaît à côté du document.

Pour éviter aux utilisateurs d'entrer leurs informations d'identification pour voir l'icône lorsque l'accès anonyme est activé, vous devez définir des autorisations héritées sur le fichier image

Pour définir des autorisations héritées sur le fichier image

  1. Cliquez avec le bouton droit sur le fichier image référencé dans le dossier IMAGES, puis cliquez sur Propriétés.

  2. Dans l'onglet Sécurité de la boîte de dialogue Propriétés, cliquez sur Avancées.

  3. Dans l'onglet Autorisations de la boîte de dialogue Paramètres de sécurité avancés, activez l'option Permettre aux autorisations héritées du parent de se propager à cet objet et aux objets enfants. Cela inclut les objets dont les entrées sont spécifiquement définies ici.

Remarque : la taille par défaut des icônes de Windows SharePoint Services est de 16 x 16 pixels.

Réinitialisez IIS pour que les modifications soient prises en compte.

Ajout d'une application d'édition

Créez une DLL contenant le contrôle à charger pour un document du type spécifié dont la valeur ProgID identifie le contrôle, par exemple, SharePoint.OpenDocuments. Le contrôle que vous créez doit fournir les mêmes méthodes pour créer, ouvrir et afficher des documents que celles qui sont décrites dans le OpenDocuments, contrôle.

Pour effectuer les personnalisations décrites dans cette rubrique, vous devez être administrateur du serveur principal sur lequel Windows SharePoint Services est installé.

Aa978104.warning(fr-fr,office.12).gif Avertissement :

Les modifications que vous apportez aux fichiers d'installation d'origine peuvent être remplacées lorsque vous installez des mises à jour ou des Service Packs de Windows SharePoint Services, ou lorsque vous procédez à la mise à jour d'une installation vers une nouvelle version du produit.

Afficher: