Dépannage des solutions SharePoint

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 symboliques aux composants visual bac à sable (sandbox)
• 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
• L'erreur apparaît lorsque le débogage commence
• Rubriques connexes

Restrictions symboliques aux composants visual bac à sable (sandbox)

Les parties visuelles de site Web dans les solutions bac à sable (sandbox) ne peut pas traiter le standard, telles que $SPUrl, ce le runtime prend en charge SharePoint.Par conséquent, l'URL n'est pas corrigé, et vous ne pouvez pas afficher un aperçu de le contenu en mode Design dans le concepteur visuel WebPart si vous faites référence à est directement dans un élément de script, comme dans l'exemple suivant :

<script src=”<% $SPUrl:~site/SiteAssets/ListOperations.js %>"></script>

Pour contourner cette limitation et résoudre le jeton, reportez -vous à celui-ci à l'aide de les littéraux :

<asp:literal ID="Literal1" runat="server" Text="&lt;script src='" />
<asp:literal ID="Literal2" runat="server" Text="<% $SPUrl:~site/SiteAssets/ListOperations.js %>" />
<asp:literal ID="Literal3" runat="server" Text="' type='text/javascript' &gt;&lt;/script&gt;" />

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

Résolution

Pour les noms de projets sharepoint et des éléments de projet, 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 de déploiement pour chaque fichier que vous déployez contient uniquement les caractères valides.

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

Dans Visual Studio, les champs personnalisés sont définis dans XML.Des erreurs peuvent se produire si un champ n'est pas défini ou n'est pas référencé à l'aide d'un format spécifique.

Message d'erreur

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

Résolution

L'ID d'une définition de champ doit être un GUID entouré par des accolades, comme indiqué 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 dans un type de contenu doit être définie à l'aide de le format élément vide (<FieldRef />), et non à l'aide de début/des éléments de fin (<FieldRef></fieldref>) :

<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE"/>

Si la source XML pour le champ n'est pas valide, n'est pas un fichier XML valide, ou montre un autre problème, l'erreur « impossible analyser le fichier » se produit.

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 avoir créé et déployer une définition de site à l'aide d'une version non anglaise d' Visual Studio (autrement dit, une version avec les paramètres régionaux ID autre que 1033), l'onglet Personnalisations SharePoint ne s'affiche pas dans la zone Sélection de modèle et le modèle de site ne s'affiche pas dans la page nouveau site SharePoint .

Message d'erreur

Aucun

Ré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 sur un système propre.Un système propre est un ordinateur qui a une nouvelle installation d' Visual Studio et SharePoint mais aucun projet de flux de travail déployés.

Message d'erreur

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

Ré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. Dans Explorateur de solutions, sélectionnez le nœud de flux de travail.

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

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.

Résolution

• Installez SharePoint Server 2010.

• Vérifiez que vous pouvez accéder au site Web SharePoint en tant qu'administrateur.Pour plus d'informations, consultez l'article en ligne Office Octroi d'autorisations d'accès au site portail (page éventuellement en anglais).

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

Ré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. Dans Explorateur de solutions, ouvrez le fichier .feature du du récepteur d'événements dans Concepteur de fonctionnalités en double-cliquant sur le fichier ou en ouvrant le menu contextuel puis choisissez Ouvrir.

2. Cliquez sur la flèche en regard portée, puis choisissez site dans la liste qui apparaît.

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

Ré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 :

• Administration centrale de SharePoint 2010.Pour plus d'informations, consultez Gérer les modèles BDC (SharePoint Server 2010) sur le site Web Microsoft TechNet.

• Windows PowerShell.Vous pouvez supprimer le modèle en tapant cette commande à l'invite de commandes : Remove-SPBusinessDataCatalogModel.Pour plus d'informations, consultez Applets de commande générales (SharePoint Server 2010) sur le site Web Microsoft TechNet.

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 « / ».

Résolution

Pour résoudre ce problème

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

2. Dans la barre de menus, sélectionnez Affichage, Fenêtre Propriétés.

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

4. Assurez-vous 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.

Ré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 projectfeaturename]\Files\Lists\[oldlist name]\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.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 d' Visual Studio , sélectionne la touche F5 pour l'exécuter, puis reste à plus longues que 90 secondes d'un point d'arrêt.

Message d'erreur

Le processus de serveur Web débogué a été arrêté par les Services Internet (IIS).Vous pouvez éviter ce problème en configurant des paramètres de ping du pool d'applications dans IIS.Pour plus d'informations, consultez l'aide.

Ré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 sélectionnez le nœud 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 le lien paramètres avancés .

4. Pour augmenter le temps d'attente avant délai d'attente IIS, remplacez la valeur Cinglez le temps de réponse max (les secondes) en 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.

2. Choisissez la touche F5 pour exécuter la solution.

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 « / ».

Ré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, déployez la solution par, dans la barre de menus, choisissant Générer, Déployer.(Ne mettez pas à déboguer la solution en choisissant la touche F5.) 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

Ré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.

L'erreur apparaît lorsque le débogage commence

Lorsque vous commencez à déboguer une solution SharePoint dans Visual Studio, une erreur indique que Visual Studio ne peut pas charger le fichier Web.config parce que la clé spécifiée n'était pas 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.

Résolution

Pour résoudre ce problème, assurez -vous que la valeur de propriété URL du site du projet SharePoint dans Visual Studio correspond à l'URL qui est assigné à la zone par défaut pour les mappages des accès de l'application Web.Vous ne pouvez pas résoudre l'erreur en utilisant une autre zone, telle que l'intranet, pour l'URL.L'URL du site du projet et l'URL dans la zone par défaut doivent correspondre.Pour accéder à d'autres mappages d'accès, ouvrez l'utilitaire Administration centrale de SharePoint 2010, choisissez le lien Gestion des applications , puis, sous applications Web, cliquez sur le lien Configurez les mappages des accès .Pour plus d'informations, consultez Créer des zones pour les applications Web.

Voir aussi

Concepts

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

Autres ressources

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

Débogage dans Visual Studio