开发者中心

SaaS集成

概述

QuarkIoE上的“Zapier附加”可以帮助你把现实生活中的数据从你的资产上服务于ERP,CRM以及其它企业IT系统。 也能使你从那些服务来远程控制你的资产。“Zapier附加”通过物联网有效地连接超过350家IT服务,比如:

  • 将机器维护告警发送到CRM系统
  • 将销售信息从自动售货机发送到企业ERP系统
  • 将生产数据转成EXCEL格式来分析
  • 创建格式以支持设备主数据的手动维护
  • 通过对互动标准的自动化比如从帮助工具重置机器等来提升客户服务。

本章节描述了怎样通过把QuarkIoE和Zapier Zapier有效地结合来轻松地实现上述内容以及其它要求。

本章节所有案例都需要一个Zapier账号,你可以从 https://zapier.com 免费获取。

在Zapier应用中访问QuarkIoE

如果你想访问并试用这个APP,请通过support@quarkioe.com联系我们

它是如何工作的?

Zapier附加通过两种方式把QuarkIoE和企业IT服务相连接

  • 你可以把数据从传感器网路或者从QuarkIoE发送到那些IT服务
  • 你也可以把数据从IT服务发送给QuarkIoE以及传感器网络
从物联网到企业IT服务

如欲发送数据到企业IT服务上,你需要在QuarkIoE上设置CEL语句(或者某个你已有的智能规则)以及在Zapier上有一个Zap,如下描述:

Triggers
新的智能规则事件

新的智能规则触发器让你能在执行智能自动规则时增加额外的行动(比如门限规则产生门限告警) 使用这个功能前请确认你已经在QuarkIoE上创建并激活了自动化规则 在QuarkIoE账号和触发器绑定之后,你就可以指定你的智能规则了。

QuarkIoE帐户
输入 描述
智能规则类型 你想触发的智能规则类型
语句 你想触发的智能规则语句,很多智能规则支持多触发器语句
智能规则 你想从QuarkIoE触发的语句。如果没有显示则表示那一类的智能规则你还没有创建。

所有的输入都有下拉菜单显示

在测试步骤,Zapier会提供案例来展示Zapier怎样接收数据

新的CEL事件

新的CEL事件触发器提供了更通用的方法来转发你的任意CEL模块的语句到Zapier。 在使用此功能之前你需要在QuarkIoE上部署你的模块。

在把你的QuarkIoE账号和触发器绑定后,你就可以指定你的CEL模块了。

跨克帐户
输入 描述
模块名称 在QuarkIoE上的CEL模块
语句名称 CEL模组上你想触发的语句
是否是通道? 你想在语句上监听还是在通道上监听

在测试阶段,Zapier会提供案例来展示Zapier如何接收数据但结构完全取决于你的CEL语句是什么样的。因此有可能案例里的某些字段在你的CEL语句中并不存在。

想对触发器了解更多, 你可以在 example里看看

从企业IT服务到物联网

Zapier附加提供了众多的Zapier操作来支持从QuarkIoE发送数据到受控于QuarkIoE的设备。现在支持的操作如下:

  • 新的设备
  • 更新库存
  • 创建操作
Actions
新设备

“新设备”让你可以注册一个新的设备以便于你直接连接。设备ID(IMEI,序列号)和你通常在“设备登记”用户界面里相同。

Device Registration
更新库存

“更新库存”使你能够创建并更新QuarkIoE库存里的资产。可以定义如下参数:

输入 描述
身份 资产的技术标识符
名称 操作人员可读的资产名称
片段 创建或者更新的片段类型
数据 该片段数据作为键和值的列表
是否是设备 标记资产作为设备的标识。比如说,当点击“所有设备”时,所有的资产就显示出来了

使用如下流程,资产会在库存里被定位:

1 设备ID会被转化成资产ID, "Zapier附加"会检验是否有一个现有的资产和分配的资产ID 2 资产ID会被转化为QuarkIoE全球ID,"Zapier附加"会查看资产和这个全球ID。 3 名称是用来发现资产和匹配的名称

任何上述一个步骤成功了,则检索的资产是被更新了的,如果发现不了,就会创建一个新资产。

Inventory
创建运营

“触发设备重启”会发送给设备一个重启的操作

输入 描述
身份 设备的技术标识符
名称 操作人员可读的设备名称
描述 操作描述
片段 将被添加到操作中的片段
数据 该片段作为键和值的列表

通过上述所示的“设备更新”操作中一样的三个步骤的机制,设备将得到认证。

Operation
在Zapier里配置QuarkIoE账号

每一次触发或者动作都要求你添加一个有效的QuarkIoE凭证。如果你是第一次用QuarkIoE连接来创建Zap,你需要连接到一个新的账号上,然后在随后的对话框里输入你的QuarkIoE凭证。

QuarkIoE帐户

举例

有关Zap设置的详细信息,请访问:https:/zapier.com/help/.要注意的是Zapier计划对传输的数据量进行限制。超过限量的数据传输会导致你的Zap暂时停用。

在Google的表格里储存CEL数据

在第一个例子里,我们把QuarkIoE和Google表格相连并且把现场测量值从你的账号发送到表格里。你可以使用测量值来做特定分析,比如,比较两个不同设备的性能表现。这个案例由四个步骤组成。

要运行这个案例, 除了Zapier账号你还需要一个谷歌账号。如果你没有,访问:https;//google.com点击“注册”然后点击“创建新账户”。我们假设你的账号里有一些默认的模拟设备再运行。

打开QuarkIoE管理应用程序,单击“事件处理”然后选择“新模块”,然后命名你的新模块为“zapier”,在“案例”下拉菜单里,选择“发送模拟文档给zapier”,点击“保存”按钮。你的屏幕应该想如下截图所示。

Sample CEL statement

上述语句选择了你账户里所有温度测量值,也赋予它们‘Zapier附加’格式。语句的输出会被打印在语句的旁边。如果你有默认的模拟器配置运行,它会开始显示数值。关于语句的更多信息,请访问“实时处理”Real-time processing

你需要创建一个表格以备留存之后从QuarkIoE传来的数据。访问 https://docs.google.com, 点击“新增”然后选择“google表格”。点击屏幕上方的“无标题表格”上的文字然后命名这个表格,比如“测试表格”。在表格里,创建一个标题行和一行如下图所示的样本数据。标题行和样本数据会被Zapier用来简化你的“Zap”设置, 比如你的新的系统集成

Sample spreadsheet

关于在Zapier上使用表格的更多信息,请访问https://zapier.com/support/questions/2301/using-zapier-with-google-docs/

现在,你可以设置你的Zap了

  • 选择“QuarkIoE”作为“触发器app”
  • 选择“新CEL事件”
  • 在Zapier里连接你的QuarkIoE账号(如果你之前已经连接过,直接选择就行)
  • “模块名字”输入框里输入Zapier,在“语句”输入框里输入“模拟器温度”
  • 在右侧选择“google表格”作为“动作app”
  • 选择“创建表格行”
  • 在Zapier里连接你的google账户(如果之前连过,直接选择)
  • 从下拉菜单里选择你的表格和工作表

所有步骤完成后你的屏幕看起来应该如下截图所示

Example 1

在Zapier里激活Zap然后打开表格来查看数据从模拟器流入

Result
从表格里登记设备

在这个案例里,我们假设你一直有一个表格来追踪你的设备,他们的IMEI号,他们的SIM卡以及他们部署的位置-“一个穷人的资产管理”。 每当一个新设备进入这个表格,它应该是自动地完成QuarkIoE的设备登记。然后你可以对设备加电并和你的账户配对。

第一步,你需要准备一个如下面截图那样的表格。在这个案例里,“IMEI”列是需要登记的设备识别符号。

Device spreadsheet

现在你可以设置你的Zap了

  • 选择“google 表格”作为“触发器app”
  • 选择“新表格行”
  • 在Zapier里连接你的google账户
  • 从下拉菜单里选择你的表格和工作表
  • 在右侧选择“QuarkIoE”作为“动作”
  • 选择“新设备”
  • 在Zapier里连接你的QuarkIoE账户(如果你之前连接过,就直接选择)
  • 从区域列表里选择“IMEI”列输入到“设备ID”输入框

所有步骤完成后你的屏幕应该看起来如以下截图

Example 2

测试Zap并且打开它,输入新设备到你的表格里

Enter device

稍等片刻,设备ID就会出现在QuarkIoE“设备登记”对话框里

Device registered

需要注意的是,依据你的Zapier计划,这一过程可能需要最长到15分钟直到Zapier读到了表格中的变化。

现在你可以使用这个设置了。 比如,你可以引入一个工作流列来显示设备状态(已订购,库存,在周转,生产中等),并且只有当此设备在周转中时才登记。

使用一个表单在库存里输入客户

这个案例里,我们用wufoo表单来更新QuarkIoE库存。

为了运行这个案例,你需要Wufoo账户Wufoo account

打开Wufoo表单生成器然后为你的库存输入创建一个表单。比如,我们在库存里创建客户联络单,然后保存这个表单

Wufoo form

现在,你可以设置你的Zap了

  • 选择“Wufoo”作为“触发器app”
  • 选择“新键入”
  • 在Zapier里连接你的Wufoo账户
  • 从下拉菜单里选择你的表单
  • 在右侧选择“QuarkIoE”作为“行动”
  • 选择“更新库存”
  • 在Zapier里连接你的QuarkIoE账户(如果之前已连接,直接选择)
  • 从Wufoo表单里填充数据字段到更新库存输入框中(如下面截图所示)

这种情况下,我们为每个进入Wufoo的客户创建一个新的入口,因此,这个入口ID可以作为在QuarkIoE里的资产ID.至于名字,我们使用联系人的名和姓。“数据”包含了你可以使用的剩余表格的键/值列表。这些键/值存储在QuarkIoE的"c8y_Contact"片段里。你可以设“是个设备吗?”来看在设备管理应用当中输入的数据(即便你的联系人不完全就是设备)

Wufoo Zap

完成所有步骤后你的屏幕应该如下截图所示。

Example 3

扩展

Zapier提供了一个内置的叫“Webhooks”操作来发送纯REST命令,你可以使用此操作来发送任何数据到我们已记录的API。

对功能还有更多疑问?请通过邮件联系我们