開(kāi)發(fā)指南：D3 Engine使用說(shuō)明

D3 Engine，全稱 Dynamic Data Director Engine。

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

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

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

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

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

1.項(xiàng)目列表

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

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

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

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

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

2.配置

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

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

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

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

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

3.編輯推送平臺(tái)

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

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

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

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

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

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

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

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

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

邏輯規(guī)則

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

四則運(yùn)算

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

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

APP推送

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

HTTP請(qǐng)求

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

郵件

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

短信推送

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

控制設(shè)備

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