标准应用使用说明

V1.0

1. 应用简介

九物云标准应用是由九物云平台提供给租户用于设备管理和监控的后台管理应用，包括监控中心、场站管理、设备管理、告警管理、消息中心、业务建模和系统管理等几大功能模块，租户管理员可以通过标准应用对接入平台的设备实时在线监测，查询历史数据和数据分析，配置告警和消息通知，同时还可以建立组织架构，创建其他可登录应用的成员，并做角色权限管理，实现不同角色的管理功能和数据的区分。

九物云标准应用的功能还在不断完善和更新迭代中，可以在平台管理中心的应用开发，创建新应用时获取最新版本的标准应用。

2. 基本概念

名词	描述
租户	即客户，指使用平台的企业/组织的统称，租户是一个独立的业务实体，拥有独立的运行环境与数据，包括用户、账户和统计信息、用户在系统中建置的各式数据、以及用户本身的定制化应用程序环境等，租户之间是逻辑隔离的。
租户管理员	注册租户时会同时创建租户管理员，拥有租户内系统和平台的最大管理权限，可以创建成员和分配权限；租户管理员具有唯一性，不能删除，但可以移交给其他成员
场站	为场站内各种设备安全使用和业务的正常开展而设置的管理对象和特定空间，例如工厂、厂区、园区、车间、站点、建筑等
设备	直接或间接用于生产，提供服务功能的实体对象，设备可以直接连接平台，也可以作为子设备通过网关连接平台。
网关	具有子设备管理功能，并代理子设备直接连接物联网平台的通讯设备。
模型	是平台中物模型的统称，包括场站模型和设备模型，是设备或场站在云端的功能描述，包含设备/场站的静态属性、动态属性。
静态属性	即信息，用来描述模型对象固有的、非变化的相关信息，例如厂商ID、厂商名称、设备类型、运行寿命等
动态属性	即测点，用来描述模型对象动态变化的参数和数据，例如温度、流量、压力、故障等

3. 创建标准应用

1）登录平台管理中心

2）点击页面右上角“应用开发”按钮

3）在应用列表点击“新建应用”按钮

4）在弹出窗口点击“从模板中心生产”标签页

5）点击预设模板中的“标准应用”方块，系统就会生成一个新的标准应用；

4. 组织管理

组织是针对用户管理的一种树形结构，可以通过创建不同层级的组织对用户进行归类，用户即组织成员；组织在系统中最多支持创建5层结构，组织成员可以分属不同层级的组织；组织中可以指定成员为组织的主管，主管可以对工作流进行审批。

组织结构的类型：

树形是一般企业和组织的结构类型；

矩阵型目前也有很多公司使用，平台中可以使用用户组来实现横向管理；

组织节点组织类型：集团、公司、部门、项目、团队、班组，

组织节点业务类型：研发（设计、软件、硬件、实验）、市场、销售、采购、生产、质管、仓储、物流、客服（售后、公关）、工程（管理、技术、施工、安装、运维）、财务、人事（人力、培训）、行政、法务、IT/信息

1）组织架构

主要有新建组织、修改组织、设置主管、删除组织、添加下级组织、添加调整组织成员等功能。

新建组织：在左侧列表，点击“+新建组织”按钮，设置组织名称、选择上级组织、指定该组织的主管（组织负责人），名称和上级组织是必填项，主管从该组织的成员中选定，也可以先不指定，在组织架构建立好后再指定。
添加子组织：在组织列表的组织名称右边的三点图标可以点开菜单，点击“添加下级组织”，然后就如上创建子组织；子组织的层级最多可创建5层；
编辑/删除组织：也是通过组织列表的菜单编辑删除，这里注意的是如果组织下有成员的不能删除，先要移除成员到其他组织或根节点下，另外组织也要解除与角色的绑定的关系后，该组织才能被删除；

2）组织成员

组织成员即用户，用户是租户下使用和管理系统应用功能的人员，不同人员可以分配到组织、用户组和角色进行绑定后，再分配不同的应用菜单、设备等不同资源权限。

新建成员：可以通过组织架构页面的右上角“新建”按钮来创建一个组织成员，也可以通过右边小三角，批量导入成员的方式新建成员；成员信息中的姓名、手机密码为必填项，手机邮箱可以用来登录、找回密码和接收通知消息，所属组织可以选择之前创建的组织，然后选择是该组织的成员还是主管；在这里还可以添加多个所属组织和头衔；

导入成员：先下载导入模板，按格式修改后导入，注意操作提示信息，按步骤操作，

导入的文件会先进行格式和数据校验，如有重复数据，可选择覆盖或忽略，点击“下一步”后执行导入操作，新建和导入的成员默认都会是启用状态；

编辑成员：点击成员列表右侧的“编辑”按钮，在弹出窗口对成员信息进行编辑修改；
禁用成员：在成员列表的启用一列中，可以通过开关对成员进行启用和禁用操作，禁用后的成员将不能登录应用系统和平台管理中心；
删除成员：拥有待办事项的成员不能删除，比如工作流中的待审核等；已删除的成员目前无法恢复，请谨慎操作，如果误操作可以通过新建成员再重新添加进来；

批量操作：通过成员列表右上角的批量操作按钮，可以选择多个成员进行导出和批量删除操作；
调整成员：调整所选组织内成员，可以将组织内成员调出到其他组织或从其他组织移入到该组织；

3）用户组管理

用户组是一组用户的集合，比如不同组织的成员可以编入一个用户组，用户组的管理相对比较灵活，也可以跟角色绑定，赋予用户组成员相应的功能权限；

新建用户组：用户组列表右上角的新建按钮，在弹出窗口填写用户组信息和编辑用户组成员；用户组名称一般填写为英文，主要为了方便系统内的逻辑调用，显示名称可以为中文，主要用于在前端页面的展示，更易于用户识别；用户组成员可以从组织内成员选入到右侧用户组成员列表中，也可以选择右侧的用户组成员移出用户组；

编辑用户组：通过用户组列表右侧的编辑按钮编辑用户组信息和调整用户组成员；
删除用户组：删除用户组前，需解除用户组与角色的绑定关系，清空用户组成员列表；

5. 权限管理

权限管理有两个层面：一是系统级权限，主要针对使用管理中心的人员权限控制；二是应用级权限，主要针对登录应用内的人员权限控制，本章主要阐述应用级权限的管理；

1）角色管理

平台的权限管理是RBAC（Role-based Access Control基于角色的访问控制）的权限管理体系，所以角色是权限系统的核心；应用级的角色是可以跨应用的，也就是说某个成员被赋予某个应用角色后，角色配置多个应用页面访问权限后可以登录访问多个应用。

图1 RBAC基础权限模型

图2 平台应用权限模型

新建角色：通过角色列表右上角的“新建”按钮，在弹出窗口填写角色相关信息；其中序号主要用来排列角色在列表中的前后顺序，序号越小越在前面，不能为负数的整数，角色名称一般填写为英文，主要为了方便系统内的逻辑调用，显示名称可以为中文，主要用于在前端页面的展示，更易于用户识别；

角色状态：在角色列表中的角色状态一列可以启用和禁用某个角色，角色创建后默认是启用状态；当角色禁用后，跟该角色绑定的成员、组织、用户组将不能使用该角色配置的权限资源；
删除角色：需要注意先要在权限管理那里解除跟该角色绑定的成员、组织和用户组关系后才可删除；

2）权限管理

权限管理主要是对已创建的角色进行角色成员的绑定和权限的分配；左侧角色列表中最上面的角色是系统管理员，这个是系统默认的角色，拥有所有系统资源权限。

关联对象：角色关联对象包括成员、组织和用户组，可以点击在角色关联对象列表右上角的“关联对象”按钮，在弹出窗口中编辑调整角色关联对象；
权限配置：目前可配置的权限资源包括组织、设备和菜单权限；组织权限是指该角色可以查看或管理哪些组织和成员，设备权限是指该角色可查看和管理哪些设备和设备数据，菜单权限是指该角色可访问哪些应用的哪些菜单页面；

6. 业务建模

业务建模是基于数据对象（人机料法环测）的模型勾选，为系统应用提供数据对象，包括数据字典、场站模型、设备模型、设备类型、状态管理和规则管理。

1）数据字典

这里的数据字典主要是指用户访问元数据的目录，以满足不同场景使用的一些基础数据定义，比如计量单位、产品类型、项目类型、指标名称等；数据分析过程中，当业务中有常量数据或者业务数据可以划分为业务事实表和业务维度表时，您可以通过使用数据字典来替代维度表实现，避免使用Join语句，从而提升查询效率。

数据字典又分为系统内置字典和扩展字典，内置字典由平台提供并维护，租户不能修改和删除，但可以对字典内的字典项进行扩展和管理，系统字典项不可修改删除，在页面左侧的字典列表名称前面的图标进行了区分，五角星图标的为系统字典，方块的为扩展字典。

2）场站模型

场站是一组设备的集合。本平台中的设备模型和场站模型都是物模型的一种，从逻辑抽象上没有什么区别，只是在具体业务场景中会有一些理解和使用上的区别，所以我们分成这两块功能。场站通常是设备的一种管理结构，具有一定的物理和管理属性，比如公司、项目、场站、工厂、车间等，每种场站可定义一个场站模型，在模型内定义场站的静态属性（如类型、规模、面积等）和动态属性（比如温度、湿度、气体浓度等），静态属性通常是用来描述物对象是什么的属性，数据一般不会经常变换，由手动编辑完成输入；动态属性通常是表达物对象现在怎么样了，数据来源于采集装置和数据通讯获取的，会根据采集上传频率动态变化；物模型还可以嵌套子模型，从而形成树形的模型结构，这样更容易表达标准化的业务场景结构，比如公司有多个工厂，工厂有多个车间等。

3）设备模型

设备模型的相关定义可参考场站模型，本节主要阐述设备模型的创建和管理操作。

新建模型：通过模型列表右上角的“新建”按钮，在弹出窗口填写角色相关信息；其中模型名称为英文，主要为了方便系统内的逻辑调用，显示名称可以为中文，用于在前端页面的展示，更易于用户识别；模型协议目前只有MQTT，未来平台可进行扩展；

导入模型：导入流程可参考组织成员导入，先下载导入模板，按格式修改后导入，注意操作提示信息，按步骤操作，在导入模板可以填入多个模型的数据，从而达到导入多个模型的目的；
编辑模型：可以编辑模型的基础属性、静态属性和动态属性；
静态属性：可单条新建，也可以导出导入批量操作，静态属性编辑信息中属性名称可输入中文易于辨识，是否可编辑是指该属性在后面的设备信息编辑时是只读还是可写；属性类型是指该属性在后面的设备信息编辑时的展现形式，也对应了值类型，比如文本输入框对应的是字符串，数值输入框对应的浮点或整型数据，如果是下拉单选多选、联级选择这些有选项的类型，就需要在选项内容中输入选项值，按Json格式填写；

动态属性：即模型测点，可新建、导入、编辑和删除，另外还可以进行测点的分组管理，测点列表有2种展示形式，卡片列表和表格；测点卡片从上至下分别显示测点的展示名称、测点名称、测点分类；测点列表可按创建时间、名称和序号进行排序；

在表格视图中可以编辑测点信息、设置模型测点告警和删除操作；

测点分组：点击“测点分组管理”按钮，可进入测点分组的编辑页面，可以新建编辑删除测点分组名称，测点分组是全局的，所有模型都可共用；
测点类型：系统提供了5种测点类型，普通测点（根据频率,定时读取、存储、上送的采集点数据，一般为数值型的测点）、状态测点（有固定几种状态量数据的测点）、开关控制测点（可写入开关控制值的测点，一般为开、关2个测点值）、范围控制测点（可写入范围起点和终点值的测点）和重置控制测点（一般为可写入一个固定值的，用于复位的测点）。其中状态、开关、重置测点可以和光字牌颜色显示关联，在后面的设备详情的数据看板里面的测点卡片就可以显示不同的颜色；光字牌颜色有三种，正常、预警和故障，对应蓝、橙、红三色，目前由系统提供，后期可开放给租户自定义；

4）规则管理

规则引擎是可视化的系统数据逻辑处理工具，可自定义数据处理规则编排，以及可视化的场景联动规则配置。

规则引擎的应用场景：

虚拟测点：经过筛选条件引用实际测点的数据，进行算式计算后的结果输出为虚拟测点的值；
告警规则：以实际测点、虚拟测点、记录值、属性值作为变量，参与算式计算的结果满足判断和生成条件后输出告警；
联动规则：以实际测点、虚拟测点、记录值、属性值作为变量，参与算式计算的结果满足判断条件后按时按序输出控制参量；

规则引擎根据业务规则中所包含的各种执行条件，在运行时匹配该条件，判断某些规则是否能够执行，如果能够执行，则执行规则中所规定的动作。因此，规则和描述规则的条件信息是规侧引擎的核心。对于业务规则的处理包含如下的过程：信息服务接受事件并将其转化为信息元然后这些信息元被传给队列管理器，最后规则引擎接收这些信息元并应用它们自身携带的规则加以执行，直到队列管理器中不再有信息元为止

基于规则引擎的规则定义和管理，包括告警规则、联动规则2种规则类型，可以在规则列表统一进行管理。

新建规则：新建编辑规则主要包括基础信息、监听时间、触发条件、执行动作，告警规则要多出一个告警设置；

生效范围：主要是指规则在哪些场站内生效；
监听时间：是指规则生效的时间段，可以是一直生效，也可以按一定周期循环；
触发条件：可以按设备模型或指定设备选择测点，然后根据测点值的阈值或多个测点的逻辑运算结果来触发；触发条件可以创建多条，多个条件情况下可以选全部或任一条件满足来触发执行动作；
触发机制：在触发条件这里有个触发机制的开关，主要用来过滤一些由于数据抖动产生的无效告警；
执行动作：包括生成告警、消息通知、设备联动，后期会加规则和工作流事件的输出；生成告警的等级目前有4种（紧急、重要、次要、提示），消息通知目前支持站内信、短信、邮件、微信和企业微信，要注意消息通道和模板需要先配置，配置方法请查看消息中心相关章节；
告警设置：针对告警的处理规则，可以设置告警的恢复和确认、重复告警和告警升级的操作逻辑；

7. 监控中心

1）集控地图

主要用于设备地理位置查询、设备状态和告警信息的整体监控。

点击地图左上角的菜单按钮，可以展开设备列表，列表以行政区域加场站的树形结构展示，方便查询查看；还可以通过搜索框以设备名称、设备编号方式搜索具体设备；

列表选择或搜索到具体设备，地图自动聚焦到设备所在位置，设备标点的颜色显示设备状态，在线为蓝色、告警红色、离线灰色；搜索框右边的按钮上的数字对应状态的设备数量，点击该按钮则会在地图显示该状态的所有设备位置；右侧上面为设备状态的相关统计数据，下面为未确认的告警列表；

2）视频监控

在设备或场站上绑定过视频，在视频监控左侧列表中会显示出来，选择场站节点，在右侧展示相应节点的视频列表，点击视频进行实时播放或全屏播放，目前只支持一路实时视频，所以点击另外一个视频，之前视频就会停止播放。

3）数据查询

可查询所有绑定过模型的场站和设备的测点数据曲线和历史数据表格，左侧是测点列表，可以选择场站、设备，然后选择需要查询的测点，支持多个测点曲线的对比，并支持测点数据的导出，在自定义时间跨度查询时要注意不要过长，当查询数据超过1万条时，系统会限制而无法查询到结果，查询数据曲线和表格支持极值显示，勾选后会显示极值标签。

8. 场站管理

场站管理属于项目管理的范畴，场站是一组设备的集合，场站是树形分支结构，根据业务不同，能够做节点类型、类型层级和属性的配置，可以定义公司、项目、场站、工厂、车间等不同类型；组织部门或成员跟场站和设备间可以绑定业务关系（运维关系、使用关系等）这种业务关系也属于权限管理范畴。

1）场站列表

新建场站：通过场站列表右上角的“新建”按钮，在场站编辑页面填写场站相关信息；其中场站类型可先在数据字典里面配置好；所属场站从已创建的场站树形结构中选择；

编辑场站：新建完场站后可再编辑配置更多信息，包括场站模型、场站扩展信息、场站图片、场站视频和场站组态；场站视频主要支持绑定视频数据源，输入HTML和HLS格式的视频链接地址；场站组态是在应用编辑器中创建的组态页面，这里可以绑定组态页面的发布后地址；场站模型是可以绑定已创建的场站模型；

9. 设备管理

设备是工业生产场景下的主要业务和数据分析对象，设备管理也是整个标准应用的核心功能，有效进行设备管理的前提条件是先完成设备接入（参考设备接入相应章节）和设备模型配置。

1）设备列表

设备管理：可以新建、导入、编辑和删除设备，设备列表和设备二维码可批量导出；设备列表的列可以通过列表右上角的图标按钮弹出列项菜单控制显示隐藏；
新建设备：有两种方式新建设备，一是通过设备列表右上角的“新建”按钮，在弹出窗口填写设备相关信息的手动创建方式；二是通过“新建”按钮旁边的三角箭头弹出“导入设备”菜单，安装设备导入的流程批量创建设备；
位置数据来源：有的设备位置并非固定的，需要通过定位设备传回定位数据，位置数据来源就是选择定位数据测点；
通讯节点类型：直连设备，具有IP地址，可直接连接物联网平台，且不能挂载子设备，但可作为子设备挂载到网关下的设备；网关子设备，不直接连接物联网平台，而是通过网关设备接入物联网平台的设备；网关设备，可以挂载子设备的直连设备。网关具有子设备管理模块，可以维持子设备的拓扑关系，将与子设备的拓扑关系同步到云端。
编辑设备：编辑基础信息、扩展信息、通讯信息，绑定设备图片、设备视频和设备组态，扩展信息的字段来自绑定的设备模型，视频、图片和组态的绑定方式与场站一样；

2）设备详情

设备信息：左上角是设备名称、设备状态、设备二维码，中间展示设备图片、设备信息等；
设备状态：设备状态含有激活状态（已激活、未激活）、通讯状态（在线、离线）、运行状态（正常、告警、故障、停机、待机等）、工作状态（各设备定义不同，如空调的制热制冷），激活和通讯状态是系统状态，运行和工作状态可以由租户自定义；

设备数据：展示设备测点的实时数据和历史数据查询等功能；设备数据可以卡片和列表形式展示，测点卡片上信息包括测点名称、当前测点值、最后上报时间等，卡片颜色可以根据测点配置时的光字牌显示不同颜色；鼠标移到卡片上会出现三个图标按钮，分别是查看测点值曲线、测点告警设置和加关注；关注后的测点可以通过“只看关注”开关进行筛选；搜索框右边是测点分组的筛选按钮；

测点曲线：可展示测点实时曲线和最近时段数据曲线，也可自定义时段，另外通过右上角的图标按钮切换数据表格和曲线视图；

设备日志：设备详情的第三个标签页为设备日志，包括运行日志和操作日志；运行日志主要跟设备运行相关的记录情况，事件类型包括上线、离线、告警；操作日志是跟设备编辑和操作相关的事件记录，包括设备创建、修改和控制；

3）网关管理

网关（Gateway）设备又称网间连接器、协议转换器，是多个网络间提供数据转换服务的通讯设备，用来连接真实设备和云平台的数据交换，进行数据上传和指令下发，有的网关设备还具备简单逻辑判断和执行；这里网关管理主要是对分配到租户下网关设备的相关信息、状态、流量等进行查询和编辑。

网关列表：包括网关通讯状态、网关名称、SN和IMEI等；连接设备是指通讯连接到该网关下的设备，如何配置网关下连接设备，请查看设备接入相关章节；
网关详情：查看网关信息和连接设备情况；网关近似位置是根据流量卡的基站定位信息，所以与实际设备位置会有所偏差；

网关配置文件：在网关配置的实施和后期运维过程中会使用到网关配置文件，在这里可以与网关的配置文件同步、备份和还原；
连接设备：查看连接到该网关的设备清单，包括设备的相关信息；

4）流量卡管理

查询流量卡流量使用情况、位置和绑定网关等信息，流量卡与网关的创建和管理是在平台的运维后台，租户这边主要是查询信息。

可以在流量卡列表中搜索卡号，根据卡类型和卡状态筛选，或者根据剩余流量查询等；在流量卡所在位置这里，如果要获取最新位置，需要点击一下刷新，刷新卡位置，每天每卡限3次；

10. 告警管理

告警主要是由告警规则生成的告警记录，告警规则的配置，包括告警等级在前面阐述过，这里主要做查询、确认和删除操作。

1）告警列表

告警状态：告警有发生、恢复和确认、未确认的组合状态，在告警规则中可设置
确认告警：在操作栏点击“确认告警”图标按钮，告警状态会置为已确认；

11. 消息中心

平台内的消息包括了告警消息、业务消息和系统消息，告警消息主要来源设备测点的告警消息，业务消息主要是应用内定义的需要提醒成员的消息，例如工单消息、审批消息等。

1) 消息列表

消息列表其实有两种展现形式，一个是通过左侧菜单进入的消息列表页面，这个是记录比较完整的消息列表，主要用户历史记录的查询和导出等；一种是在导航栏右侧的消息图标点开的消息侧边栏列表，主要展示最近时段的消息，这个展示会比较方便查看最近发生消息事件。

2) 消息通道

消息通道是用于不同消息类型的消息服务配置，连接不同消息服务平台的接口服务，目前支持配置微信和企业微信的消息通道。

新建消息通道：通过列表右上角的“新建”按钮，在弹出窗口配置相关信息，通道的配置信息需要在微信公众号和企业微信的管理后台内获得；
获取微信公众号配置信息的方法：1）进入公众号首页，点击左侧的设置与开发选项；2）在二级菜单中，选择基本配置选项；3）进入详细页面，即可看到公众号AppID和AppSecret。
获取企业微信配置信息的方法：1）登录企业微信管理后台https://work.weixin.qq.com/login；2）页面底部创建时间下面那栏就是企业微信ID；3）操作路径「企业微信管理后台」-「应用管理」-「应用名称xxx」, 点击API，获取AgentId和Secret;

3) 消息模板

消息模板是消息内容的格式模板，可以嵌入变量，格式为，不同通道的内容可以设置同一个变量，创建成功后，在使用模板发送消息时，仅需要对变量赋值即可，传递一个变量即可适配多个通道，比如设备名称、ID等。

# 标准应用使用说明

# V1.0

# 1. 应用简介

# 2. 基本概念

# 3. 创建标准应用

# 4. 组织管理

# 1）组织架构

# 2）组织成员

# 3）用户组管理

# 5. 权限管理

# 1）角色管理

# 2）权限管理

# 6. 业务建模

# 1）数据字典

# 2）场站模型

# 3）设备模型

# 4）规则管理

# 7. 监控中心

# 1）集控地图

# 2）视频监控

# 3）数据查询

# 8. 场站管理

# 1）场站列表

# 9. 设备管理

# 1）设备列表

# 2）设备详情

# 3）网关管理

# 4）流量卡管理

# 10. 告警管理

# 1）告警列表

# 11. 消息中心

# 1) 消息列表

# 2) 消息通道

# 3) 消息模板