開發(fā)指南：D3 Engine使用說明

D3 Engine，全稱 Dynamic Data Director Engine。

D3 Engine是機(jī)智云為開發(fā)者提供的傻瓜式的數(shù)據(jù)處理、開發(fā)引擎。D3 可以靈活定義數(shù)據(jù)的輸入，能將設(shè)備、用戶數(shù)據(jù)與外部第三方數(shù)據(jù)進(jìn)行有機(jī)整合，還可以支持腳本解析與自定義數(shù)據(jù)輸入，滿足不同開發(fā)者的數(shù)據(jù)處理需要。

主要特點(diǎn)如下：

1）多樣的數(shù)據(jù)源：支持自定義多種數(shù)據(jù)源，第三方公共數(shù)據(jù)甚至您的ERP系統(tǒng)的數(shù)據(jù)輸入。

2）強(qiáng)大的規(guī)則處理：基于決策樹算法支持靈活多重條件組合。

3）靈活的輸出：除了App推送、郵件、短信等服務(wù)，還可以支持回調(diào)服務(wù)以及存儲服務(wù)；存儲服務(wù)通過數(shù)據(jù)平臺的計(jì)算與開放API服務(wù)對各類應(yīng)用提供數(shù)據(jù)服務(wù)，降低各類應(yīng)用的開發(fā)成本以及面對海量數(shù)據(jù)的性能處理風(fēng)險(xiǎn)

1.項(xiàng)目列表

進(jìn)入D3 Engine，默認(rèn)進(jìn)入此產(chǎn)品的項(xiàng)目列表頁面。

項(xiàng)目列表為空時(shí)，頁面顯示如上圖。

【新建項(xiàng)目】：點(diǎn)擊后跳轉(zhuǎn)至新建項(xiàng)目頁面。
【APP推送配置】：點(diǎn)擊后跳轉(zhuǎn)至APP推送配置頁面。

項(xiàng)目列表不為空時(shí)，頁面顯示如上圖。本頁面顯示該產(chǎn)品所創(chuàng)建的所有項(xiàng)目(不包含通過調(diào)用接口創(chuàng)建的項(xiàng)目)。顯示字段為項(xiàng)目ID、項(xiàng)目名稱、動作類型、備注、是否開啟等。

【新建項(xiàng)目】：點(diǎn)擊此按鈕跳轉(zhuǎn)至新建項(xiàng)目頁面，可為該產(chǎn)品創(chuàng)建新項(xiàng)目；
【編輯】：點(diǎn)擊后進(jìn)入當(dāng)前項(xiàng)目頁面可進(jìn)行修改；
【刪除】：點(diǎn)擊此按鈕可將當(dāng)前項(xiàng)目刪除。
【是否開啟】：項(xiàng)目是否開啟按鈕。項(xiàng)目創(chuàng)建成功后默認(rèn)開啟。點(diǎn)擊關(guān)閉后該項(xiàng)目將不會被觸發(fā)。

2.配置

進(jìn)入D3 Engine，默認(rèn)進(jìn)入此產(chǎn)品的【項(xiàng)目列表】頁面，點(diǎn)擊【配置】進(jìn)入APP推送配置頁面。

當(dāng)前產(chǎn)品無綁定的應(yīng)用時(shí)，頁面顯示如上圖。

【應(yīng)用配置】：點(diǎn)擊后跳轉(zhuǎn)至應(yīng)用配置頁面，可創(chuàng)建新應(yīng)用。

當(dāng)前產(chǎn)品有綁定的應(yīng)用時(shí)，頁面顯示如上圖，列出該產(chǎn)品綁定的所有應(yīng)用。
iOS和Android類型支持配置推送，微信暫不支持。

【編輯推送平臺】：點(diǎn)擊后跳轉(zhuǎn)至APP綁定第三方推送的配置界面。

3.編輯推送平臺

此頁面可以為APP綁定百度推送或者極光推送。

應(yīng)用平臺：創(chuàng)建應(yīng)用時(shí)所選的類型iOS、Android、微信(暫不支持配置推送)
推送平臺：目前僅支持百度推送和極光推送兩種方式
推送Key和Secret：從百度推送或極光推送平臺申請的Key和Secret
證書類型：生產(chǎn)和開發(fā)兩種證書類型。iOS應(yīng)用須選擇證書類型(且應(yīng)根據(jù)所選證書類型上傳對應(yīng)證書至百度或極光推送平臺上)，Android應(yīng)用無需證書

輸入百度推送API Key、Secret Key或者極光推送App Key、Master Key綁定成功后效果如下圖：

再次點(diǎn)擊編輯推送平臺，可進(jìn)行解綁及修改操作。

4.新建/編輯項(xiàng)目

【返回】：點(diǎn)擊此按鈕，返回至項(xiàng)目列表頁；
【保存】：點(diǎn)擊對當(dāng)前所編輯的項(xiàng)目進(jìn)行保存(無法保存時(shí)會有出錯提示)；
【左側(cè)節(jié)點(diǎn)】：項(xiàng)目組成部分，不同類型的節(jié)點(diǎn)，使用拖拽的方式拖至中間空白區(qū)域。分為三類：輸入、處理方法、觸發(fā)動作；
【中間區(qū)域】：項(xiàng)目編輯區(qū)域，可拖拽頁面左側(cè)節(jié)點(diǎn)至此部分進(jìn)行項(xiàng)目創(chuàng)建和修改等操作；
【右下角三個圖標(biāo)】：可對頁面進(jìn)行縮小、恢復(fù)默認(rèn)及放大的操作(僅針對項(xiàng)目編輯區(qū)域有效)；

5.輸入節(jié)點(diǎn)

設(shè)備數(shù)據(jù)

使用接入機(jī)智云的設(shè)備的數(shù)據(jù)作為輸入。當(dāng)有報(bào)警或故障數(shù)據(jù)點(diǎn)時(shí)，設(shè)備報(bào)警或設(shè)備故障選項(xiàng)才會顯示。

自定義數(shù)據(jù)
使用自定義的JSON格式的數(shù)據(jù)作為輸入。

Schema：描述JSON字符串內(nèi)部包含的字段結(jié)構(gòu)?？梢允褂靡韵鹿ぞ呱?/jsonschema.net/#/
數(shù)據(jù)標(biāo)識名：用于引用此請求返回的JSON標(biāo)識。
更新間隔：不小于5s，請求的緩存過期時(shí)間。D3會將自定義數(shù)據(jù)緩存起來，每經(jīng)過一個更新間隔會重新獲取數(shù)據(jù)。

6.處理方法節(jié)點(diǎn)

邏輯規(guī)則

添加一個邏輯條件。比較參數(shù)可以是數(shù)據(jù)點(diǎn)值也可以是自定義的變量值。

四則運(yùn)算

添加一個由四則運(yùn)算表達(dá)式指定的中間變量。此處只能針對數(shù)值類型的數(shù)據(jù)點(diǎn)進(jìn)行四則表達(dá)式運(yùn)算。變量標(biāo)識請不要使用中文。

7.觸發(fā)動作節(jié)點(diǎn)

APP推送

規(guī)則觸發(fā)成功時(shí)，與設(shè)備綁定的APP用戶將收到一條推送消息。
此處可以編輯推送消息的標(biāo)題、推送內(nèi)容(可從參數(shù)中選擇自動替換的變量)、選擇推送應(yīng)用及消息類型，可以自定義推送的時(shí)間段。

HTTP請求

規(guī)則觸發(fā)成功時(shí)，向指定的API發(fā)送一個請求。在此節(jié)點(diǎn)中輸入要請求API的詳細(xì)參數(shù)。

郵件

規(guī)則觸發(fā)成功時(shí)，指定的郵箱將收到一封推送郵件。此節(jié)點(diǎn)定義郵件主題、郵件內(nèi)容及收件人信息。

短信推送

規(guī)則觸發(fā)成功時(shí)，與設(shè)備綁定的APP用戶的手機(jī)號碼將收到一條短信消息。Apikey和短信模板ID可以從云片獲取，此處會進(jìn)行校驗(yàn)。展開屬性可自定義消息接收時(shí)間。

控制設(shè)備

規(guī)則觸發(fā)成功時(shí)，該設(shè)備改變自己的狀態(tài)?？刂苾?nèi)容中以JSON格式填入，支持Raw和KV兩種格式。