Intégrer Sélecteur de personnes

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 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 :

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

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*/ });

people.selectPeople((error: microsoftTeams.SdkError, people: microsoftTeams.people.PeoplePickerResult[]) => 
 {
    if (error) 
    {
        if (error.message) 
           {
             alert(" ErrorCode: " + error.errorCode + error.message);
           }
            else 
            {
              alert(" ErrorCode: " + error.errorCode);
            }
      }
    if (people)
     {
            output(" People length: " + people.length + " " + JSON.stringify(people));
      }
  },{ setSelected: ["aad id"], openOrgWideSearchInChatOrChannel: true, singleSelect: false, title: true});

Gestion des erreurs

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

Exemple de code

Voir aussi

• Intégrer les fonctionnalités médias
• Intégrer le code QR ou la fonctionnalité de scanneur de code-barres dans Teams
• Intégrer les fonctionnalités d’emplacement sur Teams
• Composant sélecteur de personnes dans le Kit de ressources Microsoft Graph