Dialoge

  • Artikel

Dialoge (in TeamsJS v1.x als Aufgabenmodule bezeichnet) ermöglichen es Ihnen, modale Popupfunktionen in Ihrer Teams-Anwendung zu erstellen. Im Popupfenster haben Sie folgende Möglichkeiten:

  • Führen Sie Ihren eigenen benutzerdefinierten HTML- oder JavaScript-Code aus.
  • Zeigen Sie ein <iframe>Widget auf Basis von YouTube oder Microsoft Stream Video an.
  • Anzeigen einer adaptiven Karte.

Dialoge sind nützlich, um Aufgaben zu initiieren und abzuschließen oder umfangreiche Informationen wie Videos oder Power Business Intelligence-Dashboards (BI) anzuzeigen. Eine Popup-Benutzeroberfläche ist für Benutzer, die Aufgaben initiieren und ausführen, im Vergleich zu einer Registerkarte oder einer konversationsbasierten Bot-Erfahrung häufig natürlicher.

Dialoge bauen auf der Grundlage von Microsoft Teams-Registerkarten auf. Sie sind im Wesentlichen eine Registerkarte in einem Popupfenster. Sie verwenden dieselbe Microsoft Teams JavaScript-Clientbibliothek (TeamsJS). Wenn Sie also eine Registerkarte erstellt haben, sind Sie bereits mit dem Erstellen eines Dialogfelds vertraut.

Sie können Dialoge auf drei Arten aufrufen:

  • Kanal- oder persönliche Registerkarten: Mithilfe der TeamsJS-Bibliothek können Sie Dialoge über Schaltflächen, Links oder Menüs auf Ihrer Registerkarte aufrufen. Weitere Informationen finden Sie unter Verwenden von Dialogfeldern in Registerkarten.
  • Bots: Verwenden von Schaltflächen auf Karten , die von Ihrem Bot gesendet werden. Dies ist nützlich, wenn Sie nicht festlegen, dass jeder in einem Kanal sehen muss, was Sie mit einem Bot tun. Wenn Benutzer beispielsweise auf eine Umfrage in einem Kanal antworten, ist es nicht sinnvoll, einen Datensatz dieser Umfrage zu sehen, die erstellt wird. Weitere Informationen finden Sie unter Verwenden von Dialogfeldern aus Teams-Bots.
  • Außerhalb von Teams über einen Deep-Link: Sie können auch URLs erstellen, um ein Dialogfeld von überall aus aufzurufen. Weitere Informationen finden Sie unter Deep Link-Syntax für Dialoge.

Komponenten eines Dialogs

So sieht ein Dialogfeld aus, wenn es von einem Bot aufgerufen wird:

Dialogbeispiel

Ein Dialogfeld enthält Folgendes, wie in der vorherigen Abbildung gezeigt:

  1. Symbolcolor Ihrer App.

  2. Dershort Name Ihrer App.

  3. Der in der title -Eigenschaft des DialogInfo-Objekts angegebene Titel des Dialogfelds.

  4. Die Schaltfläche "Schließen" oder "Abbrechen" des Dialogfelds. Wenn der Benutzer diese Schaltfläche auswählt, empfängt Ihre App ein err Ereignis. Weitere Informationen finden Sie unter Beispiel für die Übermittlung des Ergebnisses eines Dialogs.

    Hinweis

    Es ist derzeit nicht möglich, das err Ereignis zu erkennen, wenn ein Dialog von einem Bot aufgerufen wird.

  5. Das blaue Rechteck ist der Ort, an dem Ihre Webseite angezeigt wird, wenn Sie Ihre eigene Webseite mithilfe der url -Eigenschaft des TaskInfo-Objekts laden. Weitere Informationen finden Sie unter Aufrufen und Schließen von Dialogfeldern.

  6. Wenn Sie eine adaptive Karte mithilfe der card -Eigenschaft des TaskInfo-Objekts anzeigen, wird der Abstand für Sie hinzugefügt. Weitere Informationen finden Sie unter CSS für HTML- oder JavaScript-Dialogfelder.

  7. Schaltflächen für adaptive Karten werden gerendert, nachdem Sie Registrieren ausgewählt haben. Wenn Sie Ihre eigene Seite verwenden, erstellen Sie ihre eigenen Schaltflächen. Standardmäßig wird der primäre Schaltflächenstil (einfarbig) auf die letzte Stammaktion in einer adaptiven Karte angewendet. Für alle anderen Aktionen wird der Standardschaltflächenstil angewendet.

Nächster Schritt

Aufrufen und Schließen von Dialogfeldern

Siehe auch