ThinkLink 实践 / 现场与运维

园区设备怎样按楼栋楼层管理:ThinkLink 位置编码与完整路径

区分位置编码、完整路径和查询范围,正确处理楼层汇总、位置移动与设备导入,避免设备存在却查不到。

ThinkLink发布于 4 分钟阅读
先看结论

先建立真实的位置记录,再用 location_code 绑定设备与网关;完整路径表达层级,编码维持关联。汇总前明确选择本级还是本级及子孙级。

建立清晰的位置层级
建立清晰的位置层级 点击查看大图 ↗

路径负责表达,编码负责关联

一个位置可以表示园区、一栋楼或一个房间。建议用“园区/一号楼/三层/机房”表达业务层级,并为每条实际位置记录分配稳定编码。路径和编码是不同字段,设备及网关通过 location_code 关联,而不是通过显示名称。当前完整路径功能适用于配套版本,实施前核对现场版本和表单。不要为了让编码看起来整齐而在楼层改名时同时更换编码;也不要把两个同名房间当作同一位置。先约定命名规则、维护责任和实际需要的层级,再批量录入。

创建真实父节点再导入设备

位置树只显示实际存在的记录,不会自动补齐路径中的中间节点。即使保存了“园区/一号楼/三层”,若中间父记录缺失,也不能期待树自动生成完整分支。先按层级建立父子记录,检查完整路径预览和唯一性。位置表导入使用 path,设备导入仍使用 location_code,两种模板不可混用。文档明确指出设备导入遇到不存在的位置编码时会置空位置并继续导入,因此导入成功还必须补做绑定回读。先抽样验证,再扩大批次,比事后逐台找回缺失位置更容易。

明确本级与整栋楼的范围

在位置详情中,本级只包含直接绑定当前编码的设备或网关;本级及子孙级还包含后代位置。统计整栋楼时,要选择正确页签,并读取完整分页或正式总数,不能把当前页行数当作楼宇总量。子树判断依据完整路径边界,不应自行按编码字符串前缀过滤。部门、位置和业务空间也是不同范围,不要假设它们天然一致。例如设备可属于某部门,但实际安装在另一个空间;维护人员应明确报表和看板到底按哪个范围取数。

层级;导入;汇总;删除
层级;导入;汇总;删除 点击查看大图 ↗

移动分支后验证绑定与汇总

修改父级或名称会更新后代路径,位置 ID 和编码保持不变;设备、网关一般不需要因为路径改动重新绑定。先在测试位置上验证,保存后回读父节点、一个后代节点及关联设备,再查看新路径下的统计范围。若路径冲突,按平台返回处理,不要靠删除重建位置绕过问题。交付时演示一次改名后的查询,确认维护人员理解显示路径变化与关联编码稳定的关系。这里的验证检查对象与范围,不需要对现场设备发送任何控制命令。

  1. 建立真实父子位置并核对预览。
  2. 用位置编码绑定一台测试设备。
  3. 比较本级与包含后代的查询。
  4. 改名后回读路径、绑定和总数。

删除前准备重新归属方案

列表删除只删除选中的位置,树上的分支删除涉及整条分支,两者范围不同。删除位置不会自动删除设备,也不会自动清除设备保存的绑定编码,因此可能留下指向不存在位置的关联。先核对影响数量、导出受影响对象并准备新的位置归属,再按批准范围操作。树上缺少父记录时,可见节点还可能不足以表达实际影响范围。日常维护应保留一份编码与路径清单,以及谁负责新增、改名和停用的说明,让后续人员不必通过猜测修复组织结构。

常见问题

楼层改名需要重新绑定设备吗?

位置编码保持不变时,不需要仅因路径改名重新绑定;仍应回读验证。

删除位置会一并删除设备吗?

不会。设备及原绑定编码仍可能保留,需要安排重新归属。

参考资料与延伸阅读

本文依据以下官方资料编写。示意图用于解释方法,具体菜单、字段和能力以目标版本文档为准。

给我们留言

合作想法、项目需求,或任何想说的话,都欢迎留下。

如需我们联系你,请留下邮箱。

留言将安全保存,供我们的团队处理本次咨询。邮箱可以不填;请勿提交密码等敏感信息。

也可以直接发邮件至 info@manthink.cn