Sélectionneur de personnes dans les Cartes adaptatives

Personnes Sélecteur permet aux utilisateurs de rechercher et de sélectionner des utilisateurs dans la carte adaptative. Vous pouvez ajouter Personnes Sélecteur en tant que 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. Personnes Sélecteur 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 Personnes sélecteur dans les cartes adaptatives et les actions correspondantes :

Scénarios	Actions
Scénarios basés sur l’approbation	Pour demander, attribuer et réaffecter l’approbation à l’utilisateur prévu en fonction de la configuration requise.
Gestion des incidents	Pour suivre les incidents et notifier, attribuer et réaffecter à l’utilisateur prévu pour une action immédiate.
Gestion de projet	Pour affecter des tickets ou des bogues à des utilisateurs particuliers.
Recherche de l’utilisateur	Pour rechercher des utilisateurs dans l’organization.

Imprimante de bureau

Le client web et de bureau prend en charge Personnes sélecteur dans la carte adaptative. Lors de la recherche sur le web, Personnes Sélecteur implique une expérience de saisie inline.

Exemple de scénario de réaffectation

L’utilisateur A (Robert) reçoit un ticket pour une tâche dans un canal et se rend compte que le destinataire est incorrect. L’utilisateur A réaffecte la tâche qui renvoie les informations au bot.

Pour réaffecter une tâche :

1. Sélectionnez Réaffecter où le champ du sélecteur de personnes est prérempli avec le nom pour réaffecter la tâche à l’utilisateur prévu.
2. Supprimez le nom d’utilisateur incorrect.
3. Sélectionnez les utilisateurs prévus selon le scénario d’image, l’utilisateur B (Mona) et l’utilisateur C (Robin) pour la tâche.
4. Sélectionnez Affecter. Après l’attribution, les informations sont envoyées au bot. Le bot met à jour la carte adaptative et avertit les utilisateurs prévus.

L’image suivante montre le scénario de réaffectation :

Mobile

Les clients mobiles Android et iOS prennent en charge Personnes sélecteur dans les cartes adaptatives. Vous pouvez utiliser Personnes sélecteur dans un appareil mobile pour rechercher et sélectionner un utilisateur afin d’améliorer l’expérience utilisateur. L’expérience de recherche est similaire à toute autre expérience de sélection d’utilisateur dans un appareil mobile.

Exemple de scénario de réaffectation

L’utilisateur A (Robert) reçoit un ticket pour une tâche dans un canal et se rend compte que le destinataire est incorrect. L’utilisateur A réaffecte la tâche qui renvoie les informations au bot.

Pour réaffecter une tâche :

1. Sélectionnez Réaffecter où le champ du sélecteur de personnes est prérempli avec le nom pour réaffecter la tâche à l’utilisateur prévu.
2. Supprimez le nom d’utilisateur incorrect.
3. Sélectionnez les utilisateurs prévus selon le scénario d’image, l’utilisateur B (Mona) et l’utilisateur C (Robin) pour la tâche.
4. Sélectionnez Terminé.
5. Sélectionnez Affecter. Après l’attribution, les informations sont envoyées au bot. Le bot met à jour la carte adaptative et avertit les utilisateurs prévus.

L’image suivante montre le scénario de réaffectation :

Implémenter le sélecteur de Personnes

Personnes Sélecteur 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.

Remarque

Le Input.ChoiceSet contrôle est basé sur les style propriétés et isMultiSelect .

Mettre à jour un schéma

Les propriétés suivantes sont des ajouts au Input.ChoiceSet schéma pour permettre Personnes’expérience du sélecteur sur le carte :

Contrôle Input.ChoiceSet

Propriété	Type	Requis	Description
choices.data	Data.Query	Non	Active la saisie semi-automatique dynamique pour différents types d’utilisateurs, en extrayant les résultats du jeu de données spécifié.

Data.Query

Propriété	Type	Requis	Description
jeu de données	String	Oui	Type de données qui doivent être extraites dynamiquement.

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 :

jeu de données	Étendue de la recherche
graph.microsoft.com/users	Recherchez tous les membres de la organization.
graph.microsoft.com/users?scope=currentContext	Effectuez une recherche dans les membres de la conversation actuelle, comme la conversation ou le canal dans lequel le carte particulier est envoyé.

Exemple

L’exemple de code pour créer Personnes sélecteur avec organization recherche 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 Personnes sélecteur dans cartes adaptatives avec organization recherche :

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 de Microsoft Entra ou des ID fournis dans la liste statique. Dans Personnes Sélecteur, 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é :

valeur de isMultiSelect	Format
false (sélection unique)	<selected_Azure_AD_ID>
true (sélection multiple)	< >selected_Azure_AD_ID_1,selected_Azure_AD_ID_2,selected_Azure_AD_ID_3<><>

Avec , Microsoft Entra IDPersonnes Sélecteur présélectionne l’utilisateur correspondant.

Présélection de l’utilisateur

Personnes Sélecteur 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.

Remarque

Les données statiques choices sont utilisées avec des jeux de données dynamiques.

Le choix se compose de title et value. Lorsqu’ils sont utilisés avec Personnes sélecteur, ces choix sont traduits en profils utilisateur qui ont comme title nom et le value comme 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 Personnes sélecteur dans les cartes adaptatives avec des choix statiques dans organization recherche :

Vous pouvez implémenter Personnes Sélecteur pour une gestion efficace des tâches dans différents scénarios.

Exemple de code

Exemple de nom	Description	.NET	Node.js	Manifeste
Contrôle du sélecteur de Personnes dans les cartes adaptatives	Cet exemple montre comment utiliser le contrôle sélecteur de personnes dans cartes adaptatives.	View	View	View

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 Groupes Microsoft 365
• Éléments multimédias dans la carte adaptative
• Balise mention