

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用一鍵式內嵌程式碼內嵌 Amazon Quick Sight 視覺效果和儀表板
<a name="1-click-embedding"></a>

您可以使用內嵌程式碼將視覺效果或儀表板嵌入應用程式中。當您共用儀表板或從 Amazon Quick Sight 中的**內嵌視覺**效果選單取得此程式碼。

您可以在已註冊使用者的內部應用程式中嵌入視覺效果或儀表板。或者，您可以在 Amazon Quick Sight 主控台中開啟公開共用。這樣做可讓網際網路上的任何人存取內嵌在公用應用程式、Wiki 或入口網站中的共用視覺效果或儀表板。

接下來，您可以找到有關如何使用一鍵式視覺效果或儀表板內嵌程式碼嵌入視覺效果和儀表板的說明。

**Topics**
+ [使用一鍵式內嵌程式碼為已註冊使用者內嵌 Amazon Quick Sight 視覺效果和儀表板](embedded-analytics-1-click.md)
+ [使用一鍵式內嵌程式碼為匿名使用者內嵌 Amazon Quick Sight 視覺效果和儀表板](embedded-analytics-1-click-public.md)

# 使用一鍵式內嵌程式碼為已註冊使用者內嵌 Amazon Quick Sight 視覺效果和儀表板
<a name="embedded-analytics-1-click"></a>


|  | 
| --- |
|  適用於：企業版  | 

您可以在內部應用程式中為 Amazon Quick Sight 帳戶的註冊使用者嵌入視覺效果或儀表板。您可以使用共用儀表板或從 Amazon Quick Sight 中的**內嵌視覺效果**選單取得的內嵌程式碼來執行此操作。您不需要執行 Amazon Quick Sight 內嵌 API 即可產生內嵌程式碼。您可以從 Amazon Quick Sight 複製內嵌程式碼，並將其貼到內部應用程式的 HTML 程式碼中。

當使用者和群組 （或 Amazon Quick Sight 帳戶上的所有使用者） 可以存取您要內嵌的儀表板，或擁有您要內嵌存取內部應用程式的視覺效果時，系統會提示他們使用其登入資料登入 Amazon Quick Sight 帳戶。通過身分驗證後，他們可以存取其內部頁面上的視覺效果或儀表板。如果您已啟用單一登入，則不會提示使用者再次登入。

接下來，您可以找到有關如何使用視覺效果或儀表板內嵌程式碼為已註冊使用者嵌入視覺效果或儀表板的描述。

## 開始之前
<a name="embedded-analytics-1-click-prerequisites"></a>

開始之前，請確認以下事項：
+ 您的網際網路瀏覽器設定包含以下項之一，以允許快顯窗口和 iframe 之間的通訊：
  + 對於 Mozilla 廣播頻道 API 的原生支援。如需詳細資訊，請參閱 Mozilla 文件中的[廣播頻道 API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API)。
  + IndexedDB 支援。
  + LocalStorage 支援。
+ 您的網際網路瀏覽器的「阻止所有 cookie」設定已關閉。

## 步驟 1：授予對儀表板的存取權
<a name="embedded-analystics-1-click-share"></a>

若要讓使用者存取內嵌式儀表板，請向他們授予檢視內嵌式儀表板的存取權。您可以授予個別使用者和群組存取儀表板的權限，或授予帳戶中的每個人存取權。視覺效果許可是在儀表板層級決定的。若要授予內嵌視覺效果的存取權，請授予視覺效果所屬儀表板的存取權。如需詳細資訊，請參閱[授予儀表板的存取權](share-a-dashboard.md)。

## 步驟 2：將要嵌入視覺效果或儀表板的域放在允許清單中
<a name="embedded-analytics-1-click-allow-list"></a>

若要在內部應用程式中嵌入視覺效果和儀表板，請確保在 Amazon Quick Sight 帳戶中允許列出您內嵌的網域。如需詳細資訊，請參閱[將靜態域新增至允許清單](manage-domains.md#embedding-static)。

## 步驟 3：取得內嵌程式
<a name="embedded-analytics-1-click-code"></a>

使用下列步驟來取得視覺效果或儀表板內嵌程式碼。

**若要取得儀表板內嵌程式碼**

1. 在 Amazon Quick Sight 中開啟發佈的儀表板，然後選擇右上角的**共用**。然後選擇**共用儀表板**。

1. 在開啟的**共用儀表板**頁面中，選擇左上角的**複製內嵌程式碼**。

   內嵌程式碼已複製到剪貼簿，類似以下項目。此範例中`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>
   ```

**若要取得視覺效果內嵌程式碼**

1. 在 Amazon Quick Sight 中開啟已發佈的儀表板，然後選擇您要嵌入的視覺效果。然後開啟視覺效果右上角的視覺效果選單，選擇**內嵌視覺效果**。

1. 在開啟的**內嵌視覺效果**窗格中，選擇**複製程式碼**。

   內嵌程式碼已複製到剪貼簿，類似以下項目。此範例中`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 頁面
<a name="embedded-analytics-1-click-html"></a>

使用下列程序將內嵌程式碼貼到內部應用程式的 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 Sites 內部網頁中嵌入視覺效果或儀表板。您可以在 Google Sites 上開啟網頁，然後將內嵌程式碼貼到內嵌小工具中。

如果您想要在內部 Microsoft SharePoint 網站中內嵌您的視覺效果或儀表板，您可以建立新頁面，然後將內嵌程式碼貼到內嵌網頁部分中。

# 使用一鍵式內嵌程式碼為匿名使用者內嵌 Amazon Quick Sight 視覺效果和儀表板
<a name="embedded-analytics-1-click-public"></a>


|  | 
| --- |
|  適用於：企業版  | 

您可以使用在 Amazon Quick Sight 中共用視覺效果或儀表板時取得的內嵌程式碼，在公有網站中內嵌視覺效果或儀表板。您也可以使用 Amazon Quick Sight 主控台開啟公開共用，並自動將共用視覺效果或儀表板的存取權授予網際網路上的任何人。

接下來，您可以了解如何為視覺或儀表板開啟公開共用，以及如何嵌入視覺或儀表板讓任何人在網際網路上查看。在這兩種情況下，您都可以使用一鍵式內嵌程式碼來執行此操作。

## 開始之前
<a name="embedded-analytics-1-click-prerequisites"></a>

開始之前，請確認以下事項：
+ 您的網際網路瀏覽器設定包含下列其中一項，以允許快顯視窗與共用使用的 iframe 之間進行通訊：
  + 對於 Mozilla 廣播頻道 API 的原生支援。如需詳細資訊，請參閱 Mozilla 文件中的[廣播頻道 API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API)。
  + IndexedDB 支援。
  + LocalStorage 支援。
+ 您的網際網路瀏覽器的「阻止所有 cookie」設定已關閉。

## 步驟 1：開啟儀表板的公用存取權
<a name="embedded-analytics-1-click-step-1"></a>

若要讓網際網路上的任何人存取您的內嵌視覺效果或儀表板，請先開啟儀表板的公開存取權。視覺效果許可是在儀表板層級決定的。若要授予內嵌視覺效果的存取權，請授予視覺效果所屬儀表板的存取權。如需詳細資訊，請參閱[授予網際網路上任何人存取 Amazon Quick Sight 儀表板的權限](share-a-dashboard-grant-access-anyone.md)。

## 步驟 2：將要嵌入視覺效果或儀表板的域放在允許清單中
<a name="embedded-analytics-1-click-step-2"></a>

若要在公有應用程式、Wiki 或入口網站中嵌入視覺效果和儀表板，請確定您內嵌它的網域位於 Amazon Quick Sight 帳戶的允許清單中。

## 步驟 3：取得內嵌程式
<a name="embedded-analytics-1-click-step-3"></a>

使用下列步驟來取得視覺效果或儀表板內嵌程式碼。

**若要取得儀表板內嵌程式碼**

1. 在 Amazon Quick Sight 中開啟已發佈的儀表板，然後選擇右上角的**共用**。然後選擇**共用儀表板**。

1. 在開啟的**共用儀表板**頁面中，選擇左上角的**複製內嵌程式碼**。

   內嵌程式碼已複製到剪貼簿，類似以下項目。此範例中`quicksightdomain`的 是您用來存取 Amazon Quick Sight 帳戶的 URL。

   ```
   <iframe
           width="960"
           height="720"
           src="https://quicksightdomain/sn/
               embed/share/accounts/accountid/dashboards/dashboardid">
       </iframe>
   ```

**若要取得視覺效果內嵌程式碼**

1. 在 Amazon Quick Sight 中開啟發佈的儀表板，然後選擇您要嵌入的視覺效果。然後開啟視覺效果右上角的視覺效果選單，選擇**內嵌視覺效果**。

1. 在開啟的**內嵌視覺效果**窗格中，選擇**複製程式碼**。

   內嵌程式碼已複製到剪貼簿，類似以下項目。此範例中`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 頁面、Wiki 頁面或入口網站
<a name="embedded-analytics-1-click-step-4"></a>

使用下列程序將內嵌程式碼貼到 HTML 頁面、Wiki 頁面或入口網站。

**若要貼上內嵌程式碼**
+ 開啟您要嵌入視覺效果或儀表板的位置的 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">
      </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">
      </iframe>
  
      </body>
      </html>
  ```

如果您的公開應用程式是建立在 Google Sites 上的，請在 Google Sites 上開啟網頁，然後使用內嵌小工具貼上內嵌程式碼。

當您嵌入 Google 網站時，請確定 Amazon Quick Sight 中的下列網域位於您的允許清單中：
+ `https://googleusercontent.com` (開啟子網域)
+ `https://www.gstatic.com`
+ `https://sites.google.com`

在您的應用程式中內嵌視覺或儀表板之後，任何可以存取您應用程式的使用者皆可存取內嵌的視覺效果或儀表板。若要更新與公眾共用的儀表板，請參閱 [更新公開共用的儀表板](share-a-dashboard-grant-access-anyone-update.md)。若要關閉公開共用，請參閱 [關閉公開共用設定](share-a-dashboard-grant-access-anyone-no-share.md)。

當您關閉公開共用時，網際網路上的任何人都無法存取您內嵌在公用應用程式中或透過連結共用的儀表板。下次任何人嘗試從網際網路查看此類儀表板時，他們都會收到一條訊息，指出他們沒有查看儀表板的存取權。