TMX Insight™ 服务平台 2.5 用户指南

1 序言

本指南主要目的是使用户管理员全面了解 ThingsMatrix 服务平台。文中 “平台” 均代指 ThingsMatrix 服务平台。

2 概述

平台通过其设计和部署中的模块化方式以实现物联网解决方案。平台包括四个主要组件:物联网网关(IOTGW),设备管理平台(DMP),连接管理平台(TMX Connect™)和控制管理中心(CMC)。每个组件还可以根据服务需求进行独立部署。

物联网网关处理设备通信并解释协议和数据。

设备管理平台处理设备和会话管理,数据收集,存储和上报。

连接管理平台集成移动运营商网络并提供整体 SIM 管理功能,比如 SIM 状态管理,会话管理和使用情况上报。

控制管理中心是一个核心组件,可通过网页的 UI 界面提供用户管理和集中控制功能。它还提供包含所有必要业务逻辑的 API 编程接口服务。

根据用户的需求,每个部署可以具有各种组件和功能。通过这些组件,整个系统提供以下功能:

  • 组织管理服务
  • 连接管理服务
  • 资产管理服务
  • 数据管理服务
  • API 编程接口服务

3 浏览器兼容性

3.1 支持的浏览器

平台目前仅支持 Chrome 和 Firefox。

4 支持的设备

4.1 设备型号

物联网网关负责通过 TCP 或 TLS 进行设备通信。每个独特型号的设备的通信支持和应用不同的协议。物联网网关目前支持以下 ThingsMatrix 许可设备:

平台版本 设备型号 设备描述
1.x TMA01 物流追踪器 (2G,LTE)
TMA11 用于TMA01的可拆卸传感器集线器
TMX06 追踪器 (2G)
TMX07 追踪器 (LTE Cat-M)
TMM01 认证的第三方设备
2.x TMX08 追踪采集器 (Cat-M)
TMF01 广和通物联网模块 (NL668,MT910,等等)
TMY01 追踪器 (2G,Cat-M)
TMY02 追踪器 (2G,Cat-M,NB)
TMX09 追踪器 (2G)
TMY07 追踪器 (2G,Cat-M,NB)
TMY09 追踪器 (2G,Cat-M,NB)
TMY03 追踪器 (2G,Cat-M,NB)
TMY05 追踪器 (2G,Cat-M,NB)
TMX01 追踪器 (2G LTE Cat-M)
TMX02 追踪器 (2G LTE Cat-M)
TMX03 追踪器 (2G)
TMX04 追踪器 (2G LTE Cat-M)

5 服务启动

每位想要使用平台的新用户都需要提供以下信息,以启动公司注册和部署:

  • 公司名称
  • 唯一名称或代码(在 URL 网址域名中使用)
  • 主要联系人电子邮箱(唯一)
  • 电子邮件域名(可多个,缺省情况下,它使用主要联系人电子邮件地址的域名)
  • 需求的服务

一旦 ThingsMatrix 收到请求并且签署了服务合同后,ThingsMatrix 将负责在平台中创建新的公司。同时,将发送带有登录 URL 网址、用户名和密码的电子邮件到主要联系人的电子邮箱。然后用户就可以根据给定的信息登录平台。

6 登录

点击登录 URL 网址进入登录门户,然后输入用户名和密码,点击 Login 按钮登录。

用户成功登录后,将进入主页。导航栏位于左侧,并显示设备位置地图,如下所示:

当前处于过滤模式。用户可以通过选择型号名称、群组名称或状态来过滤设备。

通过配置数据字段,对应的数据会显示在列表中和地图中设备位置上方。如果还未生成对应的数据,它会显示为 “--”。

据上面提及,设备列表位于右侧以显示当前可视区域的所有设备的更多信息,包括别名、序列号、型号、群组、定位类型、具体的地址和对应的数据(如果先前有配置)。

点击设备序列号进入设备详情页查看更多信息。

通过点击 Reset 按钮或 Restart 按钮,授权用户可以轻松地对特定设备进行可行的重置或重启。

点击 Search 按钮,进入搜索模式。输入序列号包含的至少3位数字,并选择想要的序列号,然后点击 Search 按钮以定位该特定设备。

授权用户也可以在地图上设置目标点以方便定位。每次登陆后,地图将以目标点为中心进行显示。右键点击地图上想要作为中心的位置,然后点击 Targeting point setting 按钮,该处会被设置为目标点。

右键点击已存在的目标点以删除它,或者右键另一个位置以设置另一个新的目标点。

如果设备上报了新的地理信息数据,地图上的数据统计和位置信息都会自动刷新。

7 组织管理服务

7.1 功能描述

平台分别为每一个公司提供组织管理功能,该功能允许用户管理员创建自己的组织架构并通过组织菜单以管理用户。基于所有用户信息,平台对所有的静态配置应用基于角色的访问控制,并且应用用户访问控制以为每个用户共享设备遥测数据。

组织管理服务包括四个部分:

  • 所有用户
  • 部门
  • 团队
  • 角色管理

7.2 所有用户

用户管理应用了用户访问控制。缺省情况下,一个普通用户只能查看设备列表,但不允许查看设备数据。查看设备遥测数据的特权由每个设备群组控制。只有被允许的用户才能通过 GUI 或 API 访问数据。公司管理员自动拥有访问所有数据的权限。

点击 All Users 项,用户列表和待处理用户列表如下所示。如果无法访问 All Users 项,请确保已购买组织管理服务并对用户管理员账户有效。在用户列表中,用户管理员有权新建和删除用户,以及查看和编辑所有级别的用户角色的信息。在待处理的用户列表中,用户管理员可以邀请新用户,查看正在申请访问平台的用户的用户信息,并对他们执行操作。

平台提供了三种添加用户的方法:

  1. 用户管理员可以输入用户的所有信息并直接添加该用户,临时密码会通过邮件分享。请参阅下方 7.2.1 添加新用户 部分。
  2. 用户管理员可以通过向电子邮箱发送邮件以邀请用户,然后用户可以接收邀请并使用邀请码完成注册。请参阅下方 7.2.3 邀请新用户 部分。
  3. 用户可以通过网页输入有效电子邮件地址以完成注册。该过程会生成邀请码,并将其发送到用户的电子邮箱。请参阅下方 7.2.5 注册新用户 部分。

用户完成注册过程后,可以使用他的用户名和密码登录平台。用户管理员可以稍后更改用户角色。每个用户都可以通过账户中心修改密码,而用户管理员可以从用户列表中重置用户密码。如果需要访问平台的 API 编程接口,用户还可以在账户中心生成 API 令牌。

7.2.1 添加新用户

点击用户列表部分的 + New 按钮,Add User 窗口会弹出,然后用户管理员可以添加一个新用户。

要为新用户分配特定的设备群组权限,在 “设备组权限 (Own)” 选择设备群组。它表示这个新用户将可以访问已选设备群组 “tmx08_periodic_30m” 以及 “tmx09_motion_10m” 的所有设备数据,如下所示。填写表格完毕后,点击 Submit 按钮以添加新用户。

7.2.2 管理用户

选择其中一个用户,点击 Actions 按钮,将显示可用操作列表。用户管理员可以点击 Modify 按钮以修改已添加用户的信息。Enable/Disable 按钮可以帮助用户管理员激活或禁用用户账户。点击 Reset Password 按钮,用户管理员可以重设用户密码。Delete 按钮可以帮助用户管理员删除用户。

  • 修改用户

    点击 Modify 按钮, Edit User 窗口会弹出,如下所示。用户管理员可以修改用户信息。

    如果 “设备组权限 (Inherited)” 不为空,它表示这个用户因部门而拥有访问特定设备群组 “tmy05_motion_30m” 以及 “tmy07_periodic_1h” 的所有设备数据的权限,如下所示。要修改它,请参考 7.3.1 添加新子部门7.3.2 修改子部门 部分。完成用户修改后,点击 Submit 按钮以应用改动。

  • 禁用用户

    禁用的用户无法登陆平台或使用 API 编程接口服务。选择一个用户,点击 Disable 按钮,该用户会被禁用。下面概述了一个示例:

  • 启用用户

    启用的用户可以登录平台和访问 API 编程接口服务。选择一个用户,点击 Enable 按钮,该用户会被禁用。下面概述了一个示例:

  • 重设密码

    点击 Reset Password 按钮,将重置所选用户的密码。一封带着新密码的电子邮件会被发送到所选用户的电子邮箱,他可以用新密码登录。

  • 删除用户

    请注意: 用户在被删除之前,需要将其从部门和团队中移除,并且需要先使用先前提供的说明禁用该用户。 在用户被禁用以后,点击 Delete 按钮,所选用户的账户将从平台中删除。

7.2.3 邀请新用户

点击待处理用户列表中的 + Invite 按钮, Invite User 窗口会弹出。用户管理员可以输入他要邀请的用户的电子邮件地址。点击 Invite 按钮后,验证邮件会发送到该电子邮箱。然后,用户可以按照验证邮件中的说明以注册平台。

7.2.4 操作待处理用户

用户管理员可以查看受邀用户的注册状态、查看和删除待处理用户。

7.2.5 注册新用户

用户可以通过门户注册页面输入有效的电子邮件地址以完成注册过程,有效的电子邮件地址应与公司电子邮件域名列表中其中一个的名称相匹配。点击 Sign Up > 按钮进入注册页面。

输入用户的有效电子邮件地址,然后点击 Sign Up 按钮。

填写注册表格,然后点击 Sign Up 按钮。

该用户已在平台上成功注册。输入用户名和密码,然后点击 Login 按钮登录。

7.3 部门组织

要组织部门架构,请点击 Department 项。用户管理员可以创建独立的子部门以分配不同的数据权限给用户。创建第一级子部门后,有需要的话,客户管理员可以修改或删除子部门。同时,他也可以选择创建更多的子部门。

7.3.1 添加新子部门

用户管理员可以选择其中一个父部门,点击 Action 按钮,然后点击 Add Sub-department 按钮以创建子部门。

Add Sub-department 窗口会弹出,然后用户管理员可以为其输入名称。要为新部门分配特定的设备群组权限,在 “设备组权限 (Own)” 选择设备群组。它表示这个部门下的所有用户将可以访问已选设备群组 “tmy02_periodic_15m” 以及 “tmy05_always_1h” 的所有设备数据,如下所示。填写表格后,点击 Submit 按钮以创建新的子部门。

7.3.2 修改子部门

如果用户管理员想修改子部门,他可以选择一个子部门,点击 Action 按钮,然后点击 Modify 按钮。Modify Sub-department 窗口会弹出,供用户管理员修改子部门。

如果 “设备组权限 (Inherited)” 非空,它表示所有属于该部门的用户均拥有访问特定设备群组 “tmy05_always_1h” 以及 “tmy02_periodic_15m” 的所有设备数据的权限,如下所示。请注意:该设备组权限继承自该部门的子部门。要修改它,您需要修改该部门的子部门。 修改完成后,点击 Submit 按钮以应用改动。

7.3.3 删除子部门

用户管理员可以删除子部门。为此,选择一个子部门,点击 Action 按钮然后点击 Delete 按钮以删除子部门。该子部门将被删除,同时,账户中关于此部门的信息也会被移除。请注意:该操作也会删除其下属的所有子部门。然而,它并不会移除关联到这些子部门的账户。

7.4 定义团队

为了提高灵活性,用户管理员可以为来自不同部门的用户定义团队以分配不同的数据权限。团队没有组织架构。

7.4.1 添加新团队

点击 + 按钮,用户管理员可以通过弹出的 Add Team 窗口输入团队名称并定义该团队的成员列表以添加新团队。

要为新团队分配特定的设备群组权限,在 “设备组权限 (Own)” 选择设备群组。它表示这个团队中的所有成员将可以访问已选设备群组 “tmx06_periodic_30m”、 “tmx07_periodic_2h” 以及 “tmx07_schedule_15m” 的所有设备数据,如下所示。填写表格后,点击 Save 按钮以创建新团队。

7.4.2 修改团队

如果用户管理员想修改团队,他可以点击 Modify 按钮以编辑团队名称、分配不同的设备群组权限和重新安排团队成员。

修改完后,点击 Save 按钮以保存修改。

7.4.3 删除团队

点击 Delete 按钮,用户管理员可以删除团队以及移除所属成员的用户信息中的团队信息。请注意:该操作并不会从公司移除团队所属成员的账户。

7.5 角色管理

平台应用基于角色的访问控制以管理用户角色。系统内部有两个缺省并且无法被修改或删除的用户角色设定:

  • 公司管理员
  • 普通用户

缺省情况下,公司管理员有权管理自己公司中的所有对象和配置,例如添加或删除设备。普通用户只能查看设备列表,并不允许查看设备数据。查看设备遥测数据的权限由每个设备组控制。只有授权用户才能通过 GUI 或 API 访问该数据。公司管理员自动拥有访问所有数据的权限。用户管理员可以为各种角色授权不同等级的访问级别。

7.5.1 添加新角色

点击 + New 按钮,用户管理员可以通过填写 Add Role 表格以创建角色。

7.5.2 管理角色

选择其中一个角色然后点击 Actions 按钮,会显示用户管理员的操作菜单列表。

  • 修改角色

    用户管理员可以点击 Modify 按钮以修改角色。Modify Role 窗口会弹出,然后用户管理员可以重命名角色和修改角色拥有的权限。

    完成修改后,点击 Submit 按钮以保存改动。

  • 删除角色

    先选择一个用户角色,然后点击 Delete 按钮以删除角色。请注意:用户管理员需要确保该角色没有关联任何用户,否则无法删除角色。

8 连接管理服务

8.1 功能描述

连接管理服务用于管理从移动网络运营商分发的 SIM 卡。平台支持两种 SIM 卡:

  1. 用户提供的 SIM 卡
  2. ThingsMatrix 提供的 SIM 卡

对于用户提供的 SIM 卡,连接管理服务负责 SIM 卡的库存管理。对于 ThingsMatrix 提供的 SIM 卡,平台与虚拟网络运营商的服务 API 集成在一起,以便检索 SIM 卡信息和实时会话状态。基于虚拟网络运营商的 SIM 卡使用情况报告,连接管理服务能够在 SIM 卡数据视图中提供有关 SIM 卡使用情况的摘要报告。请注意:在当前版本中,连接数据统计仅支持 AT&T 和 ARM 的 SIM 卡类型。

8.2 ThingsMatrix 提供的 SIM 卡

用户管理员可以查看 SIM 卡的历史数据和统计数据,以及以 Excel 和 CSV 的格式导出 SIM 卡列表。

8.2.1 查看 SIM 卡使用情况摘要

点击 Data 列的 View 按钮,将显示相应的 SIM 卡使用情况数据。您可以通过选择开始日期和结束日期以检查历史数据和统计数据。

8.2.2 导出 SIM 卡列表

点击 Export 按钮,Export 窗口会弹出。选择一种格式,然后点击 Export 按钮以导出 SIM 卡列表。

8.3 用户提供的 SIM 卡

用户管理员可以查看 SIM 卡的历史数据和统计数据,以及以 Excel 和 CSV 的格式导出 SIM 卡列表。

8.3.1 添加新 SIM 卡

点击 + New 按钮,New SIM Connectivity 窗口会弹出。

填写表格,然后点击 Submit 按钮以添加新 SIM 卡。

8.3.2 导入新 SIM 卡

点击 Import 按钮,Import 窗口会弹出。选择 CSV 或 Excel 格式后,将会请求下载一个对应的模板。

下载完模板后,用户管理员可以填写表格。点击 Browser 按钮以选择文件。

点击 Import 按钮以上传文件并导入 SIM 卡到 SIM 卡列表。

8.3.3 导出 SIM 卡列表

点击 Export 按钮,Export 窗口会弹出。选择一种格式,然后点击 Export 按钮以导出 SIM 卡列表。

9 资产管理服务

9.1 功能描述

该服务负责设备和传感器的整体管理。主设备包含主控制器、网络模块、定位模块和内置传感器。传感器集线器是一个连接多个传感器的独立设备。它可以连接到主设备,具备独立的序列号,但是不能独立地与平台通信。资产管理选项卡为授权用户提供了一系列功能,以管理所有主设备和相应的配置。 资产管理服务包括七个部分:

  • 设备管理
  • 主设备列表
  • 主设备报告列表
  • 主设备事件列表
  • 主设备警告列表
  • 主设备命令中心
  • 证书管理

9.2 设备管理

在设备管理部分中,缺省设备型号由 ThingsMatrix 预先配置,因此用户无法在此处添加、修改或删除缺省设备型号。用户管理员可以通过 ThingsMatrix 官网或者联系我们购买更多的缺省设备型号。平台为用户提供了自定义型号的添加功能以支持 MQTT 设备。

对于私有协议型号,以 TMX08 型号为例,我们选择 TMX08 型号。

型号的基本信息在中间部分显示。

  • 数据描述

    每个型号都有它自己的数据描述。最初它仅包含系统描述,它们不能被删除。用户管理员可以根据需求扩展描述。请注意:扩展描述的数据仅在数据流中已配置和计算后才会生成。 有关更多信息,请参阅 10.3.3 配置数据流组件 部分。

  • 群组

    设备群组是一个逻辑组件,其中包括一组相同型号的设备。授权用户可以管理设备的某些共同属性。Group 选项卡包含群组的基础信息,以及显示在仪表盘功能中已配置并在设置中已启用仪表盘的关于该设备群组的所有图表。有关更多信息,请参阅 10.2 仪表盘12 设置 部分。

  • 配置模板

    每一个设备型号都有其唯一的配置文件,该文件用于定义设备的基本设置,固件版本和规则集。在设备注册和身份验证期间,设备配置文件将传递到物联网网关并下载到设备上。缺省情况下,一个设备群组可能具有空的配置模板,这意味着设备将使用其缺省配置设置。应用配置模板后,设备将会使用新的配置设置。更改模板后,平台主动下发新配置给在线设备并应用;离线设备下次连接平台时下发新配置并应用。该更改将应用于该群组中的所有主设备。关于参数配置的更多信息,请参阅相应设备的 ThingsMatrix 设备手册参数表 部分。

  • 主题 (仅限 MQTT 协议的自定义型号)

    若要连接平台,MQTT 设备需要提供它的客户端 ID 作为它的序列号,并且配置好 代理服务器的网址,例如,“<公司名>.gw.thingsmatrix.io”。每一个自定义型号都有用于 MQTT 设备和平台进行通信的若干个主题。所以设备必须选择一个主题以能够上报数据以及收取配置和命令。一些预先配置的主题如下所示:

    设备可以向平台发布“设备信息”、“设备报告”和“事件”。同时,设备可以从平台订阅“配置”以及“命令”。

    • info

      设备在启动或收到相关命令后,会上报基础信息。

    • report

      设备根据不同情况上报实时数据。假设设备会上报温度的实时数据,为了平台能接收和存储它的温度数据,平台上需要先创建扩展描述。更多关于创建扩展描述的信息,请参阅 9.2.4 添加新扩展描述。在创建好温度描述后,MQTT 设备上报信息的例子如下所示:

      {
          "temperature": 27.5
      }
      

      请注意:在当前版本,平台接受 MQTT 设备的 JSON 格式的数据上报。

9.2.1 添加新自定义型号

授权用户可以添加新自定义型号以应用 MQTT 设备。点击右上角 + 按钮,New Model 窗口会弹出。

填写表格,然后点击 Save 按钮以添加新自定义型号。请注意:带 * 字段是必填项,其他为可选项。 用户还可以上传一张小于 500KB 的设备图片。

9.2.2 修改自定义型号

选择一个自定义型号,然后点击 Modify 按钮,Modify Model 窗口会弹出。

修改后,点击 Save 按钮以保存所有改动。

9.2.3 删除自定义型号

点击 Delete 按钮以删除自定义型号。请注意:您必须先清空该型号下的所有设备。

9.2.4 添加新扩展描述

点击左侧 Add 按钮,右侧会展示用以创建扩展描述的新空白表格。

将鼠标悬浮在 Information 图标上会显示字段项描述。填写这个表格并点击右侧 Add 按钮以创建新扩展描述。请注意:如有需要,可定制自定义单位。

如果用户需要一个布尔类型的描述,可通过设置其布尔值描述增加可读性。

保存描述后,该字段将显示在主设备列表中设备型号为 TMX08 的所有设备的“最新报告”选项卡的 “最新获取报告” 部分,如下所示:

请注意:只有在数据流功能中配置并计算了扩展描述的数据后,才会生成这些自定义字段的数据。 例子如下:

如果需要多个设备描述,可根据之前的说明添加更多的设备描述。

9.2.5 查看描述

我们提供多种操作帮助用户查看描述。

  • 搜索

    您可以输入字段名称或标题以搜索一个特定的设备描述。

  • 排序

    您可以通过拖拽 Drag 按钮以对设备描述进行排序,它将同样对 资产管理 - 主设备列表 - 最新报告 中的描述顺序和 资产管理 - 主设备列表 - 报告 中的字段顺序生效。

9.2.6 修改描述

点击您想要修改的特定描述卡片。修改后,点击 Save 按钮以保存改动。请注意:“字段名称” 以及 “类型” 无法被修改。如果存在任何未保存改动, Save 按钮会附带红点作为提醒。

9.2.7 启用描述

被启用描述的数据将会在平台侧进行显示,同时也可以通过 API 访问它。勾选 Enable 复选框然后点击 Save 按钮,被禁用的描述将被启用。进行该操作后,Eye 图标将亮起。

9.2.8 禁用描述

被禁用描述的数据将不在平台侧进行显示,并且也无法通过 API 访问它。导出的报告文件也会排除相关数据。取消勾选 Enable 复选框然后点击 Save 按钮,被启用的描述将被禁用。进行该操作后,Eye 图标将熄灭。

9.2.9 存储描述

可存储描述的数据将被授权用户允许在平台上进行存储。勾选 Store in database 复选框然后点击 Save 按钮,不可存储的描述将变为可存储。进行该操作后,Storage 图标将亮起。

9.2.10 停止存储描述

不可存储描述的数据将不会在平台上进行存储。取消勾选 Store in database 复选框然后点击 Save 按钮,可存储的描述将变为不可存储。进行该操作后,Storage 图标将熄灭。

9.2.11 删除扩展描述

点击 Delete 按钮以删除描述。请注意:系统描述无法被删除。对于扩展描述,如果它们处于正在使用中,例如该描述已在数据流中进行了配置,也可被删除,同时会被标记为“非法描述”。

9.2.12 添加新群组

选择设备型号 TMM01,进入 Group 选项卡,然后点击 + 按钮,New Group 窗口会弹出。

填写表格,然后点击 Save 按钮以创建新群组。

  • 关于“配置模板”字段:用户管理员可以为新群组分配特定的配置。有关更多信息,请参阅 ThingsMatrix 设备手册参数表 部分。

  • 关于“推送通知”字段:用户管理员可以明确推送通知的链接。

  • 关于“通知”字段:用户管理员可以选择期望推送通知的消息类别。

  • 关于“证书”字段:出于安全目的,用户管理员可以选择所需的认证证书。(仅适用于应用 MQTT 协议的特定型号)有关详细信息,请参阅 9.8资产-证书

9.2.13 编辑群组

点击 Modify 按钮,Modify Group 窗口会弹出。

修改群组后,点击 Save 按钮以保存对群组的改动。

9.2.14 删除群组

点击 Delete 按钮以删除群组。请注意:在删除一个设备群组前,您需要先清空该群组关联的设备。

9.2.15 添加新模板

选择一个设备型号,点击 Configuration Template 列表中的 + 按钮,New Configuration 窗口会弹出。

  • 缺省型号

    每个设备型号都有自己的配置参数设置。关于参数配置的更多信息,请参阅相应设备的 ThingsMatrix 设备手册参数表 部分。

    以设备型号 TMY07 为例,其配置包括以下类别:“Working Mode Option”,“Periodic Mode Settings”,“Storage Mode Settings”,“Motion Static Mode Settings”,“Schedule Mode Settings”,“Master Server Settings” 和 “Firmware” 。在每个参数类别中,将鼠标悬停在其中一个参数上,将显示说明。每个参数都有缺省值,用户可以根据需求修改该值。可添加描述增加可读性。配置完成后,点击 Save 按钮以创建新配置模板。

  • 自定义型号

    用户管理员可以上传一个 “JSON” 格式的配置文件以添加新模板。输入名称和必要的描述,然后点击 Save 按钮以创建新配置模板。

9.2.16 修改模板

点击 Modify 按钮,Modify Configuration 窗口会弹出。

  • 缺省型号

    修改参数值后,点击 Save 按钮以应用新改动。如果模板已经关联到设备群组,平台将主动下发新配置给相关群组的在线设备并应用;离线设备下次连接平台时下发新配置并应用。该改动将应用于相关群组中的所有主设备。

  • 自定义型号

    用户管理员可以上传一个 “JSON” 格式的配置文件以修改模板。点击 Save 按钮以创建新配置模板。

9.2.17 复制模板

点击 Copy 按钮,New Configuration 窗口会弹出。新的配置模板和用户选择的配置模板是完全一致的。为这个配置输入新的名称和描述,然后点击 Save 按钮以创建一个新的模板。您也可以在创建新模板的过程中对其中一些配置参数设置进行改动。

  • 缺省型号

  • 自定义型号

    新的配置模板和用户选择的配置模板是完全一致的。为这个配置输入新的名称和描述,然后点击 Save 按钮以创建一个新的模板。用户也可以通过上传一个新的 “JSON" 格式的配置文件,点击 Save 按钮以创建新模板。

9.2.18 删除模板

点击 Delete 按钮以删除模板。请注意:仅当未被任何群组应用时,模板可被删除。

  • 缺省型号

  • 自定义型号

9.3 主设备列表

在“主设备列表”部分中,授权用户可以获取设备的详细信息以及该设备收集的数据。平台提供上报数据的统计信息,所以用户能更好地了解数据趋势。当用户点击“主设备列表”,会显示一个包含所有已添加设备信息的窗口,如下所示:

从列表中,我们可以找到以下的基础信息:

  • 序列号:每个设备会有一个唯一的序列号用于识别。
  • 型号:设备型号名称。
  • 别名:设备别名。
  • 群组:设备所属的群组名称。
  • 状态:设备的不同工作状态如下所示:
    • 当设备刚被 ThingsMatrix 导入但尚未连接到平台时,它将显示为 “Inactive”。
    • 当设备连接到平台时,它将显示为 “Online”。
    • 当设备进入睡眠模式时,它将显示为 “Standby”。
    • 当设备一段时间不工作时(根据用户管理员的计时器设置),它将显示为 “Offline”。
    • 当设备被用户禁用时,它将显示为 “Disabled”。
    • 当设备的所属公司发生变化时,它将显示为 “Suspended”。
    • 当设备处于追踪模式时,它将显示为 “Tracking”。
  • State:平台有4种状态以指示设备属性:
    • 第一个图标像个电池,如果亮起,它表示设备的电池剩余电量;如果未亮,则表示平台未收到设备电池的电量数据。
    • 第二个图标像个插头,如果亮起,它表示设备正在接入外接电源;如果未亮,则表示平台未收到设备外接电源的数据。
    • 第三个图标像个手机信号塔或者卫星,表示定位功能。如果手机信号塔图标亮起,则表示设备正在发送 LBS 位置数据;而如果卫星图标亮起,则表示设备正在发送 GPS 位置数据。
    • 第四个图标像个警告,如果图标亮起,则设备正在向平台发送警报。
  • SIM 卡标示号:它显示设备中 SIM 卡的标示号。

除了基础信息,列表中也有上报的数据,所有的字段列是由描述决定的。请注意:禁用的描述字段以及其本身的值不会被显示。当设备报告新的有效的数据到平台,列表中最新数据会自动刷新,保括在线状态、模式状态和确认启用的描述值。

9.3.1 添加新自定义型号设备

在添加新自定义型号设备之前,您需要先创建一个群组。有关更多信息,请参阅 9.2.10 添加新群组 部分。请注意:仅自定义型号设备可通过此方式进行手动添加。所有已购缺省型号设备会由 ThingsMatrix 自动导入到平台上对应型号的缺省群组。比如,所有 TMX08 设备会被导入到 “TMX08_DG” 群组。

创建自定义型号组后,前往 资产 - 主设备列表 ,点击右上方的 + 按钮,New Device 窗口会弹出。

填写表格,然后点击 Submit 按钮以添加新设备。请注意:带 * 字段是必填项,其他为可选项。 对于 “SIM ICCID” 字段,用户可以选择提供或不提供相应的信息因为平台会自动收集此类信息。如果 Auto Update 勾选框被勾选,则允许该平台在最初填充信息后再做额外更新,例如更换 SIM 卡。否则,在最初填充信息后更换 SIM 卡,平台将拒绝与设备的连接。您还可以向设备分配别名、添加标签和创建自定义属性。

您可以看到新添加的设备。

9.3.2 导入新自定义型号设备

平台提供设备导入功能。点击 Import 按钮,Import 窗口会弹出。请注意:仅可以导入新的自定义型号设备。每次导入最多5000个设备。

通过选择 CSV or Excel 格式,对应的设备信息导入模板请求被下载。

下载设备信息导入模板后,用户管理员可以填写表格。

这些是模板中的字段:

  • SerialNumber,Group,Model 是必填字段:

    • SerialNumber:每个设备会有一个唯一的序列号用于识别。
    • Group:设备所属的群组名称。群组必须预先存在系统中,并且和型号有对应关系。否则,请先在系统中新建一个群组。
    • Model:设备型号名称。
  • 其余的是选填字段:

    • 别名:必须为1到30位字符,包括数字0到9,字母a到z和A到Z,中文字符,字符“_”和“-”。
    • SimICCID:必须为20位数字。
    • SensorSN:传感器序列号,必须是8到16位字符,包括数字0到9和字母A到Z。
    • SimAutoUpdate:“0”表示非自动更新,“1”表示自动更新。缺省是自动更新,空白即为缺省。
    • SensorAutoUpdate:“0”表示非自动更新,“1”表示自动更新。缺省是自动更新,空白即为缺省。
    • Description:必须为1到200位字符。
    • Tags:必须为1到15位的字符,包括数字0到9,字母a到z和A到Z,字符“-”、“.”、“_”、“@”、“$”和空格。单个设备的标签数量不能超过20个,并且用“,”以分开。
    • Attribute:属性是在表头填写的,例如“attribute:xx”,这意味着添加名称为 “xx” 的属性。必须为1到50位字符,包括数字0到9,字母a到z和A到Z,字符“-”、“.”、“_”、“@”、“$”和空格。
  • 示例:

    SerialNumber Alias Group Model Description Sim ICCID Tags Attribute.Address
    861901268000009 tmx07_0009 tmx07_20m TMX07 Device 1 San Antonio, Atlanta 9442 North Capital of Texas Hwy
    801046031113285 tmx08_3285 tmx08_2h TMX08 Device 2 San Antonio, Atlanta 9445 North Capital of Texas Hwy
    801046031097369 tmx08_7369 tmx08_1h TMX08 Device 3 San Antonio, Atlanta 9442 North Capital of Texas Hwy

然后点击 Browser 按钮以选择文件,点击 Import 按钮以上传文件和导入设备。如果在导入过程中出错,错误详情会在导入日志栏中显示。

9.3.3 导出设备

用户管理员可以通过单击右上方的 Export 按钮以导出设备。Export 窗口会弹出,然后用户管理员可以选择以 Excel 或 CSV 格式导出设备列表。

9.3.4 修改设备

选择一个设备,然后点击 Modify 按钮,Modify Device 窗口会弹出。请注意:被终止的设备无法被修改

完成设备修改后,点击 Submit 按钮以保存对设备的所有改动。

授权用户也可选择多个设备,然后点击 Modify 按钮,Batch Actions Device 窗口会弹出。

完成修改后,点击 Submit 按钮以保存对所选设备的所有改动。请注意:需要勾选 “Modify” 勾选框以应用对应的改动。

9.3.5 批量更新设备信息

若要批量更新设备信息,点击 Import 按钮,Import 窗口会弹出。

通过选择 CSV or Excel 格式,对应的设备信息导入模板请求被下载。

下载设备信息导入模板后,用户管理员可以填写表格。有关更多信息,请参考 9.3.2 导入新自定义型号设备

然后点击 Browser 按钮以选择文件,点击 Import 按钮以上传文件和批量更新设备信息。如果在更新过程中出错,错误详情会在导入日志栏中显示。

9.3.6 删除设备

选择一个设备,然后点击 Delete 按钮以删除设备。请注意:仅已禁用、未激活和已中止设备可以被移除。如果不小心删掉了缺省型号设备,但是还想加回来的,请联系 ThingsMatrix。关于自定义型号设备,授权用户可以根据 9.3.1 添加新自定义型号设备 的说明手动将其添加回来。

9.3.7 设备命令

选择其中一个设备,通过点击 Command 按钮,授权用户可以对设备下发命令,例如启用、禁用、重新启动和重置设备。某些设备型号会支持其他的一些操作,例如快照和追踪。然而,如果一个操作项是灰色的,表示该设备在当前状态不支持此操作。

以下所示列出可以进行的操作:

  • Enable/Disable 按钮可以帮助授权用户根据需求激活和禁用设备。
  • Restart 按钮允许授权用户远程重新启动在线的设备。
  • Reset 按钮可以帮助授权用户重置设备。
  • Snapshot 按钮可用于快照设备的位置信息。
  • Track 按钮允许授权用户在一段时间内追踪设备。

请注意:您也可以选择多个设备,然后点击 Command 按钮以批量对设备下发命令。

设备详情页面也可以操作命令。点击 Command 按钮并选择一个命令类型以执行。

  • 禁用设备

    被禁用的设备无法连接平台。点击 Disable 按钮,所选设备将被禁用,如下所示:

  • 启用设备

    只有被启用的设备才可以连接平台。点击 Enable 按钮,所选设备将被启用,如下所示:

  • 重新启动设备

    用户管理员可以通过单击 Restart 按钮以重新启动在线的设备。

  • 重置设备

    用户管理员可重置设备,请点击 Reset 按钮以重置设备。

  • 快照设备

    点击 Snapshot 按钮,然后点击 OK 按钮以快照设备。请注意:快照命令不会影响设备的任何工作计时器。

  • 追踪设备

    点击 Track 按钮, Tracking Setting 窗口会弹出。

    填写追踪时间间隔和到期时间,然后点击 OK 按钮以追踪设备。例如,授权用户希望在一小时内追踪设备,并要求设备每10秒报告一次位置信息。配置如下图所示:

    如果设备仍旧在线,它会将状态从 “Online” 转为 “tracking”。将鼠标悬浮到闹钟图标上方,会显示追踪配置。

    当追踪设备时,用户仍旧可以下发以下命令,比如重启、重置、停止追踪和禁用设备:

    请注意:追踪不会影响设备的任何工作计时器,但是会影响设备的工作时间,即延长设备的工作时间。 例如,设置设备为每小时唤醒一次报告数据。假设设备将在15:00:00唤醒,并且在30秒后它将进入睡眠状态。授权用户在15:00:10下发 “Tracking” 命令,将时间间隔设置为10秒,到期时间设置为150秒。然后,追踪操作会立即生效,设备将在接下来的150秒内每10秒报告一次数据。此后,由于设备的工作计时器原因,该设备将终止 “Track” 命令并保持工作20秒——正常情况下,设备每小时应该总共在线30秒。并且后续的报告间隔将与执行 “Track” 命令之前的间隔相同,不会发生变化。

9.3.8 查看设备详细信息

设备详细信息仅适用于授权用户。当授权用户选择其中一个已添加的设备时,页面的下半部分将显示更多详细信息:

  • 最新报告
  • 统计
  • 报告
  • 仪表盘
  • 事件
  • 警告

点击 Detail 按钮,将进入设备详情页。

  1. 最新报告 它向所有用户显示设备的序列号、别名、描述、SIM 卡标示号、传感器序列号、标签和属性。授权用户也可以在 最新接收报告 部分获取设备上报的最新数据,还可以查看设备的地理位置信息。*请注意:最新接收报告的描述的顺序可以在 资产管理 - 设备管理 - 描述 进行管理。如果设备上报了新的数据,此部分的数据将会自动刷新。

  2. 统计 授权用户可以通过配置时间范围、数据变量和颗粒度以获得详细的数据统计信息。右边的地图上显示记录的设备移动路径。通过选择一个想要的数据变量,例如 “Signal Strength",地图上将展示历史数据。您可以在“所有”、“LBS” 和 “GPS” 之间进行切换以过滤不同定位模式上报的数据。历史数据图表在设备把新的数据上报到平台后将自动刷新。

  3. 报告

    授权用户可以查看设备报告记录。点击 Export 按钮以导出过滤后的报告记录。请注意:字段的顺序可以在 资产管理 - 设备管理 - 描述 进行管理。

  4. 仪表盘

    授权用户可以查看在仪表盘功能中已配置并在设置中已启用仪表盘的所有图表。有关更多信息,请参阅 10.2 仪表盘12 设置 部分。

  5. 事件

    授权用户可以查看设备事件记录。通过点击右侧 Chart View 按钮,设备事件的图表展示将会显示。

    顶部的滚动栏可以帮助您明确时间范围。点击右侧 Table View 按钮以返回表格展示。

  6. 警告

    授权用户可以查看设备警告记录。

9.3.9 自定义主设备列表表头

点击 Modify Column 按钮,Column Edit 窗口会弹出。

您可以选择想要显示或者隐藏的列。通过点击 Left/Right 按钮以移动字段到显示列部分或隐藏列部分。

您还可以通过点击 Up/Down 按钮以自定义显示列的顺序。

完成自定义表头后,点击 Save 按钮使其生效。

9.4 主设备报告列表

在主设备报告列表部分,授权用户可以获取详细的报告记录。

9.4.1 查看报告记录

以 TMY10 为例,选择 TMY10 设备型号。

TMY10 设备的所有报告记录将被展示。授权用户可以通过明确设备序列号、选择时间范围和设备群组以过滤记录。*请注意:字段的顺序可以在 资产管理 - 设备管理 - 描述 进行管理。

9.4.2 导出报告记录

授权用户可以通过点击右上方的 Export 按钮以导出报告记录。Export 窗口会弹出,然后您可以选择以 Excel 或 CSV 格式导出报告记录。

9.5 主设备事件列表

在主设备事件列表部分,授权用户可以获取详细的事件记录。

9.5.1 查看事件记录

所有的事件记录都将被展示。授权用户可以通过明确设备序列号以及选择时间范围、型号名称、群组名称和事件代号以过滤记录。

通过点击右侧 Chart View 按钮,设备事件的图表展示将会显示。

顶部的滚动栏可以帮助您明确时间范围。点击右侧 Table View 按钮以返回表格展示。

9.5.2 导出事件记录

授权用户可以通过点击右上方的 Export 按钮以导出事件记录。Export 窗口会弹出,然后您可以选择以 Excel 或 CSV 格式导出事件记录。

9.6 主设备警告列表

在主设备警告列表部分,授权用户可以获取详细的警告记录。

9.6.1 查看警告记录

所有的警告记录都将被展示。授权用户可以通过明确设备序列号、警告种类以及选择时间范围、型号名称、群组名称、严重程度、警告代号和警告状态以过滤警告。

9.6.2 导出警告记录

授权用户可以通过点击右上方的 Export 按钮以导出警告记录。Export 窗口会弹出,然后您可以选择以 Excel 或 CSV 格式导出警告记录。

9.7 主设备命令中心

平台为设备命令管理提供了命令中心。授权用户可以看到命令记录,如下所示:

9.7.1 添加新命令

点击右上方的 + 按钮, Create a Command 窗口会弹出。

若要创建一个新命令,需要完成三个步骤。

  • 第一步:命令和设备

    输入命令别名,添加描述并且选择需要执行命令的设备。授权用户可以通过输入设备序列号、别名、SIM ICCID、属性或描述以搜索设备。授权用户还可以通过型号名称、群组名称和设备状态过滤出特定的设备。

    如果需要反选一个已选设备,点击设备右上方的 Delete 按钮以将其从已选设备列表移除。

    通过点击 Clear All 按钮,已选设备列表将被清空。

    填写完第一步的表格后,点击 Next 按钮以进入第二步。

  • 第二步:配置

    授权用户可以通过已选设备列表确认设备选择是否正确。确认过后,授权用户必须选择通用命令中的其中一个命令。仅能选择一种命令。将鼠标悬浮在命令类型右上方的 Information 图标上,会显示命令描述。让我们选择 “restart” 举例,如下所示:

    在完成选择后,点击 Next 按钮以进入第三步。

  • 第三步:参数和执行

    填写表格,然后点击 Submit 按钮以添加新命令。请注意:带 * 字段是必填项,其他为可选项。 关于执行策略,授权用户可以选择多个状态、信号强度范围和电池条件以决定需要执行该命令的设备。可直接或按期执行命令。关于重试策略,可以配置超时时长、重试次数和重试间隔。请注意:重试时长的值指的是单个设备执行命令的超时时长。换言之,如果命令执行超过超时时长,该命令会被标记为 “failed”。所有的重试都在超时时长期间内处理。

9.7.2 收藏命令

通过点击 Favorite 按钮,特定的命令会被收藏,也就是说,它会显示在命令列表最顶部。授权用户可以通过收藏名令以快速找到它。

9.7.3 取消收藏命令

通过点击 Cancel Favorite 按钮,特定的命令会被移出收藏列表。

9.7.4 查看命令

授权用户可以通过输入设备序列号、设备别名或命令别名以查找命令。您也可以通过选择一个特定时间以过滤命令,过滤结果会显示一个命令列表,这个特定时间都在它们的起始时间和结束时间之间。平台还提供了命令状态过滤功能。将 Favorite 图标打勾,过滤结果会显示已收藏的命令列表。

选择一个特定命令,它的详情会在底部部分显示,如下所示:

进入 Device 选项卡以查看详细的设备命令执行情况。

9.7.5 复制命令

点击 **Copy**按钮,Copy a Command 窗口会弹出。按照 9.7.1 添加新命令 的说明以复制命令,在提交前,您还可以根据需求做些修改以创建符合要求的命令。

9.7.6 重试命令

选择一个命令,然后点击 Retry 按钮以重试特定命令的执行。

若要重试一个特定设备的命令,授权用户可以选择一个命令,进入 Device 选项卡,选择想要重试命令的设备然后点击 Retry 按钮。

9.7.7 取消命令

选择一个命令,然后点击 Cancel 按钮以取消特定命令的执行。

若要取消一个特定设备的命令,授权用户可以选择一个命令,进入 Device 选项卡,选择想要取消命令的设备然后点击 Cancel 按钮。

9.7.8 导出命令

选择一个命令,进入 Device 选项卡,然后点击 Export 按钮以导出特定的命令记录。

Export 窗口会弹出,您可以选择以 Excel 或 CSV 格式导出命令记录。

9.8 证书管理

证书管理用于统一管理各个网络组件所需的 TLS 证书,平台支持的证书格式为 PEM。授权用户可以配置证书以及服务器信任库,用于设备与平台之间建立安全链接。服务器证书请点击 此处 下载。

9.8.1 添加新证书

点击 + Add 按钮,Add CA Certificate 窗口将会弹出。

将鼠标悬浮在 Information 图标上会显示字段项描述。填写完表格后,点击 Add 按钮以添加新 CA 证书。

  • 关于“注册码”字段:授权用户可以复制该字段值以生成验证证书。

  • 关于 “CA 证书”字段:授权用户可以上传一个私有的 CA 证书。

  • 关于“验证证书”字段:授权用户可以上传一个使用 CA 证书对应的私钥创建的验证证书,用来证明您拥有该 CA 证书。

    • 验证证书文件仅支持.cer, .crt.pem 格式。

    • 下面以使用 OpenSSL 为例,介绍创建验证证书的操作步骤:

      1. 生成私钥验证证书的密钥对。

        生成密钥对的命令如下:

        openssl genrsa -out verificationCert.key 2048
        
      2. 使用上方的“注册码”字段值创建 CSR。

        创建 CSR 的命令如下:

         openssl req -new -key verificationCert.key -out verificationCert.csr
        

        复制上方的“注册码”字段值,并粘贴为下方 Common Name 字段值。

        ……
        Common Name (e.g. server FQDN or YOUR name) []: c7cdfde6775c4b408b69d7e3c865f21bafe67937dc9a483ebbf7e6997b7b****
        ……
        
      3. 使用由 CA 证书私钥签名的 CSR 创建验证证书。

        创建验证证书的命令如下:

        openssl x509 -req -in verificationCert.csr -CA yourCA.cer -CAkey yourPrivateKey.key -CAcreateserial -out verificationCert.crt -days 300 -sha512
        

9.8.2 Viewing CA certificates

授权用户可以通过明确 CA 证书名称与描述、或选择 CA 证书状态以过滤 CA 根证书。

9.8.3 下载 CA 根证书

点击 Download 按钮,授权用户可以下载 CA 根证书。

9.8.4 删除 CA 根证书

点击 Delete 按钮,授权用户可以删除 CA 根证书。请注意:已被设备证书关联的 CA 根证书无法被删除。

9.8.5 添加新设备证书

点击 + Add 按钮,Add Device Certificate 窗口将会弹出。

将鼠标悬浮在 Information 图标上会显示字段项描述。填写完表格后,点击 Add 按钮以添加新设备证书。

  • 关于“设备证书”字段:授权用户可以上传一个设备证书。
  • 关于 “CA 证书”字段:授权用户可以选择一个已有的 CA 证书进行关联。

9.8.6 查看设备证书

授权用户可以通过明确设备证书名称、设备证书序列号、所关联的 CA 证书以及设备证书描述,或选择设备证书状态以过滤设备证书。

9.8.7 下载设备证书

点击 Download 按钮,授权用户可以下载设备证书。

9.8.8 删除设备证书

点击 Delete 按钮,授权用户可以删除设备证书。请注意:仅当未被任何群组应用时,设备证书可被删除。

10 数据管理服务

10.1 功能描述

平台具有分析一些遥测数据并向授权用户提供一些有用信息的能力。一旦用户管理员启用了数据存储服务,授权用户就可以查看历史数据和统计数据。有关更多信息,请参阅 9.3.8 查看设备详细信息。在当前版本中,平台提供了用于自定义数据可视化的仪表盘功能、用于数据配置的数据流和公式功能、和用于数据存储的数据集合功能。我们还提供了策略功能,用于进一步的数据监视和安全目的。

10.2 仪表盘

平台通过仪表盘提供数据可视化和可视数据的自主配置,以帮助用户监视和分析数据。在仪表盘中,用户可以根据实际需求配置图表,以监视单个设备的实时数据或历史数据更改轨迹。用户还可以配置统计图以统计公司中设备的总数及其状态分布。配置图表时,用户还可以配置图表显示的时间段并选择刷新间隔以定义其频率。

10.2.1 添加新仪表盘

在添加新图表之前,在添加新图表之前,您需要创建一个新的仪表盘。点击右上角 + Add 按钮,New Dashboard 窗口将弹出。输入仪表盘名称,然后点击 Submit 按钮以创建新的仪表盘。

10.2.2 查看仪表盘

点击仪表盘卡片以查看仪表盘详情。

可以在仪表盘中设置几个快速配置,如下所示。请注意:此处的配置修改并不会保存配置到图表中,它仅仅作为图表的快速配置。

  • 图例主题:

    选择图表的主题。

  • 时间范围:

    选择数据收集的时间范围。

  • 刷新间隔:

    设置图表刷新频率。

  • 群组名称栏:

    快速生成特定群组设备数据的图表。配置新的群组后,无论它们之前是由哪个群组配置的,仪表盘中的所有图表都将由特定的群组进行配置。

  • 序列号栏:

    快速生成特定序列号设备数据的图表。配置新的序列号后,无论它们之前是由哪个序列号配置的,仪表盘中的所有图表都将由特定的序列号进行配置。

  • 数据集合名称栏:

    快速生成特定数据集合设备数据的图表。配置新的数据集合后,无论它们之前是由哪个数据集合配置的,仪表盘中的所有图表都将由特定的数据集合进行配置。

  • 字段名称栏:

    快速生成特定字段的图表。配置新字段后,无论之前是由哪个字段配置的。仪表盘中的所有图表都将由特定字段配置。

平台提供特定仪表盘的全屏视图。点击 More 按钮,然后点击 Full Screen 按钮以进入全屏视图页面。

例子如下所示:

10.2.3 修改仪表盘

点击 Settings 按钮,用户管理员可以进入仪表盘设置页。在此页,用户管理员可以重命名仪表盘,并且可以决定在仪表盘详情页显示哪些快速配置。

关于 General 部分的 Hide Field,如果它处于开启状态,仪表盘详情页的快速配置部分将不会显示。

关于 Variables 部分的 Group、Serial Number、Bucket以及Field,“Query” 类表示您可以进行模糊查询,并且所有的选项都不可自定义;“Custom” 类表示用户管理员可以自定义选项;“Text box” 允许用户输入任意值,此处可预先设置默认值。

完成配置后,点击 < 按钮以回到仪表盘详情页。

然后点击 Save Dashboard 按钮以保存改动。请注意:如果存在任何未保存改动, Save Dashboard 按钮会附带红点作为提醒。

10.2.4 插入新面板

在仪表盘详情页,通过点击 Add Panel 按钮,所有受支持的面板类型将显示,包括折线图、计量盘、表格、饼图、统计以及地图。

让我们以折线图为例。点击 Graph 按钮,即会创建一个空的折线图。

10.2.5 修改面板

点击面板右上方的 ... 按钮,然后点击 Edit 按钮以进入面板详情页面。

此页面有几个选项卡显示相关信息,如下所示:

  • 数据

    数据源配置。

    请依据以下步骤以配置特定的数据源:

    1. 选择一种数据源类型,例如,“Device Telemetry Data”。

    2. 输入特定设备的序列号。考虑到便捷性,您可以输入至少3个字符以模糊查询。

    3. 选择一个想要的数据字段,例如 “Signal Strength”。

    点击 + Add Data 按钮以添加更多的数据源。

    点击 Copy 按钮,将特定数据源的复制配置生成,用户可以进行编辑。

您也可以点击 Hide 以隐藏特定数据源。请注意: 隐藏的数据将不会在面板详情页面以及面板视图页面显示。

点击 Delete 按钮以删除数据源。请注意:如果仅存在一个数据源,它不能被删除。

  • 可视化

    图表可视化配置。可以自定义数据显示、坐标轴以及图例。

  • 通用

    通用设置,包括面板名称、数据范围以及刷新频率。

完成所有设置后,请点击 < 按钮以返回仪表盘详情页面,然后点击 Save Dashboard 按钮以保存所有改动。请注意:如果存在任何未保存改动, Save Dashboard 按钮会附带红点作为提醒。

为了更舒服的可视化体验,可以通过拖拽面板的边界以修改它的尺寸。

通过拖拽,面板也可以进行位置修改。在面板上空白处悬停鼠标,当光标显示拖拽图标时,用户可以重新安排面板位置。

10.2.6 查看面板

点击面板右上方的 ... 按钮,然后点击 View 按钮,它将进入面板视图页面。

在仪表盘详情页,用户可以点击特定面板右上方的 ... 按钮,然后点击 Refresh 按钮以立即刷新数据。

10.2.7 导入面板

点击 More 按钮,然后点击 Import 按钮以导入面板。

点击 Browser 按钮以上传 JSON 格式文件,然后点击 Import 按钮以导入面板。

10.2.8 导出面板

点击 More 按钮,然后点击 Export 按钮以导出面板。

10.2.9 删除面板

点击面板右上方的 ... 按钮,然后点击 Delete 按钮以删除面板。

10.2.10 复制仪表盘

在仪表盘卡片页面,点击仪表盘卡片右上方的 ... 按钮,然后点击 Copy 按钮,将创建原始仪表盘的新副本。

10.2.11 删除仪表盘

点击仪表盘卡片右上方的 ... 按钮,然后点击 Delete 按钮以删除仪表盘。请注意:仪表盘仅当在 Settings 中没有被配置时可被删除。

10.3 数据流

平台提供了一个基于浏览器的编辑器,可轻松创建计算流以基于设备报告的数据获得所需数据。不同型号的数据流之间是独立的。

10.3.1 添加新数据流

选择一个型号,例如 TMX07,点击 + Add 按钮,New Flow 块会出现。输入数据流名称,然后点击 Save 按钮以创建新数据流。

10.3.2 重命名数据流

点击 Modify 按钮,授权用户可以重命名数据流。

10.3.3 配置数据流组件

可以按如下所示以配置数据流的几个组件:

点击数据流块进入数据流详情页。

  • 过滤器:选择输入数据。

    通过点击 Filter 部分的 Edit 按钮,授权用户可以选择特定设备群组的数据作为数据流输入。请注意:缺省情况下,所有设备的数据都会进入数据流。

    完成配置后,点击 Save 以保存所有改动。

  • 转换器:配置数据流使用的公式。

    通过点击 Transformer 部分的 Edit 按钮,授权用户可以选择该数据流所应用的特定公式。请注意:缺省情况下,数据流不应用任何公式。

    左侧有一个公式库,右侧有一个转换器中应用的公式列表。点击 Right 按钮,您可以从库中选择要在转换器中使用的公式。请注意:您必须先在 数据 - 公式 中配置公式,然后才能从库中选择公式。公式库提供了一些预置公式供您使用。 要从转换器中删除公式,请选择公式,然后点击 Left 按钮。您也可以在搜索栏中搜索公式。点击 Up/Down 按钮以修改执行公式的顺序。编辑转换器后,点击 Submit 按钮以保存设置。有关更多信息,请参阅 10.4 公式 部分。一个选择 “Ultrasonic Tmperature Compensator” 公式和 “temp_minus” 公式的例子如下所示:

  • 操作:决定经数据流处理后数据的操作。

    通过点击 Action 部分的 Edit 按钮,授权用户可以选择该数据流所应用的特定操作。请注意:缺省情况下,数据流不应用任何操作。

    点击 + Add 按钮,New Action 块会出现。选择一个操作类型然后为其输入名称。然后点击 Add Condition 按钮以配置想要的触发条件。在右上方选择 “Match Any” 或 “Match All” 以配置条件判断方式。

    添加必要条件的例子如下所示:

    • 警告:向警告列表生成警告记录。有关更多信息,请参阅 9.6 主设备警告列表

      输入警告的名称、严重程度和描述,然后点击 Save 按钮以保存所有改动。

    • 事件:向事件列表生成事件记录。有关更多信息,请参阅 9.5 主设备事件列表

      输入事件的名称和描述,然后点击 Save 按钮以保存所有改动。

    • 数据集合:将处理后数据存储到特定数据集合中。有关更多信息,请参阅 10.5 数据集合

      点击 + Add 按钮以在数据集合字段与数据流结果字段映射列表中添加一条配置。以 数据集合中 “speed” 字段为例,如下所示:

      然后点击 Save 按钮以保存所有改动。

    • 短信:向一个特定手机号码发送一条短信消息。

      输入短信消息的收信方电话号码和描述,然后点击 Save 按钮以保存所有改动。目标用户会接收到一条短信,包括可以登录平台以查看短信内容的网址。

    • 网址:向一个特定网址发送处理后数据。

      输入网址,然后点击 Save 按钮以保存所有改动。

    • 电子邮件:向(多个)特定电子邮件地址发送处理后数据。

      输入有效的电子邮件地址,然后点击 Save 按钮以保存所有改动。 请注意:通过按 Enter 键以应用一个电子邮件地址。仅应用的电子邮件地址能收到该邮件。若电子邮箱地址的字体颜色为红色,这表示它是非法的。

    • 命令:向过滤器中的设备下发控制命令。

      选择一个命令类型,然后点击 Save 按钮以保存所有改动。请注意:若参数是必填的,请填写参数。

  • 调试:显示调试消息。

    关于 Debug 开关,如果它处于开启的状态,最新的数据流处理日志会显示。

    点击 Refresh 按钮以刷新日志。

10.3.4 插入数据流

点击左侧的 + 按钮以插入新数据流。输入数据流名称,然后点击 Save 按钮,将插入新的数据流。

10.3.5 开启数据流

当数据流开启时,它将在每次数据输入时进行计算。要启动数据流,您只需将 Flow 开关拨到 “Run” 位。请注意:开启的数据流无法被修改。然而,调试开关是仍然可用的。

您还可以通过点击 Open All 按钮以批量开启所有数据流。

10.3.6 关闭数据流

当数据流关闭时,它会停止计算。要关闭开启的数据流,您只需将 Flow 开关拨到 “Stop” 位。请注意:如果想要修改数据流,您需要先将其关闭。

您还可以通过点击 Close All 按钮以批量关闭所有的数据流。

10.3.7 导入数据流

点击 ... 按钮,然后点击 Import 按钮,Import Flow 窗口会弹出。

您就可以在当前数据流的上方(选择 “Import Above”)或者下方(选择 “Import Below”)批量导入新的数据流。

点击 Browser 按钮以选择 JSON 文件,然后点击 Import 按钮以导入数据流。

10.3.8 导出数据流

点击 ... 按钮,然后点击 Export 按钮,将会请求下载一个包含当前数据流信息的 JSON 文件。

您还可以通过点击 Export All 按钮以批量导出所有的数据流。将会请求下载一个包含所有数据流信息的 JSON 文件。

10.3.9 替换所有数据流

要导入新的数据流并全量替换所有原有的数据流,只需点击 Replace All 按钮。Import Flow 窗口会弹出。

点击 Browser 按钮以选择 JSON 文件,然后点击 Import 按钮以全量替换数据流。

10.3.10 删除数据流

点击 ... 按钮,然后点击 Delete 按钮以删除数据流。请注意:只有关闭的数据流才能被删除。

10.4 公式

公式是数据流的一个用于计算数据组件。平台在公式库中预置了一些公式,如下所示。

正在运行的数据流应用的公式会显示 “In use”,并且相关数量会显示在右上角。例如,仅 “Ultrasonic Temperature Compensator”、“Temperature(C to F convertor)” 和 “temp_minus” 这三个公式正在被使用,如下所示。

10.4.1 添加新公式

点击 + Add 按钮,New Function 窗口会弹出。

授权用户可以输入公式的标题、填写描述并完成一些代码编写。右侧有参考说明,平台提供了语法解释器,以帮助授权用户编写代码。代码编辑模块内,编程语言是 JavaScript。请注意:您无需编写 return 语句。时间戳的单位是毫秒(13位数),并且合法的时间字符串格式是 “yyyy-MM-dd HH:mm:ss.SSS”。 填写完表格和代码模块后,点击 Submit 按钮以创建新公式。温度补偿公式的一个例子如下所示:

10.4.2 修改公式

点击公式卡片或 Detail 按钮以编辑公式。

修改完成后,点击 Update 按钮以保存所有改动。请注意:使用中的公式和预置的公式无法被编辑。

10.4.3 复制公式

点击 Copy 按钮,Copy Function 窗口会弹出。根据需求修改完成后,点击 Submit 按钮以保存改动。

10.4.4 删除公式

点击 Delete 按钮以删除公式。请注意:使用中的公式和预置的公式无法被删除。

10.5 数据集合

数据集合在数据存储上应用了存储策略,并统一了数据格式以简化处理。它结合了通道和策略的功能,与数据转换器一起提供了一种更好地方法以定义数据流。

10.5.1 添加新数据集合

点击 + 按钮,New Bucket 窗口会弹出。

填写表格,然后点击 Submit 按钮以创建新数据集合。

  • 关于 “存储时间” 字段,您可以定义数据收集的时间范围。例如,如果选择保留 “60天”,则数据集合将存储生成的数据达60天。
  • 关于“数据分享” 字段,您可以选择特定用户共享数据。他们将有权查看该组中的所有数据。用户管理员和已经拥有所有权限的用户自动拥有访问所有数据的权限。

10.5.2 编辑数据集合

选择您要编辑的数据集合,点击 Modify 按钮,Edit Bucket 窗口会弹出。

修改数据集合完成后,点击 Submit 按钮以保存改动。请注意:“存储时间” 字段无法被修改。

10.5.3 添加新数据集合字段

选择一个数据集合,然后进入数据集合字段选项卡。平台提供了一个预置的数据集合字段 “time”,用以记录数据生成的时间。点击 Add 按钮和 OK 按钮以添加新的数据集合字段。您可以输入字段名称、字段标题、字段值类型、字段值单位。您还可以根据需求输入字段值的最大值或最小值,以及字段的描述。如果要创建多个字段,点击 Add 按钮以添加更多字段。所有添加的字段将在下面的字段列表中列出。

10.5.4 删除数据集合字段

点击 Delete 按钮以删除一个特定的数据集合字段。请注意:使用中的数据集合字段和预置的数据集合字段无法被删除。

10.5.5 查看数据集合

它包括三个选项卡,如下所示:

  • 数据集合字段

    它显示了数据集合的数据描述。

  • 仪表盘

    它显示了在仪表盘功能中已配置并在设置中已启用仪表盘的关于该数据集合的所有图表。有关更多信息,请参阅 10.2 仪表盘12 设置 部分。

  • 数据集合数据

    它显示了数据集合中配置和存储的所有数据。授权用户可以通过明确设备序列号和选择时间范围以过滤数据。

    您还可以通过点击右侧 Export 按钮以导出数据。Export 窗口会弹出,然后您可以选择以 Excel 或 CSV 格式导出集合记录。

10.5.6 删除数据集合

选择要删除的数据集合,点击 Delete 按钮以删除数据集合。请注意:使用中的数据集合无法被删除。

11 API 编程接口服务

平台为外部用户和系统提供北向 API 编程接口服务。有关详细的技术信息,请参阅 ThingsMatrix 服务平台编程接口指南

12 设置

用户可以通过设置选择合适的语言、时区、数据统计单位和地图显示类型。您还可以在仪表盘设置中启用/禁用仪表盘显示。您可以选择将特定的仪表盘显示在 资产 - 主设备列表资产 - 设备管理数据 - 数据集合 部分。点击 Restore default 按钮以返回初始状态。用户管理员可以为公司中的其他用户预先设置通用的公司设置模板。如果有需求,其他用户可以具有自己的个人常规设置。

点击 Save 按钮以保存所有改动。

通过点击仪表盘名称,您可以直接去到仪表盘详情页。

点击 Restore default 按钮以恢复初始状态。

用户管理员可以预置通用的公司设置。如果需要,其他用户可以配置个人的通用设置。

  • 用户管理员
  1. 个人账户设置

  2. 公司设置

  • 其他用户

    仅可以进行通用设置

13 操作日志

用户管理员可以查看公司成员执行操作的操作日志。将鼠标悬停在右上角的头像图标,然后点击 Operation Log 按钮查看日志。

14 公告板

平台提供公告板以展示通知和消息,例如,服务升级计划和超频或超限SMS、URL、email警告。。查看右上角的 Ring 按钮,您可以看到旁边有一个数字,该数字是表示未确认消息条数。如下所示,有一条未读消息:

也可能 Ring 按钮旁边只有一个红点,表示公告板存在数条无需确认的未读消息。

点击 Ring 按钮,Notification Board 会弹出,它显示所有的通知和消息。您可以通过选择一个想要的公告类型以过滤消息。

点击未读消息以阅读详细内容。请注意:带红点的消息表示未读。

点击 Confirm 按钮以确认接收消息。

Last updated: 2021/4/30 上午9:52:12