設備燈號管理
# 設備燈號管理
# 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}"}]}