Konfigurieren von Microsoft Teams-Benachrichtigungen

AI/BI-Dashboards unterstützen das Senden geplanter Momentaufnahmen an Microsoft Teams-Kanäle. Auf diese Weise können Teams Dashboardupdates direkt in ihrem Teams-Arbeitsbereich empfangen. Auf dieser Seite wird erläutert, wie Sie eine Microsoft Teams-App erstellen und einen Teams-Kanal als Benachrichtigungsziel konfigurieren. Dashboard-Editoren können dieses Benachrichtigungsziel dann als Abonnent für geplante Dashboards hinzufügen. Informationen zum Hinzufügen eines Teams-Kanals als Abonnent finden Sie unter Abonnieren eines Slack- oder Microsoft Teams-Kanals.

Teams-Abonnements liefern Dashboardmomentaufnahmen, die Folgendes umfassen:

• Eine PNG-Bildmomentaufnahme des Dashboards, das direkt im Kanal sichtbar ist
• Ein direkter Link zum Öffnen des Dashboards in Azure Databricks
• Eine PDF-Momentaufnahmeanlage im Nachrichtenthread

Anforderungen

Sie müssen über die folgenden Berechtigungen verfügen:

• Sie müssen ein Azure Databricks-Arbeitsbereichsadministrator sein, um Benachrichtigungsziele zu konfigurieren.
• Sie müssen die entsprechenden Berechtigungen besitzen, um Apps zu registrieren und die Admin-Erlaubnis in Microsoft Entra ID zu erteilen. Sie müssen außerdem in der Lage sein, eine Azure-Bot-Ressource im Azure-Portal zu erstellen, eine Teams-App hinzuzufügen und Power Automate-Workflows in Microsoft Teams zu erstellen.

Während des Setupvorgangs sammeln Sie Authentifizierungsanmeldeinformationen von Microsoft, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren.

Nachdem Sie das Benachrichtigungsziel konfiguriert haben, kann jeder Benutzer mit CAN EDIT-Berechtigungen auf einem Dashboard das Teams-Ziel als Abonnent zu den Zeitplänen hinzufügen, die sie verwalten.

Schritt 1: Erstellen und Konfigurieren einer Microsoft Teams-App

Registrieren Sie eine Microsoft Entra ID-App, erstellen Sie einen Azure-Bot, der mit dieser App verknüpft ist, und fügen Sie eine Teams-App für den Bot zu Ihrem Kanal hinzu.

Registrieren Sie eine Microsoft Entra ID-App

1. Navigieren Sie zum Microsoft Entra Admin Center.
2. Klicken Sie auf Applications > App-Registrierungen > Neue Anmeldung.
3. Gib einen Namen für die App ein und klicke auf Registrieren.
4. Kopieren Sie auf der Seite "Übersicht " der App die Anwendungs-ID (Client-ID). Du brauchst diesen Wert, um den Azure Bot zu erstellen und das Azure Databricks Benachrichtigungsziel zu konfigurieren.

Konfigurieren von App-Berechtigungen in der Microsoft Entra-ID

1. Im Microsoft Entra Admin Center, mit ausgewählter App-Registrierung, klicken Sie in der linken Seitenleiste auf API-Berechtigungen.
2. Klicken Sie auf Berechtigung hinzufügen.
3. Klicken Sie in Microsoft-APIs auf Microsoft Graph-Anwendungsberechtigungen>.
4. Fügen Sie die folgenden Berechtigungen hinzu:
   • Files.Read.All
   • Sites.ReadWrite.All
5. Klicken Sie auf Berechtigungen hinzufügen.
6. Klicken Sie auf " Administratorzustimmung erteilen", um die Berechtigungen für Ihre Organisation zu erteilen.

Erstellen eines geheimen Authentifizierungsschlüssels

1. Im Microsoft Entra Admin Center, mit ausgewählter App-Registrierung, klicken Sie auf Zertifikate & Geheimnisse.
2. Klicken Sie auf "Geheime > Clientschlüssel" (Neuer geheimer Clientschlüssel).
3. Geben Sie eine Beschreibung ein, und wählen Sie einen Ablaufzeitraum aus.
4. Klicken Sie auf Hinzufügen.
5. Kopieren Sie den Wert des neu erstellten geheimen Schlüssels. Dieser Wert wird nur einmal angezeigt, und Sie benötigen ihn, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren.

Erhalten Sie die Mandanten-ID

1. Navigieren Sie im Microsoft Entra Admin Center mit ausgewählter App-Registrierung zu "Übersicht".
2. Kopieren Sie die Verzeichnis (Mandanten-) ID. Sie benötigen diesen Wert, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren.

Create an Azure Bot für die App

Erstellen Sie eine Azure-Bot-Ressource, die die von Ihnen registrierte Microsoft Entra ID-App verwendet.

1. Gehe zum Azure-Portal und klicke auf Resource erstellen.
2. Suche nach Azure Bot, wähle die Azure Bot-Karte aus und klicke auf Erstellen.
3. Unter Microsoft App ID wählen Sie "Bestehende App-Registrierung verwenden" und geben Sie die Anwendungs-(Client-)ID der registrierten App ein.
4. Füllen Sie die verbleibenden erforderlichen Felder aus und klicken Sie dann auf Überprüfen + erstellen > Erstellen.
5. Wenn die Bereitstellung abgeschlossen ist, klicke auf Zur Ressource gehen.

Verbinden Sie den Bot mit Microsoft Teams

Füge den Microsoft Teams-Kanal dem Bot hinzu, erstelle dann eine Teams-App für den Bot und füge sie deinem Kanal hinzu. Für das vollständige Verfahren siehe Einen Bot mit Microsoft Teams in der Azure Bot Service Dokumentation verbinden.

1. Öffne in der Azure Bot-Ressource die Einstellungskanäle > und klicke auf Microsoft Teams.
2. Stimmen Sie den Nutzungsbedingungen zu. Wähle im Tab Messaging die Cloud-Umgebung deines Bots aus und klicke dann auf Anwenden.
3. Erstellen Sie eine Teams-App für den Bot, paketieren Sie sie und laden Sie sie in Microsoft Teams hoch. Für Anleitungen siehe Veröffentlichen deines Bots in Teams.
4. Füge die Teams-App dem Kanal hinzu, auf dem du Dashboard-Benachrichtigungen erhalten möchtest.

Erhalten der Teams-Kanal-URL

1. Navigieren Sie in Microsoft Teams zum Zielkanal.
2. Klicken Sie auf das Hamburger-Menü ••• neben dem Kanalnamen.
3. Klicken Sie auf "Link kopieren". Stellen Sie sicher, dass Sie die Kanal-URL und nicht die Teams-URL kopieren. Sie benötigen diese URL, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren.

Erstellen eines eingehenden Webhooks für den Kanal

1. Folgen Sie den Microsoft-Schritten, um einen eingehenden Webhook mit Workflows for Microsoft Teams zu erstellen, indem Sie die Webhook-Benachrichtigungen an eine Kanalvorlage senden und den Zielkanal auswählen.
2. Kopieren sie die generierte Webhook-URL, und speichern Sie sie. Sie benötigen diese URL, um das Azure Databricks-Benachrichtigungsziel zu konfigurieren.

Schritt 2: Konfigurieren des Benachrichtigungsziels in Azure Databricks

Erstellen Sie ein Benachrichtigungsziel in Ihrem Azure Databricks-Arbeitsbereich, der auf Ihren Microsoft Teams-Kanal verweist.

1. Melden Sie sich bei Ihrem Azure Databricks-Arbeitsbereich an.

2. Klicken Sie in der oberen rechten Ecke des Arbeitsbereichs auf Ihren Benutzernamen.

3. Wählen Sie "Einstellungen" aus der Dropdownliste aus.

4. Klicken Sie im Abschnitt Arbeitsbereichsadministrator auf die Registerkarte Benachrichtigungen.

5. Klicken Sie im Abschnitt "Benachrichtigungsziele" auf "Verwalten".

6. Klicken Sie auf "Ziel hinzufügen".

7. Wählen Sie Microsoft Teams aus der Dropdownliste für den Zieltyp aus.

8. Geben Sie die folgenden Informationen ein:

   • Name: Ein beschreibender Name für dieses Teams-Kanalziel
   • Microsoft Teams-Webhook-URL: Die Webhook-URL aus dem eingehenden Microsoft Teams-Webhook
   • App-ID: Die Anwendungs-(Client-)ID aus Ihrer Microsoft Entra ID-App-Registrierung
   • Authentifizierungsgeheimnis: Der wert des geheimen Clientschlüssels von Microsoft Entra ID
   • Kanal-URL: Die Kanal-URL von Microsoft Teams
   • Mandanten-ID: Die Verzeichnis-ID (Mandant) von Microsoft Entra ID

9. Klicken Sie auf "Erstellen".

Benutzer können dieses Teams-Benachrichtigungsziel jetzt als Abonnenten zu den Dashboard-Zeitplänen hinzufügen.

Anweisungen zum Abonnieren von Teams-Kanälen zu Dashboardzeitplänen finden Sie unter Abonnieren eines Slack- oder Microsoft Teams-Kanals.

Problembehandlung

Gehen Sie folgendermaßen vor, um häufige Fehler mit Microsoft Teams-Benachrichtigungen zu beheben.

Fehlender PDF-Anhang

Wenn die Teams-Benachrichtigung ohne PDF-Anlage angezeigt wird, überprüfen Sie bitte Folgendes:

• Die Anwendungs-(Client-)ID ist korrekt im Benachrichtigungsziel konfiguriert
• Der geheime Authentifizierungsschlüssel ist gültig und ist nicht abgelaufen.
• Der App wurden die erforderlichen Berechtigungen Files.Read.All und Sites.ReadWrite.All in Microsoft Entra ID erteilt.
• Die Administratorzustimmung wurde für die API-Berechtigungen erteilt.

Die Benachrichtigung wird nicht angezeigt.

Wenn Benachrichtigungen nicht in Ihrem Teams-Kanal angezeigt werden:

• Überprüfen, ob die Webhook-URL korrekt ist und dem Zielkanal entspricht
• Überprüfen Sie, ob das Authentifizierungsgeheimnis den Wert des Client-Geheimnisses aus der Microsoft Entra ID und nicht die geheime ID verwendet.
• Überprüfe, ob die Teams-App für den Bot zum Zielkanal hinzugefügt wurde
• Stellen Sie sicher, dass die Kanal-URL korrekt ist.
• Überprüfen, ob die Mandanten-ID Mit Ihrer Microsoft-Organisation übereinstimmt
• Bestätigen, dass der Zeitplan aktiv ist und nicht pausiert ist

Nächste Schritte

• Abonnieren Sie Teams-Kanäle für Dashboardzeitpläne. Siehe Abonnieren eines Slack- oder Microsoft Teams-Kanals
• Konfigurieren von Slack-Benachrichtigungszielen. Siehe Konfigurieren von Slack-Benachrichtigungen
• Konfigurieren von E-Mail-Benachrichtigungszielen. Siehe Verwalten von Benachrichtigungszielen