Résolution des problèmes des solutions SharePoint
Les problèmes et alertes suivants peuvent se produire lorsque vous déboguez des solutions SharePoint à l’aide du débogueur Visual Studio. Pour plus d’informations, consultez Déploiement de solutions de flux de travail SharePoint 2007.
Restrictions des jetons dans les composants WebPart visuels sandbox
Les composants Visual WebPart de solutions bac à sable ne peuvent pas traiter les jetons standard, tels que $SPUrl, que le runtime SharePoint prend en charge. Par conséquent, l'URL n'est pas résolue et vous ne pouvez pas avoir d'aperçu du contenu en mode Design du concepteur de composants Visual WebPart si vous y faites référence directement dans un élément de script, tel que dans l'exemple suivant :
<script src="<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>
Pour contourner cette limitation et résoudre le jeton, faites-y référence à l'aide des littéraux :
<asp:literal ID="Literal1" runat="server" Text="<script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' ></script>" />
Restrictions de caractères dans les noms de projets et d’éléments de projet
Les noms de projets et d'éléments de projet peuvent contenir uniquement des caractères qui sont valides dans un chemin de déploiement dans SharePoint 2010. Aucun autre caractère n’est autorisé.
Message d’erreur
Message d’erreur « Caractères non valides ».
Résolution
Pour les noms de projets et d'éléments de projet SharePoint, utilisez uniquement les caractères suivants :
Caractères ASCII alphanumériques
Espace
Point (.)
Virgule (,)
Trait de soulignement (_)
Tiret (-)
barre oblique inverse (\)
Lorsqu'un projet est empaqueté, une règle de validation vérifie que la propriété du chemin d'accès de déploiement de chaque fichier déployé contient uniquement ces caractères valides.
Erreurs à la création de champs personnalisés
Dans Visual Studio, les champs personnalisés sont définis en XML. Des erreurs peuvent survenir si un champ n'est pas défini, ni référencé à l'aide d'un format spécifique.
Message d’erreur
Message d’erreur « Caractères non valides » au moment de la création d’un package.
Résolution
L'ID d'une définition de champ doit être un GUID délimité par des accolades, comme dans l'exemple suivant :
<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Type="Note"
Name="PatientName"
DisplayName="Patient Name"
Group="A Custom Group">
</Field>.
Comme le montre l’exemple suivant, une référence de champ doit être définie dans un type de contenu suivant le format d’élément vide (<FieldRef />), et non avec des éléments de début et de fin (<FieldRef></FieldRef>) :
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}"
Name="PatientName"
DisplayName="Patient Name"
Required="TRUE"/>
En cas de problème avec le code XML source pour le champ, par exemple s'il est incorrect ou si le fichier XML n'est pas valide, l'erreur d'analyse "Impossible d'analyser le fichier" du fichier survient.
Absence des nouvelles définitions de site non anglaises sur la page de création de site après le déploiement
Après la création et le déploiement d’une nouvelle définition de site à l’aide d’une version non anglaise de Visual Studio (autrement dit une version dont l’ID de paramètres régionaux est différent de 1033), l’onglet Personnalisations de SharePoint ne s’affiche pas dans la zone Sélection du modèle, et le modèle du nouveau site n’apparaît pas sur la page Nouveau site SharePoint.
Message d’erreur
Aucun.
Résolution
Ce problème se produit en présence d’une valeur incorrecte dans la propriété Path du fichier de configuration de définition du site webtemp, par exemple webtemp_SiteDefinitionProject1.xml. Dans la propriété Path du fichier webtemp, située sous l’Emplacement de déploiement, remplacez 1033 par l’ID de paramètres régionaux approprié (par exemple 1041 pour le japonais). Pour plus d'informations, consultez Locale IDs Assigned by Microsoft (en anglais).
Erreur lorsqu’un projet de flux de travail est déployé sur un système propre
Ce problème se produit si vous déployez un projet de flux de travail dans Visual Studio sur un système propre. Un système propre consiste en un ordinateur possédant une nouvelle installation de Visual Studio et de SharePoint, sans aucun projet de flux de travail déployé.
Message d’erreur
Impossible de trouver la liste SharePoint : Historique des flux de travail.
Résolution
Cette erreur se produit en l’absence de la liste Historique des flux de travail. Étant donné que l’environnement de développement est un système propre, aucun flux de travail n’est déployé. La liste Historique des flux de travail n’existe donc pas encore. Pour résoudre ce problème, rouvrez l’Assistant Flux de travail. Cette action entraîne la création de la liste Historique des flux de travail.
Retour à l’Assistant Flux de travail
Dans l’Explorateur de solutions, choisissez le nœud du flux de travail.
Dans la fenêtre Propriétés, choisissez le bouton de sélection (…) de n’importe quelle propriété en comportant un.
Nécessité pour l’utilisateur d’actualiser la page de l’application dans le navigateur lors du débogage pour afficher l’image mise à jour
Si vous déboguez une solution SharePoint contenant une page d’application dont un contrôle affiche une image (par exemple un contrôle d’image HTML), vous devez actualiser la page dans le navigateur pour afficher les modifications apportées à l’image.
Erreur : emplacement du site non valide
Ce problème peut se produire si SharePoint Server n’est pas installé, ou si vous ne disposez pas d’un accès administrateur au site web SharePoint spécifié dans l’Assistant Personnalisation de SharePoint.
Message d’erreur
- L’emplacement du site SharePoint n’est pas valide.
Résolution
Installez SharePoint Server.
Vérifiez que vous disposez d’un accès administrateur au site web SharePoint. Pour plus d’informations, consultez l’article Office Online Affectation et suppression des administrateurs d’applications de service dans SharePoint Server.
Absence de déclenchement de l’événement web de suppression de site dans le projet de récepteur d’événements
Lorsque vous créez un projet de récepteur d’événements et que vous sélectionnez certains événements web tels que « un site est en cours de suppression », l’événement ne se produit jamais.
Message d’erreur
Aucun.
Résolution
Ce problème se produit parce que l’étendue des fonctionnalités doit être « Site » pour gérer les événements au niveau du site, tandis que l’étendue par défaut pour les projets de récepteur d’événements est « Web ». Les événements web affectés sont les suivants :
Un site est en cours de suppression (WebDeleting).
Un site a été supprimé (WebDeleted).
Un site est en cours de déplacement (WebMoving).
Un site a été déplacé (WebMoved).
Pour corriger le problème, modifiez comme suit l’étendue des fonctionnalités du récepteur d’événements.
Modification de l’étendue des fonctionnalités du récepteur d’événements
Dans l’Explorateur de solutions, ouvrez le fichier .feature du récepteur d’événements dans le Concepteur de fonctionnalités. Pour cela, double-cliquez sur le fichier ou ouvrez son menu contextuel, puis choisissez Ouvrir.
Sélectionnez la flèche en face de Étendue, puis choisissez Site dans la liste qui s’affiche.
Erreur de déploiement après modification du nom d’un identificateur dans un projet de modèle Business Data Connectivity
Ce problème se produit si vous modifiez le nom d’identificateur d’une entité dans un modèle BDC (Business Data Connectivity), puis que vous essayez de déployer la solution.
Messages d’erreur
<nom du modèle> comporte les erreurs d’activation de type de contenu externe suivantes…
La valeur du champ « name » de l’objet IMetadataObject portant le nom « <nom du modèle> » est dupliquée…
Résolution
Pour résoudre ce problème, supprimez manuellement le modèle, puis redéployez la solution. Pour supprimer le modèle, utilisez l’un des outils suivants :
Administration centrale de SharePoint 2010. Pour plus d’informations, consultez Gestion des modèles BDC sur le site web Microsoft TechNet.
Windows PowerShell. Pour supprimer le modèle, tapez la commande Remove-SPBusinessDataCatalogModel dans l’invite de commandes. Pour plus d’informations, consultez Cmdlets générales (SharePoint Server 2010) sur le site web Microsoft TechNet.
Erreur de déploiement lors d’une tentative de recyclage du pool d’applications IIS sur SharePoint Server
Ce problème se produit si la fonctionnalité de compatibilité IIS 6 WMI et .NET Framework 3.5 ne sont pas installés sur l’ordinateur SharePoint Server.
Messages d’erreur
- Une erreur s’est produite lors de l’étape de déploiement « Recycler le pool d’applications IIS » : Espace de noms non valide.
- Une erreur s’est produite lors de l’étape de déploiement « Recycler le pool d’applications IIS » : Une tâche a été annulée.
Résolution
Pour résoudre ce problème, vérifiez si la fonctionnalité Windows Compatibilité IIS 6 WMI est installée sur l’ordinateur SharePoint Server :
- Windows PowerShell. Pour vérifier si la fonctionnalité est installée, exécutez la commande PowerShell get-windowsfeature -name Web-WMI. Si elle n’apparaît pas comme étant installée, vous pouvez l’installer en exécutant la commande PowerShell install-windowsfeature -name Web-WMI. Si vous voyez toujours des erreurs lorsque vous tentez de recycler le pool d’applications, vérifiez que .NET Framework 3.5 est également installé sur l’ordinateur en exécutant get-windowsfeature -name NET-Framework-Core et install-windowsfeature -name NET-Framework-Core si ce n’est pas le cas.
Erreur lors d’une tentative d’affichage d’un composant WebPart visuel dans SharePoint
Ce problème se produit lorsque la propriété Path du contrôle utilisateur ne commence pas par la chaîne « CONTROLTEMPLATES\ ».
Messages d’erreur
Le fichier « /_CONTROLTEMPLATES/<nom du projet>/<Nom du composant WebPart>/<nom du contrôle utilisateur >.ascx » n’existe pas.
Erreur de serveur dans l’application « / ».
Résolution
Pour résoudre ce problème
Dans l’Explorateur de solutions, choisissez le fichier de contrôle utilisateur, dont l’extension de nom de fichier est .ascx.
Dans la barre de menus, choisissez Affichage>Fenêtre Propriétés.
Dans la fenêtre Propriétés, développez le nœud Emplacement de déploiement.
Vérifiez que la valeur de la propriété Path commence par la chaîne « CONTROLTEMPLATES\ ».
Erreur lorsqu’un flux de travail réutilisable importé contenant un champ de formulaire de tâche est exécuté
Ce problème se produit si vous importez un flux de travail contenant un formulaire de tâche qui comporte un champ, puis exécutez le nouveau flux de travail sur le système à partir duquel vous l’avez importé.
Message d’erreur
Une erreur s’est produite lors de l’étape de déploiement « Activer les fonctionnalités » : Le champ associé à l’ID [GUID] défini dans la fonctionnalité [GUID] a été trouvé dans la collection de sites actuelle ou dans un sous-site.
Résolution
Cette erreur est le résultat de collisions d’ID de champ qui se produisent parce que le projet Importer un flux de travail réutilisable de Visual Studio ne modifie pas l’ID de champ des formulaires de tâche. Si vous déployez un flux de travail importé sur le serveur qui contient le flux de travail d’origine, des conflits d’ID de champ se produisent.
Pour résoudre ce problème, utilisez la fonctionnalité Rechercher et remplacer afin de modifier la valeur de l’attribut ID de champ dans tous les fichiers de flux de travail importés.
Erreur à l’exécution d’une instance de liste importée renommée
Ce problème se produit si vous renommez une instance de liste importée et que vous l’exécutez dans Visual Studio.
Message d’erreur
Erreur de build : Une erreur s’est produite à l’étape de déploiement « Activer les fonctionnalités » : Le fichier Template\Features\[nom de la fonctionnalitédu projetd’importation]\Files\Lists\[nomde l’ancienne liste]\Schema.xml n’existe pas.
Résolution
Lorsque vous importez une instance de liste, un attribut nommé CustomSchema est ajouté au fichier Elements.xml de l’instance de liste. Elements.xml inclut le chemin d’un fichier schema.xml personnalisé pour l’instance de liste. Lorsque vous renommez l’instance de liste dans Visual Studio, le chemin de déploiement du fichier schema.xml personnalisé change, mais la valeur du chemin de l’attribut CustomSchema n’est pas mise à jour. Par conséquent, l’instance de liste ne trouve pas le fichier schema.xml dans l’ancien chemin spécifié par l’attribut CustomSchema lorsque la fonctionnalité est activée.
Pour résoudre ce problème, mettez à jour le chemin de l’emplacement de déploiement du fichier schema.xml dans l’attribut CustomSchema.
Interruption de la session de débogage SharePoint par IIS
Ce problème se produit si vous définissez un point d’arrêt dans une solution SharePoint Visual Studio, que vous appuyez sur F5 pour l’exécuter, puis que vous restez au point d’arrêt pendant plus de 90 secondes.
Message d’erreur
Le processus de serveur web en cours de débogage a été interrompu par Internet Information Services (IIS). Pour éviter que cette situation ne se présente, configurez les paramètres Ping du pool d'applications dans IIS. Pour plus d’informations, consultez l’aide.
Résolution
Par défaut, le pool d’applications IIS attend pendant 90 secondes que l’application réponde avant de la fermer. Ce processus est appelé « test Ping » de l’application. Pour résoudre ce problème, vous pouvez augmenter le temps d’attente ou désactiver entièrement le test Ping des applications.
Accès aux paramètres du pool d’applications IIS
Ouvrez le Gestionnaire des services IIS.
Dans le volet Connexions, développez le nœud serveur SharePoint, puis choisissez le nœud Pools d’applications.
Choisissez le pool d’applications SharePoint (en général « SharePoint – 80 ») sur la page Pools d’applications, puis sélectionnez le lien Paramètres avancés dans le volet Actions.
Pour augmenter le temps d’attente avant l’expiration d’IIS, remplacez la valeur de Temps de réponse maximal à un test Ping (en secondes) par une valeur supérieure à 90 secondes.
Pour désactiver le test Ping IIS, définissez Test Ping activé sur Faux.
Instance de liste orpheline dans SharePoint après retrait automatique
Ce problème se produit si vous procédez comme suit.
Créez une définition de liste comportant une instance de liste dans Visual Studio.
Sélectionnez la touche F5 pour exécuter la solution.
Arrêtez le débogage ou fermez le site SharePoint.
Rouvrez le site SharePoint et ouvrez l’instance de liste.
Message d’erreur
Erreur de serveur dans l’application « / ».
Résolution
Ce problème se produit parce que, après la fermeture d’une session de débogage d’une solution SharePoint, la fonctionnalité de retrait automatique retire la solution. Ce retrait a pour effet de supprimer de SharePoint la définition de liste, mais pas l’instance de la liste. Or, la définition de liste sous-jacente est requise par l’instance de liste.
Pour résoudre ce problème, choisissez Générer>Déployer dans la barre de menus pour déployer la solution (ne déboguez pas la solution en sélectionnant la touche F5). Ensuite, supprimez l’instance de liste dans SharePoint.
Remplacement de la solution SharePoint d’origine par une version exportée
Si vous exportez une solution SharePoint, que vous l’importez dans Visual Studio, puis que vous la redéployez sur le site dont elle a été exportée, la solution SharePoint d’origine est remplacée. Ce problème ne se produit pas si vous déployez la solution sur un serveur sur lequel la solution d’origine n’est pas activée.
Message d’erreur
Aucun.
Résolution
Pour éviter de remplacer la solution sur le site dont elle a été exportée, modifiez les GUID de l’ID de solution et l’ID de toutes les fonctionnalités importées dans le projet Visual Studio.
Erreur lors du démarrage du débogage
Lorsque vous commencez à déboguer une solution SharePoint dans Visual Studio, vous obtenez une erreur indiquant que Visual Studio n'a pas pu charger le fichier de configuration Web.config parce que la clé spécifiée n'était pas présente dans le dictionnaire.
Message d’erreur
Impossible de charger le fichier de configuration Web.config. Recherchez dans le fichier tous les éléments XML mal formés, puis réessayez. L’erreur suivante s’est produite : la clé donnée n’était pas présente dans le dictionnaire.
Résolution
Pour résoudre ce problème, assurez-vous que la valeur de la propriété URL du site du projet SharePoint dans Visual Studio correspond à l'URL attribuée à la zone par défaut pour les mappages des accès de substitution de l'application Web. L'utilisation d'une autre zone, telle que l'Intranet, pour l'URL ne résout pas l'erreur. La propriété URL du site du projet et l'URL de la zone par défaut doivent être identiques. Pour accéder aux mappages des accès de substitution, ouvrez l’utilitaire Admission Centrale SharePoint 2010 et sélectionnez le lien Gestion des applications, puis le lien Configurer les mappages des accès de substitution sous Applications web. Pour plus d’informations, consultez Création de zones pour les applications web.