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

Notes

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 append ?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, pour chaque partie Web, vous verrez les informations récapitulatifs suivantes :

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’une instance spécifique d’un composant Web Part (c’est-à-dire, si vous avez deux autres composants Web Part sur une page, ils auront chacun le même ID de composant Web Part, mais un ID d’instance différent.
IsInternal Indique si le composant WebPart a été créé par Microsoft ou un tiers. Si true , il est effectué par Microsoft. Si false , il est effectué 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 le chargement du web part et à partir de quel endroit
  • 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 des erreurs signalées par des utilisateurs qui peuvent être causées par une configuration de partie Web Part 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 Web Parts côté client placés à la fois sur des pages SharePoint modernes et classiques. Consultez l’article de prise en charge de la page Ouvrir et utiliser la maintenance des composants Web Part pour obtenir plus d’informations sur l’ouverture de composants Web Part classiques en mode maintenance.
  • Pour ouvrir une page en mode maintenance, vous devez avoir des autorisations de modification pour cette page.
  • En mode maintenance, le code du site Web Part n’est pas en cours d’exécution et vous ne pouvez pas modifier les propriétés de ce dernier.
  • En mode maintenance, vous pouvez supprimer ou déplacer des composants Web Parts sur la page.
  • Le mode maintenance affiche uniquement des informations sur les composants Web Parts. Vous ne pouvez pas l’utiliser pour afficher des informations sur les extensions SharePoint Framework qui sont exécutées sur la page.
  • Le passage en mode maintenance désactive uniquement l’exécution du code de partie Web. Toutes SharePoint Framework extensions enregistrées sur la page continuent de s’exécuter.

Désactiver les SPFx web et les extensions

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

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

Cela empêche le chargement des composants SPFx tiers sur la page.

Voir aussi