Intégrer Sélecteur de personnes

  • Article

People Picker est un contrôle de saisie dans Teams qui permet aux utilisateurs de rechercher et de sélectionner des personnes. Vous pouvez intégrer le contrôle de saisie People Picker dans une application Web, ce qui permet aux utilisateurs finaux d'exécuter différentes fonctions telles que la recherche et la sélection de personnes dans un chat, un canal ou dans toute l'organisation au sein de Teams. Le contrôle People Picker est disponible sur tous les clients Teams, tels que le web, le bureau et le mobile.

Vous pouvez utiliser la bibliothèque de client JavaScript Microsoft Teams, qui fournit l’API selectPeople pour intégrer le contrôle d’entrée du sélecteur de Personnes dans votre application web.

Avantages de l’utilisation de Sélecteur de personnes

  • Fonctionne sur toutes les fonctionnalités de Teams, telles que la boîte de dialogue (appelée module de tâche dans TeamsJS v1.x), la conversation, le canal, l’onglet de réunion et l’application personnelle.
  • Permet à l’utilisateur de rechercher et de sélectionner des personnes dans une conversation, un canal ou toute l’organisation au sein de Teams.
  • Aide dans les scénarios impliquant l’affectation de tâches, le marquage et la notification de l’utilisateur.
  • Économise beaucoup de temps et d’efforts par rapport à la création d’un contrôle similaire.

Pour intégrer le contrôle de saisie People Picker dans votre application Teams, utilisez l'API selectPeople. Pour intégrer et appeler l'API, vous devez avoir une bonne compréhension de l'extrait de code suivant. Vous devez également connaître les erreurs de réponse d’API.

API selectPeople

L'API selectPeople vous permet d'ajouter le contrôle d'entrée Teams People Picker aux applications Web et vous aide également dans les domaines suivants :

  • Permet à l’utilisateur de rechercher et de sélectionner une ou plusieurs personnes dans la liste.
  • Retourne l’ID, le nom et l’adresse e-mail des utilisateurs sélectionnés à l’application web.

Dans une application personnelle, le contrôle recherche le nom ou l'identifiant de messagerie dans toute l'organisation au sein de Teams. Si l’application est ajoutée à une conversation ou à un canal, le contexte de recherche est configuré en fonction du scénario. La recherche est limitée dans les membres de cette conversation ou canal.

L’API selectPeople est livré avec les configurations d’entrée suivantes :

Paramètre de configuration Type Description Valeur par défaut
title Chaîne Il s’agit d’un paramètre facultatif qui définit le titre du contrôle S sélectionneur de personnes. selectPeople
setSelected Chaîne Il s’agit d’un paramètre facultatif. Vous devez passer Microsoft Entra ID du peuple pour être présélectionné. Ce paramètre présélectionne les personnes lors du lancement du contrôle d’entrée du sélectionneur de personnes. Dans une sélection unique, seul le premier utilisateur valide est pré-rempli en ignorant le reste. Null
openOrgWideSearchInChatOrChannel Boolean Il s'agit d'un paramètre facultatif qui, lorsqu'il est défini sur true, lance le People Picker dans l'ensemble de l'organisation, même si l'application est ajoutée à un chat ou à un canal. False
singleSelect Boolean Il s'agit d'un paramètre facultatif qui, lorsqu'il est défini sur true, lance le People Picker et limite la sélection à un seul utilisateur. False

L’image suivante affiche l’expérience de Sélecteur de personnes sur les appareils mobiles et de bureau :

Le contrôle d’entrée Sélecteur de personnes permet à l’utilisateur de rechercher et d’ajouter des personnes en procédant comme suit :

  1. Tapez le nom de la personne que vous voulez inviter. La liste s’affiche avec des suggestions de nom.

  2. Sélectionnez le nom de la personne requise dans la liste.

    Capture d’écran montrant le sélecteur de sélecteur sur mobile.

Extrait de code

L’extrait de code suivant affiche l’utilisation des personnes selectPeople de l’API à partir d’une liste :

people.selectPeople({ setSelected: ["aad id"], openOrgWideSearchInChatOrChannel: true, singleSelect: false, title: true}).then(people) => 
 {
    output(" People length: " + people.length + " " + JSON.stringify(people));
 }).catch((error) => { /*Unsuccessful operation*/ });

Gestion des erreurs

Le tableau suivant répertorie les codes d’erreur et leurs descriptions :

Code d’erreur Nom de l’erreur Description
100 NOT_SUPPORTED_ON_PLATFORM L’API n’est pas prise en charge sur la plateforme actuelle.
500 INTERNAL_ERROR Erreur interne rencontrée lors du lancement de Sélecteur de personnes.
4000 ARGUMENTS NON VALIDES L’API est appelée avec des arguments obligatoires incorrects ou insuffisants.
8000 USER_ABORT L’utilisateur a annulé l’opération.
9000 OLD_PLATFORM L’utilisateur se trouve sur une ancienne build de plateforme où l’implémentation de l’API n’est pas disponible. Mettre à niveau vers la dernière version de la build pour résoudre le problème.

Exemple de code

Exemple de nom Description .NET Node.js Manifeste
Sélecteur de personnes d’onglets Cet exemple montre la fonctionnalité du sélecteur de personnes à l’aide du kit de développement logiciel (SDK) client js teams dans l’onglet . View View View

Voir aussi