Actions personnalisées dans le modèle SharePoint de l’entreprise
Résumé
L’approche que vous proposez pour modifier les menus des éléments de liste et le ruban dans SharePoint est différente dans le nouveau modèle de SharePoint par rapport au code de confiance totale. Dans un scénario classique de code de confiance totale /solution de batterie de serveurs, les menus des éléments de liste et les modifications du ruban étaient définis en XML (actions personnalisées), empaquetés dans des fonctionnalités et déployés via SharePoint Solutions.
Dans un scénario de modèle de SharePoint, vous utilisez le modèle objet côté client SharePoint (CSOM) ou l’API REST pour créer des actions personnalisées qui modifient les menus des éléments de liste et le ruban. Ce modèle est souvent appelé le motif mise en service à distance.
Conseils généraux
En règle générale, nous voulons fournir les instructions générales suivantes pour la création et le déploiement d’actions personnalisées dans le nouveau modèle de SharePoint.
- Les actions personnalisées peuvent être utilisées pour modifier les menus des éléments de liste et le ruban.
- Vous ne pouvez pas masquer les éléments de menu à l’aide d’une action personnalisée directement à partir d’un add-in qui implémente une action personnalisée.
- Cela est dû au fait que l’élément HideCustomAction Element (documentation de l’API MSDN) n’est pas disponible dans le modèle objet client SHAREPOINT ECMA - Propriétés UserCustomAction (documentation de l’API MSDN)ou les API REST SharePoint/Office 365 - SP. Objet UserCustomActionCollection (sp.js) (documentation de l’API MSDN).
- Si vous devez masquer des éléments de menu, vous devez utiliser une action personnalisée pour incorporer JavaScript ou CSS personnalisé dans SharePoint pages. JavaScript ou CSS incorporé dans les pages SharePoint masque l’élément de menu.
- Utilisez le SharePoint modèle objet côté client (CSOM) et/ou les API REST SharePoint/Office 365 pour implémenter des actions personnalisées.
Prise en main
L’exemple suivant montre comment ajouter une action personnalisée au menu des paramètres du site dans le site web hôte, comment afficher une boîte de dialogue dans une action personnalisée, comment masquer une boîte de dialogue qui héberge une page à partir d’un site web de add-in distant et comment utiliser une action personnalisée pour créer des listes et définir le thème d’un site web.
Provisioning.SiteModifier (exemple PnP O365)
Ici, vous pouvez voir le lien que l’action personnalisée dans l’exemple ajoute au menu Site Paramètres.

Ici, vous pouvez voir la fenêtre popup ouverte via le lien Modifier le site.

Liens connexes
- Contrôles utilisateur et contrôles Web (SharePoint recette de add-in)
- Articles de référence sur la page https://aka.ms/OfficeDevPnPGuidance
- Références dans MSDN sur la page https://aka.ms/OfficeDevPnPMSDN
- Vidéos sur la page https://aka.ms/OfficeDevPnPVideos
Exemples PnP
- Provisioning.SiteModifier (exemple PnP O365)
- Exemples et contenu dans Microsoft 365 et pratiques PnP (Patterns and Practices)
S’applique à
- Office 365 multi-locataire (MT).
- Office 365 dédiés (D)
- SharePoint 2013 en local