ダッシュボードを埋め込む

この記事では、外部の Web サイトまたはアプリケーションに AI/BI dashboard を埋め込む方法について説明します。 ワークスペース管理者は、ダッシュボードを埋め込む前に、潜在的な埋め込みサーフェスを定義する必要があります。 ワークスペースの設定の詳細については 、「ダッシュボードの埋め込みを管理する」を参照してください。

少なくとも CAN EDIT 権限を持つユーザーは、[ 共有 ] ダイアログからダッシュボードの iframe コードを生成できます。 公開されたダッシュボードのすべての共有設定は、引き続き有効です。 明示的にアクセス権を付与されたユーザーのみが、埋め込みダッシュボードを表示できます。 ダッシュボードの共有の詳細については、「 ダッシュボードの共有 」を参照してください。 埋め込みダッシュボードは、他のすべてのダッシュボードと同じキャッシュと更新頻度に従います。 「キャッシュとデータの鮮度」を参照してください。

埋め込みコードの生成

ダッシュボードを埋め込むには、次の手順に従います。

1. 埋め込む公開済みダッシュボードを開きます。 ワークスペースでダッシュボードを表示およびアクセスする方法については、「 ダッシュボードの表示と整理 」を参照してください。

2. 右上隅にある [共有 ]をクリックします。

3. 共有ダイアログで 「 ダッシュボードを埋め込む 」をクリックします。

4. 埋め込みコードをコピー ダイアログが開きます。許可された埋め込みドメインのリストが存在する場合は、そのドメインが一覧表示されます。 コピー ボタン クリックして、コード スニペットをコピーします。

   

5. HTML 埋め込みをサポートし、iframe コンテンツをレンダリングできる任意のプラットフォームまたはアプリケーションに埋め込みコードを挿入します。 例を参照してください。

注記

[埋め込みコードをコピー ] ダイアログに、ターゲットドメインを含まない許可されたドメインのリストが含まれている場合は、ワークスペース管理者が追加できます。「ダッシュボードの埋め込みの管理」を参照してください。

例

次の例には、ダッシュボードをアプリケーションに埋め込むためのステップバイステップのガイダンスが含まれています。 各手順は、前のセクションで説明した埋め込みコードをすでにコピーしていることを前提としています。

Confluence に埋め込む

生成された埋め込みコードは、Confluence の要件を満たすためにわずかな調整が必要です。 Confluence ページにダッシュボードを埋め込むには、次の手順を実行してください。

1. 埋め込みコードを編集して、生成された URL のみを含め、iframe タグや追加のマークアップ値を含めないようにします。

   編集する前に、埋め込みコードには、iframe HTML タグ、iframe のソースを使用するためのダッシュボードへのリンク、および次のコード スニペットに示すように、高さ、幅、境界線の追加仕様が含まれています。 ダッシュボードの場合、プレースホルダーの例 <databricks-instance-name> と <dashboard-and-workspace-ID> には、ワークスペースとダッシュボードに関連付けられた実際の値が含まれています。 それらは次のとおりです。

   • <databricks-instance-name>は、ワークスペースにログインするときの URL の最初の部分です。ワークスペース オブジェクトの識別子を取得するを参照してください。
   • <dashboard-and-workspace-ID>は、ダッシュボードを指す URL の最後の部分です。それは次のようなものです: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447。

   <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>

   次の例に示すように、リンクテキストのみが含まれるように文字列を編集します。

   https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>

2. ページに iframe 要素を挿入します。 ページに iframe を挿入する方法については、 Confluence のドキュメントを参照してください。

3. 編集した埋め込みURLを URL テキストフィールドに貼り付け、幅を100%に設定します。

4. お好みに応じて他の設定を調整してください。

Salesforce ナレッジへの埋め込み

Salesforceのナレッジページにダッシュボードを埋め込むには、次の手順を実行してください。

1. Visualforce ページを作成します。 手順については、 Salesforce のドキュメントを参照してください。

2. [ページ編集 ] 画面から、カーソルを Visualforce マークアップ エディタに移動します。

3. コピーした埋め込みコードを 2 つの <apex:page></apex:page> タグの間に貼り付けます。

4. 埋め込みコードの周囲に段落タグ (<p></p>) を2つ追加します。

   次の例では、プレースホルダ <dashboard-embed-code> を使用して、Visualforce マークアップがどのように表示されるかを示しています。 インスタンスには、コピーした完全な埋め込みコードが含まれている必要があります。

   <apex:page >
   <p><dashboard-embed-code></p>
   </apex:page>

5. [ 保存 ] をクリックして変更を保存します。

6. 「 プレビュー 」をクリックして、ダッシュボードがレンダリングされることを確認します。

7. コンポーネントプレビューのURLをコピーして、新しいiframeコンポーネントを作成します。 次のコード スニペットのようになります。 プレースホルダー <your-salesforce-domain> は、Salesforce ドメインに置き換える必要があります。

   <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>

8. ダッシュボードを埋め込むナレッジ ページに移動します。

9. 「編集 」をクリックします> メディアコンポーネントを追加します 。

10. 前のステップのiframeコードを、 埋め込みテキストフィールドに貼り付けます 。

SharePoint に埋め込む

ダッシュボードを SharePoint に埋め込むには、SharePoint に埋め込まれたコンテンツが許可されているサイトの一覧に Databricks の URL を追加する必要がある場合があります。 SharePoint ページにコンテンツを埋め込む方法について詳しくは、[Microsoft のドキュメント] を参照してください。 次に、次の手順を実行します。

1. 埋め込みダッシュボードをホストする SharePoint ページに移動します。
2. ページに埋め込み要素を追加します 。
3. 完全な埋め込みコードを、画面の右側にある [Web サイトのアドレス] または [埋め込みコード ] フィールドに貼り付けます。
4. クリックして確定します。

1 つのウィジェットを埋め込む

ダッシュボードから 1 つのウィジェットを埋め込むには、ダッシュボードの埋め込みコードと、表示するウィジェットの一意の識別子が必要です。

一意の識別子をコピーします

1 つのウィジェットの識別子は、ページ name の値とウィジェットの name の値の組み合わせで、チルダ (~) で区切られます。

注記

name キーは、ダッシュボードを定義するシリアル化されたファイルに表示され、Databricks UI からはアクセスできません。これは、UI に表示されるページ名を定義する displayName 値とは別のものです。「ダッシュボード ファイルの編集」を参照してください。

一意の識別子をコピーするには:

1. 公開したダッシュボードを Databricks ワークスペースで開きます。

2. 埋め込むウィジェットの ケバブメニューをクリックします。

3. [ 全画面表示 ] または [ ウィジェットへのリンクをコピー ] をクリックします。 URL には、関連するページとウィジェットの name 値が含まれています。

4. 検索パラメーター fullscreenWidget と等号 (=) の後のすべてをコピーします。

   次の例は、フルスクリーンウィジェットのURLの最後の部分を示しています。

   fullscreenWidget=53eadf26~3490f286

生成された埋め込みコードを調整する

1. ダッシュボードの埋め込みコードを生成する手順については、「 埋め込みコードの生成 」を参照してください。
2. 埋め込み URL に &fullscreenWidget=<ID> を追加し、 <ID> を結合された <page-name>~<widget-name> 値に置き換えます。

たとえば、ベース埋め込み URL が次のとおりであるとします。

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

一意の識別子を持つ更新された埋め込み URL は、次のようになります。

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

埋め込みダッシュボードの表示

埋め込みダッシュボードは、閲覧者が Databricks の外部でダッシュボード データに安全にアクセスするための方法を提供します。 既存のすべての共有設定が適用されます。 対象閲覧者には、ダッシュボードへのアクセス権を付与する必要があります。 「ダッシュボードにアクセスできるユーザー」を参照してください。

埋め込みダッシュボードを表示するには：

• ダッシュボードが埋め込まれているページに移動します。
• 必要に応じて、Databricks の資格情報でログインします。

注記

ダッシュボードへのアクセス権が付与されていない登録ユーザーがダッシュボードを表示しようとすると、ダッシュボードが使用できないというエラーが表示されます。 共有設定を調整する方法については、「 公開されたダッシュボードの共有 」を参照してください。

埋め込みダッシュボードの更新

埋め込みダッシュボードのすべての閲覧者は、オンデマンドでダッシュボードを手動で更新できます。 ダッシュボードを定期的に更新するスケジュールを設定することもできます。

「 スケジュールされたダッシュボードの更新とサブスクリプションの管理」を参照してください。

埋め込みダッシュボードのトラブルシューティング

このセクションでは、発生する可能性のある一般的な問題の一覧と、推奨される解決策を示します。

埋め込まれたiframeは空白です

埋め込まれた iframe にデータが表示されない場合は、サードパーティの Cookie を無効にしている可能性があります。 サードパーティのCookieを有効にすることは、埋め込みダッシュボードなどの外部コンテンツを別のWebページ内で正しく機能させるために必要になることがよくあります。

この問題を解決するために、サードパーティのCookieを許可またはブロック解除するようにブラウザの設定を調整できます。 すべてのサードパーティCookieを許可したくない場合、多くのブラウザでは、サードパーティCookieを許可する必要がある特定のサイトに対して例外を追加できます。 Cookieの管理に関する詳細な手順については、ブラウザのヘルプドキュメントを参照してください。