Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 :
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 true la valeur est , elle est effectuée par Microsoft. Si false la 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.
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.
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.