Partager via

Dépannage des solutions SharePoint

  • Article

Les alertes ou problèmes suivants peuvent se produire lorsque vous déboguez des solutions SharePoint à l'aide du débogueur Visual Studio. Pour plus d'informations, consultez Debugging SharePoint Workflow Solutions.

Cette rubrique comprend les sections suivantes.

  • Restrictions de caractères dans les noms de projets et d'éléments de projet
  • Erreurs lors de la création de champs personnalisés
  • Les nouvelles définitions de site non anglaises ne s'affichent pas dans la page de création de site après le déploiement
  • Une erreur survient lors du déploiement d'un projet de flux de travail sur un système propre
  • L'utilisateur doit actualiser la page Application dans le navigateur lors du débogage pour afficher l'image mise à jour
  • Erreur : L'emplacement du site n'est pas valide
  • L'événement Web de suppression de site ne se produit pas dans le projet de récepteur d'événements
  • Une erreur de déploiement survient lorsque le nom d'un identificateur dans un projet de modèle de connectivité de données métiers est modifié
  • Une erreur survient lorsque vous essayez d'afficher un composant Visual Web Part dans SharePoint
  • Une erreur survient lorsqu'un flux de travail réutilisable importé qui contient un champ de formulaire Tâche est exécuté
  • Une erreur survient lorsqu'une instance de liste importée renommée est exécutée
  • Session de débogage SharePoint arrêtée par IIS
  • Le retrait automatique rend l'instance de liste orpheline dans SharePoint
  • La solution SharePoint d'origine est remplacée par une version exportée
  • Une erreur survient lors du démarrage du débogage
  • Rubriques connexes

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 admis.

Message d'erreur

Message d'erreur « Caractères non valides ».

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é Chemin d'accès du déploiement de chaque fichier déployé contient uniquement ces caractères valides.

Erreurs lors de la création de champs personnalisés

Les champs personnalisés dans Visual Studio 2010 sont définis dans XML. Si un champ n'est pas défini ou référencé dans un format spécifique, des erreurs peuvent se produire.

Message d'erreur

Message d'erreur « Caractères non valides » lors de l'empaquetage.

Solution

L'ID d'une définition de champ doit être un GUID entre accolades. Par exemple :

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Type="Note" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Group="A Custom Group">
</Field>.

Une référence de champ dans un type de contenu doit être définie à l'aide d'un format d'élément vide (<FieldRef />), et non d'éléments de début/fin (<FieldRef></FieldRef>). Par exemple :

<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 que le fichier XML n'est pas valide, l'erreur d'analyse du fichier survient.

Les nouvelles définitions de site non anglaises ne s'affichent pas dans 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 2010 (autrement dit, une version avec un ID de paramètres régionaux autre que 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 ne s'affiche pas dans la page Nouveau site SharePoint.

Message d'erreur

Aucun

Solution

Ce problème se produit en raison d'une valeur incorrecte dans la propriété Path pour le fichier de configuration de la définition de site WebTemp, tel que webtemp_SiteDefinitionProject1.xml. Dans la propriété Path pour le fichier WebTemp, situé sous Emplacement de déploiement, remplacez 1033 par l'ID de paramètres régionaux approprié. Par exemple, pour utiliser les paramètres régionaux japonais, remplacez la valeur par 1041. Pour plus d'informations, consultez Locale IDs Assigned by Microsoft sur le site Web MSDN.

Une erreur survient lors du déploiement d'un projet de flux de travail sur un système propre

Ce problème se produit si vous déployez un projet de flux de travail dans Visual Studio 2010 sur un système propre. Un système propre est un ordinateur avec une nouvelle installation de Visual Studio 2010 et SharePoint, sans aucun projet de flux de travail déployé.

Message d'erreur

Impossible de trouver la liste SharePoint : Historique de flux de travail.

Solution

Cette erreur se produit à cause d'un historique de flux de travail manquant. Étant donné que l'environnement de développement est un système propre, aucun flux de travail n'est déployé et l'historique de flux de travail n'existe pas encore. Pour résoudre ce problème, rouvrez l'Assistant Flux de travail afin de créer l'historique de flux de travail.

Pour ouvrir à nouveau l'Assistant Flux de travail

  1. Sélectionnez le nœud du flux de travail dans l'Explorateur de solutions.

  2. Dans la fenêtre Propriétés, cliquez sur le bouton de sélection (...) de n'importe quelle propriété.

L'utilisateur doit actualiser la page Application dans le navigateur lors du débogage pour afficher l'image mise à jour

Si vous déboguez une solution SharePoint qui contient une page d'application avec un contrôle affichant une image, tel qu'un contrôle Image HTML, vous devez actualiser la page dans le navigateur pour afficher toutes les modifications apportées à l'image.

Erreur : L'emplacement du site n'est pas valide

Ce problème peut se produire si SharePoint Server 2010 n'est pas installé. Il peut également se produire si vous ne disposez pas de l'accès administrateur au site Web SharePoint spécifié dans l'Assistant Personnalisation de SharePoint.

Message d'erreur

  • L'emplacement de site SharePoint entré n'est pas valide.

Solution

L'événement Web de suppression de site ne se produit pas 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 comme « un site est en cours de suppression », l'événement ne se produit jamais.

Message d'erreur

Aucun

Solution

Ce problème se produit car la portée de fonctionnalité doit être « Site » pour permettre la gestion des événements au niveau du site ; or, la portée de fonctionnalité par défaut des projets de récepteurs d'événements est « Web ». Les événements Web suivants sont affectés :

  • 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 résoudre le problème, modifiez la portée de fonctionnalité du récepteur d'événements comme suit.

Pour modifier la portée de fonctionnalité du récepteur d'événements

  1. Ouvrez la fonctionnalité du récepteur d'événements dans le Concepteur de fonctionnalités. Pour ce faire, double-cliquez sur son fichier .feature dans l'Explorateur de solutions.

  2. Cliquez sur la flèche de déroulement en regard de Portée.

  3. Sélectionnez Site dans la liste déroulante.

Une erreur de déploiement survient lorsque le nom d'un identificateur dans un projet de modèle de connectivité de données métiers est modifié

Ce problème survient si vous modifiez le nom d'identificateur d'une entité dans un modèle de connectivité de données métiers (BDC), puis tentez de déployer la solution.

Messages d'erreur

  • <nom de 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 de modèle>' est dupliquée...

Solution

Pour résoudre ce problème, supprimez le modèle manuellement, puis déployez de nouveau la solution. Vous pouvez supprimer le modèle à l'aide de l'un des outils suivants :

Une erreur survient lorsque vous essayez d'afficher un composant Visual Web Part dans SharePoint

Ce problème survient lorsque la propriété Chemin d'accès du contrôle utilisateur ne commence pas par la chaîne « CONTROLTEMPLATES\ ».

Messages d'erreur

  • Le fichier « /_CONTROLTEMPLATES/<nom de projet>/<nom de composant WebPart>/<nom de contrôle utilisateur>.ascx » n'existe pas.

  • Erreur de serveur dans l'application « / ».

Solution

Pour résoudre ce problème

  1. Dans l'Explorateur de solutions, sélectionnez le fichier du contrôle utilisateur. Le fichier porte l'extension de nom de fichier .ascx.

  2. Dans le menu Affichage, cliquez sur Fenêtre Propriétés.

  3. Dans la fenêtre Propriétés, développez le nœud Emplacement de déploiement.

  4. Vérifiez que la valeur de la propriété Chemin d'accès commence par la chaîne « CONTROLTEMPLATES\ »

Une erreur survient lorsqu'un flux de travail réutilisable importé qui contient un champ de formulaire Tâche est exécuté

Ce problème survient si vous importez un flux de travail qui contient un formulaire de tâche qui a un champ, puis exécutez le nouveau flux de travail sur le même système que celui à partir duquel vous l'avez importé.

Message d'erreur

Une erreur est survenue lors de l'étape de déploiement « Activer les fonctionnalités » : le champ avec l'ID [Guid] défini dans la fonctionnalité [Guid] a été trouvé dans la collection de sites actuelle ou dans un sous-site.

Solution

Cette erreur résulte de collisions d'ID de champs qui se produisent parce que le projet Importer le flux de travail réutilisable dans Visual Studio ne modifie pas les ID des champ de formulaire de la tâche. Si vous déployez un flux de travail importé sur le même serveur que celui qui contient le flux de travail d'origine, des collisions d'ID de champs se produisent.

Pour résoudre ce problème, utilisez la fonctionnalité Rechercher et remplacer pour modifier la valeur de l'attribut d'ID de champ dans tous les fichiers de flux de travail importés.

Une erreur survient lorsqu'une instance de liste importée renommée est exécutée

Ce problème se produit si vous renommez une instance de liste importée, puis l'exécutez dans Visual Studio.

Message d'erreur

Erreur de build : une erreur est survenue lors de l'étape de déploiement « Activer les fonctionnalités » : le fichier Template\Features \[import project feature name]\Files\Lists\[old list name]\Schema.xml n'existe pas.

Solution

Lorsque vous importez une instance de liste, un attribut nommé CustomSchema est ajouté au fichier Elements.xml de l'instance de liste. Le fichier Elements.xml inclut le chemin d'accès 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 pour le fichier schema.xml personnalisé est modifié, mais la valeur de chemin d'accès de l'attribut CustomSchema n'est pas mise à jour. Par conséquent, l'instance de liste ne peut pas trouver le fichier schema.xml dans l'ancien chemin d'accès spécifié par l'attribut CustomSchema lorsque la fonctionnalité est activée.

Pour résoudre ce problème, mettez à jour le chemin d'accès de l'emplacement de déploiement du fichier schema.xml dans l'attribut CustomSchema.

Session de débogage SharePoint arrêtée par IIS

Ce problème se produit si vous définissez un point d'arrêt dans une solution SharePoint Visual Studio, appuyez sur F5 pour l'exécuter, puis restez au point d'arrêt pendant plus de 90 secondes.

Message d'erreur

Le processus de serveur Web débogué a été arrêté par les Services Internet (IIS). Pour éviter que cette situation ne se présente, configurez les paramètres de ping du pool d'applications dans IIS. Pour plus d'informations, consultez l'aide.

Solution

Par défaut, le pool d'applications IIS ferme l'application après un délai d'attente de réponse de l'application de 90 secondes. Ce processus est appelé « envoyer un ping » à l'application. Pour résoudre ce problème, vous pouvez augmenter le temps d'attente ou complètement désactiver l'envoi de la commande ping à l'application.

Pour accéder aux paramètres du pool d'applications IIS

  1. Ouvrez le Gestionnaire des services Internet.

  2. Dans le volet Connexions, développez le nœud serveur SharePoint, puis cliquez sur Pools d'applications.

  3. Dans la page Pools d'applications, sélectionnez le pool d'applications SharePoint (en général « SharePoint - 80 »), puis, dans le volet Actions, cliquez sur Paramètres avancés.

  4. Pour augmenter le temps d'attente avant que les services Internet (IIS) n'expirent, modifiez la valeur de Temps de réponse maximum à un ping (secondes) par une valeur supérieure à 90 secondes.

  5. Pour désactiver l'envoi de ping à IIS, affectez la valeur False à Ping activé.

Le retrait automatique rend l'instance de liste orpheline dans SharePoint

Ce problème se produit si vous effectuez les étapes suivantes.

  1. Créez une définition de liste qui a une instance de liste dans Visual Studio 2010.

  2. Exécutez la solution en appuyant sur F5.

  3. Arrêtez le débogage ou fermez le site SharePoint.

  4. Rouvrez le site SharePoint et ouvrez l'instance de liste.

Message d'erreur

Erreur de serveur dans l'application « / ».

Solution

Cela se produit car, lorsque vous fermez une session de débogage d'une solution SharePoint, la fonctionnalité de retrait automatique supprime la solution. Le retrait supprime la définition de liste de SharePoint mais ne supprime pas l'instance de la liste. La définition de liste sous-jacente est requise par l'instance de liste.

Pour résoudre ce problème, dans le menu Générer, cliquez sur Déployer pour déployer la solution. (N'utilisez pas F5 pour la déboguer.) Ensuite, supprimez l'instance de liste dans SharePoint.

La solution SharePoint d'origine est remplacée par une version exportée

Si vous exportez une solution SharePoint, importez la solution dans Visual Studio, puis redéployez la solution sur le même site que celui à partir duquel 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

Solution

Pour éviter de remplacer une solution sur le site à partir duquel elle a été exportée, modifiez les GUID de SolutionID et les ID de fonctionnalité de toutes les fonctionnalités importées dans le projet Visual Studio.

Une erreur survient 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 un éventuel élément XML incorrect dans le fichier, et réessayez. L'erreur suivante s'est produite : la clé spécifiée n'était pas présente dans le dictionnaire.

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, cliquez sur Gestion d'applications dans l'utilitaire Administration centrale de SharePoint 2010, puis sur le lien Configurer les mappages des accès de substitution sous Applications Web. Pour plus d'informations, consultez Créer des zones pour les applications Web.

Voir aussi

Autres ressources

Dépannage de la création de packages et du déploiement SharePoint

Génération et débogage de solutions SharePoint

Débogage dans Visual Studio