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 アプリのセットアップについて説明します。
関連項目
- GitHub の Tableau アプリに関する FAQ(新しいウィンドウでリンクが開く)
- GitHub のリリース ノート(新しいウィンドウでリンクが開く)
- Youtube の入門チュートリアル(新しいウィンドウでリンクが開く)
前提条件
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.アプリ マニフェストをダウンロードして編集する
- GitHub から、「アプリ マニフェストをダウンロード」します。
マニフェスト ファイル
tableau-server-app-for-teams.zipからファイルを抽出します。テキスト エディターで
manifest.jsonファイルを開きます。manifest.jsonで*.online.tableau.comを検索し、そのドメインを Tableau Server 環境のホスト名に置き換えます。Tableau Server の URL がhttps://analytics.company.comの場合、ホスト名はanalytics.company.comになります。変更内容を
manifest.jsonに保存します。tableau-app-for-teams-serverフォルダー内のファイルを圧縮して、変更内容を含む zip ファイルを作成します。
2.アプリ マニフェストをアップロードする
組織のアプリ ポリシーによって、Microsoft Teams アプリをインストールできるかどうかが決まります。アプリをインストールするには、Microsoft 365 管理者アカウントが必要になる場合があります。
ナビゲーション パネルで、[Teams アプリ]、[アプリの管理] の順に選択します。
[アクション]、[新しいアプリのアップロード] の順に選択します。
編集した
tableau-server-app-for-teams.zipファイルをアップロードします。アプリを管理するためのリンクが記載された確認メッセージが表示されます。
3.ユーザー用にアプリをインストールしてピン留めする
アプリをインストールすると、すべてのユーザーまたは一部のユーザーが利用できるようにすることができます。アプリをピン留めして、ユーザーのアプリ バーに表示することもできます。
ナビゲーション パネルで、[Teams アプリ]、[セットアップ ポリシー] の順に選択します。
[インストール済みアプリ] で [アプリの追加] を選択し、Tableau アプリを追加します。
必要に応じて、[ピン留めされたアプリ] で [アプリの追加] を選択し、Tableau アプリを追加します。
変更内容を保存します。
Tableau アプリを追加した後、ユーザーがアプリを利用できるようになるまでに最大 24 時間かかる場合があります。
Tableau アプリを設定する
Tableau アプリをインストールすると、アプリを設定するように Microsoft Teams から求められます。アプリを Tableau サイトに接続するためのサイト情報を設定します。
1.接続済みアプリを作成する
Microsoft Teams 用 Tableau アプリは、接続済みアプリを使用して、シングル サインオンでユーザーを認証します。Tableau Cloud または Tableau Server でこの接続済みアプリを作成します。
Tableau Cloud または Tableau Server で、直接信頼の接続済みアプリを作成します。詳細については、「Tableau Cloud で直接信頼を使用して接続済みアプリを設定する」または「Tableau Server で直接信頼を使用して接続済みアプリを設定する(新しいウィンドウでリンクが開く)」を参照してください。
- 接続済みアプリのドメイン許可リストを、指定したドメインのみに制限する場合は、次のドメインを許可リストに追加します。
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- ユーザーが他の Microsoft プラットフォームからアプリにアクセスする場合は、「Microsoft 365 URL(新しいウィンドウでリンクが開く)」の一覧からその他のドメインを追加します。
- 接続済みアプリのドメイン許可リストを、指定したドメインのみに制限する場合は、次のドメインを許可リストに追加します。
接続済みアプリを有効にします。
接続済みアプリのシークレットを生成します。
接続済みアプリのクライアント ID、シークレット ID、シークレット値をコピーします。これらの値を保存します。これらは、Microsoft Teams で Tableau サイトを設定する際に必要になります。
2.Tableau アプリにサイト設定を追加する
Tableau アプリを開いたとき、まだアプリが設定されていない場合は、セットアップ画面が表示されます。
[ラベル] で、サイトに名前を付けます。この名前は、Microsoft Teams アプリのユーザーに表示されます。ラベルを入力しない場合、アプリはサイト名を表示します。このフィールドはオプションです。
[Tableau サイト名] に、サイトの URL に表示されているとおりの名前を入力します。たとえば、URL が
https://us-west-2b.online.tableau.com/#/site/mysitename/homeの場合、「mysitename」と入力します。アプリを Tableau Server に接続していて、既定のサイトを使用する場合は、このフィールドを空白のままにします。[ベース URL] には、サイトの URL の
tableau.comで終わる部分を入力します (例:https://us-west-2b.online.tableau.com)。[ユーザー マッピング属性] で、シングル サインオンでのユーザーの認証に使用する Microsoft Entra 属性を選択します。
[接続済みアプリ ID]、[接続済みアプリ シークレット ID]、[接続済みアプリ シークレット値] に、接続済みアプリを作成したときにコピーした値を貼り付けます。
[サイト設定の追加] を選択します。
設定の詳細を保存する前に、Tableau アプリが接続をテストします。アプリが Tableau に接続できない場合、サイト設定は追加されません。その場合、接続済みアプリが認証できない、接続済みアプリが有効になっていない、サイト情報が正しくない、または使用しているアカウントが Tableau 管理者アカウントではないことが原因である可能性があります。また、アプリがファイアウォールの背後にあるため、Tableau Server に到達できない場合もあります。
サイトの設定を追加または削除する
サイト設定を追加した後、その他のサイト設定を追加したり、既存のサイト設定を削除したりできます。
Microsoft Teams 用 Tableau アプリで、[設定] タブを選択します。
[設定] で [Tableau サイトの設定] タブを選択します。このタブの設定にアクセスできるのは Tableau 管理者のみです。
サイトを追加するには、[サイトの詳細の追加] を選択します。サイトを削除するには、そのサイトの削除アイコンを選択します。
