Partager via


Mode maintenance des composants WebPart côté client

Quand vous travaillez avec des composants WebPart côté client, vous pouvez les charger en mode maintenance. Le mode maintenance peut s’avérer utile quand vous tentez de déboguer les problèmes liés aux composants WebPart placés sur la page.

Basculer en mode maintenance

Remarque

Pour charger une page en mode maintenance, vous devez bénéficier d’autorisations de modification sur cette page.

Pour basculer vers le mode maintenance, accédez à la page et dans l’URL ajoutez ?maintenancemode=true, par exemple :

https://contoso.sharepoint.com/sites/team?maintenancemode=true

Pour quitter le mode maintenance, supprimez ?maintenancemode=true de l’URL et rechargez la page.

Informations disponibles

Le mode maintenance présente des informations diverses sur chaque composant WebPart de la page.

Résumé du composant WebPart

En mode maintenance, les informations récapitulatives suivantes s’affichent pour chaque composant WebPart :

Informations résumées sur un composant WebPart affichées en mode maintenance

Propriété Description
Alias Alias de composant WebPart.
ID ID unique du composant WebPart.
InstanceId L’ID d’un instance spécifique d’un composant WebPart (autrement dit, si vous avez deux autres composants WebPart identiques sur une page, ils auront chacun le même ID de composant WebPart, mais un ID instance différent.
IsInternal Indique si le composant WebPart a été créé par Microsoft ou un tiers. Si truela valeur est , elle est effectuée par Microsoft. Si falsela valeur est , elle est effectuée par un tiers.
Version Numéro de version du composant WebPart.
Environnement Énumération indiquant l’environnement dans lequel le composant WebPart est en cours d’exécution. Valeurs possibles : 1 - Workbench local, 2 -SharePoint
UserAgent Chaîne qui contient des informations sur l’appareil et le logiciel en cours d’utilisation (par exemple, le type de navigateur et la version).

Manifeste de composant WebPart

Pour plus d’informations sur le composant WebPart, sélectionnez l’onglet Manifeste.

Informations de manifeste de composant Web affichées en mode maintenance

En explorant les informations de manifeste, vous obtenez des détails sur :

  • l’emplacement d’hébergement du groupe de composants WebPart
  • quels scripts externes sont chargés par le composant WebPart et d’où
  • la version de SharePoint Framework sur laquelle le composant WebPart a été développé
  • les composants de SharePoint Framework utilisés par le composant WebPart

Ces informations s’avèrent particulièrement utiles lorsque vous recherchez le motif du dysfonctionnement d’un composant WebPart spécifique.

Données de composant WebPart

Les données de composant WebPart sont un autre élément d’information disponible en mode maintenance.

Données de composant WebPart affichées en mode maintenance

Les informations de l’onglet Données permettent de voir la configuration de chaque composant WebPart. Cela est utile lorsque vous essayez de reproduire les erreurs signalées par les utilisateurs qui peuvent être provoquées par une configuration de composant WebPart spécifique.

Si le composant WebPart intègre ses propriétés avec SharePoint, la section Données affiche les types et les valeurs transmis à SharePoint pour poursuivre le traitement.

Considérations

  • Le mode maintenance fonctionne pour les composants WebPart côté client placés sur les pages SharePoint modernes et classiques. Pour plus d’informations sur l’ouverture des composants WebPart classiques en mode maintenance, consultez l’article de support Ouvrir et utiliser la page de maintenance .
  • Pour ouvrir une page en mode maintenance, vous devez disposer des autorisations de modification pour cette page
  • En mode maintenance, le code du composant WebPart n’est pas exécuté et vous ne pouvez pas modifier les propriétés du composant WebPart.
  • En mode maintenance, vous pouvez supprimer ou déplacer des composants WebPart sur la page.
  • Le mode maintenance affiche uniquement des informations sur les composants WebPart. Vous ne pouvez pas l’utiliser pour afficher des informations sur SharePoint Framework extensions exécutées sur la page.
  • Le passage en mode maintenance désactive uniquement l’exécution du code du composant WebPart. Toutes les extensions SharePoint Framework inscrites sur la page s’exécutent toujours.

Désactiver les composants WebPart et les extensions SPFx

Si vous devez résoudre les problèmes d’une page SharePoint pour voir s’il existe une extension SharePoint Framework ou un composant WebPart à l’origine de problèmes, vous pouvez ajouter ?disable3PCode à l’URL pour désactiver le chargement des composants SPFx, par exemple :

https://contoso.sharepoint.com/sites/team?disable3PCode

Cela empêchera le chargement de composants SPFx tiers sur la page.

Voir aussi