Configurer des composants Web SharePoint Framework web Dans Microsoft Teams
Pour prendre en compte les préférences de vos utilisateurs, vous pouvez les laisser configurer vos composants Web Parts lorsqu’ils sont utilisés Microsoft Teams. Selon que vous avez exposé vos composants Web Teams sous forme d’onglets ou d’applications personnelles, il existe différentes façons d’implémenter des fonctionnalités de configuration dans votre composant Web Part.
Conseil
Pour savoir comment utiliser les différents concepts décrits dans cet article, consultez l’exemple d’application Prospects GitHub.
Configurer les onglets Microsoft Teams créés à l’aide de SharePoint Framework
En règle générale, lorsque vous créez Microsoft Teams onglet, vous devez créer une interface utilisateur personnalisée pour permettre aux utilisateurs de configurer votre onglet. En outre, vous devez écrire du code pour stocker et charger les valeurs de configuration telles que sélectionnées par l’utilisateur.
Lors de la création d’onglets à SharePoint Framework, l’onglet généré utilise le volet de propriétés du volet de propriétés du volet web pour que les utilisateurs configurent l’onglet. Cela vous permet d’économiser beaucoup d’efforts. Non seulement vous n’avez pas besoin de créer et de gérer une interface utilisateur de configuration distincte, mais vous n’avez pas non plus besoin d’implémenter du code responsable du stockage et de la gestion des paramètres. Tout cela est géré automatiquement pour vous par SharePoint Framework.
Configurer des Microsoft Teams personnelles conçues à l’aide de SharePoint Framework
Microsoft Teams applications personnelles ne proposent aucune infrastructure pour l’implémentation de la configuration. Au lieu de cela, en suivant le modèle recommandé par Microsoft Teams, les paramètres de l’application personnelle doivent être exposés dans un onglet distinct.

Pour traduire cela dans votre solution SharePoint Framework, cela implique la création d’un élément Web Part distinct qui contient l’interface utilisateur de configuration et qui sera utilisé uniquement dans le contexte de l’application personnelle, la définition d’un stockage pour la configuration de l’utilisateur et l’extension de la définition d’application personnelle pour qu’elle contienne plusieurs onglets.
Partie Web De l’interface utilisateur de configuration d’application personnelle
Chaque onglet d’une application personnelle est mappé à une URL. Le moyen le plus simple de créer une interface utilisateur pour configurer votre SharePoint Framework web part exposé en tant qu’application personnelle consiste à créer un autre partie Web Part avec l’interface utilisateur de configuration. Cela vous permettra d’optimiser l’interface utilisateur pour une utilisation dans le contexte de l’application personnelle et de conserver ce code distinct de votre partie Web.
Étant donné que le partie Web De configuration d’application personnelle n’est pas destinée à être utilisée en dehors de l’application personnelle, dans son manifeste, vous devez définir la propriété sur supportedHosts un tableau vide.

La raison pour laquelle vous souhaitez que la propriété soit vide est d’empêcher l’utilisation du partie Web Dans SharePoint mais également de ne pas l’inclure dans le manifeste Teams supportedHosts automatiquement. Par défaut, chaque partie Web qui contient la ou la valeur dans le manifeste est incluse dans le manifeste Teams généré en tant qu’application Microsoft Teams TeamsTab TeamsPersonalApp distincte. Dans ce cas toutefois, vous souhaitez que l’application personnelle se compose de plusieurs onglets, chacun pointant vers un autre partie Web. Pour ce faire, vous pouvez uniquement mettre à jour manuellement le manifeste vous-même.
Pour ajouter un onglet à votre application personnelle et le faire pointer vers un autre partie Web, dans le manifeste Teams défini dans le fichier teams/manifest.json, accédez à la section et copiez l’entrée staticTabs existante. Dans l’entrée copiée, mettez à jour les valeurs des entityId name propriétés. Dans la propriété, mettez à jour la valeur du paramètre de chaîne de requête afin qu’il corresponde à l’ID de votre partie Web De paramètres tel que défini contentUrl componentId dans son manifeste.

Choisir l’emplacement où stocker la configuration de l’utilisateur
Par défaut, la configuration des composants Web Parts est partagée et identique pour tous les utilisateurs. Les Teams personnelles sont toutefois destinées à être installées, configurées et utilisées par des individus. En tant que tel, vous devez avoir un moyen de stocker leurs préférences.
Stocker la configuration utilisateur dans le service de profil utilisateur
Dans le passé, un moyen courant de stocker des informations spécifiques à l’utilisateur dans SharePoint était d’ajouter une propriété personnalisée au service de profil utilisateur et de stocker la configuration sous forme de chaîne sérialisée à cet effet. Le problème avec l’utilisation du service de profil utilisateur à cette fin est que vous ne pouvez pas générer automatiquement de nouvelles propriétés de profil utilisateur qui compliquent le déploiement de votre application.
Stocker la configuration utilisateur dans une liste personnalisée
Vous pouvez également stocker les paramètres utilisateur dans une liste. Vous pouvez créer une liste masquée dans le site SharePoint et la configurer afin que les utilisateurs ne voient que leurs éléments. L’inconvénient de cette approche est que chaque fois que votre partie Web Part démarre, vous devez vérifier si la liste et les paramètres de l’utilisateur actuel existent et gérer correctement les erreurs au cas où elles ne le seront pas. En outre, lors du chargement de l’interface utilisateur de configuration, vous devez vérifier si la liste existe et la mettre en service, ainsi que tous ses paramètres si nécessaire.
Stocker la configuration utilisateur dans le dossier personnel de l’application
L’une des options les moins connues pour la persistance de la configuration propre à l’application et à l’utilisateur consiste à utiliser le dossier personnel de l’application. Le dossier spécifique de l’application se trouve sur le site OneDrive Entreprise’utilisateur. Chaque application obtient un dossier désigné dans lequel elle peut stocker n’importe quel nombre de fichiers.

Vous pouvez voir le dossier personnel de l’application comme un dossier de configuration d’une application de bureau sur votre disque, puis stocké dans OneDrive Entreprise et disponible sur chaque appareil que vous utilisez.
Conseil
Les dossiers personnels de l’application sont créés par application Azure AD, de sorte que dans le contexte de SharePoint Framework, toutes les solutions SharePoint Framework partagent le dossier d’application racine. Pour éviter les collisions avec d’autres solutions, vous devez envisager de créer un sous-dossier pour votre application.
Du point de vue technique, le dossier personnel de l’application est un dossier dans une bibliothèque de documents SharePoint et vous pouvez stocker n’importe quel nombre de fichiers et dossiers à l’intérieur. Lorsque vous persistez la configuration de votre application dans le dossier personnel de l’application, vous sérialisez vos paramètres comme configuré par l’utilisateur et écrivez les données sérialisées dans un fichier de votre dossier.
L’utilisation pratique du dossier personnel de l’application est qu’il est créé automatiquement s’il n’existe pas, que les données de chaque utilisateur sont stockées dans son propre OneDrive Entreprise ce qui signifie que les autres utilisateurs ne peuvent pas voir ou falsifier leurs paramètres et qu’il n’est pas nécessaire de connaître les URL spécifiques, car vous pouvez y accéder facilement à l’aide de Microsoft Graph. En cas de problème, l’utilisateur peut accéder à son site OneDrive Entreprise et supprimer la configuration de l’application pour réinitialiser son état.