Microsoft Teams通知を構成する

AI/BI ダッシュボードでは、スケジュールされたスナップショットを Microsoft Teams チャネルに送信できます。 これにより、チームは Teams ワークスペースでダッシュボードの更新プログラムを直接受け取ることができます。 このページでは、Microsoft Teams アプリを作成し、通知先として Teams チャネルを構成する方法について説明します。 ダッシュボード エディターは、スケジュールされたダッシュボードにサブスクライバーとしてこの通知先を追加できます。 Teams チャネルをサブスクライバーとして追加する方法については、「 Slack または Microsoft Teams チャネルをサブスクライブする」を参照してください。

Teams サブスクリプションは、次のようなダッシュボード スナップショットを提供します。

• チャネルに直接表示されるダッシュボードの PNG イメージ スナップショット
• Azure Databricks でダッシュボードを開く直接リンク
• メッセージ スレッド内の PDF スナップショット添付ファイル

Requirements

次のアクセス許可が必要です。

• 通知先を構成するには、Azure Databricks ワークスペース管理者である必要があります。
• Microsoft Entra IDでアプリを登録し、管理者の同意を与えるには適切な権限が必要です。 また、Azure portalでAzure Botリソースを作成し、Microsoft TeamsでTeamsアプリを追加し、Power Automateワークフローを作成できる必要があります。

セットアップ プロセス中に、Microsoft から認証資格情報を収集して、Azure Databricks 通知先を構成します。

通知先を構成した後、ダッシュボードで CAN EDIT アクセス許可を持つすべてのユーザーは、Teams の宛先をサブスクライバーとして追加して、管理するスケジュールを設定できます。

手順 1: Microsoft Teams アプリを作成して構成する

Microsoft Entra IDアプリを登録し、そのアプリに関連付けられたAzureボットを作成し、そのボット用のTeamsアプリをチャンネルに追加します。

Register a Microsoft Entra ID app

1. Microsoft Entra 管理センター に移動します。
2. 「応募」> アプリの登録 >「新規登録」をクリックしてください。
3. アプリ名を入力して 「登録」をクリックします。
4. アプリの [概要 ] ページで、 アプリケーション (クライアント) ID をコピーします。 この値はAzure Botを作成し、Azure Databricksの通知宛先を設定するために必要です。

Microsoft Entra ID でアプリのアクセス許可を構成する

1. Microsoft Entra 管理センターでアプリ登録を選択し、左サイドバーのAPI権限をクリックします。
2. [ アクセス許可の追加] をクリックします。
3. Microsoft API で、[Microsoft Graph > アプリケーションのアクセス許可] をクリックします。
4. 次のアクセス許可を追加します。
   • Files.Read.All
   • Sites.ReadWrite.All
5. [アクセス許可を追加する] をクリックします。
6. [ 管理者の同意を付与 ] をクリックして、組織のアクセス許可を付与します。

認証シークレットを作成する

1. Microsoft Entra 管理センターでアプリ登録を選択し、「証明書&シークレット」をクリックしてください。
2. [ クライアント シークレット] > [新しいクライアント シークレット] をクリックします。
3. 説明を入力し、有効期限を選択します。
4. 追加をクリックします。
5. 新しく作成されたシークレットの 値 をコピーします。 この値は 1 回だけ表示され、Azure Databricks 通知先を構成するために必要です。

テナント ID を取得する

1. Microsoft Entra 管理センターで、アプリの登録が選択されている状態で、[ 概要] に移動します。
2. ディレクトリ (テナント) ID をコピーします。 Azure Databricks 通知先を構成するには、この値が必要です。

アプリ用のAzureボットを作成

登録したMicrosoft Entra IDアプリを使うAzureボットリソースを作成しましょう。

1. Azure portalにアクセスして「リソースを作成」をクリックします。
2. Azure Botを検索し、Azureボットカードを選択し、「作成」をクリックします。
3. Microsoft App IDで「既存のアプリ登録を使用」を選択し、登録したアプリのアプリケーション(クライアント)IDを入力してください。
4. 残りの必須項目を記入し、 レビュー+作成 > 作成をクリックします。
5. 展開が完了したら、「 リソースへ移動」をクリックします。

ボットをMicrosoft Teamsに接続する

Microsoft Teamsチャンネルをボットに追加し、そのボット用のTeamsアプリを作成し、自分のチャンネルに追加してください。 手順の詳細については、Azure Bot Serviceドキュメントの「Connect a bot to Microsoft Teams」をご覧ください。

1. Azureボットリソースで「チャンネル設定」>開いて「Microsoft Teams」をクリックします。
2. 利用規約に同意します。 メッセージングタブで、ボットのクラウド環境を選択し、「適用」をクリックします。
3. ボット用のTeamsアプリを作成し、パッケージ化してMicrosoft Teamsにアップロードします。 手順については「 Teamsでボットを公開する」をご覧ください。
4. ダッシュボードの通知を受け取りたいチャンネルにTeamsアプリを追加してください。

Teams チャネルの URL を取得する

1. Microsoft Teamsで、宛先チャネルに移動します。
2. チャネル名の横にあるハンバーガー メニュー ••• をクリックします。
3. リンクをコピークリックします。 Teams の URL ではなく、チャネル URL をコピーしてください。 Azure Databricks 通知先を構成するには、この URL が必要です。

チャネル用の受信 Webhook を作成する

1. Microsoftの手順に従って、Microsoft Teamsのワークフローで受信ウェブフックを作成し、チャネルテンプレートにウェブフックを送り、宛先チャンネルを選択します。
2. 生成された Webhook URL をコピーして保存します。 Azure Databricks 通知先を構成するには、この URL が必要です。

手順 2: Azure Databricks で通知先を構成する

Microsoft Teams チャネルを指す通知先を Azure Databricks ワークスペースに作成します。

1. Azure Databricks ワークスペースにログインします。

2. ワークスペースの右上隅にあるユーザー名をクリックします。

3. ドロップダウンから [設定] を選択します。

4. [ワークスペース管理者] セクションで、[通知] タブをクリックします。

5. [通知先] セクションの [管理] をクリックします。

6. [ 宛先の追加] をクリックします。

7. 宛先 の 種類のドロップダウンからMicrosoft Teamsを選択します。

8. 次の情報を入力してください。

   • 名前: この Teams チャネル宛先のわかりやすい名前
   • Microsoft Teams Webhook URL: Teams 受信 Webhook からの webhook URL
   • App ID:Microsoft Entra IDアプリ登録からのアプリケーション(クライアント)ID。
   • 認証シークレット: Microsoft Entra ID からのクライアント シークレット値
   • チャネル URL: Microsoft Teamsからのチャネル URL
   • テナント ID: Microsoft Entra ID からのディレクトリ (テナント) ID

9. Create をクリックしてください。

ユーザーは、この Teams 通知先をサブスクライバーとしてダッシュボード スケジュールに追加できるようになりました。

Teams チャネルをダッシュボード スケジュールにサブスクライブする手順については、「 Slack または Microsoft Teams チャネルをサブスクライブする」を参照してください。

トラブルシューティング

Microsoft Teams通知に関する一般的なエラーのトラブルシューティングを行うには、次のコマンドを使用します。

PDF 添付ファイルが見つからない

PDF 添付ファイルなしで Teams の通知が表示される場合は、次のことを確認します。

• 通知宛先で アプリケーション(クライアント)ID が正しく設定されています
• 認証シークレットは有効であり、有効期限が切れていない
• アプリには、Microsoft Entra ID で必要な Files.Read.All と Sites.ReadWrite.All のアクセス許可が付与されています
• API のアクセス許可に対する管理者の同意が付与されました

通知が表示されない

Teams チャネルに通知が表示されない場合:

• Webhook URL が正しく、宛先チャネルと一致するかどうかを確認する
• 認証シークレットで、シークレット ID ではなく Microsoft Entra ID のクライアント シークレット値が使用されていることを確認する
• ボットのTeamsアプリが宛先チャンネルに追加されているか確認してください
• チャネル URL が正しいことを確認する
• テナント ID が Microsoft 組織と一致するかどうかを確認する
• スケジュールがアクティブであり、一時停止されていないことを確認する

次のステップ

• Teams チャネルをダッシュボードのスケジュールに登録します。 Slack または Microsoft Teams チャネルのサブスクライブを参照してください
• Slack の通知先を構成します。 Slack 通知の構成を参照してください
• 電子メール通知の送信先を構成します。 通知の宛先の管理を参照してください