Universal-Aktionen für adaptive Karten

  • Artikel

Universal Actions for Adaptive Cards entwickelte sich aus Dem Entwicklerfeedback, dass Layout und Rendering für adaptive Karten zwar universell waren, dies jedoch nicht der Fall war. Selbst wenn ein Entwickler die gleichen Karte an verschiedene Orte senden möchte, muss er Aktionen unterschiedlich behandeln.

Universelle Aktionen für adaptive Karten verwenden den Bot als gängiges Back-End für die Behandlung von Aktionen und führen einen neuen Aktionstyp ein, Action.Executeder appübergreifend funktioniert, z. B. Teams und Outlook.

Dieses Dokument hilft Ihnen zu verstehen, wie Sie das Modell für universelle Aktionen verwenden können, um die Benutzerfreundlichkeit der Interaktion mit adaptiven Karten plattform- und anwendungsübergreifend zu verbessern.

Verbessern der Benutzerfreundlichkeit mit universellen Aktionen für adaptive Karten

Universelle Aktionen für adaptive Karten verbessern die Benutzerfreundlichkeit, indem die folgenden Szenarien aktiviert werden:

Universelle Aktionen

Vor den Universellen Aktionen für adaptive Karten haben verschiedene Hosts wie folgt verschiedene Aktionsmodelle bereitgestellt:

  • Teams oder Bots verwendeten Action.Submit, ein Ansatz, der das tatsächliche Kommunikationsmodell auf den zugrunde liegenden Kanal zurücksetzt.
  • Outlook wird verwendet Action.Http , um mit dem Back-End-Dienst zu kommunizieren, der explizit in der Nutzlast der adaptiven Karte angegeben ist.

Die folgende Abbildung zeigt das aktuelle inkonsistente Aktionsmodell:

Inkonsistentes Aktionsmodell

Mit den Universellen Aktionen für adaptive Karten können Sie für die Behandlung von Aktionen auf verschiedenen Plattformen verwenden Action.Execute .

Action.Execute funktioniert in allen Hubs, einschließlich Teams und Outlook, und ist kein Ersatz von Action.Submit. Wenn Sie beispielsweise möchten, dass ein externes System eine Aktion ausführen soll und das Ergebnis der Aktion mithilfe der Messaging-Erweiterung an Ihre Unterhaltung zurückgesendet werden muss, Action.Execute wird nicht unterstützt.

Für Karten zum Entpacken von Links , z. B. Hero- und Miniaturansichtskarten, müssen Sie aufrufen Action.Submit.

Darüber hinaus kann eine adaptive Karte als Antwort für eine Action.Execute ausgelöste Aufrufanforderung zurückgegeben werden.

Die folgende Abbildung zeigt das neue Universal Action-Modell:

Neue universelle Aktionen für adaptive Karten

Sie können jetzt die gleichen Karte an Teams und Outlook senden und sie mithilfe des zugrunde liegenden Bots synchron halten. Jede Aktion, die auf einer der Plattformen ausgeführt wird, wird mit diesem Build einmal und überall bereitgestellt (Universelle Aktionen für adaptive Karten)-Modell für die andere wider.

Die folgende Abbildung zeigt die Universellen Aktionen für adaptive Karten für Teams und Outlook:

Benutzerspezifische Ansichten

Heute sieht jeder Benutzer im Teams-Chat oder -Kanal genau die gleichen Ansichts- und Schaltflächenaktionen auf der adaptiven Karte. In bestimmten Szenarien müssen sich bestimmte Benutzer jedoch anders verhalten und zugriff auf unterschiedliche Informationen innerhalb desselben Chats oder Kanals haben.

Wenn Sie z. B. eine Karte in einem Chat oder Kanal senden, muss nur der Benutzer, dem der Vorfall zugewiesen ist, die Schaltfläche Auflösen sehen. Auf der anderen Seite muss der Ersteller des Incidents die Schaltfläche Bearbeiten sehen, und alle anderen Benutzer dürfen nur Details des Incidents anzeigen können. Dies wird durch benutzerspezifische Ansichten ermöglicht, die durch die refresh -Eigenschaft aktiviert werden.

Die folgende Abbildung zeigt ein Beispiel für eine Ticketing-Nachrichtenerweiterung (ME), bei der verschiedenen Benutzern im Chat je nach Anforderung unterschiedliche Aktionen angezeigt werden:

Weitere Informationen finden Sie unter Beispiel für benutzerspezifische Ansichten.

Unterstützung für sequenzielle Workflows

Mit der Unterstützung für sequenzielle Workflows können Benutzer eine Reihe von Workflows durchlaufen, ohne verschiedene Karten separat zu senden. Dies wird durch die Fähigkeit von Action.Execute ermöglicht, eine adaptive Karte als Reaktion auf eine Aktion zurückzugeben. Außerdem kann jeder Benutzer im Chat oder Kanal seinen Workflow durchlaufen, ohne die Karte für andere Benutzer im Chat zu ändern.

Die folgende Abbildung veranschaulicht ein Beispiel für einen Bot für die Lebensmittelbestellung:

Sequenzieller Workflow

Die folgende Abbildung zeigt die verschiedenen Zustände für verschiedene Benutzer im Chat oder Kanal:

Zustände des Cateringbots

Weitere Informationen finden Sie unter Beispiel für sequenzielle Workflows.

Aktuelle Ansichten

Sie können adaptive Karten erstellen, die automatisch aktualisiert werden. Es kann z. B. eine Genehmigungsanforderung sein, die von einem Benutzer gesendet wird. Nach der Genehmigung muss der Karte automatisch Details zum Zeitpunkt der Anforderungsgenehmigung und zum Genehmigten der Anforderung anzeigen. Mit dem Aktualisierungsmodell können Sie solche aktuellen Ansichten bereitstellen. Die folgende Abbildung zeigt einen mehrstufigen Genehmigungsablauf und wie die Ansichten für verschiedene Benutzer angezeigt werden.

Aktuelle benutzerspezifische Ansichten

Weitere Informationen finden Sie unter Beispiel für aktuelle Ansichten.

Jetzt können Sie verstehen, wie adaptive Karten mit dem neuen Universal Actions-Modell transformiert werden können, um eine einzigartige und verbesserte Benutzererfahrung zu bieten.

Adaptive Karten und das neue Modell für universelle Aktionen

Adaptive Karten sind eine Kombination aus Inhalten, z. B. Text und Grafiken, und Aktionen, die von einem Benutzer ausgeführt werden können. Weitere Informationen finden Sie unter Adaptive Karten. Die neuen Universellen Aktionen für adaptive Karten ermöglichen eine gemeinsame Behandlung der Aktionen für adaptive Karten über Plattformen und Anwendungen hinweg. Weitere Informationen finden Sie unter Universelles Aktionsmodell.

Sie können beginnen, indem Sie Szenarien mithilfe des Schnellstartleitfadens aktualisieren und universelle Aktionen nutzen.

Nächster Schritt

Mit Universal-Aktionen für adaptive Karten arbeiten

Siehe auch