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

ワンクリック埋め込みコードを使用して登録済みユーザーに Amazon Quick Sight ビジュアルとダッシュボードを埋め込む

適用対象: Enterprise Edition

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

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

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

開始する前に

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

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

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

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

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

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

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

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

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

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

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

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

以下のような埋め込みコードがクリップボードにコピーされます。この例quicksightdomainのは、Amazon Quick Sight アカウントへのアクセスに使用する 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のは、Amazon Quick Sight アカウントへのアクセスに使用する 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のは、Amazon Quick Sight アカウントへのアクセスに使用する 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 を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

ワンクリックの埋め込み

ワンクリック匿名埋め込み