Installation, désinstallation et mise à niveau des solutions en bac à sable (sandbox)

Dernière modification : jeudi 14 avril 2011

S’applique à : SharePoint Foundation 2010

Dans cet article
Installation d’une solution en bac à sable (sandbox)
Désinstallation d’une solution en bac à sable (sandbox)
Mise à niveau d’une solution en bac à sable (sandbox)

Disponible dans SharePoint Online

Cette rubrique explique comment les administrateurs de site peuvent installer, désinstaller et mettre à niveau une solutions en bac à sable (sandbox).

Installation d’une solution en bac à sable (sandbox)

De même qu’avec une solution de batterie de serveurs, deux étapes sont nécessaires pour installer une solution en bac à sable (sandbox). Dans le contexte d’une solutions en bac à sable (sandbox), ces deux étapes sont appelées téléchargement et activation.

  • Phase de téléchargement : la phase de téléchargement implique le téléchargement d’une solution en bac à sable (sandbox) dans la galerie de solutions d’une collection de sites. Cela s’apparente à l’ajout d’une solution de batterie de serveurs.

  • Phase d’activation : la phase d’activation se produit après que la solution a été chargée dans une galerie de solutions. Lorsqu’une solution est téléchargée, elle est encore inerte d’un point de vue fonctionnel. Le processus d’activation de la solution la rend opérationnelle dans le site en déployant les fichiers, en enregistrant les récepteurs d’événements et en exécutant la validation de solution. Cela s’apparente au déploiement d’une solution de batterie de serveurs. Si une solution en bac à sable (sandbox) inclut une fonctionnalité qui se trouve au niveau de la collection de sites, elle est automatiquement activée lorsque la solution est activée.

Une solution en bac à sable (sandbox) est installée par un administrateur de collection de sites sur la galerie de solutions de la collection de sites. Cette galerie affiche aussi l’utilisation des ressources en cours, l’utilisation moyenne des ressources au cours des deux semaines écoulées et le statut de chaque solution en bac à sable (sandbox). Pour plus d’informations sur l’utilisation des ressources et la surveillance du système pour une solutions en bac à sable (sandbox), voir Limites de l'utilisation des ressources sur les solutions en bac à sable (sandbox).

Les étapes ci-après sont exécutées par l’administrateur de la collection de sites pour installer une solution en bac à sable (sandbox).

Pour installer une solution en bac à sable (sandbox)

  1. Dans une page de la collection de sites, cliquez sur Actions du site et sélectionnez Paramètres du site.

  2. Dans la page Paramètres du site, cliquez sur Solutions sous le titre Galeries.

  3. Sous l’onglet Solutions du Ruban serveur, cliquez sur Télécharger la solution.

  4. Dans la boîte de dialogue Télécharger la solution, cliquez sur Parcourir, puis accédez à votre package de solution en bac à sable (sandbox) (fichier .wsp). Cliquez sur Ouvrir.

    Le package de solution se trouve maintenant dans la galerie de solutions de la collection de sites, mais n’est pas encore déployé.

  5. Dans la boîte de dialogue Activer la solution, cliquez sur Activer pour activer la solution.

    Notes

    Si votre package de solution en bac à sable (sandbox) contient une fonctionnalité dont l’étendue se situe au niveau de la collection de sites, celle-ci est activée automatiquement. Les fonctionnalités dont l’étendue se situe au niveau du site Web doivent être activées dans la page Gérer les fonctionnalités du site à l’emplacement https://servername/site/subsite/_layouts/managefeatures.aspx. Lorsque vous ajoutez un package de solution en bac à sable (sandbox) via le modèle objet, la collection de sites et les fonctionnalités ayant pour étendue un site Web doivent être activées dans la page Gérer les fonctionnalités du site à l’emplacement https://servername/site/subsite/_layouts/managefeatures.aspx.

Notes

Autres solutions pour installer une solution en bac à sable (sandbox) :

  • Un administrateur de batterie peut aussi installer une solution en bac à sable (sandbox) sur une collection de sites en utilisant SharePoint Management Shell (PowerShell). Les commandes sont Add-SPUserSolution et Install-SPUserSolution.

  • Sur l’ordinateur de développement, dans Microsoft Visual Studio, vous pouvez exécuter toutes les étapes d’installation en sélectionnant Déployer la solution dans le menu Générer.

Désinstallation d’une solution en bac à sable (sandbox)

Deux étapes sont également nécessaires pour désinstaller une solution en bac à sable (sandbox).

  • Étape de désactivation : un administrateur de collection de sites peut désactiver une solution en bac à sable (sandbox) à partir de la galerie de solutions d’une collection de sites. La désactivation inverse la plupart des actions de déploiement de l’activation et, ainsi, désactive les diverses capacités de la solution. (Si une solution qui contient un composant WebPart est désactivée après que le composant a été ajouté à une page, le composant WebPart affiche une erreur au lieu des informations habituelles contenues dans le composant Web Part. Celui-ci ne disparaît pas entièrement parce que la désactivation n’annule pas le déploiement du fichier .webpart du composant WebPart.)

  • Phase de suppression : la phase de suppression se produit lorsqu’un administrateur choisit de supprimer une solution en bac à sable (sandbox) à partir de la galerie de solutions. Lorsque l’administrateur choisit de supprimer une solution, des validations et contrôles supplémentaires se produisent pour avertir l’administrateur des conséquences négatives d’une suppression involontaire. Une solution en bac à sable (sandbox) ne peut pas être supprimée si elle est toujours activée. Lorsqu’une solution en bac à sable (sandbox) est supprimée, elle est déplacée vers la Corbeille et peut être restaurée ou supprimée définitivement de la Corbeille.

Notes

Autres solutions de désinstallation d’une solution en bac à sable (sandbox) :

  • Un administrateur de batterie peut désactiver et supprimer une solution en bac à sable (sandbox) à partir d’une collection de sites en utilisant SharePoint Management Shell (PowerShell). Les commandes sont Uninstall-SPUserSolution et Remove-SPUserSolution.

  • Sur l’ordinateur de développement, dans Visual Studio, vous pouvez exécuter toutes les étapes de désinstallation en sélectionnant Retirer la solution dans le menu Générer.

Mise à niveau d’une solution en bac à sable (sandbox)

Un administrateur de collection de sites met à niveau une solution en bac à sable (sandbox) en installant un nouveau package de solution en bac à sable (sandbox) (.wsp file) ayant le même ID de solution que la solution en bac à sable (sandbox) existante, mais un code de hachage différent.

Si la solution en bac à sable (sandbox) contient des fonctionnalités, les actions de mise à niveau des fonctionnalités sont également traitées. Pendant la mise à niveau, les définitions des fonctionnalités de la solution existante sont comparées aux définitions de fonctionnalités de la nouvelle solution. Les définitions de fonctionnalités existantes sont mises à niveau sur le site. Toutes les nouvelles définitions de fonctionnalités sont activées sur le site. (Les demandes entrantes pour la solution en bac à sable (sandbox) échouent pendant le processus de mise à jour.)

Notes

Un administrateur de batterie peut mettre à niveau une solution en bac à sable (sandbox) dans une collection de sites avec SharePoint Management Shell (PowerShell). La commande est Update-SPUserSolution (pasUpgrade-SPUserSolution).

Voir aussi

Concepts

Architecture des solutions en bac à sable (sandbox)

Qu'est-ce qui peut être implémenté dans une solution en bac à sable (sandbox) ?

Autres ressources

Solutions en mode bac à sable