全部产品
Search

搜索本产品

    ：报表嵌入第三方系统

    文档中心

    ：报表嵌入第三方系统

    更新时间：Jul 03, 2023

    Quick BI支持将群空间中的报表（仪表板和电子表格）嵌入到其他系统中，以便和其他应用系统集成，更便捷实现业务一体化应用。下面为您介绍如何将报表嵌入到第三方系统中。

    步骤1：通过HTTPS接口获取accessToken

    本文以嵌入群空间中的仪表板至第三方系统为例。

    • 如果开通仪表板接入权限的账号拥有开发或分析权限，则只能开通该账号创建的仪表板权限。

    • 如果该账号拥有管理权限，则可以开通该工作空间所有报表权限。

    1. 获取AccessKey ID和AccessKey Secret。

      1. 登录Quick BI控制台。

      2. 按照下述步骤，获取AccessKey ID和AccessKey Secret。

        获取AK_intl

    2. 获取Aliyun ID。

      • 如果您使用的是主账号，则登录账号为Aliyun ID。

        在安全设置页面，查看到的账号ID，即为此处的参数Aliyun ID对应的值。

        账号ID

      • 如果您使用的是子账号，则Aliyun ID为主账号的账号名：子账号。

        假设主账号的账号名为test，子账号为zhangsan@xxx123.xxaliyun.com，则Aliyun ID为test:zhangsan。

        说明

        您可以联系主账号管理员获取该子账号对应的主账号。

    3. 获取Token。

      将上述步骤获取的AccessKey ID、AccessKey Secret和Aliyun ID参数拼接到如下请求地址中，并发送get请求获取Token。

      https://das.base.shuju.aliyun.com/api/ac3rdservice/token.json?accessId=xxx&accessKey=xxx&aliyunId=xxx&validityTime=60

      当success为true时，表示获取token成功。此时accessToken的值即为token。1

      说明

      如果您在accessToken有效期内再次发送请求获取或访问报表，都会自动延迟默认设置的token有效时长。

      validityTime最大值为240，单位：分钟。

      例如，第一次获取validityTime并设置为10分钟，如果10分钟之内您再次发送请求，会在此基础上延长10分钟：

      • 当超过token的有效时长后再次获取validityTime，token内容才会改变。

      • 如果想要立即取消token时效，可以发送如下post请求，并适配对应的参数值。

        https://das.base.shuju.aliyun.com/api/ac3rdservice/tokenInvalid.json?aliyunId=XXX&accessToken=XXX。

    步骤2：添加需要嵌入的仪表板

    仅当仪表板是发布状态时，才支持设置报表嵌入功能。

    1. 在Quick BI产品首页，按照如下步骤操作。

      报表嵌入_intl

      此时您可以在报表嵌入页面的列表中，看到新嵌入的报表。1

    2. 嵌入配置。

      单击报表右侧操作列的image..png图标，在报表嵌入配置的对话框，进行以下配置。

      image..png

      参数名称

      描述

      嵌入对象

      选择嵌入的对象。

      • 选择页面整体，则嵌入的对象为当前仪表板。

      • 选择某个组件，则嵌入的对象为当前仪表板下的某个组件。

      展示型配置

      嵌入后，是否携带当前仪表板的标题。

      安全认证类型和Ticket链接

      选择Ticket认证并生成Ticket链接。

      您可以手动输入Ticket链接或者单击快捷生成，生成Ticket。

      image.png

      在生成Ticket的界面，您可以设置绑定用户、有效时长、水印参数和访问次数。

      获取嵌入代码

      支持生成URL链接和Iframe代码。

    步骤3：拼接免登URL

    1. 在Quick BI首页，单击工作台仪表板。

    2. 在仪表板管理页面，选择步骤2中已嵌入的第三方报表，单击1图标。

      您在仪表板预览页面的地址栏中看到的地址即为访问报表的地址。

      说明

      系统支持修改预览地址的域名。例如，预览地址域名为das.base.shuju.aliyun.com，您可以修改为bi.aliyun.com。

    3. 将步骤1：通过HTTPS接口获取accessToken拼接到报表的URL后面，免登录即可查看报表。

      示例如下。

      https://das.base.shuju.aliyun.com/token3rd/dashboard/view/pc.htm?pageId=703d6621-7aa0-4716-bcc1-515e3da794c2&accessToken=XXXXX

    管理嵌入的报表

    对已嵌入的第三方报表，可以执行如下操作：

    • 查询已嵌入的报表：在报表列表页面的搜索框中，输入报表名称关键字并单击查询图标，查询报表。

      您可以通过选择报表的工作空间或报表类型，缩小搜索范围。

    • 查看已嵌入的报表数量。请参见查看嵌入报表数量。

    • 删除已嵌入的报表：单击报表后的删除图标，删除报表。

    查看嵌入报表数量

    1. 在Quick BI产品首页，单击开放平台。

    2. 在左侧导航栏单击报表嵌入。

      在报表嵌入页面，您可以看到嵌入到第三方的报表数量。嵌入数量