TOC

  1. Intro
  2. TagModel
  3. Structure
  4. TimeZones
  5. Units
  6. Grids
    1. 概述
    2. 结构
    3. 范例
  7. Filters
  8. Zinc
  9. Json
  10. Trio
  11. Csv
  12. Rest
  13. Ops
  14. Auth
  15. VFDs
  16. Networks
  17. Energy
  18. Zones
  19. AHUs
  20. VAVs
  21. UnitaryEquips
  22. Chillers
  23. Boilers
  24. Tanks
  25. ElecPanels
  26. Lighting
  27. Builds
  28. Bacnet
  29. ChangeLog
  30. License
Units Filters

Grids

概述

网格是标签化实体的二维表格形式。我们使用网格作为核心数据模型,并在 HTTP 层面使用 Rest API来序列化被 haystack 标记的数据。

结构

一个网格由以下组成:

元数据只是由标签模型( tag model )指定的键值对标签的列表。网格级元数据允许我们指定关于整个网格的标签。

列和行用于建立 Haystack 标签实体列表。列通过实体列表中所有唯一标签名的并集计算得出。每列由编程名称组成,该名称必须是有效的标签名称( tag name )。列也可以使用标签指定元数据。 dis 列标签可以用于为列提供人性化的显示名称(因为编程名称可能是驼峰式命名方式)。

行用于对标记实体的列表进行建模。行由网格中每列的单元组成。每个单元格必须是有效的 tag kind ,如果该行没有给定列的值,则可能为 null 或 空白。

范例

下面是三个站点模型的haystack实体:

id: @site-a
dis: "Site A"
site
area: 45000ft²

id: @site-b
dis: "Site B"
site

id: @site-c
dis: "Site C"
site
area: 62000ft²
phone: "(804) 555-1234"

上面的三个实体都有一个id,dis和site标签。另外有两个area标签,一个有phone标签。要将这三个实体组合成一个网格,我们最终得到五列三行:

id       dis       site  area      phone
-------  -------   ----  --------  ------
@site-a  "Site A"  ✓     45000ft²
@site-b  "Site B"  ✓
@site-c  "Site C"  ✓     62000ft²  "(804) 555-1234"

请注意:列是由实体贡献的所有标签的并集。因为并不是每个实体共享相同的列,所以我们有空或 null 的单元格。我们可以进一步添加网格级或列级元数据。

Units Filters