Procédure : ajouter un modèle de document, un type de fichier et une application d'édition à une définition de site
Dernière modification : lundi 1 novembre 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Ajout d'un modèle de document
Ajout d'une définition de mappage pour un type de fichier
Ajout d'une application d'édition
Cette tâche de programmation constitue les étapes de personnalisation de Microsoft SharePoint Foundation pour que des documents puissent être créés ou modifiés dans une application tierce.
La tâche 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 spécifier une icône de type fichier et identifier le contrôle à utiliser lors de l’ouverture du fichier ;
la création d’une DLL qui fournit des fonctionnalités similaires à celles décrites pour le contrôle OpenDocuments, c’est-à-dire la possibilité de créer, d’ouvrir et de modifier des documents correspondant au type de fichier.
Pour effectuer les personnalisations décrites dans cette rubrique, vous devez être administrateur du serveur principal sur lequel SharePoint Foundation est installé.
.gif "Note Attention") Attention |
|---|
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 SharePoint Foundation, ou lorsque vous procédez à la mise à jour d'une installation vers une nouvelle version du produit. |
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 contenu), 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 le 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 est situé dans le répertoire %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\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ècheEdit d’un document. L’attribut OpenControl spécifie la valeur de l’identificateur programmatique (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 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\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
Cliquez avec le bouton droit sur le fichier image référencé dans le dossier IMAGES, puis cliquez sur Propriétés.
Dans l’onglet Sécurité de la boîte de dialogue Propriétés, cliquez sur Avancées.
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.
Notes
La taille par défaut des icônes de SharePoint Foundation 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 contrôle OpenDocuments.