BuildRun低代碼開發教程第三節 | 數據模型設計和定義

課程說明

本課程介紹如何利用Buildrun低代碼平臺構建數據模型，爲頁面設計提供數據來源。涉及的主要內容有：

1. 低代碼應用服務
2. 數據模型
3. 創建靜態值列表（選項集）
4. 創建業務對象
5. 定義業務對象的屬性
6. 完成V1.0業務對象的定義

課程內容

1. 低代碼應用服務

低代碼應用服務是Buildrun平臺中的一種通過可視化構建的應用服務類型，底層基於微服務技術體系實現，構建的低代碼應用加上Buildrun多雲應用引擎(BrAppEngine)構成了完整的雲原生應用體系。

登錄Buildrun平臺後，選擇頂端菜單“項目”進入項目列表界面，點擊我們創建的“Br一站式物聯網應用平臺項目”的“物聯網低代碼服務詳情”，在服務窗口中點擊“進入設計器”按鈕進入應用設計器；也可以進入“項目視圖空間”中，選擇“開發->應用服務”進入應用服務界面，點擊應用服務的“進入設計器”鏈接進入應用設計器。

2. 數據模型

根據前面課程的準備和BrIoT應用平臺的需求，我們規劃了v1.0版本中主要實現產品和設備的新增、修改和查看功能，因此需要定義產品和設備兩個業務對象來存儲相關的信息，下面是第一版本的業務對象設計。

業務對象是將信息保留在數據庫中並實現數據庫模型的元素，可以將它們視爲數據庫表或視圖。

業務對象是通過存儲與之相關的實體屬性定義的，實體屬性的示例包括：名稱，地址，郵政編碼，城市等。

3. 創建靜態值列表（選項集）

由於我們在業務對象屬性中需要引用一些靜態的值，如產品類型、運營商等，在創建對象屬性前先定義好這些值方便引用，定義如下圖：

1. 選擇應用設計器左側的選項集圖標進入選項集界面
2. 點擊左上角的“創建選項集”鏈接，彈出的創建選項集窗口錄入如下信息：
   1. 名稱：選項集名稱，必填。填寫值列表用戶的業務名稱；
   2. 編碼：選項集的唯一編碼，在程序擴展和API訪問時會用到，選擇有意義的英文單詞；
   3. 描述：對選項集的描述；
   4. 選項集值定義區域
      • 編碼：值的編碼，實際返回的值；
      • 值：用戶看到的值；
      • 點擊“添加選項”鏈接創建多個選項值
3. 填寫信息完成後，點擊創建選項集窗口左下角的“創建”按鈕完成業務對象創建

重複以上1~3的步驟創建 雲端協議、產品類型、上聯繫統、運營商和上聯網絡 選項集：

4. 創建業務對象

進入應用設計器後，按照下列的步驟創建業務對象和業務對象屬性：

1. 選擇左邊的業務對象圖標進入業務對象設計視圖
2. 點擊左上角的“創建業務對象”鏈接，彈出的創建業務對象窗口錄入如下信息：
   1. 名稱：業務對象的名稱，必填。填寫一個有意義的名稱，儘量能夠代表業務實體所代表的業務含義；
   2. 編碼：業務對象的唯一編碼，在程序擴展和API訪問時會用到，選擇有意義的英文單詞；
   3. 描述：對業務對象的描述；
   4. 存儲數據庫：數據持久化的標誌，選中則會在後臺創建一個數據庫對象，不選中則創建一個臨時的數據對象，不進行建數據庫對象的持久化；
   5. 樂觀鎖定版本號：對象版本控制標誌，用來控制實體數據記錄更新，防止覆蓋別人的更新導致髒數據的產生。
3. 填寫信息完成後，點擊創建業務對象窗口左下角的“創建”按鈕完成業務對象創建

重複以上1~3的步驟創建三個業務對象：

名稱	編碼	存儲數據庫	樂觀鎖版本號
產品	PRODUCTS	是	是
設備組	DEVICE_GROUPS	是	是
設備	DEVICES	是	是

完成三個業務對象創建後可以從業務對象關係圖看到：

5. 定義業務對象的屬性

從業務對象關係圖中的實體對象上方點擊圖標進入業務對象屬性查看界面：

1. 選擇左上角的“添加屬性”鏈接進入添加屬性界面，錄入如下信息：

   1. 名稱：屬性名稱，必填。填寫一個有意義的名稱；
   2. 編碼：屬性對象的唯一編碼，在程序擴展和API訪問時會用到，選擇有意義的英文單詞；
   3. 描述：屬性的描述；
   4. 是否存儲：存儲數據庫字段是會在數據庫表中定義一個列；計算字段可以通過邏輯流來取得一個不進行持久化的值；
   5. 必填：是否是一個必須的屬性；
   6. 可搜索：是否可以在界面中進行此屬性的搜索。
   7. 屬性設置區域根據選擇組件的不同顯示不同的屬性(下面列出本課程定義相關的組件類型屬性)：
      1. 【文本】 組件用來錄入文本信息，相關的屬性：
         • 最大長度：允許用戶輸入的最大文本長度；
         • 默認值：界面錄入時默認帶出的值；
         • 組件形式：單行文本代表顯示字段輸入；多行文本顯示多行文本域；
         • 設爲名稱字段：一個業務對象只能設置一個名稱字段。
      2. 【長文本】 組件用來錄入較長的文本信息，相關的屬性：
         • 組件形式：多行文本顯示多行文本域；html文本格式；markdown文本格式。
      3. 【單選】 組件用來從靜態值列表中選擇一個值，相關的屬性：
         • 選項集：單選值的來源，選擇一個選項集；
         • 默認值：從已選擇的選項集中選擇一個默認的值；
         • 組件形式：下拉和radio形式；
         • 標籤展示：字段顯示爲彩色的標籤。
      4. 【浮點數】 組件用來錄入一個浮點數，相關的屬性：
         • 默認值：提供一個整數默認值；
         • 組件形式：數字或金額；
         • 整數存儲位數：浮點數中的整數位數；
         • 小數存儲位數：浮點數中的小數位數。
      5. 【關聯關係】 組件是用來關聯外部對象，相關的屬性：
         • 關聯對象：選擇一個已定義的業務對象，內部會存儲關聯對象的UUID值作爲關聯；
         • 子級關係名稱：關聯關係名稱。

2. 填寫信息完成後，點擊添加屬性窗口左下角的“創建”按鈕完成業務對象屬性添加

5.1 定義文本組件（未列出的屬性採用默認值）

業務對象	屬性名	屬性編碼	必填	可搜索	最大長度	設爲名稱字段
產品	產品名稱	PRODUCT_NAME	是	是	60	是
設備組	組名稱	GROUP_NAME	是	是	60	是
設備	設備名稱	DEVICE_NAME	是	是	60	是
設備	MAC	MAC_ADDRESS	否	否	60	否
設備	製造商	MANUFACTURER	否	否	160	否
設備	序列號	SERIAL_NUMBER	否	否	60	否
設備	軟件版本	SOFTWARE_VERSION	否	否	60	否
設備	硬件版本	HARDWARE_VERSION	否	否	60	否
設備	設備位置	DEVICE_LOCATION	否	否	160	否
設備	設備編號	DEVICE_NUMBER	否	否	60	否
設備	連接用戶名	CONNECT_USERNAME	否	否	36	否
設備	設備祕鑰	SECRET_KEY	否	否	36	否

5.2 定義長文本組件（未列出的屬性採用默認值）

業務對象	屬性名	屬性編碼	必填	可搜索
產品	產品描述	PRODUCT_DESCRIPTION	否	否
設備組	設備組描述	GROUP_DESCRIPTION	否	否
設備	設備描述	DEVICE_DESCRIPTION	否	否
設備	元數據	META_DATA	否	否

5.3 定義浮點數組件（未列出的屬性採用默認值）

業務對象	屬性名	屬性編碼	必填	可搜索	組件形式	整數存儲位數	小數存儲位數
設備	位置經度	LONGITUDE	否	否	數字	3	6
設備	位置緯度	LATITUDE	否	否	數字	2	6

5.4 定義單選組件（未列出的屬性採用默認值）

業務對象	屬性名	屬性編碼	必填	可搜索	選項集	默認值	組件形式
產品	雲端協議	CLOUD_PROTOCOL	是	是	雲端協議	MQTT	下拉
產品	產品類型	PRODUCT_TYPE	是	是	產品類型	設備	下拉
設備	上聯繫統	UP_SYSTEM	是	是	上聯繫統	雲	下拉
設備	運營商	OPERATOR	否	否	運營商		下拉
設備	上聯網絡	UP_NETWORK	否	否	上聯網絡		下拉

5.5 定義關聯關係（未列出的屬性採用默認值）

業務對象	屬性名	屬性編碼	必填	可搜索	關聯對象	子級關係名稱
設備	設備組	BELONG_DEVICE_GROUP	是	是	設備組	所屬設備組
設備	產品	BELONG_PRODUCT	是	是	產品	所屬產品
設備	父設備	PARENT_DEVICE	否	是	設備	所屬設備

6. 完成V1.0業務對象的定義

定義好的業務對象和屬性後的對象關係圖如下：

遇到問題怎麼辦

在Buildrun使用過程中，任何平臺的問題和建議，都可以點擊頁面右下角用戶反饋按鈕，實時向開發團隊提交反饋，我們會在第一時間處理。

前兩節開發課程回顧

《BuildRun低代碼開發教程第一節|項目環境準備》
《BuildRun低代碼開發教程第二節 | 功能需求梳理和任務定義》

下一節將講解如何通過迭代計劃和代辦事項進行任務的管理，本系列開發教程不斷更新中，歡迎持續關注。

關於BuildRun

BuildRun帶來了多雲架構環境下基於視覺的企業級應用創建、集成、部署、生命週期管理和分發的能力，由開源Choerodon豬齒魚核心團隊創立的BuildRun公司（上海翹騰科技有限公司）的使命是以雲原生的現代化軟件架構來幫助企業提升軟件開發生產力和業務敏捷性，它提供企業級DevOps平臺和企業級低代碼開發平臺，幫助隱藏應用所依賴的基礎環境的複雜性，讓每個人都只需要專注在業務邏輯上，以新的方式讓團隊能夠快速、持續地將他們的想法轉化爲真正的商業價值。

---

歡迎免費註冊體驗試用低代碼應用開發

• 註冊地址：apps.gobuildrun.com/#/base/regi…
• 官網：http://gobuildrun.com
• 微信：BuildRun低代碼開發平臺