Handbuch
Im diesem Handbuch finden Sie alle Informationen und Beispiele zu den MS Teams Aktivitäten:
Inhalt
Eigenschaften
Eingabe
Name | Beschreibung | Datentyp | Erforderlich |
|---|---|---|---|
Titel der Nachricht | Der Titel der Nachricht, der als Titel in MS Teams angezeigt wird. | string | |
Nachricht | Der Nachrichtentext der mit Markdown (einer vereinfachten Auszeichnungssprache) formatiert werden kann. Dieses Feld oder das Feld „Zusammenfassung“ müssen belegt werden. | string | |
Zusammenfassung | Eine kurze Zusammenfassung des Inhalts. Muss verwendet werden, wenn das Feld „Nachricht“ nicht verwendet wird. Dieses Feld wird in Teams nicht angezeigt. | string | |
Theme Farbe | Farbe als Hex Wert, der als farblicher Streifen über oder neben der Nachricht angezeigt wird. Empfehlung Microsoft: Bitte nicht für die Wiedergabe von Status verwenden. | string | |
Sektion | Eine Liste mit Sektionen. Sektionen sind Nachrichten und Elementen die eingerückt in der Nachricht angezeigt werden. Details im entsprechenden Kapitel. | string | |
Aktionen | Eine Liste von Aktionen, wie Öffnen einer Seite oder Http Post Aktionen. |
Ausgabe
Name | Beschreibung | Datentyp | Erforderlich |
|---|---|---|---|
Erfolgreich | Ein Rückgabewert der bei erfolgreichem Versand „wahr, ansonsten falsch ist. |
Beispiele
In den meisten Fällen werden Sie wahrscheinlich nur Titel, Nachricht und die Theme Farbe benötigen. Im Folgenden eine Beispiel Aktivität und wie dies in Teams aussehen kann.
Bis auf das Nachrichten oder Zusammenfassungsfeld sind die anderen Felder optional.
Textnachricht senden
Text formatieren mit Markdown
Sie können den Text in der Nachricht mit Markdown und einigen HTML Befehlen formatieren. Markdown ist eine Auszeichnungssprache, die über einfache Textzeichen Programmen Formatierungen von Text vorgeben kann. Im Folgenden sehen Sie eine Beispiel Nachricht mit Markdown Formatierung.
Text in der Nachricht der Aktivität:
"<h1>Typoblindtext</h1>" +
"Dies ist ein **Typoblindtext**. An ihm kann man sehen, ob *alle
Buchstaben* da sind und wie sie aussehen. Manchmal benutzt man
Worte wie ***Hamburgefonts, Rafgenduks oder Handgloves***, um
Schriften zu testen. Manchmal Sätze, die alle Buchstaben des
Alphabets enthalten - man nennt diese Sätze »Pangrams«. <br> " +
"[ALRO IT GmbH](https://www.alro-it.de ) <br>" +
" "
Diese Markdowns stehen Ihnen zur Verfügung:
Style | Markdown/HTML |
Titel | <h1>Titel</h1> |
Fett | **Fett** |
Kursiv | *Kursiv* |
Fett + Kursiv | ***Fett und Kursiv*** |
Zeilenumbruch | <br> |
Listen | <li><ul>Element</ul></li> |
Links | [ALRO IT](https://www.alro-it.de) |
Bilder |  |
Sektionen
Sektionen sind in Teams untergeordnete Nachrichten unter der Hauptnachricht, welche aber um einiges mächtiger sind als die Hauptnachrichten. Nachfolgend ein Beispiel wie eine Nachricht mit einer Sektion in Teams aussehen kann.
Rot eingerahmt sehen Sie oben den Bereich der Sektion. Diese besteht in diesem Beispiel von oben nach unten aus dem Titel, einem Aktivitätenbereich und einem Nachrichttext. Der Aktivitätenbereich besteht aus einem Bild, einem Titel, einem Untertitel und einem Nachrichtentext.
Um Sektionen als Aktivität zu nutzen brauchen Sie folgende Aktivitäten in ihrem Workflow:
Eine Umfrage erstellen
Im Folgenden einige Beispiele für komplex aufgebaute Nachrichten für Ihre Inspiration. In den Beispielen werden feste Texte verwendet. Sie können die Texte auch über Variablen befüllen.
Anforderung:
Sie haben einen Workshop oder ein Seminar in Teams gerade abgeschlossen und möchten von den
Teilnehmern Feedback
Voraussetzung:
Ein Dienst, der Http Post Anfragen mit Get zur Verarbeitung des Formulars entgegennimmt. Der Connector muss in einem Kanal eingerichtet sein, in dem alle Umfrageteilnehmer Zugriff haben.
Umsetzung im WMS:
Im WMS wurden für das Beispiel 2 Wertpaarlisten als Variablen angelegt. Zusätzlich wurde eine Liste für die Eingabefelder, eine Liste für die Post http Aktion und eine Liste für die Aktionskarte angelegt.
Die zwei Listen sind nötig, weil die Aktionskarte die HTTP Post Aktion als Aktionsliste braucht. Und
die Aktionskarte selbst auch als Liste in die Nachricht eingefügt wird.
Post mit Kommentarfunktion
Anforderung:
Sie haben einen externen Dienst, in dem Sie Texte zum Korrekturlesen zur Verfügung stellen und auf dem ihre Kollegen unkompliziert antworten können sollen? Dies könnte wie im folgenden Beispiel gelöst werden.
Voraussetzung:
Ein Dienst, der http Post Anfragen mit Get entgegen nimmt zur Verarbeitung des Formulars. Der Connector muss in dem Kanal konfiguriert sein, in dem sich die Benutzer befinden.
Umsetzung im WMS:
Um hier nur den Sektionsbereich angezeigt zu bekommen wurde das Zusammenfassungsfeld in der Nachrichten Aktivität ausgefüllt anstelle der Nachricht. Des Weiteren werden als Variablen benötigt:
eine Sektionsliste um die Sektion zu kapseln,
eine Aktionsliste, um die Aktionskarte zu kapseln und
eine weitere Liste von Aktionen für die Open Uri und die http Post Aktion.
eine Liste für das Eingabefeld als Variable im Workflow benötigt, um folgenden Workflow zu bauen
WMS Portalaufgabe Benachrichtigung
Anforderung:
Sie möchten benachrichtigt werden, wenn eine Aufgabe im Portal beendet oder abgebrochen wurde?
Dann könnte sie das wie im folgenden Beispiel lösen.
Mit einer Schaltfläche in der Nachricht gelangen Sie direkt in die Aufgabe.
Umsetzung im WMS
Für das Beispiel wurde eine Aktionsliste und eine Variable für die ID der Aufgabe erstellt.
Tipps und Tricks
Nachrichten in andere Office 365 Anwendungen schicken
Die Aktivität verwendet den Standard „Incoming Webhook Connector“ in Teams. Dieser Connector ist auch in anderen Office 365 Anwendungen verfügbar, sodass sich mit der Aktivität auch Nachrichten in diese Anwendungen (wie z.B. Outlook) schicken lassen können.