概述
本文介绍如何把仪表盘发布 给协作者使用、通过链接分享 或 iframe 嵌入 到第三方系统，以及外部用户嵌入访问的支持方式。
仪表盘有两种状态：
草稿态（Draft） ：编辑产生的临时内容，仅 可编辑、可管理 角色能看到。
发布态（Published） ：发布后形成快照，可查看、可运行 角色访问的就是这个版本。
前提条件
在开始本操作前，请确保满足以下条件：
已在仪表盘中完成数据集与图表的搭建。
当前账号在该仪表盘上拥有 可编辑 或更高权限（发布需 可编辑 ；分享权限的增删改需 可管理 ）。
嵌入功能依赖 Workspace 管理员开启嵌出开关并配置允许的域名（详见下方 嵌入到第三方系统章节）。
操作步骤
步骤 1：发布仪表盘
1. 在仪表盘编辑态右上角单击发布 。
2. 在发布弹窗中配置：
发布模式 ：
共享发布者的数据权限 （默认）：发布者发布时使用自身的数据权限，并产生一份缓存供查看者复用。
遵循查看者自有数据权限 ：按最终访问用户的数据权限即时计算（编辑态永远按当前访问者计算）。
拥有“可查看”权限的用户 ：可点击 右侧的编辑 icon 进入可查看的用户修改。
3. 单击发布，右上角弹窗提示成功，可点击切换到发布态。
覆盖发布
再次单击发布会用当前草稿覆盖上一次发布版本。
注意：
当仪表盘发布者账号被删除时，使用「共享发布者数据权限」模式的仪表盘对查看者会提示「发布者不存在，无对应数据权限」。
步骤 2：复制分享链接
1. 在仪表盘顶部单击分享 。
2. 在弹窗左下角单击复制链接 。
3. 将链接发送给目标用户。打开链接后：
已发布过的仪表盘 → 进入发布态。
未发布过的仪表盘 → 进入编辑态（前提是访问者有可编辑权限）。
说明：
访问权限配置：
主账号下所有用户可访问：主账号下任意子用户无需在权限列表单独配置即可访问；
只有配置了权限的用户可访问：支持去切换配置的权限范围，如果切换到必须在权限列表中存在对应授权才能访问。
步骤 3：管理分享权限
在 分享 弹窗中可以查看与修改仪表盘的权限主体列表（仅 可管理 角色可修改）。
列表结构
列 | 说明 |
授权主体 | 已经被授权的用户 / 用户组 |
权限角色 |
搜索与过滤
搜索框 ：默认占位符「搜索用户/用户组」，输入后模糊匹配。无结果时显示「暂无搜索结果」。
所有角色 ：下拉多选权限角色：可管理、可编辑、可运行、可查看作为筛选条件。
搜索、所有角色为 AND 关系。
新增、移除授权
新增 ：通过下拉或模糊搜索选择用户、用户组，已被授权对象会出现，但无法选择。
移除 ：选择左侧方框进行多选，然后点击批量操作支持对多选授权主体后批量移除；系统继承类型不可选中。
转让所有者
1. 单击
···，支持选择 转让所有者 。2. 显示当前所有者，可搜索 Workspace 下的其他用户作为新所有者。
3. 单击确认 ，新所有者默认获得「可管理」权限。
步骤 4：嵌入到第三方系统
基础嵌入 用于将仪表盘以 iframe 方式集成到企业内部系统。
前提条件
仪表盘必须已发布；未发布时 嵌出仪表盘 按钮置灰，悬停提示「当前仪表盘暂未发布」。
Workspace 管理员需在 工作空间设置、安全管理、外部访问 中开启嵌入功能并配置允许的域名。可选模式：
允许
允许批准的域
拒绝
操作步骤
1. 在分享弹窗中单击嵌出仪表盘 。
2. 复制 HTML 嵌出代码或 JS 嵌出代码（JS 嵌出需 token 校验）。
3. 将代码粘贴到第三方应用页面。
嵌入后的仪表盘包含：
全局筛选器。
所有 Tab 页面。
刷新按钮（保留刷新时间）。
后续上线的图表全屏、下载操作。
注意：
当嵌入端的域名不符合当前 Workspace 安全设置时，会提示「当前嵌出的仪表盘不符合安全设置，无法展示。如果您是 DataBuddy 用户，可访问控制台仪表盘访问链接（外部 URL）」。
参数说明
发布配置
参数 | 说明 | 是否必填 | 默认值 | 取值范围 |
发布模式 | 数据权限计算方式 | 是 | 共享发布者的数据权限 | 共享发布者 / 遵循查看者 |
已发布版本 | 发布后将形成快照，再次发布会覆盖 | - | - | - |
分享权限角色
角色 | 仪表盘可看 | 编辑数据集 / 修改仪表盘 / 发布 | 复制和移动 | 刷新 | 导出 | 分享链接 | 查看权限用户 / 嵌入 | 增删改权限 | 删除仪表盘 |
无权限 | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ | ✗ |
可查看 | ✓ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
可运行 | ✓ | ✗ | ✗ | ✓ | ✓ | ✓ | ✗ | ✗ | ✗ |
可编辑 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✗ | ✗ |
可管理 | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
嵌入配置（Workspace 级，由管理员配置）
配置项 | 说明 |
嵌入开关 | 不允许 / 仅指定域名 / 所有域名 |
允许域名列表 | 允许嵌入的域名清单 |
验证结果
操作完成后，您可以通过以下方式确认：
1. 顶部仪表盘标题旁的状态变为「已发布」，编辑仪表盘 按钮替换为「编辑」入口。
2. 复制的链接在新浏览器窗口能直接打开发布态视图（前提是访问者具有 可查看 权限）。
3. 在第三方系统中，iframe 嵌入的仪表盘内容正常呈现，并可使用全局筛选器和刷新。
常见问题
Q：发布失败、部分查询失败时怎么办？
A：发布本身只生成快照，不会预先执行所有查询。查看者首次访问时会按需查询，单个图表查询失败不会影响其他图表。
Q：查看者看到的数据为什么和我不一致？
A：取决于发布模式：
共享发布者权限 ：查看者看到的是发布者权限下的数据。
遵循查看者权限 ：按访问者实时数据权限计算，可能因为查看者无某些表的权限而看到部分空数据或受限提示。
Q：分享链接被未授权用户打开会怎样？
A：访问页面会提示「无查看权限」。后续版本支持在该页面发起「申请权限」。
Q：嵌入页面显示「不符合安全设置」，如何处理？
A：联系 Workspace 管理员，将您的嵌入域名加入允许列表（工作空间设置、安全管理、外部访问 ）。
Q：账号试用结束、欠费会影响嵌入吗？
A：会。所有已发布仪表盘的访问入口将不可用，并显示「该仪表盘当前不可用，免费试用已结束、账户已欠费」。
相关文档
管理仪表盘权限
