Freigeben über

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.

Abhängige Eingaben in adaptiven Karten

Sie können adaptive Karten in Teams entwerfen, bei denen der Wert einer Eingabe vom Wert einer anderen abhängt. Betrachten Sie beispielsweise eine adaptive Karte mit zwei Input.ChoiceSet Dropdownlisten: eine für die Auswahl eines Landes und eine andere für die Auswahl einer bestimmten Stadt innerhalb dieses Landes. Die erste Dropdownliste muss die Städte filtern, die in der zweiten Dropdownliste angezeigt werden. Dies kann erreicht werden, indem Sie eine Input.ChoiceSet Dropdownliste mit dynamischer Typaheadsuche erstellen, die von einer oder mehreren anderen Eingaben im Karte abhängig ist. Weitere Informationen finden Sie unter Abhängige Eingaben.

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, YouTube-, Vimeo- oder Dailymotion-Videos 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.

Rahmen und abgerundete Ecken

Sie können den ContainerElementen , ColumnSet, Columnund Table in adaptiven Karten Rahmen hinzufügen, um verschiedene Abschnitte der Karte abzugrenzen. Sie können abgerundete Ecken zu den ContainerElementen , ColumnSet, Column, Tableund Image in adaptiven Karten hinzufügen, um das Karte Design modern und visuell ansprechend aussehen zu lassen. Weitere Informationen finden Sie unter Rahmen und abgerundete Ecken in Adaptive Karten.

Container mit Bildlauf

Ein Container mit vielen Elementen kann zu einer langen, nicht lesbaren Karte führen. Verwenden Sie die maxHeight -Eigenschaft, um die maximale Höhe des Containers zu definieren. Wenn der Container eine maximale Höhe aufweist und sein Inhalt diese Höhe überschreitet, wird eine vertikale Bildlaufleiste angezeigt. Weitere Informationen finden Sie unter Scrollfähige Container in adaptiven Karten.

Zusammengesetzte Schaltfläche

Die Verbundschaltfläche ist ein spezieller Typ von Schaltfläche mit einem Symbol, einem Titel und einer Beschreibung. Sie können eine Verbundschaltfläche mithilfe des CompoundButton -Elements hinzufügen. Mit diesem Element können Sie die Darstellung von Eingabeaufforderungsstartern in einer adaptiven Karte replizieren . Weitere Informationen finden Sie unter Zusammengesetzte Schaltfläche in adaptiven Karten.

Fluent-Symbole

Adaptive Karten unterstützen das Hinzufügen von Symbolen aus der Fluent-Symbolbibliothek mithilfe des Icon -Elements. Weitere Informationen finden Sie unter Symbole in Adaptive Karte.

Sternbewertungen

Sie können Ihrer adaptiven Karte mithilfe des Input.Rating -Elements eine star Bewertungseingabe hinzufügen. Sie können auch eine schreibgeschützte star Bewertung mithilfe des Rating -Elements einschließen. Weitere Informationen finden Sie unter Bewertungen in Adaptive Karten.

Bedingte Aktivierung von Aktionsschaltflächen

Sie können die conditionallyEnabled -Eigenschaft verwenden, um Aktionsschaltflächen zu deaktivieren, bis der Benutzer den Wert von mindestens einer der erforderlichen Eingaben ändert. Diese Eigenschaft kann nur mit Action.Submit - und Action.Execute -Aktionen verwendet werden. Weitere Informationen finden Sie unter Bedingtes Aktivieren von Aktionsschaltflächen.

Ü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.

Diagramme in adaptiven Karten

Bots 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.

Containerlayouts in adaptiven Karten

Sie können reaktionsfähige Container für verschiedene Breiten adaptiver Karten mit den Layout.StackLayouts , Layout.Flowund Layout.AreaGrid entwerfen. Weitere Informationen finden Sie unter Containerlayouts.

Nächster Schritt

Kartentypen

Siehe auch