QR 标签与公开页面
为每个区域 · 线体 · 设备创建并粘贴 QR 标签后，即可通过手机扫描直接查看该设备的信息。扫描标签将打开公开页面(/qr/<token>)。由于公开页面无需登录即可访问，因此每个站点默认处于关闭状态，仅在管理员开启的站点中才会显示设备信息。
需预先配置的地址
在 设置界面 中输入两个键。其值为用户在浏览器中输入的地址 —— 在代理之后，这与服务器监听的地址不同，因此 Platform 无法自动识别。
| 设置键 | 用途 | 为空时 |
|---|---|---|
PP_UI_CONSOLE_URL | 写入标签的地址(<콘솔 주소>/qr/<token>)。报警邮件的链接也使用此地址 | 不生成 QR 码，并显示 «无写入 QR 标签的控制台地址» 提示 |
PP_UI_FRONTLINE_URL | 公开页面中 «在 frontline 中打开» 按钮的跳转地址 | 隐藏该按钮 |
值应为像 https://plantpulse.example.com 这样以 http(s) 开头的绝对地址，末尾的 / 在保存时将被截断。拒绝带有查询参数或 # 的值。若要在手机上打开公开页面，手机必须能够访问该地址。
创建标签
在 设备树 中选择区域 · 线体 · 设备，打开固有属性选项卡，即可看到 QR 标签卡片。标签包含 QR 码 · 名称 · ID · 位置（站点 › 区域 › 线体）。尺寸为 70 × 40 mm，屏幕上将按实际打印尺寸绘制。若 ID 和位置较长，最多显示两行，超出部分将被截断。
| 数字 | 位置 | 功能 |
|---|---|---|
| ① | 卡片头部右侧 | 保存 PNG · 打印标签 · 重新颁发 — 详见下表 |
| ② | 卡片正文 | 按打印尺寸绘制的标签（QR · 名称 · ID · 位置） |
| 按钮 | 功能 | 权限 |
|---|---|---|
| 保存 PNG | 将标签下载为图像文件 | 所有登录用户 |
| 打印标签 | 仅打印标签 | 所有登录用户 |
| 重新颁发 | 创建新令牌 | 管理员(ADMIN) |
令牌在首次查看标签时创建，每台设备仅拥有一个有效的令牌。标签中使用不可预测的随机令牌而非设备 ID。
重新颁发后扫描旧标签将显示 «找不到该 QR 码»。必须打印并粘贴新标签。此功能适用于标签照片泄露等需要禁用旧标签的情况。
开启公开页面
公开权限按站点设定。在设备树中选择站点，在固有属性选项卡的 QR 公开页面卡片中进行更改。仅管理员可以更改开关。
| 开关 | 默认 | 开启时 | 关闭时 |
|---|---|---|---|
| 开启公开页面 | 关闭 | 扫描该站点设备的标签将显示以下信息 | 仅显示 «该设备未公开» 及登录按钮。名称 · 照片均不可见 |
| 显示负责人联系方式 | 关闭 | 同时显示负责人的电话 · 电子邮件 | 仅显示负责人姓名。仅在公开页面开启时生效 |
公开页面显示内容
| 项目 | 值 |
|---|---|
| 名称 · 照片 | 设备名称及关联照片。无照片时显示楼层图标 |
| 位置 | 站点 › 区域 › 线体 |
| 功能位置 | 设备的 functional_location。若无则不显示该行 |
| 设备分类 | 按访问者语言显示 |
| 运行状态 | 记录的运行状态(operational_status_code)。非实时值 |
| 负责人 | 负责员工。若无则显示 «未指定负责人» |
| 电话 · 电子邮件 | 仅在开启 «显示负责人联系方式» 的站点中显示 |
实时值 · 报警 · 序列号 · 制造商 · 型号 · 内部 ID 不会出现在公开页面中。语言遵循访问者的浏览器设置。
下方为两个按钮。
| 按钮 | 跳转位置 |
|---|---|
| 在 frontline 中打开 | 现场 App 中的该设备。仅在存在 PP_UI_FRONTLINE_URL 时显示 — 通过 QR 标签打开设备 |
| 在控制台中查看 | 控制台的设备界面。若未登录，将在登录后返回该界面。关闭公开状态时的登录按钮与之相同 |
扫描后的显示界面
| 界面 | 触发场景 |
|---|---|
| 设备信息 | 已开启公开站点的有效标签 |
| «该设备未公开» | 已关闭公开站点的标签 |
| «找不到该 QR 码» | 重新颁发后的旧标签或地址错误时 |
| «请求过多» | 单个地址请求密集时。允许单次 10 条，随后每分钟最多 30 条 |
留存记录
公开路径的每次响应将记录在 pp.mm_asset_qr_access_audit 中 —— 时间 · 令牌提示 · 访问地址 · 结果。由于公开路径不涉及用户身份，因此不记录用户信息，也不记录令牌值本身。公开页面已禁止缓存和搜索引擎索引。
API
像现场 App 一样通过令牌在服务器中查找设备时，请使用 GET /api/v5/asset/qr/{token}。标签中所含的地址为 GET /api/v5/asset/{id} 响应中的 qr_payload。此调用不创建令牌，因此对于尚未在控制台中打开标签的设备或无控制台地址的设备，将返回空字符串。请参阅 端点完整列表。