设备灯号管理
# 设备灯号管理
# 1. 说明
- 以下是设备灯号管理在TaskRunner中实现的功能的自定程序，主要包含了初始化设备数据，更新设备数据，以及更新OEE图表数据。
- 灯号设备使用MQTT网关实现功能，可以向MQTT发送灯号变化的数据实现功能。
# 2. 设计程序
TaskRunner 的初始示例中包含有以下程序：
- fasterp2_oee_init：初始化灯号信息处理。
- fasterp2_oee_report：更新日报表的灯号数据信息。
- fasterp2_update：更新近期定时周期内有数据变化的单据。
下面介绍创建自定程序的流程。
点击
自定程序选项卡，在自定程序界面中点击新建按钮，打开新建程序界面。在新建程序界面，填写要设计的自定程序的基本信息。如下图所示。填写完成点击
保存按钮。
返回自定程序列表界面，选择刚才创建的自定程序，点击菜单栏中的
设计按钮，打开程序设计器界面。在程序设计器界面中输入自定程序代码，代码示例如下。完成后，点击
保存按钮。- fasterp2_oee_init：初始化灯号信息处理。
重复2、3、4步骤，依次更新以下的代码。
fasterp2_oee_update：更新近期定时周期内有数据变化的单据。
fasterp2_oee_report：更新日报表的灯号数据信息。
如需要测试效果，可在程序设计器界面中点击
运行按钮进行测试。
程序中定义的参数说明如下：
- fasterp2_oee_report：更新日报表的灯号数据信息。
| 名称 | 说明 | 是否必填 | 默认值 |
|---|---|---|---|
| date | 产生报表的日期 | 是 |
# 3. 调用执行
设计完成的自定程序可使用以下方式来调用执行。
# 3.1. RestAPI
使用浏览器或RestAPI 客户端，访问以下地址，执行自定程序调用。请将 {ip} 修改为运行 TaskRunner 主机的IP地址，{port} 修改为 TaskRunner WebSocket 服务端监听的地址。
http://{ip}:{port}?restapi=script&taskname=fasterp2_oee_init
http://{ip}:{port}?restapi=script&taskname=fasterp2_oee_update
2
fasterp2_oee_report需要自定义参数，参照以下方式执行。其中将 {} 标识的参数值替换为目标参数值。
http://{ip}:{port}?restapi=script&taskname=fasterp2_oee_report&date={date}
# 3.2. WebSocket
使用WebSocket客户端，连接至 TaskRunner 中的 WebSocket 服务端。向 WebSocket 服务端发送以下文本实现自定程序的调用。
{"action":"script","taskname":"fasterp2_oee_init"}
{"action":"script","taskname":"fasterp2_oee_update"}
fasterp2_oee_report需要自定义参数，参照以下方式执行。其中将 {} 标识的参数值替换为目标参数值。
{"action":"script","taskname":"fasterp2_oee_report","params":[{"name":"date","value":"{date}"}]}
# 3.3. MQTT
使用 MQTT 客户端，连接至 TaskRunner 连接的 MQTT 服务器。MQTT 客户端向 TaskRunner 订阅的主题发送以下文本实现自定程序的调用。
{"action":"script","taskname":"fasterp2_oee_init"}
{"action":"script","taskname":"fasterp2_oee_update"}
fasterp2_oee_report需要自定义参数，参照以下方式执行。其中将 {} 标识的参数值替换为目标参数值。
{"action":"script","taskname":"fasterp2_oee_report","params":[{"name":"date","value":"{date}"}]}