Sélectionneur de personnes dans les Cartes adaptatives

Le sélecteur de personnes permet aux utilisateurs de rechercher et de sélectionner des utilisateurs dans la carte adaptative. Vous pouvez ajouter le Sélecteur de personnes comme contrôle d’entrée à la carte adaptative, qui fonctionne sur les conversations, les canaux, les boîtes de dialogue (appelées modules de tâche dans TeamsJS v1.x) et les onglets. Le sélecteur de personnes prend en charge les fonctionnalités suivantes :

• Recherche un ou plusieurs utilisateurs.
• Sélectionne un ou plusieurs utilisateurs.
• Réaffecte à un ou plusieurs utilisateurs.
• Préremplir le nom des utilisateurs sélectionnés.

Scénarios populaires

Le tableau suivant fournit des scénarios courants pour le sélecteur de personnes dans les cartes adaptatives et les actions correspondantes :

Implémenter le sélecteur de personnes

Le sélecteur de personnes est implémenté en tant qu’extension du contrôle Input.ChoiceSet . Le contrôle d’entrée comprend les sélections suivantes :

• Liste déroulante, telle qu’une sélection développée.
• Case d’option, telle qu’une seule sélection.
• Cases à cocher, telles que plusieurs sélections.

Mettre à jour un schéma

Les propriétés suivantes sont des ajouts au schéma pour activer l’expérience Input.ChoiceSet sélecteur de personnes sur la carte :

Contrôle Input.ChoiceSet

Data.Query

jeu de données

Le tableau suivant fournit des valeurs prédéfinies en tant que jeu de données pour le sélecteur de personnes :

Exemple

L’exemple de code pour la création d’un sélecteur de personnes avec la recherche d’organisation est le suivant :

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "isMultiSelect": true
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

L’image suivante illustre le sélecteur de personnes dans les cartes adaptatives avec la recherche d’organisation :

Pour activer la recherche dans une liste de membres de conversation, utilisez le jeu de données approprié défini dans la table du jeu de données . isMultiSelect la propriété est utilisée pour activer la sélection de plusieurs utilisateurs dans le contrôle . Il est défini sur false par défaut et ce paramètre vous permet de sélectionner un seul utilisateur.

Soumission de données

Vous pouvez utiliser Action.Submit ou Action.Execute pour envoyer des données sélectionnées à votre bot. La invoke charge utile reçue sur votre bot est une liste d’ID Microsoft Entra ou des ID fournis dans la liste statique. Dans le Sélecteur de personnes, lorsqu’un utilisateur est sélectionné dans le contrôle, le Microsoft Entra ID de l’utilisateur est la valeur renvoyée. est Microsoft Entra ID une chaîne qui identifie de façon unique un utilisateur dans le répertoire.

Le format de la valeur envoyée au bot dépend de la valeur de la isMultiSelect propriété :

Avec , le Microsoft Entra IDsélecteur de personnes présélectionne l’utilisateur correspondant.

Présélection de l’utilisateur

Le sélecteur de personnes prend en charge la présélection de l’utilisateur dans le contrôle lors de la création et de l’envoi d’une carte adaptative. Input.ChoiceSet prend en charge la value propriété utilisée pour présélectionner un utilisateur. Le format de cette value propriété est identique au format de valeur envoyé dans l’envoi de données.
La liste suivante fournit les informations permettant de présélectionner les utilisateurs :

• Pour un seul utilisateur dans le contrôle , spécifiez le Microsoft Entra ID de l’utilisateur comme value.
• Pour plusieurs utilisateurs, par isMultiSelecttrueexemple, spécifiez une chaîne séparée par des virgules de Microsoft Entra IDs.

L’exemple suivant décrit la présélection d’un utilisateur unique :

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "value": "<Microsoft Entra ID 1>"
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

L’exemple suivant décrit la présélection de plusieurs utilisateurs :

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "isMultiSelect": true,
   "value": "<Microsoft Entra ID 1>,<Microsoft Entra ID 2>,<Microsoft Entra ID 3>"
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

Choix statiques

Les choix statiques prennent en charge les scénarios où des profils personnalisés doivent être insérés dans les jeux de données prédéfinis. Input.ChoiceSet prend en charge la choices spécification statique dans le json. Le choix statique est utilisé pour créer les choix à partir desquels l’utilisateur peut sélectionner.

Le choix se compose de title et value. Lorsqu’ils sont utilisés avec le sélecteur de personnes, ces choix sont traduits en profils utilisateur qui ont comme title nom et comme value identificateur. Ces profils personnalisés font également partie des résultats de la recherche lorsque la requête de recherche correspond au donné title. L’exemple suivant décrit les choix statiques :

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [
    {
     "title": "Custom Profile 1",
     "value": "Profile1"
    },
    {
     "title": "Custom Profile 2",
     "value": "Profile2"
    }
   ],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "isMultiSelect": true
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

L’image suivante illustre le sélecteur de personnes dans les cartes adaptatives avec des choix statiques dans la recherche d’organisation :

Vous pouvez implémenter le sélecteur de personnes pour une gestion efficace des tâches dans différents scénarios.

Exemple de code

Voir aussi

• Types de cartes
• Bots et kits de développement
• Générer des extensions de message pour Teams
• Créer des connecteurs pour les groupes Microsoft 365
• Éléments multimédias dans la carte adaptative
• Mention de balise