Personenauswahl in Adaptiven Karten

Die Personenauswahl unterstützt Benutzer beim Suchen und Auswählen von Benutzern in adaptiver Karte. Sie können die Personenauswahl als Eingabesteuerelement zu adaptiver Karte hinzufügen, die über Chats, Kanäle, Dialoge (in TeamsJS v1.x als Aufgabenmodule bezeichnet) und Registerkarten hinweg funktioniert. Die Personenauswahl unterstützt die folgenden Features:

• Durchsucht einzelne oder mehrere Benutzer.
• Wählt einzelne oder mehrere Benutzer aus.
• Zuweisen zu einzelnen oder mehreren Benutzern.
• Füllt den Namen der ausgewählten Benutzer im Voraus aus.

Beliebte Szenarien

Die folgende Tabelle enthält beliebte Szenarien für die Personenauswahl in adaptiven Karten und die entsprechenden Aktionen:

Szenarien	Aktionen
Genehmigungsbasierte Szenarien	Zum Anfordern, Zuweisen und Erneuten Zuweisen der Genehmigung an den vorgesehenen Benutzer basierend auf der Anforderung.
Verwaltung von Sicherheitsvorfällen	Um Incidents nachzuverfolgen und zu benachrichtigen, weisen Sie den beabsichtigten Benutzer zu und weisen sie ihm zur sofortigen Aktion neu zu.
Projektmanagement	So weisen Sie bestimmten Benutzern Tickets oder Fehler zu.
Benutzersuche	So suchen Sie nach Benutzern in der gesamten Organisation.

Desktop

Der Web- und Desktopclient unterstützt die Personenauswahl in adaptiver Karte. Bei der Suche im Web umfasst die Personenauswahl eine Inlineeingabe.

Beispiel für ein Neuzuweisungsszenario

Benutzer A (Robert) erhält ein Ticket für eine Aufgabe in einem Kanal und erkennt einen falschen Zugewiesenen. Benutzer A zuweisen die Aufgabe neu, die die Informationen zurück an den Bot sendet.

So weisen Sie eine Beliebige Aufgabe neu zu:

1. Wählen Sie Neu zuweisen aus, wo das Personenauswahlfeld mit dem Namen vorab aufgefüllt ist, um die Aufgabe dem vorgesehenen Benutzer neu zuzuweisen.
2. Entfernen Sie den Namen des falschen Benutzers.
3. Wählen Sie die gewünschten Benutzer gemäß dem Bildszenario, Benutzer B (Mona) und Benutzer C (Robin) für die Aufgabe aus.
4. Wählen Sie Zuweisen aus. Nach der Zuweisung werden die Informationen an den Bot gesendet. Der Bot aktualisiert adaptive Karte und benachrichtigt die vorgesehenen Benutzer.

Die folgende Abbildung zeigt das Neuzuweisungsszenario:

Mobil

Mobile Android- und iOS-Clients unterstützen die Personenauswahl in adaptiven Karten. Sie können die Personenauswahl auf Mobilgeräten verwenden, um einen Benutzer zu suchen und auszuwählen, um die Benutzererfahrung zu verbessern. Die Sucherfahrung ist mit jeder anderen Benutzerauswahl auf Mobilgeräten vergleichbar.

Beispiel für ein Neuzuweisungsszenario

Benutzer A (Robert) erhält ein Ticket für eine Aufgabe in einem Kanal und erkennt einen falschen Zugewiesenen. Benutzer A zuweisen die Aufgabe neu, die die Informationen zurück an den Bot sendet.

So weisen Sie eine Beliebige Aufgabe neu zu:

1. Wählen Sie Neu zuweisen aus, wo das Personenauswahlfeld mit dem Namen vorab aufgefüllt ist, um die Aufgabe dem vorgesehenen Benutzer neu zuzuweisen.
2. Entfernen Sie den Namen des falschen Benutzers.
3. Wählen Sie die gewünschten Benutzer gemäß dem Bildszenario, Benutzer B (Mona) und Benutzer C (Robin) für die Aufgabe aus.
4. Wählen Sie Fertig aus.
5. Wählen Sie Zuweisen aus. Nach der Zuweisung werden die Informationen an den Bot gesendet. Der Bot aktualisiert adaptive Karte und benachrichtigt die vorgesehenen Benutzer.

Die folgende Abbildung zeigt das Neuzuweisungsszenario:

Implementieren der Personenauswahl

Die Personenauswahl wird als Erweiterung des Input.ChoiceSet-Steuerelements implementiert. Das Eingabesteuerelement enthält die folgenden Auswahlmöglichkeiten:

• Dropdownliste, z. B. eine erweiterte Auswahl.
• Optionsfeld, z. B. eine einzelne Auswahl.
• Kontrollkästchen, z. B. Mehrfachauswahl.

Hinweis

Das Input.ChoiceSet Steuerelement basiert auf den style Eigenschaften und isMultiSelect .

Schema aktualisieren

Die folgenden Eigenschaften sind Ergänzungen zum Schema, um die Input.ChoiceSet Benutzerauswahl auf der Karte zu aktivieren:

Input.ChoiceSet-Steuerelement

Eigenschaft	Typ	Erforderlich	Beschreibung
choices.data	Data.Query	Nein	Aktiviert die dynamische automatische Vervollständigung für verschiedene Benutzertypen, indem Ergebnisse aus dem angegebenen Dataset abgerufen werden.

Data.Query

Eigenschaft	Typ	Erforderlich	Beschreibung
Dataset	Zeichenfolge	Ja	Der Datentyp, der dynamisch abgerufen werden muss.

Dataset

Die folgende Tabelle enthält vordefinierte Werte als Dataset für die Personenauswahl:

Dataset	Suchbereich
graph.microsoft.com/users	Durchsuchen Sie alle Mitglieder in der gesamten Organisation.
graph.microsoft.com/users?scope=currentContext	Suchen Sie innerhalb der Mitglieder der aktuellen Unterhaltung, z. B. Chat oder Kanal, in dem die jeweilige Karte gesendet wird.

Beispiel

Das Codebeispiel zum Erstellen der Personenauswahl mit der Organisationssuche sieht wie folgt aus:

{
 "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"
}

Die folgende Abbildung veranschaulicht die Personenauswahl in adaptiven Karten mit Organisationssuche:

Um die Suche in einer Liste von Konversationsmitgliedern zu aktivieren, verwenden Sie das entsprechende Dataset, das in der Datasettabelle definiert ist. isMultiSelect -Eigenschaft wird verwendet, um die Auswahl mehrerer Benutzer im Steuerelement zu aktivieren. Sie ist standardmäßig auf false festgelegt, und mit dieser Einstellung können Sie nur einen einzelnen Benutzer auswählen.

Datenübermittlung

Sie können oder Action.Execute verwendenAction.Submit, um ausgewählte Daten an Ihren Bot zu übermitteln. Die invoke für Ihren Bot empfangene Nutzlast ist eine Liste von Microsoft Entra-IDs oder die in der statischen Liste bereitgestellten IDs. Wenn in der Personenauswahl ein Benutzer im Steuerelement ausgewählt ist, ist der Microsoft Entra ID des Benutzers der wert, der zurückgesendet wird. ist Microsoft Entra ID eine Zeichenfolge und identifiziert eindeutig einen Benutzer im Verzeichnis.

Das Format des an den Bot übermittelten Werts hängt vom Wert der isMultiSelect Eigenschaft ab:

Wert von isMultiSelect	Format
false (single select)	<selected_Azure_AD_ID>
true (Mehrfachauswahl)	< >selected_Azure_AD_ID_1,selected_Azure_AD_ID_2,selected_Azure_AD_ID_3<><>

Mit dem wählt die Microsoft Entra IDPersonenauswahl den entsprechenden Benutzer vorab aus.

Vorauswahl des Benutzers

Die Personenauswahl unterstützt die Vorauswahl des Benutzers im Steuerelement beim Erstellen und Senden einer adaptiven Karte. Input.ChoiceSet unterstützt die value -Eigenschaft, die verwendet wird, um einen Benutzer vorab auszuwählen. Das Format dieser value Eigenschaft entspricht dem Format des übermittelten Werts bei der Datenübermittlung.
Die folgende Liste enthält die Informationen zum Vorwählen von Benutzern:

• Geben Sie für einen einzelnen Benutzer im Steuerelement den Microsoft Entra ID des Benutzers als an value.
• Geben Sie für mehrere Benutzer, z isMultiSelect . B. ist true, eine durch Trennzeichen getrennte Zeichenfolge von Microsoft Entra IDs an.

Im folgenden Beispiel wird die Vorauswahl eines einzelnen Benutzers beschrieben:

{
 "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"
}

Im folgenden Beispiel wird die Vorauswahl mehrerer Benutzer beschrieben:

{
 "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"
}

Statische Auswahlmöglichkeiten

Die statischen Optionen unterstützen Szenarien, in denen benutzerdefinierte Profile in die vordefinierten Datasets eingefügt werden müssen. Input.ChoiceSet unterstützt die statische Angabe choices im JSON-Code. Die statische Auswahl wird verwendet, um die Auswahlmöglichkeiten zu erstellen, aus denen der Benutzer auswählen kann.

Hinweis

Statisch choices werden mit dynamischen Datasets verwendet.

Die Auswahl besteht aus title und value. Wenn sie zusammen mit der Personenauswahl verwendet werden, werden diese Optionen in Benutzerprofile übersetzt, die den title als Namen und den value als Bezeichner aufweisen. Diese benutzerdefinierten Profile sind auch Teil der Suchergebnisse, wenn die Suchabfrage mit dem angegebenen titleübereinstimmt. Im folgenden Beispiel werden statische Optionen beschrieben:

{
 "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"
}

Die folgende Abbildung veranschaulicht die Personenauswahl in adaptiven Karten mit statischen Auswahlmöglichkeiten in der Organisationssuche:

Sie können die Personenauswahl für eine effiziente Aufgabenverwaltung in verschiedenen Szenarien implementieren.

Codebeispiel

Beispielname	Beschreibung	.NET	Node.js	Manifest
Personenauswahl-Steuerelement in adaptiven Karten	In diesem Beispiel wird gezeigt, wie sie das Personenauswahl-Steuerelement in adaptiven Karten verwenden.	View	View	Anzeigen

Siehe auch

• Kartentypen
• Tools und SDKs
• Erstellen von Nachrichtenerweiterungen für Teams
• Erstellen von Connectors für Microsoft 365-Gruppen
• Medienelemente in adaptiver Karte
• Markierungserwähnung