Die MS Teams-Kommunikationserweiterung stellt einen Bot zur Verfügung, der von Microsoft Teams aus aufgerufen werden kann, um Informationen vom i-net Clear Reports Server anzufordern. Der Bot wird über Ausgehende Webhooks angebunden. Die von Microsoft Teams bereitgestellten Eingehenden Webhooks können für die Verwendung mit der Aufgabenplanung eingerichtet werden - um z.B. Status- oder Benachrichtigungsmeldungen zu senden.

Der Microsoft Teams-Bot ermöglicht es, Informationen vom i-net Clear Reports Server anzufordern. Die Liste der verfügbaren Befehle wird zurückgegeben, wenn der Bot ohne einen bestimmten Befehl aufgerufen wird - z.B. mit @botname.

Hinweis: Um den i-net Clear Reports Server mit einem ausgehenden Microsoft Teams-Webhook zu verbinden, ist es erforderlich, dass zumindest der Serverkontext /bot/msteams öffentlich verfügbar ist. Zu Testzwecken können Sie ngrok verwenden.

Hinweis: Das Token Authentication Plugin muss aktiviert sein und das HMCA Login in der Konfiguration hinzugefügt werden, damit die ausgehenden Webhooks funktionieren. Dies sollte vorbereitet werden, bevor Sie mit dem folgenden Prozess fortfahren.

Der Prozess der Erstellung einer Bot-Verbindung wird hier in Ergänzung zum Support-Dokument von Microsoft beschrieben:

1. Melden Sie sich bei Microsoft Teams an.
2. Wählen Sie "Team verwalten" aus dem Drei-Punkte-Menü Ihres Teams
3. Wählen Sie "App" und dann "Ausgehenden Webhook erstellen"
4. Füllen Sie die angeforderten Informationen aus. Es hängt davon ab, wie Ihr Server aus dem Internet erreichbar ist, welche Adresse Sie eingeben müssen. In der Regel wird sie lauten: https://your-server.com/bot/msteams. Sie sollten vorher überprüfen, ob diese Adresse im Internet verfügbar ist, sonst wird die Bot-Registrierung fehlschlagen.
   • Hinweis: Es ist möglich, die URL später zu ändern, falls sie sich ändert.
5. Wählen Sie "Erstellen". Bei Erfolg wird Ihnen ein geheimes Token angezeigt, das in der i-net Clear Reports-Serverkonfiguration eingegeben werden muss.
   1. Stellen Sie sicher, dass das Token Authentication Plugin aktiviert ist und der HMCA Login in der Konfiguration hinzugefügt wurde.
   2. Öffnen Sie den Benutzer- und Gruppenmanager und wählen Sie den Benutzer aus, den Sie für den Webhook verwenden und dem Sie Zugriff gewähren möchten. Der Benutzer benötigt keinen Login-Eintrag.
   3. Stellen Sie sicher, dass der Benutzer die Token Authentication Berechtigung besitzt. Wenn Sie den Benutzer neu hinzugefügt haben, müssen Sie Speichern und den Benutzereinstellungsdialog erneut öffnen
   4. Überprüfen Sie andere erforderliche Berechtigungen für den Benutzer, die vom Bot verwendet werden können
   5. Wählen Sie das Feld Access Tokens und fügen Sie einen Eintrag für einen HMAC Token hinzu
   6. Fügen Sie das geheime Token ein
   7. Überprüfen Sie die Berechtigungen der jeweiligen Komponenten

Ein Webhook ist eine alternative Möglichkeit, Informationen an MS Teams zu senden. Webhooks werden z.B. vom Task Planner verwendet, um Benachrichtigungen an einen bestimmten Kanal zu senden.

Die Konfiguration der eingehenden Webhooks erlaubt es, diese an verschiedenen Stellen im System durch die Benutzern verwenden zu lassen. Ein Webhook wird von einem Serveradministrator in Microsoft Teams erstellt.

1. Wählen Sie in Ihrem Teams-Kanal unter "Workflows" die folgende Option aus
2. Dadurch wird ein mehrstufiger Assistent geöffnet, mit dem Sie konfigurieren können, wie Webhook-Benachrichtigungen in Ihrem Kanal gepostet werden sollen. Klicken Sie auf "Weiter".
3. Wählen Sie dann den Kanal aus, an den die Webhook-Benachrichtigung gesendet werden soll.

- Danach wird eine URL für Webhooks bereitgestellt, an die gepostet werden kann. Kopieren Sie diese URL und fügen Sie sie als "Incoming Webhook"-URL in die i-net Clear Reports-Serverkonfiguration von MS Teams ein.