第3节 “对象模板”的使用方法

（一）创建模板

我们先为机组对象创建模板：

保存后，可以看到创建的模板项目：

刚才创建的这个模板项目，还只是一个模板的组织形式，还需要把每个模板项创建好，放到这个模板项目里面。

打开详情：

在列表中看到这个模板，说明我们已经创建好了各种模板项的一个容器。

打开详情，就可以看到这个模板容器里面的模板项：

先来了解一下，模板项的布局形式是什么样子的：

打开详情后就可以看到，对象模板的模板项都列举在左边的模板项列表中。

选择某模板项标签后，该模板项的内容，都在右边的区域内。

【A】添加，手动创建模板项内容；
【B】导入，从某个“模板项文件”导入来创建模板项内容，这样就无需手动创建；
【C】从已有项目选择，就是直接把已经有的东西变成模板项；
【D】同步配置，如果模板项的内容有了修改，则可以通过这个同步配置操作，去把该模板项生成的所有实例，进行同步的更新。这样避免了手动逐条去修改更新可能产生的错误和疏漏。

（二）模板项

一个对象模板需要容纳多少个模板项，是根据实际需要来确定的。

（1）模板项–映射表

映射表是对象模板中最重要的一个模板项。

对象模板的映射表模板项，可以通过三个方式来创建映射表模板项：

第一个方式，就是手工去 “添加”，这有点类似在 “对象管理” 中重新创建一个新的映射表：

跟在 “对象管理” 里面创建一个新的映射表是一样的：

第二个方式，是通过导入一个 “映射表模板项” 文件。这个 “映射表模板项文件” 是怎么来的呢？ 这是来源于 “对象管理”，任何一个映射表，都可以通过操作菜单 “导出模板项”，导出映射表模板项文件：

导出后，可以在 Downloads 目录看到这个模板项文件：

可以打开看看这个文件的样子：

点击 “导入”操作：

直接选择“映射表模板项”的导出文件就行：

第三个方式，是直接从已有的映射表（项目）中选择：

现在来讨论一个问题：为什么会有 “导入映射表模板项文件” 和 “从已有的映射表项目中选择” 这两个方式？

事实上，我们不难看出，“从已有的映射表项目中选择” 这种方式来完成映射表模板项的创建是最简单的。这也非常符合常识，就是从已经有的东西里面，选出一个作为 “模范”，这个模范就是 “模板项”。

如果模范是之前做好的，已经存在于 MixIOT 系统里面，那么最简洁最直接的方式当然就是从已有的东西中选择。如果把已有的模范先导出成模板项文件，再把这些模板项文件导 入进来，这似乎是多余的。

如果这样假设，假设SERG（三普能源集团）的姊妹公司 KERG（凯特能源集团）跟 SERG 一样也运营多个瓦斯电站，它有更好、更优的映射表，也愿意拿出来与SERG分享，这时候就可以导出这个映射表的模板项文件，把这个映射表模板项文件分享给SERG。SERG集团的MixIOT系统管理员拿到这个映射表的模板项文件，直接导入就行。

所以，现在应该理解，“导入” 这个方式，实际上是为了来自外部的模板项而准备的。

这里可以选择已经有的映射表项目作为该对象模板的模板项：

确定后，所选择的映射表的信息和脚本就被导入进来了。

检查无误后，给这个“映射表模板项”设定一个名字和别名：

确定保存：

当看到这个画面的时候，说明映射表模板项已经成了。可以点击 “编辑” 修改这个映射表模板项的属性或映射表脚本。

我们注意到，映射表模板项的操作中，并没有 “删除” 操作。也就是说，一个对象模板的映射表模板项，一旦创建就不能删除，只能修改。

右上角的 “同步设置”，是一个从“模板项–>模板生成实例”方向上的同步更新。意思是如果这个映射表模板项修改了，那么点击这个 “同步设置” 按钮，就可以让所有的由这个模板生成的对象都会得到同步的修改。

（2）模板项–控制码

一个对象模板中，只有 “映射表模板项” 和 “控制码模板项” 这两个模板项，是 “单模板项”。所谓 “单模板项”，就是在一个对象模板中这个模板项只能有一个。

这是因为按 MixIOT 体系的规则，每个对象只能对应一个 “映射表” 和一个 “控制码”。

控制码模板项，对应的是 “对象管理” 应用中的 “控制码”。

还是跟 “映射表模板项” 一样，从已有的控制码项目中选择一个：

确定后，就完成了控制码模板项的创建。

（3）模板项–历程模板项

从详情中进入历程模板项标签：

“历程模板项” 跟前面两个模板项（“映射表模板项”和“控制码模板项”）都是单模板项不一样，这个模板项是多模板项。

可以选择两个历程项目放到这个对象模板里面来：

（三）理解对象模板

我们回到已经创建的对象模板：

这个对象模板中，现在已经有三个模板项，分别是“映射表模板项（单）”和“控制码模板项（单）”以及“历程模板项（两个）”。

对象模板的操作，除了我们熟悉的“详情”、“编辑”和“删除”，还有其他的几个内容：

（1）导出

导出就是把整个对象模板的模板文件导出：

这个对象模板文件，实际上是包括了三个部分：“映射表模板项”、“控制码模板项” 和 “两个历程模板项”。

前面解释过，可以在 “对象管理” 应用中单独导出 “映射表模板项文件”、“控制码模板项文件” 和 “历程模板项文件”，所以，很容易理解为：

对象模板文件=Σ所有模板项文件

假设这个对象模板完整做好了，那导出的对象模板文件，就可以分享给其他的 MixIOT 用户。

正因为有了这个模板文件（脚本）的标准化，MixIOT 将会为不同的专业领域提供一些标准的对象模板，为 MixIOT 的客户快速实现 MixIOT 的项目实施。

（2）复制

对象模板复制的目的，就是为了省事。也就是说可以通过 “复制” –> “修改” –> “保存” 的方法，快速创建相近的对象模板。

（3）创建实例

对象模板的目的，就是为了创建模板实例：

这个对象模板，已经有了 “映射表模板项” 和 “控制码模板项”：

来看看如何创建对象模板的实例：

展开看，有4个内容需要完善，分别是：

映射表实例：

控制码实例：

历程实例：

需要完善这些信息，包括名称、别名和描述。

现在要清楚的是，从这个对象模板创建实例最终得到的结果是什么？其实答案是很容易理解的，就是给出上述名称、别名的 “一个映射表”、“一个控制码”和 “两个历程项目”。

（四）完成对象模板

前面深入讲解了对象模板的原理。接下来继续完成整个模板的其他模板项。

（1）显示板模板项

我们选择机组运行监控显示板作为模板项：

按 MixIOT 的规则，每个对象只能对应一个 PRO显示板、一个大屏显示板以及一个 App显示板。

所以，每个对象模板中显示板模板项最多只能有三个显示板，PRO、大屏和App显示板各一个。

选择后，点击 “确定”，导入该映射表的内容：

（2）离线数据与离线常数模板项：

除非是本系统外部导入的模板项文件， 一般来说，如果 “离线数据” 和 “离线常数” 在本系统中已经有，那这两个模板项是不需要的。

（3）统计模板项

SERG现有的统计项目，在运营中都发挥着重要的作用，我们从中选择了2个机组的日统计项目进入这个对象模板的模板项：

这两个统计分别是：

都是机组运行时间的日统计，一个是运行时间统计，一个是正常运行时间统计。这两个统计项目，可以参考 “统计计算” 一章的说明。

（4）计算模板项

计算项目的模板项，可以选择的有两个：

看一下这两个计算项目的情况：

如果要增加计算模板项，还必须要对模板项进行修改：

所以，暂时还不能添加计算模板。

要注意的是，Mixiot V8 的某些部署版本中，对象模板中有可能并不包括 “计算模板项”。这是因为计算的表达式是不可能完全一致，无法完全复制。

（5）稳定性分析模板项

选择数据分析（机组稳定性分析）作为模板项：

这个稳定性分析项目是可以选择成为模板项的：

看一下这个分析项目：

这个分析的对象，是机组对象。机组的映射在这个模板中已经有了，所以这个分析项目是可以收录到这个对象模板里面的。

（6）对象模板与实例

刚才完成了对象模板的创建：

通过查看这个对象模板的详情，就知道这个对象模板包括了哪些模板项：

意思是说，如果我们现在创建这个对象模板的实例，将会看到的结果是：

理解这个概念非常重要。

（五）创建对象模板实例

我们完成了编号为 OBT4571532700006（名称：瓦斯机组对象模板、别名：OBT4571532700006）的对象模板，现在就来真正创建实例。

前面说了，创建模板实例的时候需要填写该对象模板实例的名称、别名和描述：

这些留空的地方称为 “模板变量”，在创建实例的时候，是需要赋值（填写）的。

创建实例之前，还是需要对这个模板仔细检查，如果没有什么问题，那就可以放心大胆地去创建对象实例了：

（1）映射表实例

我们可以在 “对象管理”映 射表列表中看到，由对象模板创建的映射表实例：

创建方式为 “模板创建”，模板编号就是该对象模板的映射表模板项编号：

（2）控制码实例

控制码实例也是一样，创建方式是模板创建：

对应的对象模板的模板项是：

（3）显示板实例

由对象模板的显示板模板项创建的显示板实例：

看详情里面，所关联的对象是空的：

对应的模板项是：

（4）统计实例

统计实例有两个：

第一个统计实例的关联对象是空的：

第二个统计实例的关联对象也是空的：

对应两个统计模板项：

（5）历程实例

历程实例也有两个：

实例1，关联对象是空的：

实例2，关联对象也是空的：

对应的两个模板项也是两个：

（6）稳定性分析实例

这是一个代表性的实例创建：

该实例关联的对象是空的：

对应的模板项是：

在这里要留意的是，这些实例的关联对象是空的，也就是说到目前为止，这个“ 对象模板” 还没有对象，这就是我们要做的最重要的事情。

（六）创建对象

完成了对象模板的实例创建后，接下来的工作就是要创建对象了。创建对象的地方只有一个，还是“对象管理”应用：

创建对象有两个方式：

普通方式

通过“＋添加”创建对象的方式，就是“普通方式”。普通方式创建对象，选择的是“映射表”。到目前为止，“对象管理”应用里面的所有对象，都是这样创建的。这里需要认识到，用“普通方式”创建的对象，仅仅是创建了对象。

模板方式

另一个方式是从 “模板” 创建对象，这是 “模板方式”。用 “模板方式” 创建的对象，选择的是 “对象模板”。这里需要建立新的概念，用 “模板方式” 创建的对象，除了所创建的对象本身， 而且会把所创建的对象，添加到该对象模板所包含的模板项实例。简单地说，就是把创建的对象，塞到前面通过模板创建的显示板、统计、历程、稳定性分析等项目里面。

如果用普通方式去创建对象，当然也可以选择由模板创建的映射表：

但即便选择了这个映射表，用普通方式创建对象的结果，也只是创建了一个新对象。

如果用模板方式创建对象，选择的是对象模板：

这个时候所创建的对象，除了这个对象本身，这个对象的控制码就是该对象模板的 “控制码模板项” 的实例。

除此以外，刚才前面特别说到的 “对象是空的” 这些应用的项目里面，都会有了这个创建的对象。

无论用什么方式创建对象，当然还是要先做好其他的准备， 比如客户/项目的备案登记，数据终端的备案登记等等。

（1）模板方式创建第一个对象

用模板方式创建第一个对象：成峰1#机组：

点击 “从模板添加”：

选择对象模板，填写相关的内容：

完善这些输入后，确定保存，就完成了这个对象的创建：

这里面很清楚地显示，该对象是由对象模板创建。

（2）统计模板项实例

这里有两个统计实例，看看里面的关联对象：

这两个统计项目，“从模板添加” 对象后，所创建的对象已经被添加到这两个统计项目里面去了。

（3）历程模板项实例

历程模板项也有两个：

对应的实例也有两个：

每个历程项目的关联对象，也包含了用模板创建的对象：

（4）稳定性模板项

该对象模板的稳定性模板项：

对应的实例：

该稳定性分析项目实例的关联对象，也有用模板创建的对象：

（七）对象模板的修改

在完成了对象模板实例的创建工作后，“创建实例” 的操作项变成了 “不可用”。

也就是说，从 “对象模板” 整体来看，如果该模板创建过模板实例，就不允许再次创建。即便对该对象模板的属性进行编辑修改，也不能再次创建实例。

但还是可以对某个（或某些）模板项进行修改：

如果对象模板中的模板项没有经过编辑修改，该模板项的 “同步” 操作是不可用的：

如果对象模板中的某个模板项经过编辑修改，可以通过 “同步”，把已经创建的实例进行修正，保证改实例与模板项一致。

比如，我们增加了一个统计项目：

创建了这个新的统计项目后：

这个 “同步” 操作就变成了可用。如果这个时候进行同步操作，该操作就会去创建一个新的统计项目实例。

“对象模板” 应用是 MixIOT 系统中最复杂的一个应用。

智物联将会在 “智物联工业云” 发布一系列的行业模板，简化 MixIOT 工业互联网系统的落地实施和使用。