Microsoft Teams 用 Tableau アプリのセットアップ

Microsoft Teams 用 Tableau アプリを使用すると、ユーザーは仕事の流れを妨げることなく、Tableau ビュー (ビジュアライゼーション) とメトリクスを操作できます。Tableau 管理者は、アプリをインストールして設定し、既存の Tableau サイトを Microsoft Teams の環境と連携させます。Tableau Cloud 用アプリは、Microsoft Apps Marketplace から直接インストールできます。Tableau Server 用アプリをインストールするには、アプリをダウンロードしてサイド ロードします。

Microsoft Teams 用 Tableau アプリの詳細については、「Microsoft Teams での Tableau コンテンツへのアクセス」を参照してください。この記事では、Tableau アプリのセットアップについて説明します。

関連項目

前提条件

Microsoft Teams 用 Tableau アプリを設定するには、次のアプリとアカウントが必要です。

  • Tableau Cloud または Tableau Server バージョン 2023.1 以降
  • Tableau Cloud のサイト管理者アカウントまたは Tableau Server のサーバー管理者アカウント
  • Microsoft 365 for Enterprise サブスクリプション
  • Microsoft Teams
  • Microsoft 365 管理者アカウント (組織のポリシーでアプリをインストールするために管理者アカウントが必要な場合)
  • ユーザー マッピング属性のいずれかに基づいて相互に関連付けられた、Tableau と Microsoft Teams の両方のユーザー ライセンス

ユーザー マッピング属性

Tableau でのシングル サインオンを可能にするには、Microsoft Teams のユーザー アカウントを Tableau のユーザー アカウントにマッピングします。このマッピングは、Microsoft Teams SDK またはユーザーの Microsoft Entra プロファイルの属性を使用して設定できます。

Microsoft Teams SDK の属性

属性説明
Preferred_Username(新しいウィンドウでリンクが開く)Microsoft Teams ユーザーのメール アドレス。この値は、Microsoft Entra で定義されているメールと異なる場合があります。
User Principal Name(新しいウィンドウでリンクが開く)ユーザーが Microsoft Entra にログインする主な方法。

Microsoft Entra プロファイルの属性

属性説明
Primary Email(新しいウィンドウでリンクが開く)user.mail 属性に対応し、ユーザーのメール アドレスを表します。
Mail Nickname(新しいウィンドウでリンクが開く)user.mailNickname 属性に対応し、ユーザーのエイリアスを表します。
Employee ID(新しいウィンドウでリンクが開く)user.employeeId 属性に対応し、組織によって割り当てられた従業員 ID を表します。
On-Premise Distinguished Name(新しいウィンドウでリンクが開く)user.onPremiseDistinguishedName 属性に対応し、オンプレミスの Active Directory から同期された識別名 (DN) を表します。
On-Premise User Principal Name(新しいウィンドウでリンクが開く)user.onPremiseUserPrincipalName 属性に対応し、オンプレミスの Active Directory から同期された userPrincipalName を表します。
On-premise SAM Account Name(新しいウィンドウでリンクが開く)user.onPremiseSamAccountName 属性に対応し、オンプレミスの Active Directory から同期された samAccountName を表します。
Extension Attribute X(新しいウィンドウでリンクが開く)Microsoft Entra では、ユーザーの Entra プロファイルに最大 15 個の属性を追加できます。Tableau ユーザー名が Microsoft Entra に存在しない場合は、拡張機能属性を使用して各 Entra ユーザーの Tableau ユーザー名を格納します。

Tableau Server の追加の前提条件

Tableau アプリは API 呼び出しを使用して Tableau Server と通信し、インタラクティブなコンテンツを埋め込みます。これらの呼び出しは、Tableau Server に到達できる必要があります。

  • Tableau Server がファイアウォールの内側にある場合、4.152.0.0/15 および 20.2.0.0/16 の IP 範囲からの内向きの HTTP 要求を許可します。
  • ユーザーが Microsoft Teams にアクセスするのと同じ方法で Tableau Server にアクセスできる必要があります。
    • ユーザーが VPN を使用して Microsoft Teams にアクセスする必要がある場合、同じ VPN を使用して Tableau Server にアクセスできる必要があります。
    • ユーザーがパブリック インターネットから Microsoft Teams にアクセスできる場合、Tableau Server はパブリック インターネットからアクセスできる必要があります。
    • ユーザーがモバイル アプリ経由で Microsoft Teams にアクセスできる場合、Tableau Server がモバイル デバイスからアクセスできる必要があります。

Tableau Server 用 Tableau アプリのインストール

Tableau Server 用 Tableau アプリをインストールするには、アプリ マニフェストを編集してホスト名をカスタマイズしてから、アプリ マニフェストを Microsoft Teams にアップロードします。

Tableau Cloud 用 Tableau アプリをインストールするには、「Tableau Cloud セットアップ ガイド」を参照してください。

1.アプリ マニフェストをダウンロードして編集する

  1. GitHub から、「アプリ マニフェストをダウンロード」します。
  2. マニフェスト ファイル tableau-server-app-for-teams.zip からファイルを抽出します。

  3. テキスト エディターで manifest.json ファイルを開きます。

  4. manifest.json*.online.tableau.com を検索し、そのドメインを Tableau Server 環境のホスト名に置き換えます。Tableau Server の URL が https://analytics.company.com の場合、ホスト名は analytics.company.com になります。

  5. 変更内容を manifest.json に保存します。

  6. tableau-app-for-teams-server フォルダー内のファイルを圧縮して、変更内容を含む zip ファイルを作成します。

2.アプリ マニフェストをアップロードする

組織のアプリ ポリシーによって、Microsoft Teams アプリをインストールできるかどうかが決まります。アプリをインストールするには、Microsoft 365 管理者アカウントが必要になる場合があります。

  1. Microsoft Teams 管理センター(新しいウィンドウでリンクが開く)」を開きます。

  2. ナビゲーション パネルで、[Teams アプリ][アプリの管理] の順に選択します。

  3. [アクション][新しいアプリのアップロード] の順に選択します。

  4. 編集した tableau-server-app-for-teams.zip ファイルをアップロードします。アプリを管理するためのリンクが記載された確認メッセージが表示されます。

3.ユーザー用にアプリをインストールしてピン留めする

アプリをインストールすると、すべてのユーザーまたは一部のユーザーが利用できるようにすることができます。アプリをピン留めして、ユーザーのアプリ バーに表示することもできます。

  1. Microsoft Teams 管理センター(新しいウィンドウでリンクが開く)」を開きます。

  2. ナビゲーション パネルで、[Teams アプリ][セットアップ ポリシー] の順に選択します。

  3. [インストール済みアプリ][アプリの追加] を選択し、Tableau アプリを追加します。

  4. 必要に応じて、[ピン留めされたアプリ][アプリの追加] を選択し、Tableau アプリを追加します。

  5. 変更内容を保存します。

Tableau アプリを追加した後、ユーザーがアプリを利用できるようになるまでに最大 24 時間かかる場合があります。

Tableau アプリを設定する

Tableau アプリをインストールすると、アプリを設定するように Microsoft Teams から求められます。アプリを Tableau サイトに接続するためのサイト情報を設定します。

1.接続済みアプリを作成する

Microsoft Teams 用 Tableau アプリは、接続済みアプリを使用して、シングル サインオンでユーザーを認証します。Tableau Cloud または Tableau Server でこの接続済みアプリを作成します。

  1. Tableau Cloud または Tableau Server で、直接信頼の接続済みアプリを作成します。詳細については、「Tableau Cloud で直接信頼を使用して接続済みアプリを設定する」または「Tableau Server で直接信頼を使用して接続済みアプリを設定する(新しいウィンドウでリンクが開く)」を参照してください。

    • 接続済みアプリのドメイン許可リストを、指定したドメインのみに制限する場合は、次のドメインを許可リストに追加します。
      • tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net
      • teams.microsoft.com
      • *.teams.microsoft.com
    • ユーザーが他の Microsoft プラットフォームからアプリにアクセスする場合は、「Microsoft 365 URL(新しいウィンドウでリンクが開く)」の一覧からその他のドメインを追加します。
  2. 接続済みアプリを有効にします。

  3. 接続済みアプリのシークレットを生成します。

  4. 接続済みアプリのクライアント ID、シークレット ID、シークレット値をコピーします。これらの値を保存します。これらは、Microsoft Teams で Tableau サイトを設定する際に必要になります。

2.Tableau アプリにサイト設定を追加する

Tableau アプリを開いたとき、まだアプリが設定されていない場合は、セットアップ画面が表示されます。

  1. [ラベル] で、サイトに名前を付けます。この名前は、Microsoft Teams アプリのユーザーに表示されます。ラベルを入力しない場合、アプリはサイト名を表示します。このフィールドはオプションです。

  2. [Tableau サイト名] に、サイトの URL に表示されているとおりの名前を入力します。たとえば、URL が https://us-west-2b.online.tableau.com/#/site/mysitename/home の場合、「mysitename」と入力します。アプリを Tableau Server に接続していて、既定のサイトを使用する場合は、このフィールドを空白のままにします。

  3. [ベース URL] には、サイトの URL の tableau.com で終わる部分を入力します (例: https://us-west-2b.online.tableau.com)。

  4. [ユーザー マッピング属性] で、シングル サインオンでのユーザーの認証に使用する Microsoft Entra 属性を選択します。

  5. [接続済みアプリ ID][接続済みアプリ シークレット ID][接続済みアプリ シークレット値] に、接続済みアプリを作成したときにコピーした値を貼り付けます。

  6. [サイト設定の追加] を選択します。

設定の詳細を保存する前に、Tableau アプリが接続をテストします。アプリが Tableau に接続できない場合、サイト設定は追加されません。その場合、接続済みアプリが認証できない、接続済みアプリが有効になっていない、サイト情報が正しくない、または使用しているアカウントが Tableau 管理者アカウントではないことが原因である可能性があります。また、アプリがファイアウォールの背後にあるため、Tableau Server に到達できない場合もあります。

サイトの設定を追加または削除する

サイト設定を追加した後、その他のサイト設定を追加したり、既存のサイト設定を削除したりできます。

  1. Microsoft Teams 用 Tableau アプリで、[設定] タブを選択します。

  2. [設定] で [Tableau サイトの設定] タブを選択します。このタブの設定にアクセスできるのは Tableau 管理者のみです。

  3. サイトを追加するには、[サイトの詳細の追加] を選択します。サイトを削除するには、そのサイトの削除アイコンを選択します。

フィードバックをお送りいただき、ありがとうございます。フィードバックは正常に送信されました。ありがとうございます!