開始する前にステップ 1: ダッシュボードへのアクセス権を付与するステップ 2: ビジュアルもしくはダッシュボードを埋め込むドメインを許可リストに入れるステップ 3: 埋め込みコードを取得するステップ 4: 内部アプリケーションの HTML ページにコードを貼り付ける

ワンクリック埋め込みコードを使用した登録済みユーザー用のビジュアルおよびダッシュボードの埋め込み

適用対象: Enterprise Edition

Amazon QuickSight アカウントの登録済みユーザー向けに、ビジュアルまたはダッシュボードを内部アプリケーションに埋め込むことができます。そのためには、ダッシュボードを共有するときに取得する埋め込みコードを使用するか、のビジュアルの埋め込みメニューから取得します QuickSight。 QuickSight 埋め込み API を実行して埋め込みコードを生成する必要はありません。から埋め込みコードをコピーし QuickSight 、内部アプリケーションの HTML コードに貼り付けることができます。

埋め込みたいダッシュボードにアクセスできるユーザーやグループ (または QuickSight アカウント上のすべてのユーザー）、または埋め込みたいビジュアルが内部アプリケーションにアクセスできるユーザーやグループが、認証情報を使用して QuickSight アカウントにサインインするように求められます。ユーザーは認証後に、内部ページから、ビジュアルやダッシュボードにアクセスできるようになります。シングルサインオンが有効になっている場合は、ユーザーにサインインが再度求められることはありません。

以下で、ビジュアルまたはダッシュボードの埋め込みコードを使用して、登録済みユーザー向けに。ビジュアルまたはダッシュボードを埋め込む方法を説明します。

開始する前に

作業を始める前に、以下を確認してください。

ポップアップと iframe 間の通信を許可するため、インターネットブラウザの設定に以下のいずれかが含まれている。
- Mozilla Broadcast Channel API のネイティブサポート。詳細については、Mozilla ドキュメントで Broadcast Channel API を参照してください。
- IndexedDB のサポート。
- LocalStorage サポート。
インターネットブラウザの「すべての cookie をブロック」設定がオフになっている。

ユーザーが埋め込みダッシュボードにアクセスできるように、ダッシュボードを表示するためのアクセス権をユーザーに付与します。個々のユーザーやグループにダッシュボードへのアクセス権を付与する、またはアカウント内の全ユーザーにアクセス権を付与することができます。ビジュアルのアクセス許可はダッシュボードレベルで決定されます。埋め込みビジュアルに対するアクセス許可を付与するには、そのビジュアルが属するダッシュボードへのアクセスを許可します。詳しくは、「ダッシュボードに対するアクセス権の付与」を参照してください。

ステップ 2: ビジュアルもしくはダッシュボードを埋め込むドメインを許可リストに入れる

ビジュアルとダッシュボードを内部アプリケーションに埋め込むには、埋め込むドメインが QuickSight アカウントに許可リストに登録されていることを確認します。詳細については、「静的ドメインを許可リストに追加する」を参照してください。

ステップ 3: 埋め込みコードを取得する

以下の手順を使用して、ビジュアルもしくはダッシュボードの埋め込み用コードを取得します。

ダッシュボードの埋め込み用コードを取得する

で公開されたダッシュボードを開き QuickSight 、右上の共有を選択します。次に、[Share dashboard] (ダッシュボードの共有) をクリックします。
開いた [Share dashboard] (ダッシュボードの共有) ページで、左上の [Copy embed code] (埋め込みコードをコピー) をクリックします。

以下のような埋め込みコードがクリップボードにコピーされます。この例quicksightdomainのは、 QuickSight アカウントへのアクセスに使用する URL です。
```
<iframe
        width="960"
        height="720"
        src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias">
    </iframe>
```

ビジュアルの埋め込み用コードを取得する

で公開されたダッシュボードを開き、埋め込むビジュアル QuickSight を選択します。次に、ビジュアルの右上にあるビジュアルのメニューを展開した後、[Embed visual] (埋め込みビジュアル) を選択します。
[Embed visual] (埋め込みビジュアル) ペインが開くので、[Copy code] (コードをコピー) を選択します。

以下のような埋め込みコードがクリップボードにコピーされます。この例quicksightdomainのは、 QuickSight アカウントへのアクセスに使用する URL です。
```
<iframe
        width="600"
        height="400"
        src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
    </iframe>
```

ステップ 4: 内部アプリケーションの HTML ページにコードを貼り付ける

以下の手順を使用して、埋め込みコードを内部アプリケーションの HTML ページに貼り付けます。

内部アプリケーションの HTML ページにコードを貼り付ける

ダッシュボードを埋め込むページの HTML コードを開き、埋め込みコードを貼り付けます。

埋め込まれたダッシュボードでは、この表示は以下の例のようになります。この例quicksightdomainのは、 QuickSight アカウントへのアクセスに使用する URL です。


<!DOCTYPE html>
    <html>
    <body>

    <h2>Example.com - Employee Portal</h2>
    <h3>Current shipment stats</h3>
        <iframe
        width="960"
        height="720"
        src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias">
    </iframe>

    </body>
    </html>

埋め込まれたビジュアルでは、この表示は以下の例のようになります。この例quicksightdomainのは、 QuickSight アカウントへのアクセスに使用する URL です。


<!DOCTYPE html>
    <html>
    <body>

    <h2>Example.com - Employee Portal</h2>
    <h3>Current shipment stats</h3>
        <iframe
        width="600"
        height="400"
        src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID?directory_alias=account_directory_alias">
    </iframe>

    </body>
    </html>

例えば、ビジュアルもしくはダッシュボードを、内部的な Google サイトのページに埋め込みたいとしましょう。Google サイトのページを開いて、埋め込みウィジェットに埋め込みコードを貼り付けることができます。

ビジュアルまたはダッシュボードを内部 Microsoft SharePoint サイトに埋め込む場合は、新しいページを作成し、埋め込みウェブ部分に埋め込みコードを貼り付けることができます。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ワンクリック埋め込み、パブリック埋め込み

ワンクリックパブリック埋め込み