开发者中心

控制台

概述

控制台应用程序为您提供了管理物联网(物联网)资产和业务数据的能力。在这个指南中,我们将向您展示:

有关控制台应用程序的更多信息,请参考下面的介绍。

介绍

QuarkIoE控制台可用于许多工业领域,包括:

  • 有条件监控

  • 报警监控和升级

  • 建筑资产监控。

  • 工业厂房和设备的能耗。

  • 传感器数据监控。

下面对控制台应用程序进行了描述。它提供了以下功能:

  • 数据浏览器: 交互式浏览,比较和可视化IoT数据

  • 仪表盘: 通过自由选择和设置小部件创建您自己的网页。小部件包括地图,表格,图表,图表,控制等等。

  • 智能规则构造器: 轻松创建业务规则来执行对传入数据的实时操作。

  • 业务规则包: 对地理围栏、阈值、报警升级和通知(短信/电子邮件/语音)使用预先定义的业务规则。

  • 报表: 创建基于仪表盘布局并通过电子邮件发送的报告。

  • 资产管理: 在层次结构中组织你的连接资产。

  • 报警管理: 用严重级别和工作流程监控资产问题。

  • 易用性: 用仪表盘欢迎页和首页分别做介绍和概述。

  • 数据点库: 管理设备的默认设置(“配置文件”),并使用“数据点库”自动应用。

概念

控制台应用的主要概念如下:

资产: 资产表示业务对象,例如建筑物、机器或汽车。

资产分级: 资产是在一个层次结构(树)。树的节点是群组,树的叶子是设备。

群组: 在资产层次结构中组织设备和资产的方法。一个群组可以包含一个或多个设备、子设备或其他群组。

设备: IoT 设备,或网关设备,或连接到网关的设备(例如Modbus或KNX设备),或传感器。

数据点: 传感器数据测量值,例如温度时间序列。在QuarkIoE其他部分称为测量值。也用术语时间序列或变量表示。

数据点属性: 元数据的一个数据点,代表已添加的用户的附加属性,例如标签、最小值/最大值、阈值等。

仪表盘: 一个网页,其内容可以由终端用户通过定位部件填充。

报表: 类似的仪表板,不同报告期和范围。

智能规则: QuarkIoE业务规则,已从智能规则模板实例化使用智能规则生成器。

QuarkIoE应用程序

控制台中应用程序基于QuarkIoE应用程序框架。要了解下列项目,请参看 "介绍":

  • 支持哪些Web浏览器?

  • 如何登录到QuarkIoE?

  • 如何浏览?

  • 如何链接到应用程序?

  • 触摸设备上如何使用QuarkIoE?

  • 用户界面约定

开始使用QuarkIoE控制台

欢迎页

第一次登录到QuarkIoE控制台会显示欢迎页。

之后,显示一个类似于下面的页面。

image alt text

欢迎页显示以下部分:

  • 设备(或资产)的连接数目。

  • 快捷链接列表。

  • 现有应用程序列表。

  • 开发文档的链接。

隐藏欢迎页

进入控制台应用程序时可以隐藏欢迎页,不显示它为默认页。要做到这一点,点击右上角的“启动时不显示”。

重置欢迎页为默认页面

为了使欢迎页再次成为默认页面,在左上角的导航器中选择“欢迎”。然后,取消选择“启动时不显示”。

仪表盘主页

如果不选择“欢迎页”为默认页面,启动应用程序时,可以看到下面的仪表盘:

image alt text

仪表盘显示租户的总体数据。

仪表盘主页是由租户的所有用户共享。包含可视化IoT数据的小部件。默认情况下,仪表盘主页包括五个小部件,一个欢迎的文本,现有对象摘要,有报警的资产,最近的报警和包含所有对象的地图。

仪表盘主页可以编辑,类似于其他控制台仪表盘:可以添加,删除或更改所显示的小部件。要做到这一点,使用右上角的设置符号或在一个小部件内移动光标,并使用小部件的设置符号。

细节参见下面的“编辑仪表板”。

要重置仪表盘的原始内容,使用菜单项“重置默认仪表盘”图标。

连接设备

要使用控制台应用程序,必须连接IoT设备。连接新设备是在“设备管理”应用程序中完成的。在右上角的应用程序切换器切换到“设备管理”应用程序,然后选择“注册”。详见设备管理用户指南

资产管理

资产表示业务对象,例如建筑物、机器或汽车。

资产是在层次结构中组织的。例如,一个能量监测应用程序可能有以下的资产层次结构:

image alt text

资产层次结构是由两种类型的对象组成的:

  • 群组对象:由控制台应用程序中创建,可以分组其他对象,即其他群组和设备。

  • 设备对象:连接到资产层次结构的设备。

在这个示例中,群组对象表示建筑资产。设备对象代表房间资产。群组名称和层次结构可以由用户自由定义。层次结构可以有多层,如区域级、城市级、街道级、建筑级、楼层级和房间级。一个设备可以是多个不同层次结构的一部分,例如区域层次的一部分和客户层次的一部分。

设备不在控制台应用程序管理。而是使用设备管理应用程序管理。 要在资产层次结构中放置一个设备,必须将设备“分配”到各自的群组中。详见下面的说明。

资产层次结构与设备层次结构

QuarkIoE支持两个层次的对象:设备层次结构和资产结构。设备层次从通信的角度追踪设备如何连接到QuarkIoE。资产层次结构组织通过M2M设备远程监控的资产。详细信息请参阅"QuarkIoE域模型"。

在控制台应用程序中,通过创建组对象和通过将设备连接到层次结构中构造资产层次结构。通常情况下,资产层次取决于所使用的IoT设备的种类。IoT设备有很多,其中两种非常常见:

  • 智能设备是一个独立的设备,包含传感器,执行器和通信模块。他们通常连接到一个单一的资产。典型的智能设备是跟踪器、气象站或内置通信模块的"智能"传感器。

  • 网关设备从其他设备向QuarkIoE建立通信,但不包含传感器和执行器。典型的网关设备包括ZigBee、Modbus、M-BUS或KNX网关。

QuarkIoE控制台设计来管理这两种类型的设备。下面的段落解释如何在控制台上使用智能设备和网关设备。

对于智能设备,下面的示例演示如何将智能设备连接到资产层次结构:

image alt text

设备管理(右边)中的智能设备是顶层设备。在控制台中应用程序中,您可能希望将智能设备组织成群组,如上图箭头所示。

网关设备在设备管理作为顶级设备,其附加设备(如ZigBee、Modbus或KNX设备)显示为“子设备”(右侧)。这些子设备可以在资产层次结构如上图所示。

请注意,资产层次和设备层次结构是独立的:而在设备管理应用程序中的所有子设备都低于网关设备,在控制台应用程序中相同的子设备被组织在两个不同的建筑物。虽然网关设备在设备管理应用程序中是可见的,在控制台中应用程序不可见(因为它不提供业务相关的数据,至少在这个例子中)。

控制台资产对比业务资产

控制台资产层次结构和商业资产(汽车,机器等)不是一对一映射。在层次结构中的业务资产的确切“位置”取决于许多因素,包括部署的设备层次结构和您的特定用例:

  • 例如,用于跟踪用户,每个设备代表了一个企业的资产:如果在你的卡车安装了一个跟踪装置,然后在QuarkIoE内部跟踪设备代表卡车。

  • 对于建筑管理,在层次结构中的某一层次的资产代表一个业务资产:如果你有多个设备部署在一个建筑物来监控它,那么该群组的对象“建筑”代表你的资产。

由于这些差异,控制台应用程序没有一个内置的“资产”对象。群组还是设备代表你的资取决于你的用例。

资产导航

导航显示“群组”下的资产的层次结构(见下面的截图):

  • 在顶部,显示顶级群组。 详情参见“添加群组”。

  • 当展开群组时,显示所有子项。 子项可能包括分配给该群组的其他群组或设备。 子项也显示在选项卡的“子资产”中。

image alt text

当在资产层次结构中选择一个对象时,应用程序的右部显示所选择的对象的更多细节:

image alt text

根据导航器选中的内容,右上的可见选项卡是不同的。下表显示根据导航器选中的内容,哪些选项卡可见:

选项卡名称 仪表盘名 信息 报警 子资产 位置 数据浏览器
选中的群组: 有,如果配置了 有, 显示所有子项数据点
选中的设备: 有,如果配置了 有, 显示所有子项数据点

请注意,应用程序已扩展插件,有可能显示额外的选项卡。详见"插件开发介绍"。

请注意,设备层次结构不显示在资产层次结构中。如果您添加了网关设备,则不显示子设备。要显示子设备,您必须显式地将它们添加到相关的资产。要浏览子项层次结构,使用设备管理应用程序。

要在资产层次结构中向下导航,要么使用导航器,要么在“子资产”选项卡中选择一个对象。在资产结构中导航,使用资产下面名字下面的面包屑导航进入。

搜索资产

要搜索群组或设备,将群组或设备的名称输入搜索框。然后按“回车”。匹配的群组和设备显示在右侧。通过点击选择一个搜索结果。左边的导航器中相应的群组和设备变长选中状态,并在右边显示详细信息。

添加群组

要添加一个新的顶级群组,在应用程序的顶部点击“+”,并选择“添加组…”。这将显示以下对话框:

image alt text

这将创建一个所选设备的新群组。在按“为n设备创建群组”后,该组做为顶层对象显示在导航器中。

要添加一个新的群组作为一个现有的资产的子群组,请单击“子资产”选项卡中的“+添加群组”。

image alt text
分配设备到群组

在添加一个设备到资产层次,它必须连接到QuarkIoE。使用设备管理应用程序将设备连接到平台。请参见设备管理用户指南的"设备连接"。

要将新连接的设备分配到资产层次结构中,请选择该设备应出现的群组,点击“子资产”,然后按“+分配设备”按钮。

在下面的对话中,寻找设备,并选择应被分配的设备(或子设备)。

image alt text
删除群组

您可以通过悬停在“子资产”选项卡中的群组中删除群组。你会看到一个红色的[X],可以点击删除群组。

取消分配设备

要从群组中取消分配一个设备,在导航器中选择组。然后在“子资产”选项卡上的设备悬停,并按下红色[X]按钮。

请注意,取消分配一个设备不删除设备,子设备或任何相关的数据。该设备只是从资产层次结构中的位置删除。它可以再被分配给其他群组。

编辑群组

要编辑群组的名称,请单击“信息”选项卡并编辑名称。

使用数据浏览器可视化数据

可以在控制台中的三个地方对数据点(测量值或传感器数据)可视化:

  • 点击导航器中的“数据浏览器”。可以访问所有资产的所有数据点。

  • 导航到一个特定的资产,并点击选项卡上的“数据浏览器”。您可以访问此资产和子资产的所有数据点。

  • 将相关的小部件添加到仪表盘上。在这里,您可以轻松查看预定义的报告。

要可视化数据点,执行以下步骤:

  • 转到该群组或设备,并单击“数据浏览器”。

  • 显示的所选设备或组的前五个数据点。

  • 通过选择“添加数据点……”添加额外的数据点

  • 调整颜色,范围,和其他可视化性能。

  • 通过改变时间周期或数值范围来浏览所显示的数据。

  • 如果你想为以后浏览存储配置,使用“作为小部件发送到仪表盘……”将它保存为一个小部件

数据浏览器和仪表盘是密切相关的:

  • 当发送做为小部件的数据浏览器配置到一个仪表盘时,可以选择保存新小部件的仪表盘。

  • 当点击“配置数据点图”小部件的配置图标,会有一个类似数据浏览器的对话框,在这里可以配置小部件。

打开数据浏览器

当单击“数据浏览器”选项卡时,数据浏览器打开。

它预先填充了对象(群组或设备)的现有数据点的。默认情况下显示前5个数据点。

image alt text

可视化取决于数据点属性。

数据点属性(最小值,最大值,颜色,..)预先填写如下:

  • 如果这些属性已被编辑过,则使用以前的值。

  • 如果数据点在“数据点库”中有一个匹配的定义(即测量值名称和系列是相同的),那么使用数据点库中的值。

可能有一个以上的“数据点库”中的匹配数据点条目。在这种情况下,系统自动选择第一个。你可以用齿轮的符号并选择“从库中加载X“覆盖此选择,其中X是指数据点库条目。

image alt text
添加数据点

通过按“+添加数据点”,可以添加附加数据点到数据浏览器中。将显示以下对话框:

image alt text

在对话框的顶部,从资产层次结构中选择一个设备。只有在导航器中选中的对象下面的资产层次结构才会显示。如果选择“导航器”中的“数据浏览器”,则显示完整的资产层次结构。

对话框的底部显示选定对象的所有数据点。选择要在数据浏览器中显示的数据点。按“添加”将所有选定的数据添加到所显示的数据点的列表中。

注意:该表显示了预填充的数据点属性。

更改数据点可视化

要改变数据点的可视化,改变图表下面的属性。

下面的字段可以指定一个精确的时间周期来进行可视化:

  • 左场:开始时间轴

  • 右场:X结束时间

  • 时间聚合级:不聚合,每天,每小时

以下属性可用于数据点:

  • v:选择是否可视化数据点。

  • 颜色:图的颜色。

  • 标签:用Y轴上的文字。

  • 单位:Y轴单位。用户定义的单位显示在Y轴上。

  • 最小/最大值:Y轴范围。

  • 目标值:目标值目前没有在图中显示。该值在“数据点列表”窗口中使用。

  • 黄色范围最小/最大:定义次要报警应由阈值规则触发的范围。这些值目前没有可视化。详情请参见下面的智能规则。

  • 红色范围最小/最大:定义严重报警应由阈值规则触发的范围。这些值是目前没有显象。详情请参见下面的智能规则。

  • 图表类型:对于聚合数据,选择哪些聚合值可视的。选项是:最小值,最大值,区域

  • Y轴:选择数据点应该显示在哪个Y轴。选项是:自动,左,右。

  • 资产:数据点的资产名称。这个字段是不可编辑的。此外,显示数据点(测量值片段和系列)的内部名称。

在数据浏览器中浏览

可以在数据浏览器中使用手势和/或鼠标导航。

支持以下操作:

  • 移动时间范围:移动X轴拖动到左边或右边。

  • 缩小时间范围: 在图中选择一个时间范围。

  • 放大时间范围: 双击。

使用多个Y轴

在数据浏览器,您可以配置"Y轴"列,值如下:

  • 自动(默认)

数值定义了Y轴在哪里显示各数据点。自动位置:第一个数据点到左边的Y轴,剩下的到右边的Y轴。

每个数据点显示在自己的Y轴,除非满足以下条件:

  • 两个数据点具有相同的最小值和最大值,共享一个相同的Y轴。

这个情况下,两个数据点在同一个Y轴显示。Y轴只显示单位(或单位不同时显示多个单位)。该标签是不显示的。

在数据浏览器中创建小部件

使用菜单并选择“向仪表盘发送部件”。

这将显示包含当前对象的所有仪表盘的模态对话框。移动到相关的仪表盘,并按“选择”,在选定的仪表盘创建一个新的小部件。

image alt text
导出测量值数据为CSV或XLSX文件>

在QuarkIoE,用户能够以CSV或XLSX文件下载测量值数据。导出的测量值数据分为六列:

  • 时间 - 日期和时间的具体测量
  • 测量源
  • 设备名称 - 您正在使用的设备的名称
  • 片段系列(如c8y_speedmeasurement)
  • 数值 - 简单的测量值
  • 单位 - 用于特定测量的单位(如“C”,“公里/小时”,“秒”……)

要以CSV或XLSX格式下载测量值,导航到“数据练篮球”,选择你所需的时间范围,然后点击位于右上方小滚轮按钮。

Export measurement data

选择下载CSV或Excel(XLSX)格式

“生成报告”窗口将出现。文件加载将取决于您添加到“数据浏览器”中的数据点的多少。一旦加载完成后,点击“下载”按钮。

使用仪表盘

仪表盘为你提供了一个定制的可视化的数据,由一套自由设置所谓的"小部件"组成。小部件可以显示地图,图像,图表,表格以及其他数据的图形表示。QuarkIoE自带的一些预设置小部件,详细见“小部件包”部分。你也可以开发自己的小部件并将它们添加到您的QuarkIoE帐户。参见 web开发者指南

建立新仪表盘

要创建一个仪表盘,导航到资产层次结构中的一个对象。然后点击右上方的齿轮图标。选择“创建仪表盘”。这将打开一个对话框,输入

  • 仪表盘的名称,它将显示在菜单中。

  • 菜单中仪表盘的位置。

  • 菜单中名称旁边的图标。

  • “设置仪表盘为全局”:仪表盘对每个人(“全局”)可见或只对一个用户的子集可见。

  • “将仪表盘应用到所有类型的设备”:仪表盘是否只为这个对象或同一类型的所有设备可见。

image alt text

单击“保存”来创建和打开仪表盘。在仪表盘上还没有小部件,您将看到一个“添加小部件”按钮。使用此按钮将您的第一个小部件添加到仪表盘上。

为同类型的所有设备创建一个仪表盘

您可以创建一个单一的仪表盘,将出现在同一类型的所有设备上。要做到这一点,如上所述创建一个新的仪表盘。在按“保存”前,选择“将仪表盘应用到所有type类型的设备”选项。文本“type”由当前选定的设备类型替换。

随后仪表盘应出现在这种类型的所有的设备上。一个仪表盘变化,所有仪表盘自动可见。

注意:您只能添加设备本身的小部件和数据到仪表盘上。不能添加子设备的数据,因为子设备结构可能不同。

在仪表盘中添加小部件

要在仪表盘上添加一个小部件,确保仪表盘是可见的。然后点击右上方的齿轮图标。选择“添加小部件到仪表盘”。这将打开一个对话框,在这里您可以选择要添加到仪表盘中的小部件类型。

image alt text

当选择一个小部件类型时,将显示该部件类型的附加字段。字段数量和类型取决于小部件类型,参阅"小部件包"。

编辑仪表盘

仪表盘的各个方面可以编辑。

image alt text

你可以通过点击齿轮图标选择“编辑仪表盘”编辑仪表盘的属性。这将显示和创建仪表盘类似的对话框。您可以更改仪表盘名称、图标、位置和权限。

您可以重新安排仪表盘上的小部件。通过拖放小部件的头,您可以将小部件移动到页面上的另一个位置上。通过拖放小部件的右下角的箭头,可以调整大小。通过点击右上角的交叉图标,可以删除小部件。通过点击在窗口右上角的齿轮图标,可以编辑小部件的属性。如下图所示:

image alt text

注意:在非触摸设备上,图标只出现在您悬停在小部件头上时。

注意:使用PC编辑仪表盘。在触摸设备(智能手机,平板电脑)编辑不支持所有功能。为了显示在触摸设备上的小部件图标,请在短按这个小部件的标题。

复制仪表盘

要把仪表盘从一个对象复制到另一个对象,用右上方的齿轮选择“复制仪表盘”。然后选择仪表盘应应用的对象,并按“粘贴仪表盘”插入仪表盘。

另一种复制一个仪表盘的方法是使用每类型"仪表盘"实现。使用"每类型仪表盘",可以从一个对象复制仪表盘到所有同类型的对象上。

删除仪表盘

要在仪表盘上添加一个部件,确保仪表盘是可见的。然后点击右上方的齿轮图标。选择“删除仪表盘”。

小部件包

QuarkIoE控制台包括预定义的小部件类型。每个小部件类型提供不同的参数来配置小部件以及小部件所显示的数据。下面的部分描述了每个可用的小部件类型和它提供的配置属性。

"资产属性"小部件

显示当前对象的用户定义的属性列表。当前的对象可以是一个设备或群组。

配置参数:

  • 小部件名

  • 属性列表,请参见下面的配置属性列表.

"数据点图表"控件

显示图中的数据点(测量值)。可视化与在数据浏览器中的相同。

注:创建一个数据点图小部件的最简单的方法是导航到数据浏览器,然后选择“发送到仪表盘”。

配置的参数与数据浏览器中的相同。请参见"数据浏览器"。

"数据点表格"控件

这个小部件的配置和数据点图相同,只是不用线图可视化数据,而是用表格可视化数据。

  • 数据点表格部件显示基于所选数据点、时间间隔和聚合的数据。

  • 超出范围的数值,基于配置的黄色和红色区域,在表中突出显示。

数据点表格
"地图"小部件

显示群组中所有设备的位置。该地图提供了以下功能:

  • 该地图可以正常使用,也就是说,可以拖动,放大/缩小。

  • 表示设备的图标是颜色编码的。使用的颜色取决于以下规则:

    • 至少一个严重报警: 红色

    • 至少一个主要报警: 橘黄色

    • 至少一个次要报警: 黄色

    • 至少一个警告报警: 蓝色

    • 无报警: 绿色

  • 当点击设备图标,弹出以下信息:

    • 设备名。当点击时,应用程序导航至设备。

    • 设备上一次报告位置的日期,如果可用。

    • 显示/隐藏之前和现在的设备轨迹的选项。

配置参数:

  • 目标设备或群组:选择要在地图上显示的设备。如果选择了一组,则显示包含在该组中的所有设备。

注意:如果没有一个目标设备有已知位置,那么这个小部件将显示一个没有图标的世界地图。

HTML小部件

显示用户定义的内容。内容可以使用HTML格式。

配置参数:

目标设备或群组:对哪些对象计算HTML表达式。详情见下文。

  • HTML 内容:

可用在HTML内容的变量:

  • {{devicesCount}}: 设备总数。

  • {{usersCount}}: 用户总数。

  • {{deviceGroupsCount}}: 群组总数。

  • {{device.name}}: 设备名称。

  • {{device.property}}: 以上更通用形式。您可以表达该设备的任何属性。

  • {{device.c8y_Hardware.model}}: 设备的模型

  • {{device.fragment.property}}:以上更通用形式。您可以表达该设备的任何片段属性。

上面的一些注释:

  • “设备”是指目标设备,在小部件配置参数中选择的。

  • fragment.property 是指相应的设备的属性。要了解可用的属性名称,您可以使用“资产属性”或“资产表”小部件,并按小部件配置中的“+添加属性”链接。这将显示一个支持的属性表。您可以复制并粘贴“属性”列的值。注:计算得出的属性在HTML小部件中不可用,如所有名称包括“count”的属性。

资产报警小部件

显示有严重报警的所有对象。没有额外的参数来配置。

资产计数小部件

显示在线的,有严重报警的设备数量。没有额外的参数来配置。

报警列表小部件

显示报警列表,通过对象,严重级别以及报警状态过滤。

参数配置:

  • 目标设备或组:对哪些对象计算HTML表达式。

  • 状态:只显示已选择报警状态的报警。

  • 类型:只显示指定类型的报警。当单击一次报警时,可以看到报警的类型。

  • 严重级别:只显示选定的报警严重级别的报警。

最近报警小部件

显示所有的严重级别按时间排序的警报。没有额外的参数来配置。

数据点列表小部件

显示数据点(测量值),每行一个,当前值和数据点属性。

配置参数:

  • 数据点列表:选择一个或多个数据点。

  • 选择可见列:

    • 标签:数据点标签。详情参见数据浏览器。

    • 目标:目标值。可以在数据浏览器或数据点库配置

    • 当前:当前值

    • 差异:当前值与目标值的绝对差

    • 差异百分比:当前值与目标值之间的差异百分比

    • 资产:设备名或数据点群组

资产表小部件

显示表中所有子设备的详细信息。这是一个非常强大的小部件,它允许您在表中安排对象的选定属性。

配置参数:

  • 目标设备或组:选择要显示的对象所有子设备。通常是一个群组对象。

  • 属性:选择对象的属性或动作以将它们可视化为表中的列。在配置对话框中,您看到配置列的列表,每一列都可以是属性或动作。

例子:

  • 在下面的截图中,配置了五个列。三个属性列“表”,“供应商”,和“所有者”,这是指属性“名称”,“类型“和”所有者“。另外有两个动作,一个切换维护模式,令一个重启设备。 image alt text

  • 得到的表显示如下:image alt text

属性列表可以编辑如下:

  • 添加新的属性:点击“+添加属性”,选择一个或多个属性。选择的属性将被添加到列的结尾。
    注意:属性“活跃报警状态”在表中作为图标显示活跃报警。如果您选择此属性,请在列列表配置渲染“活跃报警状态”。

  • 添加一个新的动作:点击“+添加动作”。然后,您可以添加预定义的动作来切换维护模式。或您选择“创建操作”创建一个按钮,执行一个命令。在下面的对话框中,您可以输入按钮的标签和要执行的命令。 image alt text 注:该对话框显示了支持预定义shell命令的第一个设备。如果没有这样的设备,列表为空。详情请参阅shell命令
    注:您还可以输入要发送到设备的json格式的操作。要了解支持的操作联系设备供应商。

  • 编辑列标题:编辑列的标题,单击“标签”列上的“标签”,并编辑标签。

  • 整理列:您可以通过使用在列“标签”之前的手柄拖放重新排列。

  • 删除属性:单击一行结束时的红色图标,删除列。
继电器控制小部件

允许您开关设备继电器。只适用于支持这种类型的操作的设备。

继电器阵列小部件

给定一个继电器阵列,你可以独立开关继电器。只适用于支持这种类型的操作的设备。

消息发送小部件

向设备发送消息。设备本身的行为是依赖于设备的。只适用于支持这种类型的操作的设备。

使用报警

使用报警是和设备管理中一样的。参见设备管理用户指南中的"使用报警"。

使用仪表盘报表

在控制台应用程序中有两种报表。第一种是仪表盘报表,可以跟踪应用程序、报警、资产、事件和其他小部件。第二种报表是“使用报表导出数据”,你可以导出特定数据到SV或XLSX文件。

浏览报表

仪表盘报表是独立于资产层次的全球仪表盘。导航显示在“报表”项下的所有报表。要显示所有的报表,展开“报表”小部件。

建立新报表

要添加一个新的报表,选择标题中的“+”按钮,然后选择“创建新报表”。

在对话框中填写“名称”和“图标”,然后按“保存”。

image alt text

然后在创建的报表中添加小部件。

删除报表

要删除一个报表,按齿轮的图标,选择删除报表

向报表添加小部件

您可以自由地向报表中添加小部件,类似于仪表盘小部件。

查看报表

要查看一个报表,请在“导航器”中打开“报表”,然后单击相关报表。报表将显示。

使用报表导出数据

s

通过这个“报表”功能,您可以请求整个租户的CSV或XLSX报表。此外,您可以根据特定的设备,时间范围或字段选择过滤器。报表包含有关所有指定的“筛选器”和已启用的“字段”的信息。文件可以导出为一个xlsx文件的最大数目为100万条。如果定义“过滤器”的文档超过了限制,只导出文档的前100万条。

使用仪表盘报表请参阅使用仪表盘报表

要显示所有的报表,展开“报表”,并点击“报表”。

报表创建时,你可以选择克隆它。要克隆报表首先导航到报表的名称,然后单击“克隆”。在“克隆”按钮被按下后,你将被重定向到一个新的窗口,在那里所有的当前报表的数据将被复制。如果你愿意,你可以应用变更。要完成按“保存”按钮。

添加报表

要创建额外的报表,请单击“添加报表”。

  • 输入报表名。
  • 选择文件类型,csv或Excel。
  • 添加过滤器得到特定对象或时间范围的报表。
  • 报表的选择字段
  • 点击"保存"按钮结束。
添加报表

Filters

报表可以被过滤到特定的对象或时间范围。要选择导出的对象,首先要导航到位于“过滤器”部分下的“对象导出”搜索栏。特定的设备或劝阻组可以通过在搜索栏中输入它们的名称或属性来选择。当您单击“搜索”按钮时,控制台将在您的设备库中搜索匹配项。所有匹配的设备都找到后,他们将显示在搜索栏下。要选择一个设备,只需点击他们的名字,他们将被绿色高亮显示。

对象过滤器

附加的过滤器,如“时间范围”可以启用。您有可能过滤对象报告为“最后一年”,“上个月”,“最后一周”或简单地输入一个自定义日期范围。要选择时间范围,请单击向下滚动菜单,并选择您所需的时间段。如果您选择自定义时间范围,将出现两个小日期字段。只需选择一个时间范围。

时间范围

需要注意的是,为了启用过滤器,你必须点击下面的复选框“启用”。

Fields

为了方便地处理报表,可以选择不同的字段。例如,如果您选择“报警”和“事件”,您将只对这两个字段过滤报告。总的来说有四个领域,你可以选择。

  • 报警
  • 事件
  • 托管对象
  • 测量值

要启用字段,只需单击字段的名称。

字段

当某个字段被启用时,可以添加预定义的或空的属性。如果您选择添加空属性,请单击“添加”。要在位于红行的“列”或“路径”上输入标签或路径。例如如果你启用了“报警”的字段你可以输入“严重”列和路径接收报告只报警的严重级别。

如果您至少有一个字段中的字段不是从“添加预定义”列表中选择的,而是定义为一个自定义属性,那么就需要至少有一个这样的属性必须存在于导出的对象中,以将其包含在列表中。作为一个例子,如果报告有4个字段定义:时间、设备名称、类型和c8y_speedmeasurement.speed.value,前面3个是预定义的属性,而最后一个是一个自定义属性。如果导出的测量值不具备这样的自定义属性c8y_speedmeasurement.speed.value,则不导入Excel。

如果字段属于一个valid.key.with.dot则在路径中称为['fragment.key.with.dot'],例如:['fragment.key.with.dot'].serie.value。

要添加预定义的属性,请先单击“添加预定义”。

选择预定义的属性,点击位于“显示”下的相应复选框。选中所需属性后点击“选择”。

选择

请注意,为了有效地搜索一个特定的属性,您可以使用搜索字段。

如果启用了“测量值”字段也可以“从数据点添加”。

从数据点添加

按复选框选择一个数据点。当选择完成后,单击“添加”。

记住,“搜索字段”可以用于简化处理。只需键入“搜索字段”中的任何属性的所需设备的名称或值,然后按“提交”。这样,所有的匹配项都将显示出来。

添加数据点
导出库存数据到CSV或XLSX文件

为导出库存数据到“CSV或xlsx文件,导航到“报表”下的“报表”选项卡。

  • 通过点击相应的复选框选择所需的文件。
  • 点击“导出”
导出

您将收到一封带有每个文件的链接的电子邮件。

文件的标准时间属性(如报警中的时间和创建时间)会被导出

  • xlsx文件格式:03/13/2016 00:00:24
  • CSV文件格式:2016-03-13T00:01:24.000Z

注意只有CSV时间包含毫秒和时区。

编辑报表

编辑报表只需点击报表名称。要应用更改单击“保存”按钮。

删除报表

删除报表,悬停在报表名称上,并单击“X”按钮。

使用数据点库

数据点库提供数据点属性的默认值。数据点属性类似于文字处理应用中的“段落格式”:你不会希望单独格式化每一段。相反,你希望定义一组默认格式,然后将它们应用到文档中的段落中。数据点库对数据点提供了相似的功能:它提供了一组默认的数据点格式,可以很容易地应用到不同设备的数据点。

控制台应用程序如何使用数据点库?要找到一个数据点的默认可视化,如颜色或标签,控制台搜索数据点库,并试图找到一个匹配的条目。如果在数据点库中的片段和系列的值和测量值匹配,条目被认为是“匹配”。如果找到匹配的条目,则使用相应的数据点属性进行默认可视化。

此外,数据点库的属性被用于阈值业务规则:在数据点库中配置的红色和黄色的值被阈值规则使用,以提高警报。

当在导航器中选择“数据点库”时,将有一个预定义的数据点的列表,它们的属性打开。

image alt text

当点击一个条目,可以编辑数据点库一个条目:

image alt text

使用智能规则

QuarkIoE包括规则引擎用来实时分析数据并基于数据执行行为。这些规则用脚本语言描述,在管理应用程序中管理。

为了简化创建规则,控制台应用程序包括一个智能规则生成器。使用智能规则生成器,可以从模板创建规则。这些规则被称为智能规则。该模板被称为智能规则模板。

智能规则是参数化的。参数有两个来源:

规则参数由用户提供时,创建智能规则时由用户从模板提供。例如电子邮件地址和报警文本。

对象参数存储在群组或设备中。这些参数可以在智能规则被创建之后也可以编辑。示例包括例如阈值的最小值和最大值。

建立智能规则

智能规则可以在“配置 -> 智能规则”或在“信息”选项卡下的群组和设备创建。

智能规则按如下创建:

  • 点击“+添加智能规则”

  • 点击一个智能规则模板。

  • 在下一个窗体中,输入规则参数。每个规则参数不同,详细信息请参见下面的各规则描述。

  • 使用搜索字段,您也可以激活当前目标设备或资产的智能规则。请注意,这一步是可选的。

  • 选择启用或禁用规则。

  • 按“创建”。

下面列出了一个智能规则列表。请注意,根据你的安装显示的智能规则的数量可能会有所不同。

image alt text

之后,如果规则被设置为启用,并不是为特定的对象激活,则该规则将对所有设备和群组激活。见下一节如何停用特定对象的智能规则。

如果一个智能规则被禁用,则该规则在“信息”选项卡中的群组或设备级别上不显示。这样更容易理解哪些规则实际上是相关的。

智能规则可以被实例化多次。

激活和停用智能规则

智能规则可见于一个给定的设备或群组的信息标签下,无论他们在群组或子项水平激活,以及激活的子项数量。

一个单一的智能规则可以为一个单一的对象(群组或设备)激活(打开)和停用(关闭)。例如,如果设备出错并产生太多的阈值报警,你可以关闭这个单一对象的规则。该规则仍然对所有其他对象激活。

要停用或激活一个群组或设备的智能规则,在“信息”选项卡单击按钮以启用或禁用规则。

信息选项卡
编辑,克隆或删除智能规则

编辑、克隆或删除一个特定的智能规则只需点击齿轮定位到智能规则并点击需要的选项。

为更容易调试,智能规则链接到相应的事件处理模块。点击齿轮,然后点击“检查”即可。

举例:定义显式阈值

定义一个阈值规则如下:

  • 在资产导航器中,导航到群组或设备

  • 点击“数据浏览器”。

  • 如果默认情况下,如果您的数据点是不可见的,请选择“添加数据点”,并添加您的数据点。

  • 对于应提高阈值的数据点,点击排在末尾的“齿轮”图标,选择“创建智能规则”。 image alt text

  • 选择“创建测量值显式阈值报警”

  • 填写规则参数: image alt text

  • 填写红色范围最小值和红色范围最大值。当这些值之间的值,阈值报警将触发。

  • 在“创建报警”下面,可选编辑报警类型和报警文本。

  • 在”为目标群组或设备激活”下面,可以选择对哪些对象激活规则。

  • 点击"创建”

规则创建后,应该自动激活和和报警。

链式规则执行

智能规则可以在平台中创建新的数据项。如,阈值规则创建新的警报。 这些新的数据可以通过智能规则进一步处理。如,过“报警发送电子邮件”规则。 使用这种机制,可以创建智能规则链。注意,有循环的风险。 这可能让平台超载,导致多余的数据。

业务规则包

可在系统中使用下面的智能规则模板。

按测量值阈值创建报价

定义黄色和红色的范围,产生报警并清除。

规则使用设备对象或数据点库中的下列参数:

  • 红色范围:系统创建严重报警时的范围。这些值可以在每个数据点的数据浏览器中编辑。

  • 黄色范围:系统创建次要报警时的范围。这些值可以在每个数据点的数据浏览器中编辑。

  • 数据点库红色范围:如果对象没有存储红色范围,搜索数据点库使用相关的红色范围。

  • 数据点库黄色范围:类似于红色范围。

使用这个机制,可以在数据点库中配置全局阈值范围。这些全局值可以被具体对象重写。

规则使用以下参数:

image alt text
  • 片段:测量值片段的名称。传入的测量值必须有和配置完全相同的片段名称。注:当从数据浏览器创建规则时,该片段已被填充。

  • 系列:类似片段,只是为系列。

  • 数据点库条目:数据点库中的条目的名称。如果没有单独配置,用来找到红色和黄色的范围的默认值。

  • 类型:将被触发的报警的类型。

  • 文本:将被触发的警报的文本。

此智能规则为每个传入的测量值执行步骤的详细说明:

  • 检查是否测量值包括片段和序列数据(规则参数)。

  • 检查是否该规则为源对象激活。

  • 从下面任意一种收集红色和黄色的范围:

    • (测量值的)源对象

    • 数据点库(规则参数)

如果在它们中的任何一个都没有定义红色/黄色的范围,那么就不会产生警报。

注意:源对象定义的范围值比在数据点库上定义的优先级更高。也可以通过设置在源对象中的一个值(例如黄色范围最大值)来重写一个值(例如,最大值)。其他值从数据点库中提取。

  • 如果传入的值在黄色范围内:

    • 如果有个给定类型的对象活跃报警:

      • 严重级别为"次要"
    • 否则

      • 用给定的参数建立新的"次要"报警。
  • 如果传入的值在红色范围内:

    • 如果有个给定类型的对象活跃报警:

      • 严重级别为"严重"
    • 否则

      • 用给定的参数建立新的"严重"告警。
  • 如果测量是在黄色和红色的范围以外:

    • 如果有个给定类型的对象活跃报警:

      • 清除报警。

故障排除

  • 请确认报警已创建并未被消除。

  • 是否设备不在 维护 模式:在这种情况下,因为抑制策略不创建新报警。

  • 是否没有报警映射规则(参见: 变更报警优先顺序) 改变报警的严重级别:在这种情况下,报警可能和预期的严重级别不同。

  • 是否报警没有被下一个绿色范围内的测量值清零。

  • 请注意,如果你清除一个报警,表示已经解决报警。除非设备改变其状态并再次超过阈值,否则不会触发新报警。

按测量值显式阈值创建报警

当测量值进入或离开红色的范围时,创建或清除严重报警。

报警的严重级别取决于:

  • 是否测量值在红色范围,严重报警。

  • 是否测量值在绿色范围,清除警报 。

此规则类似于上述阈值规则。然而,在这条规则中,红色的阈值是显式提供的。另一个阈值规则从设备或数据点库中提取。

规则使用以下参数:image alt text

  • 片段:测量片段的名称。传入的测量必须有和配置完全相同的片段名称。注:当从数据浏览器创建规则时,该片段已被填充。

  • 系列:类似片段,只是为系列。

  • 最小值,最大值:当一个值在[最小值;最大值]时,触发配置的报警。

  • 类型:触发的报警的类型。

  • 文本:触发的报警的文本。

故障排除

  • 请按上面的阈值规则相同的步骤检查。
报警邮件发送

当报警创建发送电子邮件。

该规则使用以下参数:

image alt text
  • 报警类型:触发规则的报警的类型。对于每一个新创建的报警,在列表中的其中一个类型的规则被触发。

  • 收件地址:电子邮件的收件地址。多个地址可以用逗号分隔(“,”,不要使用空格!)。

  • 抄送地址:和上面一样,只是为电子邮件“抄送”字段。

  • 密送地址: 和上面一样,只是电子邮件“密送”字段。

  • 回复地址:回复消息的地址。

  • 主题:电子邮件的主题。你可以使用;{变量名}格式的变量。支持的变量在下面的“智能规则变量”中列出。

  • 文本:电子邮件文本。你可以使用{变量名}格式的变量。支持的变量在下面的“智能规则变量”中列出。

故障排除

  • 请确认警报是创建的,而不是重复的。

  • 是否设备不在 维护模式:在这种情况下,因为抑制策略不创建新报警。

  • 是否没有报警映射规则(见:变更告警优先顺序)改变报警的严重级别:在这种情况下,报警可能与预期的严重级别不同。

  • 请检查您的垃圾邮件文件夹。

报警短信发送

创建报警时,发送短信。

请注意,这条规则只适用租户有一个配置的短信服务提供商。

该规则使用以下参数:

image alt text
  • 报警类型:触发规则的报警的类型。对于每一个新创建的报警,这些类型的一个规则被触发。

  • 电话号码:目标电话号码。建议包括所有号码国家码,例如:中国是“+86”或“0086”。多个号码可以用逗号隔开(“,”,不要用空格!)。

  • 消息: 短信最多160个字符。你可以使用{变量名}格式的变量。支持的变量在下面的“智能规则变量”中列出。

故障排除

  • 请确认警报是创建的,而不是重复的。

  • 是否设备不在 维护模式:在这种情况下,因为抑制策略不创建新报警。

  • 是否没有报警映射规则(见:变更告警优先顺序)改变报警的严重级别:在这种情况下,报警可能与预期的严重级别不同。

  • 如果你使用的变量,记住160的限制是在填充变量之后的。如果填充后的变量文本大于160个字符是不会发送的。

按报警持续时间提升严重级别

如果报警活跃了一定的时间,提升严重级别。

规则使用以下参数:image alt text

  • 报警类型:触发规则的报警的类型。

  • 持续时间:报警要多长时间才能触发规则?

规则描述:

  • 开始监测多久活跃报警后触发配置的报警类型。

  • 如果报警经过配置的时间后依然活跃,增加一级严重级别,即从次要到主要。

  • 如果报警是“严重”的,停止监控,因为没有任何更高的严重级别。

注意: 该规则每分钟检查一次是否已超出配置的持续时间。因此,它不改变下一次检查前产生报警的严重级别。

按地理围栏产生报警

地理围栏智能规则可以被配置来创建离开或进入(或两者)地理围栏的报警。条件相反时,清除已有的报警。

规则使用以下参数:

image alt text
  • 地理围栏:通过定义边界定义一个多边形。为此,点击“编辑地理围栏”,导航到相应的区域(例如,使用“搜索地址”输入框),并通过针对边界各点点击定义一个多边形。 image alt text

  • 类型:触发的报警的类型。

  • 文本:触发的报警的文本。

  • 严重级别:触发的报警的严重级别。

  • 触发条件:定义触发报警的条件。取值:“离开”、“进入”或“两者”。不设置则是“离开”。

住: 该规则将对跨区域边界触发。因此,如果你的设备在外部或内部的区域创建规则时没有报警将直到设备过第一次区域边界生成。

故障排除

  • 请确认设备在规则创建/激活后在地理围栏中至少一次

  • 是否设备不在 维护模式:在这种情况下,因为抑制策略不创建新报警。

  • 是否没有报警映射规则(见:变更告警优先顺序)改变报警的严重级别:在这种情况下,报警可能与预期的严重级别不同。

计算能耗

根据电、气、水表的数据创建消耗数据点。

规则使用以下参数:

image alt text
  • 片段:测量片段的名称。传入的测量必须与配置有完全相同的片段名称。注意:当从数据浏览器创建时,片段已填充。

  • 系列:类似片段,只是为系列。

  • 时间间隔:计算消耗值的时间周期。注意:这只定义消耗的频率而不是计算消耗的单位。

  • 消耗片段:应生成的测量值片段的名称。

  • 消耗系列:应生成的测量值系列的名称。

消费测量值单位总是每小时(例如,如果测量值是在“公斤”的消耗是“公斤/小时”)。 规则将采取每一个配置的持续时间段的最后两个测量值。 然后,它会计算数值值和时间的差异,并计算每小时的消耗。

举例:

规则被配置为每20分钟计算一次。有以下的测量值输入: 11:59 100公斤, 12:14 200公斤。 12:20规则将被触发下一次它会带上两测量值。它将计算数值和时间差。消耗测量值12:20创建,为400公斤/小时。 如果在最后一段时间没有创建新的测量值,将创建一个消耗0的测量值。

按测量缺失创建报警

如果给定时间内选定的测量值(数据点)没有接收到新数据,则创建一个报警。

规则使用以下参数:

image alt text
  • 类型: 测量的类型。传入的测量必须与配置具有完全相同类型。注意:当从数据浏览器创建时,类型已经填写。

  • 时间间隔: 计算消耗值的时间间隔。

  • 报警类型: 触发的报警的类型。

  • 严重级别: 触发的报警的严重级别。

  • 文本: 触发的报警的文本。

注: 规则一分钟检查一次是否配置的时间间隔超时。因此,创建报警后的时间间隔最多超过一分钟。要检查时间间隔是否已超时,至少需要在规则激活后创建的配置类型上有一个测量值。

按报警创建操作

如果发生某个报警,发送指定操作到设备。

规则使用以下参数: image alt text

  • 报警类型: 触发规则的报警的类型。对于每一个新创建的报警,这些类型的规则被触发。

  • 操作: 应发送的操作。操作由JSON描述。一些标准操作可以在下面的操作字段中选择。要使用一个标准操作,选择一个,然后按箭头键到右边。这会将选定的操作json。

按地理围栏发送邮件

如果一个设备离开定义地理围栏发送电子邮件。

规则使用以下参数:

image alt text
  • 地理围栏:用类似规则”按地理围栏创建报警”方式第一多边形。

  • 收件地址:用于发送电子邮件的电子邮件地址。多个地址可以由逗号分开(“,”,不使用空间!)。

  • 抄送地址: 如上,只是为电子邮件“抄送地址”字段。

  • 密送地址: 如上,只是邮件的“密送地址”字段。

  • 回复地址:用来回复消息的地址。

  • 主题:电子邮件主题。你可以使用{变量名}格式的变量。支持的变量在下面的“智能规则变量”中列出。

  • 文本:电子邮件文本。你可以使用{变量名}格式的变量。支持的变量在下面的“智能规则变量”中列出。

注意:象“按地理围栏创建报警”这一规则一样,穿越边界触发。要发送邮件,设备在创建规则后必须至少在地理围栏内一次。

故障排除

  • 请确认设备在创建/激活规则后至少在地理围栏内一次

  • 请检查您的垃圾邮件文件夹。

按报警启动文本到语音通话

报警时创建发起文本语音呼叫。

规则使用以下参数:

image alt text
  • 报警类型:触发规则的报警的类型。对于每一个新创建的报警,这些类型的一个规则被触发。

  • 电话号码:目标电话号码。建议所有号码都包括国家码,例如:中国是“+86”或“0086”。

  • 消息:规则读取的消息。

  • 重试次数:如果不成功,向目标的电话号码的重试次数(如电话占线或电话被拒绝)

  • 时间间隔:重试之间的时间间隔(分钟)。

  • 确认:呼叫的接收者必须确认该呼叫的标志(如果不确认呼叫将不算作一个成功的呼叫)

  • 确认文本:确认消息读取(将在主消息后读取),例如:“请按按钮5确认此呼叫”

  • 确认数字:接收器的按钮的数字,按此按钮确认。如果按此按钮,呼叫成功,报警状态将被更改为确认。

故障排除

  • 请确认报警已创建并未被消重。

  • 是否设备不在 维护模式:在这种情况下,因为抑制策略不创建新报警。

  • 是否没有报警映射规则(见:变更告警优先顺序)改变报警的严重级别:在这种情况下,报警可能与预期的严重级别不同。

升级报警

当报警创建时发送电子邮件,短信,或/和启动文本到语音。

规则使用以下参数:

image alt text
  • 报警类型:触发规则的报警的类型。对于每一个新创建的报警,这些类型的一个规则被触发。

该规则允许定义动作步骤的链。为了添加步骤单击按钮“添加步骤”。将出现下列参数的窗体: image alt text

  • 动作类型:在步骤中执行的动作类型。可能的值是:

    • 电子邮件 (参数描述参见按报警发送电子邮件规则)

    • 短信 (参数描述参见按报警发送短信规则)

    • 电话 (参数描述参见按报警启动文本到语音通话规则)

  • 条件:执行该操作的条件。可能的值是:

    • 总是:动作将无条件地执行。

    • 总是:在第N步失败:如果第N步链失败则执行动作。只有电话步骤可能会失败。一旦通话重试都失败,这一步标记为失败。如果已经配置电话步骤,则此选项会出现。

故障排除

  • 请确认报警已创建并未被消重。

  • 是否设备不在 维护模式:在这种情况下,因为抑制策略不创建新报警。

  • 是否没有报警映射规则(见:变更告警优先顺序)改变报警的严重级别:在这种情况下,报警可能与预期的严重级别不同。

智能规则变量

您可以在某些规则参数中使用变量。当一个规则被触发时,变量被它们的实际值所取代。您可以使用这个机制将设备名称或报警文本插入到不同的输出(电子邮件、短信、文本到语音)。 您可以包括触发事件(如报警)的任何信息和它的源设备。

下表列出了示例变量:

变量 内容
{creationTime} 报警在数据库中建立的时间。
{type} 报警类型。
{time} 报警时间,由报警提供。
{text} 报警文本描述。
{source.name} 设备名。
{source.c8y_Hardware.serialNumber} 设备序列号。
{source.c8y_Notes} 设备备注字段。
{status} 报警状态:活跃、确认或清除。
{severity} 报警严重级别:严重,主要,次要,警告。
{count} 此设备的报警消息数:同一设备的重复消息和相同报警类型被放在同一个报警信息中。
{source.c8y_Address.street} 设备的街道。
{source.c8y_Address.cityCode} 设备的邮编。
{source.c8y_Address.city} 设备的城市。

注: 如果变量不存在或是拼写错误,变量名被当作内容替换。