Übersicht über adaptive Karten für Microsoft Teams

Adaptive Cards sind eine plattformunabhängige Methode, Informationsblöcke zu teilen und anzuzeigen, ohne den Aufwand, CSS oder HTML individuell anzupassen, um sie darzustellen. Sie erstellen adaptive Karten im JSON-Format mit Integrationen, die Cloud-Apps und -Dienste offen austauschen können. Bei Übermittlung an einen bestimmten Host, beispielsweise Microsoft Teams, wird die JSON-Datei in eine native Benutzeroberfläche umgewandelt, die sich automatisch an den jeweiligen Host anpasst. Daher können Prozessdesigner jetzt konsistente UI-Muster anbieten, wenn sie Informationen als Teil eines Geschäftsprozesses oder einer Automatisierung anzeigen müssen.

Da sich adaptive Karten ihrem Host anpassen, sind sie perfekte Instrumente für den Informationsaustausch zwischen Microsoft Teams und anderen Diensten.

Screenshot von adaptiven Karten.

Derzeit für Flows verfügbare Aktionen

Die folgenden Aktionen ermöglichen es Erstellenden, adaptive Karten für Microsoft Teams zu erstellen. Während sich Integrationsszenarien entwickeln, unterstützt Power Automate andere Hosts, wodurch Ihre Möglichkeiten erweitert werden, adaptive Karten in Microsoft Cloudabonnements zu nutzen.

Anmerkung

Adaptive Karten sind in der DoD-Umgebung (Verteidigungsministerium) nicht verfügbar.

Weiterleiten von Inhalten an Teammitglieder oder Microsoft Entra-Benutzenden

Ihre eigene adaptive Karte als Flow-Bot an einen Benutzer senden

Mithilfe dieser Aktion wird eine adaptive Karte als Flow-Bot an einen bestimmten Benutzer bzw. eine bestimmte Benutzerin übermittelt. In diesem Fall müssen Sie eine Empfänger-E-Mail-Adresse angeben. Anschließend erscheint die Karte während der Ausführung des Workflows im Chat und im Aktivitätsfeed des Empfängers. Es ist nicht notwendig, dass die Benutzenden zu einer Teams-Instanz gehören, um diese Arten adaptiver Karten zu erhalten. In diesem Fall funktionieren nur die URL-Schaltflächen durch Umleitung zur URL, die innerhalb des Flows konfiguriert ist.

Adaptive Karte als Flowbot für Teams-Benutzer posten und auf Antwort warten

Mit dieser Aktion wird eine adaptive Karte als Flowbot an einen bestimmten Benutzer übermittelt, z. B. wie im weiter oben in diesem Artikel vorgestellten Fall. In diesem Fall wird die Flow-Ausführung allerdings nicht nach dem Posten fortgesetzt, bis der Empfänger auf Eingaben antwortet, die auf der Karte erforderlich sind. Der Flow wird fortgesetzt, nachdem der Empfänger geantwortet hat. Der Fluss gibt dynamischen Inhalt für eine Antwort pro Empfänger und pro Karte zurück.

Direkte Inhalte zu Teams-Kanälen

  • Eigene adaptive Karte als Flowbot in einem Kanal posten
    Mithilfe dieser Aktion wird eine adaptive Karte als Flow-Bot an einen bestimmten Teams-Kanal übermittelt. In diesem Fall werden Sie aufgefordert, eine Microsoft Teams-Instanz und einen Kanal anzugeben, in dem die Karte gepostet wird. Der Flow Maker muss Zugriff auf die Teams-Instanz haben, um dort eine adaptive Karte zu veröffentlichen. In diesem Fall funktionieren nur URL-Schaltflächen durch Umleitung zur URL, die innerhalb des Flows konfiguriert ist.

  • Adaptive Karte als Flow-Bot in einem Teams-Kanal posten und auf Antwort warten
    Mithilfe dieser Aktion wird eine adaptive Karte als Flow-Bot an einen bestimmten Teams-Kanal übermittelt, wie im Fall weiter oben. In diesem Fall wird der Flow jedoch erst fortgesetzt, nachdem Benutzende auf dem Kanal auf Eingaben antworten, die auf der Karte erforderlich sind. Der Flow wird fortgesetzt, sobald jemand im Teams-Kanal antwortet, gibt jedoch nur dynamische Inhalte für jeweils eine Antwort pro antwortender Person und pro Karte zurück. Wenn Sie diese Karte verwenden, wartet der Flow auf eine Antwort von beliebigen Teams-Mitgliedern.

Bekannte Probleme

  • Sie können keine Daten aus adaptiven Karten sammeln, es sei denn, Sie erstellen sie, indem Sie eine der Warteaktionen verwenden . Adaptive Karten, die nicht warten, geben für alle Schaltflächenaktionen außer OpenURL einen Fehler zurück. Weitere Informationen über OpenURL-Schaltflächen.

  • Wenn Sie "Action.Submit "-Schaltflächen auf einer Karte auswählen, die das Warten auf ein Antwortsuffix nicht enthält, wird ein Fehler angezeigt.

  • Adaptive Karten, die mithilfe der Wartezeit auf Antwortaktionen erstellt werden, können nur einmal pro Karte gesendet werden. Der Flowlauf wird nach der ersten Antwort fortgesetzt, und alle weiteren Einreichungen werden ignoriert.

  • Nur die Informationen im Eingabefeld Aktualisierungsnachricht werden auf der Ersatzkarte angezeigt, nachdem Nutzer die Karte übermittelt haben.

    Weitere Details, z. B. die Benutzer-ID der Person, die die Karte sendet, sind in den dynamischen Inhalten in Aktionen verfügbar, die der Aktion Warten auf eine Antwort folgen. Es kann jedoch erforderlich sein, den Office 365-Benutzer Connector einzuschließen, um die gewünschten Profilinformationen für den Benutzer abzuschließen, der die Karte übermittelt hat.

  • Sobald die adaptiven Karten des Typs wait for a response (auf eine Antwort warten) übermittelt wurden, wird die Karte zurückgesetzt. Danach bleibt die Karte genau gleich, es sei denn, der Bereich für Ersatz-/Aktualisierungsnachrichten ist konfiguriert. Aktualisierungsnachrichten sind eine bewährte Methode. Ihnen wird empfohlen, andere zu informieren und zu verhindern, dass Verbraucher versuchen, die Karte mehr als einmal einzureichen.

    Screenshot einer Aktualisierungsmeldung.

Die Eingaben Aktualisierungsnachricht und Karte aktualisieren müssen konfiguriert werden, wenn eine Ersatzkarte gewünscht wird.

  • Power Automate nutzt die besonderen Funktionen und Dienste adaptiver Karten von Microsoft, um die Karten in jedem beliebigen Host zu verarbeiten. Dieser Artikel erläutert spezifische Aspekte zu Flow-Aktionen. Sie können auch die vollständige Dokumentation zum Entwickeln adaptiver Karten zurate ziehen.