Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Image Removed

Inhalt

toc
Image Added

Handbuch

Im diesem Handbuch finden Sie alle Informationen und Beispiele zu den MS Teams Aktivitäten:

View file
nameALRO IT GmbH - Handbuch MS Teams Aktivitäten.pdf

Inhalt

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. Die einzelnen Aktionen erstellen Sie jeweils mit eigenen Aktivitäten. Diese Aktionen stehen zur Verfügung:

  • Open Uri Aktion: Öffnet einen Link zu einer Seite im Standardbrowser auf dem Gerät, auf dem die Teams Nachricht zu sehen ist.

  • Http Post Aktion: Führt eine Http Post Aktion auf die hinterlegte URL aus.

  • Aktionskarten Aktion: Ein gekapselter Bereich mit Eingabemöglichkeiten, und einem Aktionsbereich der auf http Post Aktionen oder Open Uri Aktionen eingeschränkt ist.

Ausgabe

Name

Beschreibung

Datentyp

Erforderlich

Erfolgreich

Ein Rückgabewert der bei erfolgreichem Versand „wahr, ansonsten falsch ist.

Beispiel

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

Image RemovedImage Added

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.

Image RemovedImage Added

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>" +
"![Bild](https://www.alro-it.de/.../white-rolling-armchairbeside-table-1957478-Kopie.jpg) "

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

![Bild](https://...)

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.

Image Removed

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.

Die Aktivität für das Nachrichten Beispiel sieht wie folgt aus:

Image RemovedImage Added
Image Added

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.

Erweitern
titleWorkflow ausklappen
Image AddedImage Added

Image Added

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

Erweitern
titleWorkflow
:Image Removed
ausklappen
Image Added

Image Added

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.

Erweitern
titleWorkflow ausklappen
Image Added

Image Added

Tipps und Tricks

Info

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.