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

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)

5 服务启动

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

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

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

6 登录

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

用户成功登录后,主页将显示功能和设备详细信息地图,如下所示:

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 窗口会弹出,然后用户管理员可以将任何用户级别的账户添加到用户列表中。

7.2.2 管理用户

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

  • 修改用户

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

  • 禁用用户

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

  • 启用用户

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

  • 重设密码

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

  • 删除用户

    如果用户管理要删除用户,他需要先使用先前提供的说明来禁用该选定用户。在用户被禁用以后,点击 Delete 按钮, Delete User 警告会弹出。 点击 OK 按钮后,所选用户的账户将从平台中删除。

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 添加新子部门

用户管理员可以点击 Add Sub-department 按钮来创建子部门。 Add Sub-department 窗口会弹出,然后用户管理员可以为其输入名称来创建新的子部门。

7.3.2 重命名子部门

如果用户管理员想重命名子部门,他可以点击 Rename 按钮。 Rename 窗口会弹出,供用户管理员为子部门输入新名称。

7.3.3 删除子部门

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

7.4 定义团队

为了提高灵活性,用户管理员可以为来自不同部门的用户定义团队。

7.4.1 添加新团队

点击 + New 按钮,用户管理员可以通过输入团队名称并定义该团队的用户列表来添加新团队。

7.4.2 修改团队

如果用户管理员想修改团队,他可以点击 Modify 按钮来编辑团队名称和重新安排团队成员。

7.4.3 删除团队

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

7.5 角色管理

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

  • 公司管理员
  • 普通用户

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

7.5.1 添加新角色

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

7.5.2 管理角色

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

  • 修改角色

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

  • 删除角色

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

8 连接管理服务

8.1 功能描述

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

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

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

请参阅上方 7.2.2.1 查看 SIM 卡使用情况摘要 部分。

8.3.2 添加新 SIM 卡

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

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

8.3.3 导入新 SIM 卡

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

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

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

8.3.4 导出 SIM 卡列表

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

9 资产管理服务

9.1 功能描述

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

  • 设备管理
  • 主设备列表

9.2 设备管理

在设备管理部分中,设备型号由 ThingsMatrix 预先配置,因此用户无法添加或删除设备型号。

  • 配置模板

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

  • 群组

设备群组是一个逻辑组件,其中包括一组相同型号的设备。授权用户可以管理设备的某些共同属性。

9.2.1 添加新群组

选择其中一个设备型号,然后点击 + New Group 按钮,New Group 窗口会弹出。

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

  • 关于配置模板:用户管理员可以为新群组分配特定的配置。有关更多信息,请参阅 ThingsMatrix 设备手册参数表 部分。
  • 关于策略:用户可以为设备设置平台策略,以激活特殊功能,从而为用户带来更大的价值。这是一个可选项,关于平台策略的更多信息,请参阅 10.4.2 平台策略 部分。
  • 关于通道:用户管理员可以选择任何想要查看的数据放在白名单中,选择任何他不想查看的数据放在黑名单中,来控制数据消费。这也是一个可选项,关于通道的更多信息,请参阅 10.5 通道 部分。
  • 关于共享数据:您可以选择特定用户共享数据。他们将有权查看该设备群组中的设备的所有数据。用户管理员和已拥有所有权限的用户自动拥有访问所有数据的权限。

9.2.2 编辑群组

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

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

9.2.3 删除群组

点击 Delete 按钮,Delete Group 警告会弹出,然后点击 OK 按钮以删除群组。请注意:在删除一个设备群组前,您需要先清空该群组关联的设备。

9.2.4 添加新模板

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

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

以设备型号 TMY07为例,其配置包括以下类别:”refresh_timer“,”work_settings“,”firmware“,”net_settings“ 和 ”device_area“ 。在每个参数类别中,将鼠标悬停在其中一个参数上,将显示说明。每个参数都有缺省值,用户可以根据需求修改该值。

9.2.5 修改模板

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

修改参数值后,点击 Save 按钮来应用新的改动。如果模板已经被群组所应用,当它再次连接平台时最新的配置才会下发给设备并生效。

9.2.6 复制模板

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

9.2.7 删除模板

点击 Delete 按钮,然后 Delete Template 警告会弹出。

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

9.2.8 添加新设备

设备群组创建并且应用了必需的配置模板后,新设备添加准备就绪。

选择一个设备群组,然后点击右侧的 + 按钮。

New Device 窗口会弹出。填写表格,然后点击 Submit 按钮以添加设备。

点击群组您会看到新添加的设备。下一步是插入 SIM 卡到设备中并开启设备电源。

设备接着会自动连接上平台。点击 Refresh 按钮来刷新页面读取设备最新状态。设备已被成功添加,如下所示。

9.2.9 管理设备

选择设备,然后点击 Actions 按钮,授权用户可以修改、启用/禁用、重新启动、重置和删除设备。有关更多信息,请参阅 9.3.4 设备操作 部分。

9.3 主设备列表

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

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

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

9.3.1 添加新设备

在添加新设备之前,您需要先创建一个群组。有关更多信息,请参阅 9.2.1 添加新群组 部分。有关如何添加一个 ThingsMatrix 许可设备的完整信息,请参阅 ThingsMatrix 服务平台快速开始指南

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

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

下一步是插入 SIM 卡和开启设备电源,设备将会自动连接到平台。当设备状态显示为 “Online”,它表示设备已成功连接到平台。有关设备安装的更多信息,请参阅相应设备的 ThingsMatrix 设备手册 中的 安装说明 部分。

9.3.2 导入新设备

平台提供设备导入功能。点击 Import 按钮,Import 窗口会弹出。

通过选择 CSV or Excel 格式,对应的模板请求被下载。

下载模板后,用户管理员可以填写表格。

这些是模板中的字段:

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

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

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

SerialNumber Group Model Description Sim ICCID SensorSN Tags Attribute.Address
861901268000009 TMX07_GM TMX07 60s 89860437111890028017 661808008000092 San Antonio, Atlanta 9442 North Capital of Texas Hwy
801046031116490 tmx08_1123 TMX08 70s 89860782111730537722 661808008000093 San Antonio, Atlanta 9445 North Capital of Texas Hwy
801046031094416 tmx08_1125 TMX08 50s 89011703278173974331 661808008000094 San Antonio, Atlanta 9442 North Capital of Texas Hwy

点击 Browser 按钮来选择文件,然后点击 Import 按钮来上传文件和导入设备。

9.3.3 导出设备

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

9.3.4 设备操作

选择其中一个设备,点击 Actions 按钮,将显示可用操作列表。 然而,如果一个操作项是灰色的,表示该设备当前不支持此操作。

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

  • Modify 按钮可用于编辑设备信息。
  • Enable/Disable 按钮可以帮助授权用户根据需求激活和禁用设备。
  • Restart 按钮允许授权用户远程重新启动设备。
  • Reset 按钮可以帮助授权用户重置设备。
  • Delete 按钮可用于从主设备列表中删除设备。

请注意,您也可以选择多个设备,然后点击 Batch Actions 按钮以批量执行类似的操作。

  • 修改设备

    单击 Modify 按钮,Edit Device 窗口会弹出,如下所示。用户管理员可以进行基本设备信息的编辑。编辑完成后,请点击 Submit 按钮以应用这些更改。

  • 禁用设备

    点击 Disable 按钮,然后点击 OK 按钮。所选设备将被禁用,如下所示:

  • 启用设备

    点击 Enable 按钮,然后点击 OK 按钮。所选设备将被启用,如下所示:

  • 重新启动设备

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

  • 重置设备

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

  • 删除

    请注意:您需要先禁用设备,然后才能将其删除。 点击 Delete 按钮,然后点击 OK 按钮以从主设备列表中删除设备。

9.3.5 查看设备详细信息

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

  • 信息
  • 状态
  • 统计
  • Path
  • 事件
  • 告警
  1. 信息 向所有用户显示设备的描述、SIM 卡标示号、传感器序列号、标签和属性。

  2. 状态 授权用户可以查询设备详细信息,例如设备信息、设备数据、网络信息、其他数据以及设备在地图上的位置。

  3. 统计 授权用户可以通过配置时间范围、数据变量和颗粒度以获得详细的数据统计信息。

  4. Path 授权用户可以找到设备路径记录。

  5. 事件 授权用户可以查看设备行为记录。

  6. 告警 授权用户可以查看所有设备告警记录。

9.3.6 自定义主设备列表表头

选择一个设备然后点击 Edit Column 按钮,Column Edit 窗口会弹出。

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

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

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

10 数据管理服务

10.1 功能描述

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

10.2 仪表盘

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

10.2.1 添加新仪表板

在添加新图表之前,在添加新图表之前,您需要创建一个新的仪表板。点击右上角 + 按钮,将创建新的仪表板。

10.2.2 编辑仪表板

点击 在仪表板名称的右侧的 Down 按钮,然后点击 Edit 按钮。

用户管理员可以编辑仪表板名称,主题,数据收集的时间范围和刷新间隔。例如:

  • 名称:Demo
  • 主题:Theme 1
  • 时间范围:2019-08-17 16:31:47 - 2019-11-15 16:31:47
  • 刷新间隔:30 min (每30分钟刷新一次图表,0s表示不刷新)

点击 Down 按钮,然后点击 Save 按钮来应用仪表板配置。

10.2.3 插入新图表

编辑仪表板时,点击 + Insert 按钮,将显示所有受支持的图表和面板类型,包括折线图、折线图、条形图、饼图、圆图、数字面板、地图面板、表格面板和量规面板。

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

10.2.4 修改图表

点击图表右上方的 Settings 按钮, Chart Configuration 窗口会弹出。

您可以重命名图表,自定义主题,数据收集的时间范围和刷新间隔。如果需要,还可以进行边界设置以在图表中显示边界。 修改后,点击右下角的 Submit 按钮以应用配置。

保存配置后,图表将显示如下数据:

10.2.5 查看图表

编辑后,点击 Down 按钮,然后点击 Save 按钮以保存仪表板。

现在该图表已成功显示在仪表板上。

您可以点击图表右上方的 Sync Chart Data 按钮以立即刷新数据。

您还可以点击 Hide Legend 按钮以隐藏图表的图例。

10.2.6 删除图表

编辑仪表板时,点击 Close 按钮,该图表将被删除。

10.2.7 查看仪表板

按照上面的 10.2.3 插入新图表 部分中的说明创建更多的图表。保存所有图表后,它们将显示在仪表板上。授权用户可以调整所有图表的大小,并可以根据需求重新排列它们的位置。

10.2.8 复制仪表板

点击 Down 按钮,然后点击 Copy 按钮,将创建原始仪表板的新副本。

点击新的仪表板,以便您可以查看或编辑仪表板。

10.2.9 删除仪表板

点击 Down 按钮,然后点击 Delete 按钮,Delete Dashboard 警告会弹出。点击 OK 按钮以删除仪表板。

10.3 转换器

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

10.3.1 添加新转换器

首先,您需要选择一个特定的你想要创建转换器的设备型号。以 TMX08 为例:

右键点击 Begin 按钮,该按钮表示转换器起始节点。点击 New Transformer 按钮。

New Transformer 窗口会弹出,授权用户可以输入转换器的标题、编写描述并完成一些代码编写。右侧有参考说明,可帮助授权用户编写代码。请注意:您无需编写 return 语句。 代码编辑模块内,编程语言是 JavaScript。

填写完表格和代码模块后,点击 Submit 按钮以添加新转换器。

输出字段由用户创建,并且可由用户自定义字段名。转换器数据流会生成输出值,最新生成的输出值可在设备信息的 ExtraData 选项卡中查看。更多有关信息,请参阅 9.3.5 查看设备信息

右键点击刚刚创建的转换器节点,然后点击 Output 按钮,Output Editor 窗口会弹出。

点击 + New 按钮以创建新输出字段。

您可以在转换器中定义多个输出字段。填写表格来定义所有的输出字段,然后点击 Submit 按钮以保存更改。若正确创建,数据流会在运行时部署到 JavaScript 公式。

您还可以根据需求添加更多的转换器,您可以根据需求创建不同的数据流。

10.3.2 修改转换器

右键点击您想要修改的转换器节点,然后点击 Coding 按钮,Edit Transformer 窗口会弹出。您可以重命名转换器或修改代码吗,然后点击 Submit 按钮以保存更改。

另外,您可以右键点击您想要修改的转换器节点,然后点击 Output 按钮,Output Editor 窗口会弹出。然后您可以编辑输出,点击 Submit 按钮以保存更改。

10.3.3 删除转换器

右键点击您想要删除的转换器节点,然后点击 Delete 按钮,Delete Transformer Confirmation 窗口会弹出。

点击 Delete 按钮以删除该转换器。

10.4 策略

在当前版本中,平台支持两种类型的策略:

  • 设备策略
  • 平台策略

10.4.1 设备策略

设备策略是设备配置的一部分。如果违反了策略,设备将通过通信协议触发警报。但是,并非所有设备都支持设备策略。

资产 - 设备管理,授权用户可以从配置模板列表中选择可用的设备策略,然后将其激活。他们还可以根据需求创建新的设备策略。

以 TMX08 为例。在其配置模板中,“sensor_policy” 和 “device_area” 属于设备策略。在 “sensor_policy”内,有两种类型的设备告警:温度告警和距离告警。在 “device_area”内,有地理围栏告警。当设备违反设备策略时,设备本身将向平台触发相应的告警,并通知授权用户。

10.4.2 平台策略

平台策略是在平台的数据引擎上实现的。当设备数据违反平台策略配置时,将直接在平台端触发告警。这两种类型的策略(设备策略和平台策略)具有不同的配置,但独立工作。

在当前版本中,该策略在平台端执行数据验证。该平台支持两种类型的策略:一种称为基本类型策略,即监视数据阈值;另一个被称为地理围栏策略,它可以监视设备的地理位置。地理围栏策略支持由中心点和半径定义的圆形围栏。当设备越过围栏边界时,将触发告警。建议仅当许多设备在同一位置非常靠近时才使用。

在一个设备群组中,可以同时启用多个策略,但它们可以独立工作。

10.4.3 创建基本类型的平台策略

  1. 点击 + New 按钮,Create New Policy 窗口会弹出。选择用户管理员将要应用策略的设备型号,然后点击 Next 按钮。

  2. 输入策略名称并选择配置类型,然后点击 Next 按钮。

  3. 选择要配置的数据字段(例如温度)。用户可以根据自己的要求配置温度范围,然后点击 Next 按钮。

  4. 添加任何有助于其他用户理解的描述,然后点击 Submit 按钮。

  5. 已创建新的平台策略,用户可以在 数据 - 策略 部分中看到它。

  6. 返回 资产 - 设备管理 部分,然后选择一个已有群组(或创建一个新的设备群组)。点击 Edit 按钮,Modify Group 窗口会弹出。授权用户可以选择刚刚创建好的策略并点击 Save 按钮以使策略生效。

10.4.4 创建地理围栏平台策略

  1. 点击 + New 按钮,Create New Policy 窗口会弹出。选择用户管理员将要应用策略的设备型号,然后点击 Next 按钮。

  2. 输入策略名称并选择配置类型,然后点击 Next 按钮。

  3. 输入地理围栏的纬度、经度和半径。用户管理员可以操作地图并修改其中的圆以定义地理围栏的位置。可以拖动圆的边缘以更改大小,并且可以拖动中心店以移动圆。然后点击 Next 按钮。

  4. 添加任何有助于其他用户理解的描述,然后点击 Submit 按钮。

  5. 已创建新的平台策略,用户可以在 数据 - 策略 部分中看到它。

  6. 返回 资产 - 设备管理 部分,然后选择一个已有群组(或创建一个新的设备群组)。点击 Edit 按钮,Modify Group 窗口会弹出。授权用户可以选择刚刚创建好的策略并点击 Save 按钮以使策略生效。

10.5 通道

在当前版本中,通道是控制数据共享的逻辑组件。用户管理员可以根据设备型号定义数据字段的白名单和黑名单。通道是在设备群组中进行配置。每个设备组可以具有多个数据通道,以用于各种目的并过滤不同的数据字段。通过数据通道,授权用户可以利用适当的数据字段从设备群组查询数据。如果用户要访问原始数据,则要在设备或群组层面来实现。

10.5.1 创建新通道

  1. 点击 + New 按钮,Create New Channel 窗口会弹出。然后授权用户可以选择设备型号,点击 Next 按钮。

  2. 输出通道的名称,然后点击 Next 按钮。

  3. 根据需求,将数据字段移动到正确的列表中。通过 API,可以获得白名单的数据,不可获得黑名单数据,因为用户无法访问该数据。

    请注意这并不意味着平台不会显示黑名单数据。通道仅用于当 API 被调用以查询数据时,阻挡对黑名单数据访问。

  4. 添加任何有助于其他用户理解的描述,然后点击 Submit 按钮。

  5. 已创建新的通道,用户可以在 数据 - 通道 部分中看到它。

  6. 返回 资产 - 设备管理 部分,然后选择一个已有群组(或创建一个新的设备群组)。点击 Edit 按钮,Modify Group 窗口会弹出。授权用户可以选择刚刚创建好的通道并点击 Save 按钮以使通道生效。

11 API 编程接口服务

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

12 设置

用户可以通过设置选择合适的语言、时区、数据统计单位和地图显示类型。点击 Restore default 按钮以返回初始状态。用户管理员可以为公司中的其他用户预先设置通用的公司设置模板。如果有需求,其他用户可以具有自己的个人常规设置。

  • 用户管理员
  1. 常规设置

  1. 公司设置

  • 其他用户

仅可以进行常规设置

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