Karten

  • Artikel

Bei einer Karte handelt es sich um einen Benutzeroberflächencontainer für kurze oder verknüpfte Informationen. Karten können mehrere Eigenschaften und Anhänge aufweisen sowie Schaltflächen enthalten, über die Kartenaktionen ausgelöst werden können. Mithilfe von Karten können Sie Informationen in Gruppen organisieren und Benutzern die Möglichkeit geben, mit bestimmten Teilen der Informationen zu interagieren.

Die Bots für Microsoft Teams unterstützen die folgenden Arten von Karten:

  • Adaptive Karte
  • Hero-Karte
  • Listenkarte
  • Connector Karte für Microsoft 365-Gruppen
  • Belegkarte
  • Karte anmelden
  • Miniaturbildkarte
  • Kartensammlungen
  • Überlaufmenü für adaptive Karten

Je nach Kartentyp können Sie Ihren Karten Rich-Text-Formatierung mittels Markdown oder HTML hinzufügen. Karten, die von Bots und Nachrichtenerweiterungen in Teams verwendet werden, fügen diese Karte Aktionen, openUrl, messageBack, imBack, invokeund , und signinhinzu und reagieren darauf.

In Microsoft Teams werden Karten an drei verschiedenen Orten verwendet:

  • Connectors
  • Bots
  • Nachrichtenerweiterungen

Karten in Connectors

Karten wurden zuerst als Teil von Outlook und Microsoft 365 definiert und werden jetzt als Teil von Connectors für Microsoft 365-Gruppen verwendet. Wie viele Microsoft 365-Anwendungen unterstützt Teams Connectors. Weitere Informationen finden Sie unter Erstellen von Connectors für Microsoft 365-Gruppen. Sie finden die Spezifikation für Karten in Connectors unter Referenz zu Aktion erfordernde Nachrichtenkarten.

Karten in Bots

Das Microsoft Bot Framework erweitert die Kartenspezifikation durch das Hinzufügen einer Reihe vordefinierter Karten, die Bots als Teil von Botnachrichten verwenden können. Microsoft Teams unterstützt Bots, die das Bot-Framework nutzen, unterstützt jedoch einen anderen Satz dieser Karten. Allgemeine Informationen zu Karten im Bot Framework finden Sie unter Hinzufügen umfangreicher Kartenanlagen zu Nachrichten. Diese Karten werden in Microsoft Teams als einfache Karten bezeichnet.

Bots in Microsoft Teams können einfache Karten, Connectorkarten oder adaptive Karten verwenden. Kartentypen enthält Informationen zu Karten, die von Bots in Microsoft Teams unterstützt werden.

Karten in Nachrichtenerweiterungen

Nachrichtenerweiterungen können ebenfalls eine Karte zurückgeben. Nachrichtenerweiterungen können einfache Karten, Connectorkarten oder adaptive Karten verwenden. Diese Karten befinden sich unter Kartentypen.

Kartentypen

Alle von Microsoft Teams verwendeten Karten sind unter Kartentypen aufgeführt. In dieser Referenz werden auch die Unterschiede zwischen Bot Framework-Karten und Karten in Microsoft Teams beschrieben.

Adaptive Karten

Adaptive Karten sind eine neue produktübergreifende Spezifikation für Karten in Microsoft-Produkten, einschließlich Bots, Cortana, Outlook und Windows. Sie sind der empfohlene Kartentyp für die Entwicklung neuer Teams-Lösungen. Allgemeine Informationen vom für adaptive Karten zuständigen Team finden Sie unter Übersicht über adaptive Karten. Sie können adaptive Karten überall dort verwenden, wo Sie vorhandene Hero-Karten, Microsoft 365-Karten und Miniaturansichtskarten verwenden.

Neben adaptiven Karten unterstützt Microsoft Teams noch zwei andere Arten von Karten:

  • Verbinderkarten: Werden als Teil von Connectors für Microsoft 365-Gruppen verwendet.
  • Einfache Karten: Werden vom Bot-Framework verwendet, z. B. Miniaturbild- und Hero-Karten.

Personenauswahl in adaptiven Karten

Die Personenauswahl, die als Eingabesteuerelement adaptiven Karten hinzugefügt wurde, ermöglicht die Suche und Auswahl von Personen. Sie können es in Chats, Kanälen, Dialogen (in TeamsJS v1.x als Aufgabenmodule bezeichnet) und Registerkarten verwenden. Mobilgeräte- und Desktopclients unterstützen die Personenauswahl, die eine Inlineeingabe ermöglicht.

Personen-Symbol auf einer adaptiven Karte

Personen Symbol in einer adaptiven Karte hilft Benutzern, die Bilder von Benutzern in der adaptiven Karte in Teams anzuzeigen. Sie können das Bild eines einzelnen oder mehrerer Benutzer anzeigen. Personen Symbol wird in mobilen Teams- und Desktopclients unterstützt.

Vorausschauende Suche in Adaptiven Karten

Die Typeahead-Suche, die als Eingabesteuerelement in adaptiven Karten hinzugefügt wurde, ermöglicht die dynamische Suche aus einem dynamisch geladenen Dataset. Außerdem können Benutzer eine statische Typahead-Suche innerhalb einer Liste mit einer begrenzten Anzahl von Auswahlmöglichkeiten ausführen. Die mobilen Clients und Desktopclients unterstützen dynamische Suchfunktionen von Typahead.

Medienelemente in adaptiven Karten

Medienelemente in adaptiven Karten bieten eine verbesserte Medienerfahrung und erhöhen die Interaktion mit der adaptiven Karte. Sie können Ihrer adaptiven Karte Mediendateien wie Audio- oder Videoclips hinzufügen. Weitere Informationen finden Sie unter Medienelemente in adaptiver Karte.

Adaptive Karten und eingehende Webhooks

Hinweis

Mit adaptiven Karten mit eingehenden Webhooks können Sie die umfangreichen und flexiblen Funktionen adaptiver Karten nutzen. Dabei werden Daten mithilfe eingehender Webhooks in Microsoft Teams über ihren Webdienst gesendet.

CodeBlock in adaptiven Karten

Geben Sie Codeausschnitte als reich formatierte adaptive Karten in Teams-Chats, -Kanälen und -Besprechungen mit dem CodeBlock -Element frei. Adaptive Karten mit dem CodeBlock -Element erleichtern die Lesbarkeit des Codeausschnitts, da der Einzug, die Nummerierung und die Syntaxmarkierung der Programmiersprache entsprechen. Weitere Informationen finden Sie unter CodeBlock in adaptiven Karten.

Adaptives Kartenlayout

Sie müssen Ihre adaptiven Karten so entwerfen, dass sie auf jedem Gerät gut aussehen, um eine verbesserte Benutzererfahrung für Chats, Kanäle und Besprechungschats zu bieten. Das adaptive Kartenlayout hilft Ihnen beim Entwerfen von Karten mit unterschiedlichen Layouts, die auf unterschiedliche Karte Breiten ausgerichtet sind. Weitere Informationen finden Sie unter Responsive Layout für adaptive Karten.

Überlaufmenü für adaptive Karten

Adaptive Karte in Teams unterstützt das Überlaufmenü. Sie können ein Überlaufmenü für alle sekundären Aktionen in einer adaptiven Karte auffüllen.

Unterstützung für Microsoft Entra Objekt-ID und UPN in Benutzer-Erwähnung

Bots mit adaptiven Karten unterstützen zusätzlich zu den vorhandenen IDs Erwähnung Benutzer-IDs, z. B. Microsoft Entra Objekt-ID und Benutzerprinzipalname (User Principle Name, UPN). Eingehende Webhooks unterstützen Erwähnung von Benutzern in adaptiver Karte mit der Microsoft Entra Objekt-ID und dem UPN.

Nächster Schritt

Kartentypen

Siehe auch