Universal-Aktionen für adaptive Karten
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 dieselbe 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
- Benutzerspezifische Ansichten
- Unterstützung für sequenzielle Workflows
- Aktuelle Ansichten
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:
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:
Sie können jetzt dieselbe 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 zur Meldung von Vorfällen 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:
Die folgende Abbildung zeigt die verschiedenen Zustände für verschiedene Benutzer im Chat oder Kanal:
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 die 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.
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.