《工業互聯網平臺綜合應用》/

工業APP零代碼應用1

工業設備報警維修APP《工業互聯網平臺綜合應用》/知識準備任務實施目錄0102了解根云積木，首先要了解工業互聯網APP

(以下簡稱工業APP)，工業APP是面向工業產品全生命周期相關業務的場景需求，把工業產品及相關技術過程中的知識、最佳實踐及技術訣竅封裝成應用軟件。?根云積木是一個APaaS平臺，可以快速搭建個性化的企業應用，用戶不

需要寫代碼開發就能夠搭建出用戶體驗上佳的銷售、運營、人事、采購

等核心業務應用，打通企業內部各環節業務數據，也能夠通過API和

Webhook和其他系統對接。根云積木介紹工業互聯網平臺綜合應用?根云積木通過封裝好的6個功能模塊的組合來構建一個應用，6個功能模塊分別為：根云積木介紹角色和權限自定義頁面工業互聯網平臺綜合應用輸入

文字統計圖表工作表工作流視圖

工作表：用于收集和存儲業務數據。

想錄入任何數據，都需要建立對應的工作表，例如員工表、客戶表、訂單表、庫存表等。

視圖：是業務數據的不同場景的展示頁面

，可以根據業務場景，操作人員展示出不同的數據。

角色和權限：控制成員的對業務數據增刪改查的操作權限。

工作流：可以實現業務數據的自動化處理和自動流轉。

統計圖表：用于統計多種維度的數據幫您分析做決策。

自定義頁面：可以放置快捷按鈕，統計圖表等，

常用于配置儀表臺，駕駛艙或工作臺。根云積木介紹工業互聯網平臺綜合應用工作表，

除了是一個在線Excel可以用來管理業務數據，表中每一行數據都可以進行討論協作，并支持分享到其他平臺查看，建立了工作表，基本的數據錄入、查詢、搜索、排序、篩選等能力就立即具備了。用戶可以通過Excel、

API向工作表寫入數據。如圖所示，單擊“應用項”，彈出有“工作表”

和“自定義頁面”的頁面，單擊“工作表”工作表的創建和使用工作表基本操作工業互聯網平臺綜合應用01如圖所示，彈出“新建工作表”的彈框。輸入工作表名稱，單擊“創建”，工作表的創建和使用工作表基本操作工業互聯網平臺綜合應用02字段的設置說明添加字段在左側控件區為字段選擇合適的控件，點擊+或拖拽到中間編輯區即可。注：工作表的字段限制在200個以內，分段字段和備注字段不計數。標題字段通常選擇具有明顯的唯一標識性的字段為標題字段。例如，當您查看通訊錄表時，標題字段應該選擇“姓名”字段，看到姓名，您就知曉是哪條記錄。鼠標放在字段上，就會顯示出操作按鈕。調整字段位置單擊字段不放鼠標，拖拽到期望的位置松手即可。列的布局即表中一行可以顯示幾個字段，最多4個字段，點擊【快速排列】快速設置列數復制字段有時兩個字段有很多重復的配置，則可以通過復制字段實現快速的修改配置。當把鼠標放在需要復制的字段上面，就會顯示復制控件，單擊即可復制。刪除鼠標懸停在字段上，就會顯示出刪除按鈕，字段刪除后，如果字段默認值、視圖篩選、工作流中用到了此字段，則會顯示為“此字段已刪除”字樣。恢復字段在編輯頁面右上角可查看回收站，可在回收站進行字段恢復。添加工作表字段。

工作表字段相當于Excel工作簿的列，不同的是，他具有特定的“類型”，允許您在每個記錄

中存儲豐富的內容。

下列關于字段的設置說明如下表所示工作表的創建和使用工作表基本操作工業互聯網平臺綜合應用0301編號。編號是自動遞增的計數編號，有以下幾個特性

編號方式：

如果是自然數編號，那么就從1開始遞增，如果是指定位數編號，則可以按位數補充不足的0。

位數：

例如，指定位數是3，,記錄編號依次是001，002...999。【當編號超出位數時繼續遞增】

，如果勾選，會自動增加位數，如果不勾選，則編號從1開始。

開始值：開始值代表的以哪個數值作為編號的基數。

例如，開始值設置為1，則第一條記錄的編號為1，后面的編號依次為2、3、4....，如果開始值設置為5，那么記錄的編號依次為5、6、7、8。

周期重置：

有些業務流水號可能會在某個周期內從新計算，例如餐廳的排號，每天都會從1開始。重置周期分為：「每天重置」、「每周重置」、「每月重置」、「每年重置」

。設置了重置周期以后，當達到重置時間時就會從初始值重新開始計數。設置的重置周期為「每天重置」

，初始值為1，明天添加的記錄又從1開始編號了。自動編號控件，

可以為每一條記錄自動生成一個自定義格式的流水號。

下面對4種規則元素進行介紹。自動編號設置工作表基本操作工業互聯網平臺綜合應用自動編號設置

02

創建時間。記錄的創建時間，可以選擇多種格式，也可以自定義格式。

常見的格式如年：YYYY；月：MM；日：

DD；小時：hh；分鐘：mm；秒：ss。其中，MM和mm分別代表的月份和分鐘，區分大小寫，其他規則不區分

大小寫。

03

固定字符。固定字符主要有兩種用途。

一種是用作連接符，例如，創建日期和編號之間，用-符號連接起來。另外一種是用于標識不同的業務，類似的業務可能用同一種流水號編寫規則，但是更好的區分不同的業務流水單號，可以給他們加上一個前綴的固定字符。例如，入庫單號的RK-001，出庫單CK-001。

04

引用字段。引用表單的字段，可以進一步的標識不同的業務。

支持引用多個字段。支持的字段類型有：文本、選項、時間、地區。工作表基本操作工業互聯網平臺綜合應用工作流?每項業務背后都有一套業務流程，例如產品研發流程、生成制造流程等。除了業務流程，還有為了控制風險的審批流程，例如采購審批、請假審批等。?工作流為業務流程和審批流程提供一個可自動執行的流程模型，通過分析拆解流程中的活動，達到自動化流程的目的，最終實現重復性的任務由自動化代替，減少人工操作，提高效率。?一條自動化工作流程

由1個觸發器

+

N個動作節點組成。動作節點是流程中自動執

行的操作，流程中需要進行的數據操作、通知、審批等任務都需要對應的動作節點

來完成。工作流介紹工業互聯網平臺綜合應用工作流的組成

一個工作流由觸發器和若干個動作節點組成。

觸發器是流程啟動的開關，通過多種類型的動作節點來完成各種任務，以此實現流程自動化。

一個簡單的工作流模型：當有新的工單提交，根據

問題類型，指定不同的負責人跟進。?觸發器：工單被創建或更改；?自動執行動作1

(邏輯分支)：分為購買咨詢和使用

咨詢兩個分支；?自動執行動作2

(更新記錄)：每個分支下執行的相

應的操作——修改負責人字段。工作流介紹工業互聯網平臺綜合應用工作流特點

工作流是一種新型的商業流程管理(BPM)工具，

它和傳統的BPM相比，有如下特點：?完全在互聯網上運行，可以接通外部數據源；?創建和維護的過程更為友好，不需要掌握艱深的

IT知識就能夠使用；?強調自動化的觸發和執行。工作流介紹工業互聯網平臺綜合應用

數據的自動化處理。

當數據變更滿足條件時，新增或修改其他表的數據。當設定的時間到達時，修改某些記錄的數據。

業務流程的審批控制。

銷售訂單、項目變更等業務審批；請假、用人、物品領用等事物審批。

通知內部和外部人員查看或填寫數據。

以系統消息的方式通知內部成員數據的變更，進行查看或修改；將記錄內容以郵件、短信的方式發送給外部用戶查看或修改。

和外部系統的數據對接。

將工作表的數據推送到外部系統；主動或被動的獲取外部系統數據，寫入或更新到工作表。工作流可以用來解決的信息化問題工作流介紹工業互聯網平臺綜合應用觸發方式

通過工作表觸發：

即當工作表中創建了記錄或更改記錄數據、刪除記錄時觸即可發流程。

例如：《費用報銷》表中有新的記錄產生，就觸發流程，通知領導進行審批操作。

定時觸發：

您可以設定一個循環周期時間，每當時間到達一個周期時間，都可以執行一次計劃動作。

例如：每個

工作日的晚上6點，給同事發送通知提醒：【下班時間到了，別忘了寫日報哦】

按日期字段觸發：

選擇工作表中的一個日期字段組成日期時間表，每當到表中的其中1個時間，就觸發流程執行

操作。

例如：《員工檔案》表中的員工生日(日期字段)，每到1個員工的生日當天，就給這個員工發送祝福短信。工作流介紹工業互聯網平臺綜合應用觸發方式

人員事件觸發：

當組織內有人加入或離職時觸發流程。

例如：單獨做了一個《員工管理》表，同步管理后臺中的

人員信息，當有人員離職時，自動觸發流程，在《員工管理》表中將其標記為“已離職”。

Webhook觸發：

工作表支持被動接收數據，

您其他系統有數據變更后，可以將變更的數據內容推送到平臺服務

器，服務器接收到推送消息后可以觸發工作流，然后自動執行計劃的操作

(新增一行記錄，發送一個通知消息等)，從而打通和其他系統的數據對接，提高業務效率。工作流介紹工業互聯網平臺綜合應用工作表事件觸發

通過工作表事件觸發，

即工作流會一直“監聽”某個工作表，一旦這個表有數據變更，就自動執行設置好的一系列動作。

每一個自動化工作流，都需要一個觸發動作來啟動，

它是流程的第一個節點，即發起節點，或者叫觸發器，觸發節點。

通過工作表事件觸發，需要配置3點內容：監聽的“工作表”、觸發方式、觸發條件?觸發的表：選擇一個工作表，觸發器會“監聽”此表的記錄數據，一旦某個記錄有數據變更，就能啟動工作流。?觸發方式：即工作表數據的變更方式，怎樣的變更才觸發工作流。是新增？修改？刪除？?觸發條件：僅篩選出符合條件的數據進入流程。工作流介紹工業互聯網平臺綜合應用觸發方式說明當新增或更新記錄時【選擇觸發字段】，只有選擇的字段被填寫或修改時才會觸發流程。這樣減少不必要的工作流執行。支持指定多個字段。如果不選擇，則表中數據有任何新增或更改都會觸發工作流。僅新增記錄時當有新記錄添加時，就能觸發流程。僅更新記錄時觸發僅已有記錄的內容被修改時觸發工作流，支持【選擇觸發字段】觸發。刪除記錄時觸發刪除一行記錄后，觸發流程。觸發方式說明如下表所示。工作流介紹工業互聯網平臺綜合應用定時觸發定時觸發方式：

您可以設定一個循環周期時間(例如每周一早8點)，每到達一個周期時間就會自動觸發流程。

場景舉例：員工打卡用的是企業微信，在明道云搭建了一個《員工考勤》應用中，每天9點和晚上9點從企業微信中同步下打卡數據，周六周日不用同步。那么我們就可以配置一個定時觸發的工作流，

設計好相關的觸發時間就能自動

同步數據了。每天18:00

自動為每個員工生成一條工作日志記錄，并發給員工填寫。工作流介紹工業互聯網平臺綜合應用參數說明開始執行時間開始執行時間，即第一次開始執行的時間，以這個時間為基準開始第一次循環觸發。默認當天8點整。結束執行時間如果流程不是永久循環執行下去，可以指定一個時間，到達指定時間后，流程就會自動關閉停用。循環類型循環：即循環的周期類型，可以是每小時、每天、每個工作日、每周、每月、每年、或者自定義的周期時間。1、循環的日期是依據您設置的開始執行時間的日期時間。2、工作日是周一至周五，同時不包含節假日，如果您需要的周一至周六，請使用

自定義周期。定時觸發相關參數說明如下表所示。工作流介紹工業互聯網平臺綜合應用Webhook觸發

工作表支持被動接收數據，

您其他系統有數據變更后，可以將變更的數據內容推送到服務器，服務器接收到推送消息后可以觸發工作流，然后自動執行計劃的操作(新增一行記錄，發送一個通知消息等)，從而打通根云積木

和其他系統的數據對接，提高業務效率。

Webhook觸發方式配置步驟為：①在工作表所在的應用下，創建工作流，選擇

Webhook觸發；②配置觸發方式。為每個應用生成了一個專門的URL用來接收其他系統發來的請求。點擊鏈接后面的按鈕，復制

此鏈接。③打開金數據中的《jin

-人員表》

。將上一步復制的URL粘貼到金數據的數據推送設置中，保存設置。④返回明道云，配置webhook的觸發參數列表。工作流介紹工業互聯網平臺綜合應用API

(APPlication

Programming

Interface，應用程序接口)，是軟件開發者將某個做好功能開放給外部人員使用

的一個窗口。外部人員無需訪問源碼或理解內部代碼處理細節，只需要按API規定的格式傳遞一些參數，即可獲取期

望的數據或執行期望的操作。API基礎知識平臺API介紹工業互聯網平臺綜合應用組成部分說明API接口地址即API接口服務公開給外部訪問的地址請求方式常用的有Get、Post和其他方式，這取決于API接口服務，無需理解，他們支持什么，我們選擇對應的方式

即可。請求的參數API接口根據你傳遞的參數處理對應的數據。例如，phone手機號就是一個參數授權認證方式在請求API時，不是誰請求都會處理，需要對您的請求做認證。常見的是token認證和key(有時還有會結合sign)。這些信息API服務商都會給到您。Header請求過程中需要傳遞的表頭信息，是系統級的參數，包含存儲認證信息Token的參數。一般情況下我們不需要配置，需要配置時，API文檔會特別說明。Body存儲傳遞的數據，它在請求方式為Post時才需要配置。常用來存儲表單信息，有時授權認證的參數也可以存儲在這里。例如，通過API接口，將一個表單數據新增到第三方系統，表單的字段名稱和字段值存放在Body中。API基礎知識什么是請求，API接口的調用，是通過一個URL地址傳輸的，URL打開一次就是一次請求，刷新頁面，又算一次請

求。請求API接口，其實就是打開訪問接口的URL，因此URL在請求時需要幾個組成部分，如下表所示，平臺API介紹工業互聯網平臺綜合應用外部數據通過Webhook寫入到工作表

工作流的webhook功能，即可以被動接收其他系統傳過來的數據，也能主動去獲取其他系統的數據，然后將獲取到數據寫入到工作表中。

配置Webhook：生成了一個用來接收請求的Webhook

URL，您只需將其他系統的數據

發送到這個URL即可。

點擊復制鏈接，將URL配置到您的系統中。

配置數據的請求參數列表有已發送請求范例、自定義參數列表兩種方式。?已發送請求范例：

點擊選擇已發送請求范圍后，請立即在您的系統中提交一個數據，并推送到WebhookURL，工

作流接收到數據后，就能自動生成參數列表。?自定義參數列表：

可以直接將對接系統中的字段對照表的JSON格式數據粘貼進來，自定義比較靈活，可以刪除不

需要的參數。API基礎知識總體來說：調用API接口時，需要三部分：①請求的API

URL地址；②傳遞的參數；③授權身份認證。平臺API介紹工業互聯網平臺綜合應用《工業互聯網平臺綜合應用》/知識準備任務實施目錄0102在網頁輸入https://cube.rootcloud.com

，進入登錄頁面，

使用手機或郵箱進行登錄。

如下圖所示。添加應用工業互聯網平臺綜合應用01登錄頁面后，進入主頁面。如下圖所示，在全部應用處，單擊“添加應用”，再單擊“從空白處創建”。添加應用工業互聯網平臺綜合應用02修改名稱和圖標，如圖所示，名稱輸入“維修管理”。添加應用工業互聯網平臺綜合應用03創建工作表之前，首先明確工作表的字段，

例如，本書示例的設備信息表的字段包含：設備編號、設備名稱、

型號、設備位置、購買日期、品牌、設備照片。單擊“維修管理”應用，跳轉頁面，如下圖所示，輸入工作表名稱“設備信息表”，單擊“創建工作表”。創建設備信息表工業互聯網平臺綜合應用0201根據設備信息表字段，將工作表控件拖拉拽到表單設計頁面，如下圖所示，將①處文本控件拖拉拽到②處，再

到③處編輯文本控件相關信息，字段名稱輸入“設備名稱”。創建設備信息表工業互聯網平臺綜合應用03如下圖所示，編輯完成設備信息表后，單擊保存，然后單擊關閉表單。創建設備信息表工業互聯網平臺綜合應用04

05

由于設備信息表是依靠員工手動維護，需要手動添加記錄，

如下圖所示。單擊“記錄”。創建設備信息表工業互聯網平臺綜合應用

06

彈出“創建記錄”頁面，本書示例：設備名稱輸入“工業機器人001”，設備編號輸入“GYROBOT001”，型號輸入“HJ10001”，

設備位置輸入“焊接區域”，日期選擇“2022-09-27”，品牌輸入“樹根”，設備描述輸入“工

業機器人001能夠進行焊接功能，型號HJ10001，保質期3年。”創建設備信息表工業互聯網平臺綜合應用本書示例的報警同步表的字段包含：租戶id、物模型id、物實例id、報警id、報警名稱、報警描述、報警等級，

報警級別，開始時間，結束時間，擁有者。

報警同步表是由物模型物實例處報警數據。通過時間工作流定期查

詢數據。創建報警同步表，單擊“應用項”，在彈框下單擊“工作表”。

如下圖所示。創建報警同步表工業互聯網平臺綜合應用0102彈出新建工作表頁面，工作表名稱輸入“報警同步表”，單擊“創建”

，如下圖所示。創建報警同步表工業互聯網平臺綜合應用03如下圖所示，進行表單設計。設計完成后單擊“保存”

，并退出頁面。創建報警同步表工業互聯網平臺綜合應用04同理創建報警同步表，創建維修表單，維修表單字段包括：工單編號、報警名稱、報修時間、設備信息表、故

障照片、故障類型、維修人員、維修記錄、工單狀態、維修完成時間、維修照片。

進入表單設計頁面，如下所示。創建維修表單工業互聯網平臺綜合應用01如圖所示，拖拽一個“自動編號”的控件到頁面。再編輯字段名稱，輸入“工單編號”。創建維修表單工業互聯網平臺綜合應用02編號規則處單擊“添加規則”，下列列表有“固定字符、創建時間、引用字符”三種形式，如下圖所示，可以進行組合。創建維修表單工業互聯網平臺綜合應用03選擇“固定字符”，輸入“GZ-

”，再添加“創建時間”，類型選擇“YYYYMMDD”，再添加“固定字符”，輸入

“

-

”。如下圖所示。創建維修表單工業互聯網平臺綜合應用04編號處，點擊編輯按鈕，

如下圖所示。創建維修表單工業互聯網平臺綜合應用0506彈出編號設置頁面，選擇“指定位數編號”，位數3位數，開始值為1，周期設置選擇“不重復”。單擊確定。創建維修表單工業互聯網平臺綜合應用維修表單字段的報修時間、設備信息表、故障類型、維修人員、工單狀態、維修完成時間等編輯信息如下列圖所示。創建維修表單工業互聯網平臺綜合應用07創建維修表單

續上圖工業互聯網平臺綜合應用如下圖所示，排列好表單，單擊“保存”。創建維修表單工業互聯網平臺綜合應用08本任務中，創建一個時間觸發的工作流，利用API將根云平臺數據調入到根云積木的報警同步表中。

如下圖所示，單擊“工作流”。創建時間觸發工作流工業互聯網平臺綜合應用01進入工作流頁面，單擊“時間”，單擊“新建工作流”

，如下圖所示。創建時間觸發工作流工業互聯網平臺綜合應用02彈出頁面“如何開始你的流程”，選擇“定時觸發”

，如下圖所示。創建時間觸發工作流工業互聯網平臺綜合應用03進入工作流配置頁面，如下圖所示。單擊“設置觸發方式”，選擇一個執行時間，和結束執行時間，循環選擇

“每天”。創建時間觸發工作流工業互聯網平臺綜合應用04

05

如下圖所示，單擊“+”。彈出頁面，選擇要執行的動作，選擇“發送API請求”。然后在發送對象頁面上選擇“發送自定義請求”

。創建時間觸發工作流工業互聯網平臺綜合應用

06

如圖所示，?單擊①處，彈出“發送自定義請求”編輯

頁面，?單擊②處，修改名稱為獲取token，?修改③處為POST，?再編輯④處，輸入API地址“

https://openapi.rootcloud.com/accou

nt-manage/v2/auth/login”，?主體Body⑤處選擇raw

JSON，?⑥輸入以下JSON文件，?然后單擊⑦處，測試API，?會有響應Body出現⑧，最后單擊保存。創建時間觸發工作流工業互聯網平臺綜合應用

07

如圖所示?再添加一個“發送自定義請求”節點，單擊①處，

彈出編輯頁面?在②處修改名稱：解析API?③處選擇“GET”?④處輸入API地址：https://openapi.rootcloud.com/alarm-

event/v1/historian/alarms/query/all,Headers?⑤處輸入“Authorization”?在⑥處輸入“Bearer

”(注意：

Bearer后面有空格)?再點擊⑦處，選擇“獲取token”下的

“[Body]access_token”,最后單擊保存創建時間觸發工作流工業互聯網平臺綜合應用

8再返回上一個節點

，如下列圖所示，復制響應Body中的參考值，再到下一個節點，

如圖所示，測試API，彈出

“編輯API測試數據”頁面，將響應Body的參考值粘貼到“參數值”處。測試成功則有響應Body呈現。創建時間觸發工作流工業互聯網平臺綜合應用創建時間觸發工作流

續上圖工業互聯網平臺綜合應用

9

解析API后，得到多個數組，

如圖所示需要添加一個獲取多條數據的節點。獲取方式選擇“從對象數組獲取數據”

，如圖所示。創建時間觸發工作流工業互聯網平臺綜合應用

10

如圖所示，設置第5個節點，數據類型選擇“發送API請求數據組”，請求節點選擇“解析API”，數組選擇“payload”。最后保存此設置。創建時間觸發工作流工業互聯網平臺綜合應用添加第6個節點，

如圖所示，選擇新增記錄。創建時間觸發工作流工業互聯網平臺綜合應用11

12

設置第7個節點信息，

如圖所示，?單擊①處?②處選擇報警同步表?③處選擇基于多