步骤 3：嵌入控制面板 URL - Amazon QuickSight
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

步骤 3：嵌入控制面板 URL

重要

Amazon 推 QuickSight 出了用于嵌入分析的新 API：GenerateEmbedUrlForAnonymousUser和GenerateEmbedUrlForRegisteredUser。

您仍然可以使用GetDashboardEmbedUrl和 GetSessionEmbedUrl API 来嵌入仪表板和 QuickSight 控制台，但它们不包含最新的嵌入功能。有关最新的 up-to-date 嵌入体验，请参阅嵌入概述。

 适用于：企业版 
   目标受众：Amazon QuickSight 开发者 

在下一节中，您可以了解如何使用QuickSight 嵌入式 SDK (JavaScript) 将第 2 步中的控制面板 URL 嵌入到您的网站或应用程序页面中。通过使用该开发工具包，您可以执行以下操作：

  • 将控制面板放在 HTML 页面上。

  • 将参数传递到控制面板。

  • 使用为应用程序自定义的消息处理错误状态。

调用 GetDashboardEmbedUrl API 操作获取可嵌入应用程序的 URL。该 URL 的有效期为 5 分钟，生成的会话的有效期为 10 个小时。该 API 操作为 URL 提供 auth_code 以启用单点登录会话。

下面显示了 get-dashboard-embed-url 的示例响应：

//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https: //dashboards.example.com/embed/620bef10822743fab329fb3751187d2d...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}

使用嵌入软件开发工具包或将此网址添加到 iframe 中，将此仪表板 QuickSight 嵌入到您的网页中。如果设置了固定高度和宽度数字（以像素为单位）， QuickSight 将使用这些数字，并且在调整窗口大小时不会更改视觉对象。如果您设置了相对的百分比高度和宽度，则会 QuickSight 提供响应式布局，该布局会随着窗口大小的变化而进行修改。通过使用 Em QuickSight bedding SDK，您还可以控制控制面板中的参数并接收有关页面加载完成和错误的回调。

以下示例演示了如何使用生成的 URL。此代码位于您的应用程序服务器上。

<!DOCTYPE html>
<html>

<head>
    <title>Basic Embed</title>
    <!-- You can download the latest QuickSight embedding SDK version from https://www.npmjs.com/package/amazon-quicksight-embedding-sdk -->
    <!-- Or you can do "npm install amazon-quicksight-embedding-sdk", if you use npm for javascript dependencies -->
    <script src="./quicksight-embedding-js-sdk.min.js"></script>
    <script type="text/javascript">
        var dashboard;

        function embedDashboard() {
            var containerDiv = document.getElementById("embeddingContainer");
            var options = {
                // replace this dummy url with the one generated via embedding API
                url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode",  
                container: containerDiv,
                scrolling: "no",
                height: "700px",
                width: "1000px",
                footerPaddingEnabled: true
            };
            dashboard = QuickSightEmbedding.embedDashboard(options);
        }
    </script>
</head>

<body onload="embedDashboard()">
    <div id="embeddingContainer"></div>
</body>

</html>

要使此示例起作用，请务必使用 Amazon QuickSight Embedding SDK 将嵌入式控制面板加载到您的网站上 JavaScript。要获取副本，请执行下列操作之一：

  • 从以下网址下载亚马逊 QuickSight 嵌入软件开发工具包 GitHub。该存储库由一组 QuickSight 开发人员维护。

  • 从 https://www.npmjs.com/package/ 下载最新的 QuickSight 嵌入式 SDK 版本amazon-quicksight-embedding-sdk。

  • 如果您使用npm JavaScript 依赖关系，请通过运行以下命令下载并安装它。

    npm install amazon-quicksight-embedding-sdk