Utilisation des pages d’application à composant unique dans SharePoint Online

  • Article

Les pages d’application à composant unique proposent une fonctionnalité d’hébergement de composants WebPart SharePoint Framework ou d’applications Microsoft Teams dans SharePoint Online avec une disposition verrouillée. Les utilisateurs finals ne peuvent pas modifier ou configurer la page qui utilise la disposition d’application à composant unique.

Les pages d’application présentent les caractéristiques suivantes :

  • Les pages d’application à composant unique ne peuvent pas être modifiées par des utilisateurs finals dans un navigateur.
  • Elles prennent actuellement en charge uniquement l’hébergement de composants WebPart uniques ou d’une application Microsoft Teams.
  • Les utilisateurs finaux peuvent créer des pages d’application à l’aide de l’expérience Nouvelle>Page disponible dans les sites modernes.
  • Les développeurs peuvent modifier la mise en page par programmation, pour passer d’une mise en page normale vers une page d’application monopage
  • Il n’existe pas d’expérience Nouvelle dans une page d’application monopage. Les utilisateurs finaux peuvent créer des pages Article ou Application monopage à l’aide de l’expérience Nouvelle/page présente dans le ruban de toute page d’article moderne.

Les pages d’application sont exposées en tant qu’option dans la fonctionnalité de création de page moderne lorsque vous avez choisi la disposition utilisée pour votre page. Tous les composants WebPart configurés pour être également disponibles en tant que page d’application sont disponibles via la fonctionnalité Créer une page.

Vous pouvez configurer le composant WebPart pour l’afficher en tant que page d’application. Pour effectuer cette configuration dans le fichier manifeste du composant WebPart, ajustez la valeur supportedHosts. Le composant WebPart sera exposé en tant qu’option dans l’interface utilisateur du sélecteur de pages d’application à venir si la valeur supportedHosts contient la valeur "SharePointFullPage".

Le manifeste du composant WebPart suivant illustre le scénario où le composant WebPart est inclus dans toutes les plateformes prises en charge en mettant à jour toutes les valeurs différentes du paramètre supportedHosts.

{
  // ...

  "requiresCustomScript": false,
  "supportedHosts": ["SharePointWebPart", "SharePointFullPage", "TeamsTab"],

  "preconfiguredEntries": [{
    // ...
  }]
}

Comment approvisionner une page Application à composant unique dans votre client

En tant que développeur, les deux méthodes les plus courantes d’approvisionnement de pages Application à un composant unique sont d’utiliser PnP PowerShell ou CLI pour Microsoft 365.

Vous pouvez utiliser PnP PowerShell pour mettre à jour la mise en page de la page existante avec le script suivant.

Remarque

PnP PowerShell est une solution open source pour laquelle un support est assuré par la communauté active. Il n’existe pas de contrat SLA Microsoft pour le support technique relatif à cet outil open source.

Vous pouvez également utiliser CLI pour Microsoft 365 pour mettre à jour la mise en page de la page existante avec le script suivant.

Remarque

L’interface CLI pour Microsoft 365 est une solution open source pour laquelle un support est assuré par la communauté active. Il n’existe pas de contrat SLA Microsoft pour le support technique relatif à cet outil open source.

Connect-PnPOnline -Url https://contoso.sharepoint.com/sites/marketing
Set-PnPPage -Identity "Page" -LayoutType SingleWebPartAppPage

Reportez-vous à la documentation PnP PowerShell pour obtenir des détails complets et des exemples sur cette applet de commande.

Vous devez ajuster le nom du client et de la page selon votre environnement.