---
schema_version: "1"
id: ec7f3b8cb32a64a1e8a58fa14a428f8b4f6401248b8fde178bd3376eee17655e
title: ワークシートへの Viz 拡張機能の追加
collection: tableau
version: next
locale: ja-jp
portal_url: https://docs.salesforce.com/tableau/next/ja-jp/public/desktop/viz_extensions.md
canonical_url: https://help.tableau.com/v0.0/public/desktop/ja-jp/viz_extensions.htm
source_site: help.tableau.com
content_type: documentation
content_hash: aa1306cd3d8815915b7cf76b688a09b6c3048deea1c70903637532180fba0909
description: Add Viz Extensions to a worksheet to extend visual capabilities.
---
[メイン コンテンツに進む](#main-content)

# ワークシートへの Viz 拡張機能の追加

Viz 拡張機能は、Tableau のネイティブなビジュアル機能を拡張できる Web アプリケーションです。Viz 拡張機能を使用すると、ユーザーはワークシート上でカスタム Viz タイプを操作できるようになります。

Tableau の拡張機能を使用すると、Tableau、Tableau パートナー、サードパーティの開発者がコミュニティ内で作成した Web アプリケーションでワークシートの機能を強化できます。開発者が独自の拡張機能を作成したい場合は、GitHub のドキュメンテーション[「Tableau 拡張機能 API」](https://tableau.github.io/extensions-api/)を参照してください。

Viz 拡張機能は、[Tableau Exchange](https://exchange.tableau.com/ja-jp/) でホスティングされる Web アプリケーションであるという点で、[ダッシュボード拡張機能](https://help.tableau.com/current/pro/desktop/ja-jp/dashboard_extensions.htm?_gl=1*uu9rzu*_ga*MTY0NjQ4Mjc3NS4xNzA3NzcyMzUx*_ga_8YLN0SNXVS*MTcxMjE2NjcxNC41NC4xLjE3MTIxNzA1MzUuMC4wLjA.)に似ています。ダッシュボードにオブジェクトとして追加するのではなく、Viz の構築中にワークシートに追加するという点では、ダッシュボード拡張機能とは異なります。

## ワークシートに Viz 拡張機能を追加する

マーク カードを使用してワークシートに Viz 拡張機能を追加する方法は 2 つあります。Tableau Exchange からすでにダウンロードしている場合は、ローカル ファイルとして追加できます。または、Viz の作成フロー内で Tableau Exchange からダウンロードすることもできます。

### Viz 拡張機能をローカル ファイルとして追加する

Tableau Exchange から Viz 拡張機能を既に選択してダウンロードしている場合は、.trex ファイルとしてコンピューターに保存されます。

1. Tableau ワークブックを開き、データ ソースに接続します。
2. ワークシートの \[マーク\] カードで、\[マークの種類\] ドロップダウン メニューを展開します。
3. Viz 拡張機能で、\[拡張機能の追加\] を選択します。  
      
    ![Viz 拡張機能オプションを備えたマーク カード ドロップダウン メニュー。](/tableau/next/ja-jp/public/desktop/ja-jp/Img/viz_ext_marks_AddExt.png)
4. 表示される \[拡張機能の追加\] ダイアログ ボックスで、\[ローカル Viz 拡張機能にアクセス\] を選択します。  
      
    ![\[ローカル Viz 拡張機能にアクセス\] するオプションを含む \[拡張機能の追加\] ダイアログ ボックス。](Img/viz_ext_addlocal.png)
5. 保存した .trex ファイルに移動して開きます。
6. プロンプトが表示されたら、ワークブックにあるデータへの Viz 拡張機能のアクセスを許可または拒否します。

Viz 拡張機能がビューに読み込まれ、マーク タイプが Viz 拡張機能の名前に変わります。

### Viz の作成中に Viz 拡張機能を追加する

Viz 拡張機能の選択とダウンロードは、まだ実施していない場合、Viz の作成フローの中で行うことができます。

1. Tableau ワークブックを開き、データ ソースに接続します。
2. ワークシートの \[マーク\] カードで、\[マークの種類\] ドロップダウン メニューを展開します。
3. Viz 拡張機能で、\[拡張機能の追加\] を選択します。  
      
    ![Viz 拡張機能オプションを備えたマーク カード ドロップダウン メニュー。](/tableau/next/ja-jp/public/desktop/ja-jp/Img/viz_ext_marks_AddExt.png)
4. 表示される \[拡張機能の追加\] ダイアログ ボックスで、ワークシートに読み込む \[Viz 拡張機能\] を選択します。この例では、Tableau が作成した Sankey 図を読み込んでいます。  
      
    ![Tableau Exchange から拡張機能を検索して追加するための、\[拡張機能の追加\] ダイアログ ボックス。](Img/viz_ext_addext.png)
5. プロンプトが表示されたら、ワークブックにあるデータへの Viz 拡張機能のアクセスを許可または拒否します。詳細については、「データ セキュリティ、ネットワーク対応拡張機能、およびサンドボックス化された拡張機能」を参照してください。
6. \[開く\] を選択します。  
      
    ![Tableau が開発した Sankey 図の Tableau Exchange 説明ページ。](/tableau/next/ja-jp/public/desktop/ja-jp/Img/viz_ext_exchange.png)

Viz 拡張機能がビューに読み込まれ、マーク タイプが Viz 拡張機能の名前に変わります。  
  
![\[Viz 拡張機能\] セクションで Sankey 拡張機能が拡大表示されたマーク カードのドロップダウン メニュー。](Img/viz_ext_add_sankey.png)

## マークカードを使用してマークをエンコードする

フィールドをマーク カードのエンコード ボックスにドラッグして、Viz を構築します。マークのエンコード ボックスと書式設定オプションは、開発者が決定します。ロードする Viz 拡張機能の詳細については、Tableau Exchange の拡張機能の説明を確認してください。

Sankey 拡張機能を使用するには、次のエンコード手順に従ってください。

Sankey 拡張機能は、**レベル**と**リンク**に拡張機能固有のエンコーディングを使用するように構築されています。これらは、組み込みのマーク エンコーディング ボックスの \[ツールヒント\] と \[詳細\] とともに使用して、ワークシート上に Sankey を構築できます。

- **レベル**\- Sankey レベルは、Sankey が関連付けたカテゴリ ディメンションを表します。この拡張機能では、レベルとして不連続ディメンションを 5 つまで含めることができます。
- **リンク**\- Sankey リンクは Sankey 全体のカテゴリを接続します。このエンコーディングは、数値の測定値に基づいて各リンクの幅を決定します。

## ワークブック拡張機能の管理

Tableau 2026.2 以降では、1 か所からワークブック全体で使用されているすべての拡張機能を表示、削除、または置換できます。

拡張機能を管理するには:

1. ツールバーから \[分析\] を選択し、\[ワークブック拡張機能の管理\] を選択します。  
      
    ![さまざまな設定と、強調表示された \[ワークブック拡張機能の管理\] オプションが表示されている \[分析\] ドロップダウン メニュー。](Img/vizext_manageextensions.png)
2. \[ワークブック拡張機能の管理\] ダイアログで、管理する拡張機能を選択します。  
      
    ![選択した Sankey 拡張機能の詳細が表示されている \[ワークブック拡張機能の管理\] ダイアログ ウィンドウ。](Img/vizext_manageextension_dialog.png)
3. 次のいずれかのアクションを選択します。
    
    **拡張機能の削除**: \[削除\] を選択して、ワークブックから拡張機能を削除します。\[ワークブック拡張機能\] ダイアログで、その拡張機能が現在どこで使用されているかを確認できます。拡張機能を削除すると、すべてのワークシート、ダッシュボード、ストーリーからその拡張機能が削除されます。拡張機能を使用するビジュアライゼーションでは、\[マーク\] カード上のマーク タイプが \[自動\] に変更されます。
    
    **拡張機能の置換:**\[置換\] を選択して、別の拡張機能に切り替えます。切り替えたい拡張機能を選択し、\[確定\] を選択します。拡張機能を置き換えると、ワークブック全体ですべての拡張機能のインスタンスが置き換えられます。Tableau では可能な限り設定を保持するよう努めていますが、設定は拡張機能やバージョンによって異なる場合があります。
4. 更新が完了したら、\[OK\] を選択します。

注: ワークブックに拡張機能が含まれていない場合、ダイアログ ボックスに「このワークブックには拡張機能がありません」というメッセージが表示されます。

## Tableau Cloud で拡張機能が許可されていることを確認する

Viz 拡張機能を追加できない場合は、サイト上で拡張機能が許可されているかどうかを確認します。Tableau 管理者は、拡張機能がサイト上で実行されることを許可し、ネットワーク対応拡張機能を許可リストに追加する必要があります。管理者は、テスト済みで信頼できる拡張だけを許容すべきです。

ネットワーク対応拡張機能を許可リストに追加する方法の詳細については、[「Tableau ヘルプ: サイトの既定の設定を変更する」](https://help.tableau.com/current/server/ja-jp/dashboard_extensions_server.htm#change-the-default-settings-for-a-site)を参照してください。

### データ セキュリティ、Tableau Trusted 拡張機能、およびネットワーク対応拡張機能

拡張機能は、次の 2 つの標準形式で提供される Web アプリケーションです。

- _Tableau Trusted 拡張機能_は、厳密に審査され、Tableau が管理するホスト上で展開されます。これらには、Tableau が開発および管理する拡張機能、Tableau Exchange パートナーが作成し、Tableau の拡張機能審査およびホスト サービスを通じて展開される拡張機能、および従来のサンドボックス拡張機能ホスト内の拡張機能が含まれます。
- _ネットワーク対応拡張機能_は、サードパーティーのホストに展開されています。これらの拡張機能を使用すると、開発者は Tableau を介さずに拡張機能の配信を管理できます。これらには、より優れた本番環境サポートを提供するためにパートナーが直接管理する拡張機能、ローカル ネットワーク内でホストおよび展開される拡張機能、および Tableau 外部のサードパーティー サービスとの通信を必要とする拡張機能が含まれます。

ネットワーク対応拡張機能を追加する前に、機能をホストする Web サイトが信頼できるサイトであることを確認します。拡張機能がホストされている URL、および開発者が要求しているデータ アクセスの種類に関する情報は、\[ワークブック拡張機能の管理\] ダイアログで確認できます。  
  
![強調表示された拡張機能の詳細セクションが表示されている \[ワークブック拡張機能の管理\] ダイアログ ウィンドウ。](Img/vizext_manageextension_dialog_magnified.png)

既定では、拡張機能は HTTPS プロトコルを使用します。これにより、データの送受信用の暗号化チャネルが保証され、ある程度のプライバシーとセキュリティが保証されます。拡張機能を使用する際のデータ セキュリティの詳細については、[「拡張機能のセキュリティ - 導入に関するベスト プラクティス」](https://help.tableau.com/current/server/ja-jp/security_extensions.htm)を参照してください。

### ネットワーク対応拡張機能の許可または拒否

既定では、ネットワーク対応拡張機能を実行するには、パーミッションを要求する必要があります。このパーミッション ダイアログには、ホスト元のサードパーティー サーバーと、拡張機能に必要なデータ アクセス レベルに関する情報が表示されます。拡張機能の実行を許可する前に、この情報を確認することをお勧めします。

拡張機能は、通常、ビュー内の表示データにアクセスします。拡張機能が「フル データ アクセス」を要求する際に、ワークブック内のより深いデータへのアクセスを要求することがあります。これには、参照元データへのフル アクセス、データ ソースのテーブル名とフィールド名、データ ソース接続に関する情報が含まれます。ワークブックで拡張機能の実行を許可する前に、拡張機能のパーミッション ダイアログで宣言された情報を確認し、拡張機能の実行とこのデータへのアクセスを許可するかどうかを決定する必要があります。

### ネットワーク対応拡張機能のデータ アクセスのリセット

拡張機能のパーミッション ダイアログで \[許可\] ではなく \[拒否\] を選択した場合、拡張機能はワークシートに読み込まれません。拡張機能を信頼してアクセスを許可する場合は、同じ Viz 拡張機能をワークブックにもう一度追加してパーミッションをリセットできます。これにより、パーミッションを求めるダイアログが再度読み込まれます。

### 拡張機能にワークブックまたはビューにアクセスするパーミッションがあることを確認する

拡張機能を含むワークブックをパブリッシュする場合は、ビュー内の表示可能なデータに拡張機能がアクセスできることを確認してください。表示可能なデータは、サマリー データとも呼ばれます。Tableau Server または Tableau Cloud でこのアクセス権を付与するには、ワークブックまたはビューで \[サマリー データをダウンロード\] するパーミッションが許可されていることを確認します。拡張機能でデータがダウンロードされません。拡張機能には、ビュー内のデータを操作するためのパーミッションが必要です。

ワークブックをパブリッシュしたときにシートをタブとして表示するよう選択したかどうかに応じて、ワークブック レベルまたはビュー レベルのいずれかで \[サマリー データをダウンロード\] するパーミッションを設定します。シートがタブとして表示されない場合は、ビュー レベルでパーミッションを設定しています。

ワークブックまたはビューを Tableau Public にパブリッシュする場合、拡張機能には表示可能なデータへのアクセス権も必要です。パーミッションを付与するには、\[設定\] を開いて \[アクセスを許可\] を選択します。

## Tableau Desktop で JavaScript が有効になっていることを確認する

Viz 拡張機能は JavaScript ライブラリである Tableau 拡張機能 API ライブラリを使用してデータを操作します。拡張機能を使用する場合は、セキュリティ設定で JavaScript が有効になっていることを確認します。

\[ヘルプ\]、\[設定とパフォーマンス\]、\[ダッシュボード Web 表示セキュリティの設定\]、\[JavaScript の有効化\] の順に選択します。

## サードパーティーおよび Tableau パートナーが作成した Viz 拡張機能についてのサポートを受ける

サードパーティーおよび Tableau パートナーが作成した拡張機能は、Tableau では直接サポートされていません。ただし、サポートが必要な場合、拡張機能の開発者によっては、サポートを受けることができる開発者 Web サイトへのリンクを提供しています。

サポートを受けるには、以下を行います。

1. \[ワークブック拡張機能の管理\] ダイアログまたは Tableau Exchange の拡張機能の説明ページで、開発者 Web サイトのリンクを探してください。
2. \[ワークブック拡張機能の管理\] ダイアログで、拡張機能の ID とバージョンを確認します。これらの詳細を開発者に提供することは、トラブルシューティングに不可欠です。これにより、古いバージョンが使用されているかどうかを確認し、問題の原因を特定しやすくなります。
3. 開発者 Web サイトから直接、拡張機能の開発者に問い合わせてください。

拡張機能 API に関する質問については、[theDataDev Slack チャネル](https://tableau-datadev.slack.com/archives/CHJ9BHKG9)を通じて質問を共有してサポートを求めるか、拡張機能 API に関する[問題を GitHub から送信](https://github.com/tableau/extensions-api/issues)することをお勧めします。