Résoudre les problèmes de packaging et de déploiement SharePoint
Cette rubrique couvre différents problèmes que vous pouvez rencontrer lorsque vous empaquetez et déployez des solutions SharePoint.
Activer le débogage amélioré
Pour effectuer un diagnostic entre Visual Studio, SharePoint et d'autres couches, vous pouvez utiliser la clé de Registre EnableDiagnostics afin de consulter la trace de la pile. Pour plus d'informations, consultez Solutions de débogage SharePoint.
Ajouter la sortie de projet au package de solution
Vous pouvez ajouter la sortie de projet à un package via le Concepteur de packages. Toutefois, lorsque vous ajoutez la sortie de projet, assurez-vous que la plateforme du projet correspond à la plateforme de la solution SharePoint. Nous vous recommandons d'utiliser la plateforme cible Any CPU pour les assemblys que vous souhaitez déployer sur un serveur SharePoint. Pour plus d’informations, consultez Page de compilation, Concepteur de projets (Visual Basic) et Boîte de dialogue Paramètres du compilateur avancé (Visual Basic).
Erreurs et avertissements de validation
Les outils de développement SharePoint dans Visual Studio exécutent des étapes de validation pour vérifier que le package de solution est correctement formé. Vous pouvez également créer des étapes de validation personnalisées pour vos fonctionnalités et vos packages. Pour plus d’informations, consultez Guide pratique pour créer des règles de validation de fonctionnalité et de package personnalisées pour les solutions SharePoint.
Résolution de conflit de déploiement
Lorsque vous déployez une solution SharePoint, vous pouvez être confronté à des collisions lorsqu'un élément sur le serveur a un nom, une URL ou un ID identique à celui ou celle d'un élément dans votre package de solution. Vous pouvez modifier la propriété Deployment Conflict Resolution pour résoudre, signaler ou ignorer des collisions relatives aux modules, aux composants WebPart, aux instances de listes et aux types de contenu.
Le tableau suivant indique les paramètres pour la propriété Deployment Conflict Resolution.
| Valeur | Description |
|---|---|
| Automatique | Détecte les collisions et résout automatiquement les conflits. |
| Prompt | Détecte les collisions et les signale au développeur avant de résoudre les conflits. |
| None | Ne détecte pas les collisions. |
Différences entre le déploiement F5
Lorsque vous utilisez Visual Studio pour déployer votre projet SharePoint sur le serveur SharePoint local à des fins de test et de débogage, Visual Studio exécute des opérations supplémentaires.
Réinitialisation des services IIS (Internet Information Services) pendant l'étape de déploiement.
Association automatique des flux de travail.
Définition de l’ordre d’activation des fonctionnalités en fonction de la hiérarchie du Concepteur de packages.
Vous pouvez ajouter des étapes de déploiement personnalisées pour modifier davantage le comportement F5. Pour obtenir un exemple, consultez Procédure pas à pas : Créer une étape de déploiement personnalisée pour des projets SharePoint.
Différer l'affichage de la page SharePoint lors du déploiement d'un composant Visual Web Part
L'affichage de la page SharePoint prend un certain temps lors du déploiement d'un composant Visual Web Part dans le dossier Bin sur Windows Vista, Windows 7 ou Windows Server 2008. Si vous modifiez des fichiers dans un répertoire ASP.NET de niveau supérieur, tel que le répertoire bin, l'application Web entière est recompilée. Cela peut différer de 25 secondes le rendu de la page SharePoint.
Message d’erreur
Aucun.
Résolution
Pour contourner ce problème, exécutez les étapes suivantes :
Installez la mise à jour KB967535 comme indiqué dans l'article du support technique Microsoft CORRECTIF : Un correctif est disponible pour résoudre deux problèmes dans ASP.NET sur IIS 7.0 pour Windows Vista et Windows Server 2008.
Ajoutez la ligne suivante au fichier Web.config :
<compilation batch="false" optimizeCompilations="true">
Le déploiement du projet SharePoint échoue avec l'erreur « Échec de l'extraction du fichier .cab dans la solution »
Si le nom d'un élément de projet SharePoint quelconque contient des parenthèses, le déploiement de la solution associée échoue avec une erreur.
Message d’erreur
Une erreur s'est produite lors de l'étape de déploiement 'Ajouter une solution' : Échec de l'extraction du fichier .cab dans la solution.
Résolution
Pour résoudre ce problème, supprimez les parenthèses dans les noms d'éléments de projet SharePoint.
Une erreur survient lors du déploiement d'un élément Visual Web Part sur un site d'une autre application Web
La première fois que vous déployez un élément Visual Web Part sur un site d'une application Web autre que celle dans laquelle il est actuellement déployé (en modifiant la propriété SiteUrl de l'élément Visual Web Part), vous obtenez une erreur.
Message d’erreur
Une erreur s'est produite lors de l'étape de déploiement 'Ajouter une solution' : Une fonctionnalité avec l'ID [#] a déjà été installée dans cette batterie de serveur. Utilisez l’attribut force pour installer à nouveau la fonctionnalité de façon explicite.
Résolution
Cette erreur est due au mode de retrait des fonctionnalités d'éléments Visual Web Part dans SharePoint. Pour déployer correctement le composant Visual Web Part, déployez de nouveau la solution en choisissant la touche F5.
Un avertissement s'affiche lors du déploiement de contrôles utilisateur imbriqués
Cet avertissement se produit lorsque vous déployez une solution SharePoint qui contient des contrôles utilisateur imbriqués, tels qu'un composant Visual Web Part qui contient un contrôle utilisateur ou un contrôle utilisateur qui contient un composant Visual Web Part ou un autre contrôle utilisateur. Cet avertissement se produit si vous ajoutez un contrôle à un concepteur en le faisant glisser à partir de la Boîte à outils ou en utilisant la directive @Register dans le mode Source.
Message d’erreur
Avertissement 1 L'élément '[Control Name]' n'est pas un élément connu. Ceci peut se produire s'il existe une erreur de compilation dans le site Web ou si le fichier Web.config est manquant.
Résolution
Si le système de projet Visual Studio n'est pas informé de la présence d'un contrôle utilisateur imbriqué, il ne peut pas fournir IntelliSense et il émet l'avertissement. Le système de projet ignore la présence d'un contrôle utilisateur imbriqué si le projet n'est pas généré et que le concepteur n'est pas fermé et rouvert, ou si l'option de retrait automatique est activée, ce qui entraîne le retrait du contrôle utilisateur de la ruche SharePoint après le débogage.
Pour supprimer cet avertissement, générez le projet puis fermez et rouvrez le concepteur, ou désactivez l'option de retrait automatique pour le projet. Pour ce faire, désactivez la case à cocher Retrait automatique après le débogage dans l'onglet SharePoint de la boîte de dialogue des propriétés du projet.