预览、发布与分享
大屏的保存、草稿与版本、预览地址、发布、导入导出，外链分享的密码与 IP 白名单规则，以及嵌入业务系统与运行配额。
概述
大屏从设计到上墙经过保存、预览、发布三步。保存写入草稿；发布把草稿固化为一个数字版本；运行页默认读取已发布版本。发布后，可以用外链分享给免登录的访问者，也可以嵌入业务系统。外链受访问密码和 IP 白名单保护，且可随时关闭。
功能入口
- 设计器顶栏：「保存」「预览」「发布」，「更多」里有「草稿记录」「版本列表」「导入大屏文件」「导出大屏文件」「导出为图片 (PNG)」。
- 「大屏管理」卡片：「设计」「预览」「复制」「外链分享」「删除」，以及右上角「导入」。未发布的大屏，卡片上预览不可用；已发布的显示「已发布」和版本号。
操作步骤
保存与草稿
- 点击顶栏「保存」（或
Ctrl / Cmd + S），提示「大屏已保存」，内容存为草稿。 - 页面有未保存的改动时离开，会提示「您有未保存的更改，确定要离开吗？」。直接关闭页面不会自动保存。
- 「更多」>「草稿记录」列出每次保存的记录，最多保留最近 30 条，可「比较」与当前设计的差异，或「导入」回设计器。
预览
- 点击顶栏「预览」。有未保存的改动时会提示先保存，选「保存并预览」。
- 运行页在新标签页打开，地址是
/datawall-view/{大屏ID}。联动、动画、自动轮播和刷新都在这里生效。 - 运行页默认读取已发布版本。要看草稿，在地址后加
?version=draft；要看某个历史版本，加?version=版本号。
发布
- 点击顶栏「发布」，有未保存的改动时选「保存并发布」。
- 在「发布版本」对话框填「版本说明」（最多 200 个字符），点击「发布」，提示「大屏已发布」。
- 发布把当前草稿固化为一个数字版本。「更多」>「版本列表」显示各版本的版本号、发布说明、发布人、发布时间和发布状态。
版本管理
在「版本列表」中对每个版本可以：「预览」查看该版本；「切换」让它成为当前发布版本（会二次确认「确定要切换到版本 vN 吗？」）；「比较」与当前设计对比差异；「导入」把该版本内容导入设计器，导入后需要保存才生效。
导出与导入
- 设计器「更多」>「导出大屏文件」得到
.mrb文件，「导出为图片 (PNG)」得到整屏截图。 - 在「大屏管理」点击「导入」，选择
.mrb或.zip（.zip可包含多个大屏），一次最多 20 个文件，逐个显示「导入成功」或「失败」。设计器内「更多」>「导入大屏文件」把文件内容导入当前设计，需要保存后生效。
外链分享
- 在「大屏管理」点击卡片上的「外链分享」图标，打开「外链分享」对话框。对话框顶部提示：外链免登录访问，链接一旦外泄，任何人都能看到大屏数据，强烈建议同时设置访问密码和 IP 白名单。
- 打开「开启外链」，「外链地址」点击「复制」。关闭后链接立即失效，谁都打不开。
- 「访问密码」留空表示不设密码；「IP 白名单」留空表示不限，支持精确 IP、CIDR（例如
192.168.1.0/24）、*通配，逗号或换行分隔。 - 点击「保存」。访问者打开复制出的外链地址（生产包为 hash 路由，形如
http://<地址>/#/share/{大屏ID}），若设了密码，输入后点击「进入大屏」。
属性/参数说明
外链访问规则
| 规则 | 说明 |
|---|---|
| 外链开关 | 关闭后访问返回「大屏不存在或已删除」，不泄露是否存在或是否设了密码 |
| IP 白名单 | 客户端 IP 不在范围内，提示「当前网络（IP）不在该大屏的允许访问范围内」；只支持 IPv4 的 CIDR |
| 访问密码 | 设置了密码就必须输入正确密码；错误提示「访问密码错误」 |
| 组合 | IP 白名单与访问密码同时生效：两者都设置时，IP 必须在范围内，且密码正确 |
| 限流 | 同一大屏、同一 IP 在 10 分钟内输错 10 次后锁定，提示「访问密码错误次数过多，请稍后再试」；输对清零 |
| 内容版本 | 外链返回已发布版本，没有发布过则返回草稿 |
| 数据刷新 | 外链页的自动刷新通过独立的取数接口，用访问票据校验；票据有效期 12 小时，失效时前端凭已输入的密码静默换新，不向观众弹错误；每次取数仍校验 IP |
| 凭据保护 | 返回给匿名访问者的大屏内容会去掉 API 数据集的凭据，取数在服务端完成 |
三类访问入口
| 入口 | 地址 | 是否需要登录 |
|---|---|---|
| 运行页（设计器预览） | /datawall-view/{大屏ID} |
需要，且账号有该大屏的查看权限 |
| 外链分享 | /#/share/{大屏ID}（生产包 hash 路由；早期发出的 /share/{大屏ID} 链接会被自动改写） |
不需要，受密码与 IP 白名单保护 |
| 嵌入业务系统 | 把外链地址放进 iframe，没有单独的签名嵌入 | 不需要，同样受密码与 IP 白名单保护，见大屏集成 |
运行配额
授权中的大屏配额（maxDatawall）限制的是统计窗口内运行过的不同大屏数，不限制创建。设计器内预览、新建、编辑、保存都不计入；运行页与外链访问会计入，外链页的自动刷新取数会持续续期，因此它等价于「同时在播的大屏数」。超限时返回提示（错误码 42902）。授权说明见授权与许可。
运行页行为
| 行为 | 说明 |
|---|---|
| 适配 | 按「适配模式」缩放画布，见画布与页面设置 |
| 多页 | 「页面自动轮播」开启时按「轮播间隔(s)」自动切页，页面过渡按设置 |
| 刷新 | 「自动刷新」开启时按间隔轮询数据集，间隔不小于 5 秒 |
| 实时推送 | 「实时推送」开启时优先建立 SSE 通道，断线时回退到轮询 |
| 退出预览 | 在预览里按 Esc |
示例
把门诊大屏投到值班室大屏：
- 设计器里「保存」，「发布」，「版本说明」填「上线首版」。
- 「大屏管理」点「外链分享」，打开「开启外链」，「访问密码」设为一个强密码，「IP 白名单」填值班室出口网段
10.20.30.0/24，「保存」。 - 值班室电脑用浏览器全屏打开复制的外链，输入密码进入大屏；其他网段的访问者会看到「当前网络（IP）不在该大屏的允许访问范围内」。
注意事项
注意：默认预览与外链读取的是已发布版本。保存但没发布的改动，外链不会看到；要看草稿只能用
?version=draft（需登录）。注意：外链的 IP 白名单和密码是「同时满足」关系：IP 不在白名单内，即使密码正确也无法访问；IP 命中白名单也不会免除密码。
注意：外链取数使用已发布版本的数据集定义；发布后改了 SQL 但没有重新发布，外链仍按旧定义取数。
注意：关闭外链会让链接立即失效；修改访问密码会使已签发的访问票据全部失效，访问者需要重新输入密码。
提示：外链无法防止已获得访问权的人截图，敏感数据请配合 IP 白名单使用。
