Procédure : créer et déployer des éléments déclaratifs courants dans les solutions en bac à sable (sandbox)
Cette rubrique explique comment créer, dans une solution en bac à sable (sandbox), les composants de projet SharePoint courants définis de manière déclarative.
Dernière modification : mercredi 13 avril 2011
S’applique à : SharePoint Foundation 2010
Disponible dans SharePoint Online
La rubrique traite uniquement des composants suivants. (Pour plus d'informations sur la manière de créer et déployer d'autres types de composants dans les solutions en bac à sable (sandbox), voir la section Rubriques connexes.)
Modèle de liste/bibliothèque (y compris le fichier schema.xml)
Instance de liste/bibliothèque
Type de contenu
Liaison du type de contenu à une liste
Champ (mais pas les types de champs personnalisés)
Action personnalisée (Toutefois, la définition d'un groupe d'actions personnalisées et le masquage d'une action personnalisée ne sont pas autorisés dans les solutions en bac à sable (sandbox). Voir la remarque ultérieure à ce sujet dans cette rubrique.)
Conteneur des propriétés
Association d'une fonctionnalité à une configuration de définition de site (également appelée association de modèles de fonctionnalités/sites)
Notes
Les composants de projet SharePoint déclaratifs courants qui ne peuvent pas être déployés dans une solution en bac à sable (sandbox) sont les suivants :
-
Inscription d'un candidat de contrôle délégué (élément Control).
-
Inscription d'un convertisseur de documents (élément DocumentConverter). Ceux-ci s'inscrivent au niveau de l'application Web, et les solutions en bac à sable (sandbox) ne sont pas autorisées à accéder à tout ce qui se trouve en dehors de la collection de sites hôte.
-
Définition d'un groupe d'actions personnalisées (élément CustomActionGroup).
-
Masquage d'une action personnalisée (élément HideCustomAction).
-
Définition d'un flux de travail (élément Workflow). Cet élément est uniquement utilisé dans le cadre de flux de travail codés, lesquels ne peuvent pas être déployés dans une solution en bac à sable (sandbox).
Pour plus d’informations sur les raisons pour lesquelles ces composants ne peuvent pas être déployés dans les solutions en bac à sable (sandbox), voir Restrictions imposées aux solutions en bac à sable (sandbox).
Pour créer les composants
Démarrez un projet Microsoft Visual Studio SharePoint. Il peut s'agir de n'importe quel type de projet autorisé dans les solutions en bac à sable (sandbox), notamment Solution SharePoint vide. (Il ne peut pas s'agir des types Modèle de connectivité de données métiers, Modèle de site, Composant Visual Web Part, Flux de travail séquentiel ou Flux de travail de la machine à états.)
Lorsque vous êtes invité à choisir le type de solution, sélectionnez Solution bac à sable (sandbox), et non Batterie de serveurs.
Une fois que Visual Studio a créé le projet, ajoutez des éléments de projet Type de contenu, Instance de liste, Modèle de liste ou Modèle de liste du type de contenu selon les besoins du projet.
Personnalisez les fichiers Elements.xml (et les fichiers Schema.xml, le cas échéant) dans ces éléments de projet de la même façon que vous le feriez dans une solution de batterie de serveurs.
Si votre solution inclut l'un des autres types de composants mentionnés dans cette liste à puces, il n'existe aucun élément de projet Visual Studio spécifique, donc ajoutez un élément Élément vide au projet.
L'élément Élément vide contient un seul fichier Elements.xml dont le seul balisage est l'élément racine <Elements>.
Personnalisez le fichier Elements.xml de la même façon que vous le feriez dans une solution de batterie de serveurs. Par exemple, si votre composant correspond à un ou plusieurs champs, ajoutez un ou plusieurs éléments Field en tant qu'éléments enfants de l'élément <Elements>, puis configurez leurs attributs et leurs éléments enfants, le cas échéant.
S'il existe plusieurs composants dans votre solution pour lesquels il n'existe aucun élément de projet Visual Studio spécifique, vous pouvez ajouter des éléments Élément vide distincts pour chacun d'eux ou combiner différents types d'éléments enfants avec l'élément <Elements> du même élément Élément vide. Après avoir ajouté un élément enfant à l'élément <Elements>, configurez ses attributs et ses éléments enfants. Le tableau suivant présente les composants purement déclaratifs disponibles dans les solutions en bac à sable (sandbox) qui ne possèdent pas d'élément de projet Visual Studio spécifique.
Composant
Élément
Liaison d'un type de contenu à une liste
Action personnalisée
Conteneur des propriétés
Association de fonctions
Champ
Votre projet doit comporter au moins une fonctionnalité, et tous les manifestes d'éléments (fichiers Elements.xml) de tous vos composants doivent être référencés dans une fonctionnalité. Si vous utilisez Visual Studio, une première fonctionnalité est automatiquement créée lorsque vous ajoutez le premier composant, et chaque nouveau composant y est ajouté. Vous pouvez ajouter d'autres fonctionnalités et utiliser le Concepteur de fonctionnalités Visual Studio pour déplacer des composants d'une fonctionnalité à l'autre. Une solution en bac à sable (sandbox) ne peut rien déployer en dehors de la collection de sites dans laquelle elle est téléchargée, donc aucune de vos fonctionnalités ne peut s'étendre à la batterie de serveurs ou à l'application Web.
Générez, empaquetez et déployez sur votre installation SharePoint de développement. Lorsque les phases de test et de débogage sont terminées, mettez le package de la solution en bac à sable (sandbox) (fichier .wsp) à la disposition des administrateurs de collections de sites.
Déploiement de la solution en bac à sable (sandbox)
Un administrateur de collection de sites peut installer une solution en bac à sable (sandbox) dans la galerie de solutions de la collection de sites. Il existe deux étapes dans ce processus : tout d'abord, le package de solution est téléchargé dans la galerie. Ensuite, il est déployé, ce qui correspond à une « activation » pour les solutions en bac à sable (sandbox). La seconde étape permet d'activer automatiquement toutes les fonctionnalités du package. Si des validateurs de solution sont inscrits dans la collection de sites, ils s'exécutent également lors de la phase d'activation. Si la solution passe la validation avec succès et qu'elle n'a pas été bloquée par un administrateur de batterie de serveurs, elle est prête à être utilisée sur la collection de sites.