Resource Guide
数字孪生对象、资产、点位与页面映射表
摘要：这份映射表用于把园区、建筑、楼层、设备等空间对象，与三维模型构件、资产台账、传感器点位、接口字段、告警规则、页面组件和责任人对应起来。它适合在建模、接口联调和页面开发前建立，并在模型或系统版本变化后持续维护。
为什么设备点位表还不够
常规点位表能说明设备编号、字段和数据值，但未必能回答模型里哪个构件高亮、点击后打开哪个页面、异常时关联哪个视频或工单、谁负责修正数据。若模型、台账、接口和页面各自使用不同名称，问题往往在联调后期才暴露。
先建立稳定主键，再讨论三维效果
对象编码、资产编码、点位编码和模型构件ID承担不同职责，不建议互相替代。显示名称可以调整，主键应尽量稳定；发生换表、换设备、模型重导出或系统迁移时，应保留旧新编码映射与生效时间，避免历史趋势和事件记录失去关联。
五层关系要逐项核对
| 层级 | 回答的问题 | 验收证据示例 |
|---|---|---|
| 空间对象 | 对象位于哪个园区、建筑、楼层或区域？ | 图纸与模型位置对照、层级清单。 |
| 模型与资产 | 哪个构件代表哪项真实资产？ | 构件ID、资产台账与现场编号对照。 |
| 点位与数据 | 哪个字段表达何种状态、单位和更新时间？ | 接口样例、字段说明、正常/空值/异常联调记录。 |
| 页面与交互 | 点击、高亮、趋势、视频和工单怎样联动？ | 目标终端操作录像、页面路径与异常状态截图。 |
| 责任与版本 | 数据、模型和接口分别由谁维护？ | 责任人确认、版本记录、变更与回归结果。 |
一个资产对应多个点位时怎样填写
让同一资产编码占多行，每行记录一个点位，分别填写点位类型、字段、单位、频率、正常异常规则和告警条件。设备运行状态、温度、压力和累计电量的语义不同，不宜合并成一个模糊的“设备数据”字段。
异常状态要与业务告警分开
接口超时、空值、超量程、时间戳倒退和累计量复位属于数据质量或链路异常，不一定代表设备故障。停止、离线、故障和检修也应分别定义。页面需要能显示未知状态，不能在没有证据时自动标成正常。
建议按这个顺序建立映射
- 确认园区、建筑、楼层、区域和设备的对象层级与首期范围。
- 统一对象、资产、点位与模型构件ID，并记录来源系统。
- 逐点位填写字段、单位、频率、有效范围、告警和空值规则。
- 确认每项数据进入哪个页面、组件以及触发何种交互。
- 补充视频、工单、权限角色和数据、模型、接口责任人。
- 用正常、异常、断数、无权限和版本变更场景完成验收。
与开放标准的关系
OGC SensorThings API提供了连接设备、观测数据和应用的开放标准思路。项目可参考其对实体和观测关系的组织方式，但本模板是通用项目工作表，不是标准实现规范，也不代表系统已经符合SensorThings或其他行业标准。是否采用标准接口应结合既有平台、设备协议和采购要求评估。
常见问题
已有设备点位表还需要对象映射表吗？
如果点位表已经同时包含空间对象、模型构件、资产编码、页面联动和责任关系，可以直接扩展；否则建议建立映射，避免模型、台账、接口和页面各用一套名称。
一个设备对应多个点位怎么填写？
可让同一资产编码占多行，每行记录一个点位，同时保持对象编码、模型构件ID和资产编码一致，并分别填写字段、单位、频率和规则。
模型构件没有稳定ID怎么办？
应在轻量化或导出环节生成稳定且可追踪的构件ID，并保留旧新版本映射；不要用页面显示名称代替长期主键。
这份模板是否代表符合OGC SensorThings标准？
不代表。模板可借鉴实体关系和观测数据分离的思路，但是否采用或符合该标准需要结合系统接口与正式规范单独评估。
下载与相关资料
项目启动时可先使用数字孪生项目资料清单，告警字段较多时配合数字孪生点位编码与告警分级模板，上线前再使用数字孪生项目验收清单。