Konfigurera Microsoft Teams-meddelanden

AI/BI-instrumentpaneler stöder sändning av schemalagda ögonblicksbilder till Microsoft Teams-kanaler. På så sätt kan team ta emot instrumentpanelsuppdateringar direkt på sin Teams-arbetsyta. Den här sidan förklarar hur du skapar en Microsoft Teams-app och konfigurerar en Teams-kanal som ett meddelandemål. Instrumentpanelsredigerare kan sedan lägga till det här meddelandemålet som prenumerationsmottagare på schemalagda instrumentpaneler. Information om hur du lägger till en Teams-kanal som prenumerant finns i Prenumerera på en Slack- eller Microsoft Teams-kanal.

Teams-prenumerationer levererar ögonblicksbilder av instrumentpaneler som innehåller:

• En PNG-bildögonblicksbild av instrumentpanelen som visas direkt i kanalen
• En direktlänk för att öppna instrumentpanelen i Azure Databricks
• En pdf-ögonblicksbildbilaga i meddelandetråden

Kravspecifikation

Du måste ha följande behörigheter:

• Du måste vara administratör för Azure Databricks-arbetsytan för att konfigurera notifikationsdestinationer.
• Du måste ha rätt behörigheter för att registrera appar och ge administratörssamtycke i Microsoft Entra ID. Du måste också kunna skapa en Azure Bot-resurs i Azure Portal, lägga till en Teams-app och skapa Power Automate-arbetsflöden i Microsoft Teams.

Under installationsprocessen samlar du in autentiseringsuppgifter från Microsoft för att konfigurera Azure Databricks-meddelandemålet.

När du har konfigurerat aviseringsdestinationen kan alla användare med redigeringsbehörighet på en instrumentpanel lägga till Teams-destinationen som prenumerant på de scheman de hanterar.

Steg 1: Skapa och konfigurera en Microsoft Teams-app

Registrera en Microsoft Entra ID-app, skapa en Azure-bot kopplad till den appen och lägg till en Teams-app för boten i din kanal.

Registrera en Microsoft Entra ID-app

1. Gå till administrationscenter för Microsoft Entra.
2. Klicka på Applications > App registrations > Ny registrering.
3. Ange ett namn på appen och klicka på Registrera.
4. På appens översiktssida kopierar du program-ID:t (klient-ID:t). Du behöver detta värde för att skapa Azure Bot och för att konfigurera Azure Databricks notifikationsdestination.

Konfigurera appbehörigheter i Microsoft Entra-ID

1. I Microsoft Entra administrationscenter, med din appregistrering vald, klicka på API-behörigheter i vänstra sidofältet.
2. Klicka på Lägg till en behörighet.
3. I Microsoft API:er klickar du på Microsoft Graph-programbehörigheter>.
4. Lägg till följande behörigheter:
   • Files.Read.All
   • Sites.ReadWrite.All
5. Klicka på Lägg till behörigheter.
6. Klicka på Bevilja administratörsmedgivande för att bevilja behörigheter för din organisation.

Skapa en autentiseringshemlighet

1. I Microsoft Entra administrationscenter, med din appregistrering vald, klicka på Certifikat & hemligheter.
2. Klicka på Klienthemligheter > Ny klienthemlighet.
3. Ange en beskrivning och välj en förfalloperiod.
4. Klicka på Lägg till.
5. Kopiera värdet för den nyligen skapade hemligheten. Det här värdet visas bara en gång och du behöver det för att konfigurera Azure Databricks-meddelandemålet.

Hämta hyresgäst-ID

1. I administrationscentret för Microsoft Entra går du till Översikt med din appregistrering vald.
2. Kopiera katalog-ID :t (klientorganisation). Du behöver det här värdet för att konfigurera Azure Databricks-meddelandemålet.

Create an Azure Bot för appen

Skapa en Azure Bot-resurs som använder Microsoft Entra ID-appen du registrerade.

1. Gå till Azure Portal och klicka på Create a resource.
2. Sök efter Azure Bot, välj Azure Bot-kortet och klicka på Skapa.
3. Under Microsoft App ID väljer du Använd befintlig appregistrering och ange applikations-ID:t (klient) för den app du registrerat.
4. Fyll i de återstående obligatoriska fälten, klicka sedan på Granska + skapa > Skapa.
5. När distributionen är klar, klicka på Gå till resurs.

Koppla boten till Microsoft Teams

Lägg till Microsoft Teams-kanalen i boten, skapa sedan en Teams-app för boten och lägg till den i din kanal. För hela proceduren, se Koppla en bot till Microsoft Teams i Azure Bot Service dokumentation.

1. I Azure Bot-resursen, öppna Inställningar > Kanaler och klicka på Microsoft Teams.
2. Godkänn villkoren för tjänsten. På fliken Meddelande, välj molnmiljön för din bot och klicka sedan på Tillämpa.
3. Skapa en Teams-app för boten, paketera den och ladda upp den till Microsoft Teams. För instruktioner, se Publicera din bot i Teams.
4. Lägg till Teams-appen i kanalen där du vill få dashboard-notiser.

Få URL för Teams-kanalen

1. I Microsoft Teams navigerar du till målkanalen.
2. Klicka på hamburgermenyn ••• bredvid kanalnamnet.
3. Klicka på Länken Kopiera. Se till att kopiera kanal-URL:en och inte Teams-URL:en. Du behöver den här URL:en för att konfigurera Azure Databricks-meddelandemålet.

Skapa en inkommande webhook för kanalen

1. Följ Microsoft steg för att skapa en inkommande webhook med Workflows for Microsoft Teams, genom att använda Skicka webhook-varningar till en kanalmall och välja destinationskanalen.
2. Kopiera och spara den genererade webhookens URL. Du behöver den här URL:en för att konfigurera Azure Databricks-meddelandemålet.

Steg 2: Konfigurera meddelandemålet i Azure Databricks

Skapa ett meddelandemål på din Azure Databricks-arbetsyta som pekar på din Microsoft Teams-kanal.

1. Logga in på din Azure Databricks-arbetsyta.

2. Klicka på ditt användarnamn i det övre högra hörnet på arbetsytan.

3. Välj Inställningar i listrutan.

4. I avsnittet Arbetsyteadministratör klickar du på fliken Meddelanden.

5. Klicka på Hantera i avsnittet Aviseringsmål.

6. Klicka på Lägg till mål.

7. Välj Microsoft Teams i listrutan måltyp.

8. Ange följande information:

   • Namn: Ett beskrivande namn för det här Teams-kanalmålet
   • Webhook-URL för Microsoft Teams: Webhook-URL från Teams inkommande webhook
   • App-ID: Applikations-ID:t (klient-)ID från din Microsoft Entra ID-appregistrering
   • Autentiseringshemlighet: Klienthemlighetsvärdet från Microsoft Entra-ID
   • Kanal-URL: Kanal-URL:en från Microsoft Teams
   • Klientorganisations-ID: Katalog (klientorganisation) ID från Microsoft Entra ID

9. Klicka på Skapa.

Användare kan nu lägga till denna Teams-notifikationsdestination som mottagare i panel-scheman.

Anvisningar om hur du prenumererar på Teams-kanaler till panelschema finns i Prenumerera på en Slack- eller Microsoft Teams-kanal.

Felsökning

Använd följande för att felsöka vanliga fel med Microsoft Teams-meddelanden.

Saknad PDF-bilaga

Om Teams-meddelandet visas utan en PDF-bifogad fil kontrollerar du att:

• Applikations-ID:t (klient) är korrekt konfigurerat i notifikationsdestinationen
• Autentiseringshemligheten är giltig och har inte upphört att gälla
• Appen har beviljats nödvändiga Files.Read.All och Sites.ReadWrite.All behörigheter i Microsoft Entra ID
• Administratörsmedgivande har beviljats för API-behörigheterna

Meddelandet visas inte

Om meddelanden inte visas i Teams-kanalen:

• Kontrollera att webhookens URL är korrekt och matchar målkanalen
• Kontrollera att autentiseringshemligheten använder klienthemlighetsvärdet från Microsoft Entra-ID:t och inte det hemliga ID:t
• Kontrollera att Teams-appen för boten har lagts till i destinationskanalen
• Kontrollera att kanal-URL:en är korrekt
• Kontrollera att klientorganisations-ID:t matchar din Microsoft-organisation
• Bekräfta att schemat är aktivt och inte pausat

Nästa steg

• Anmäl dig till Teams-kanaler för översiktsscheman. Se Prenumerera på en Slack- eller Microsoft Teams-kanal
• Konfigurera Slack-meddelandemål. Se Konfigurera Slack-meddelanden
• Konfigurera e-postaviseringsmål. Se Hantera aviseringsmål