Utilisation de modules pour inclure des fichiers dans la solution
Vous souhaiterez parfois déployer des fichiers sur le serveur SharePoint quel que soit leur type (nouvelles pages maîtres, par exemple). Pour ce faire, vous pouvez utiliser des modules (à ne pas confondre avec les modules de code Visual Basic). Les modules sont des conteneurs réservés aux fichiers dans une solution SharePoint. Une fois la solution déployée, les fichiers appartenant au module sont copiés dans les dossiers spécifiés sur le serveur SharePoint.
Éléments de module et éléments
Pour créer un module, ajoutez-le à un projet en le sélectionnant dans la boîte de dialogue Ajouter un nouvel élément. Modifiez ensuite son fichier Elements.xml afin d'inclure les noms des fichiers que vous souhaitez déployer et d'indiquer leur emplacement d'origine sur le système et leur destination sur le serveur SharePoint.
Voici un exemple de fichier Elements.xml pour un module :
<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
<Module Name="Module1">
<File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
</Module>
</Elements>
Les modules nouvellement créés contiennent les fichiers par défaut suivants :
Nom du fichier |
Description |
|---|---|
Elements.xml |
Fichier de définition pour le module. |
Sample.txt |
Fichier réservé servant d'exemple de fichier dans le module. |
Le fichier Elements.xml est constitué des éléments suivants :
Nom de l'élément |
Description |
|---|---|
Éléments |
Contient l'ensemble des éléments définis dans le module. |
Module |
L'élément de module possède un attribut unique, Name, qui définit le nom du module au format <Module Name="Module1">. .gif "Remarque") Remarque
Si vous changez le nom du module (ou sa propriété Folder Name), vous êtes obligé de mettre à jour manuellement le nom dans l'élément Module.
Si vous prévoyez un sous-répertoire pour le(s) fichier(s) dans l'élément Module, Windows SharePoint Services(WSS) crée automatiquement une structure de répertoire correspondante pour le(s) fichier(s) en question. |
Fichier |
L'élément File est défini par deux paramètres, Path et Url.
Nom d'attributDescription
Chemin d'accèsNom et emplacement du fichier dans la solution SharePoint.Il se présente sous le format suivant : Path="Module1\Sample.txt".
UrlEmplacement où le fichier sera déployé sur le serveur SharePoint.Il se présente sous le format suivant : Url="Module1/Sample.txt".
TypeAttribut facultatif défini par deux paramètres : GhostableInLibrary et Ghostable.Il se présente sous le format suivant : Type="GhostableInLibrary".Le fait de spécifier GhostableInLibrary signifie que le fichier sera ajouté à une bibliothèque de documents dans SharePoint et qu'il sera accompagné par un élément de liste au moment de l'ajout.Le fait de spécifier Ghostable implique l'ajout du fichier à SharePoint hors de la bibliothèque de documents.
|
Chaque fichier que vous souhaitez déployer nécessite une entrée d'élément <File> indépendante dans Elements.xml.
Voir aussi
Autres ressources
Comment : inclure des fichiers à l'aide d'un module
Procédure : mettre en service un fichier
Développement de solutions SharePoint