2023年7月9日发(作者：)

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. 选项集值定义区域1. 编码：值的编码，实际返回的值；2. 值：⽤户看到的值；3. 点击“添加选项”链接创建多个选项值3. 填写信息完成后，点击创建选项集窗⼝左下⾓的“创建”按钮完成业务对象创建重复以上1~3的步骤创建 云端协议、产品类型、上联系统、运营商和上联⽹络 选项集：4. 创建业务对象进⼊应⽤设计器后，按照下列的步骤创建业务对象和业务对象属性：1. 选择左边的业务对象图标进⼊业务对象设计视图2. 点击左上⾓的“创建业务对象”链接，弹出的创建业务对象窗⼝录⼊如下信息：1. 名称：业务对象的名称，必填。填写⼀个有意义的名称，尽量能够代表业务实体所代表的业务含义；2. 编码：业务对象的唯⼀编码，在程序扩展和API访问时会⽤到，选择有意义的英⽂单词；3. 描述：对业务对象的描述；4. 存储数据库：数据持久化的标志，选中则会在后台创建⼀个数据库对象，不选中则创建⼀个临时的数据对象，不进⾏建数据库对象的持久化；5. 乐观锁定版本号：对象版本控制标志，⽤来控制实体数据记录更新，防⽌覆盖别⼈的更新导致脏数据的产⽣。3. 填写信息完成后，点击创建业务对象窗⼝左下⾓的“创建”按钮完成业务对象创建重复以上1~3的步骤创建三个业务对象：名称产品设备组设备编码PRODUCTSDEVICE_GROUPSDEVICES存储数据库是是是乐观锁版本号是是是完成三个业务对象创建后可以从业务对象关系图看到：5. 定义业务对象的属性从业务对象关系图中的实体对象上⽅点击图标进⼊业务对象属性查看界⾯：1. 选择左上⾓的“添加属性”链接进⼊添加属性界⾯，录⼊如下信息：1. 名称：属性名称，必填。填写⼀个有意义的名称；2. 编码：属性对象的唯⼀编码，在程序扩展和API访问时会⽤到，选择有意义的英⽂单词；3. 描述：属性的描述；4. 是否存储：存储数据库字段是会在数据库表中定义⼀个列；计算字段可以通过逻辑流来取得⼀个不进⾏持久化的值；5. 必填：是否是⼀个必须的属性；6. 可搜索：是否可以在界⾯中进⾏此属性的搜索。7. 属性设置区域根据选择组件的不同显⽰不同的属性(下⾯列出本课程定义相关的组件类型属性)：1. 【⽂本】 组件⽤来录⼊⽂本信息，相关的属性：1. 最⼤长度：允许⽤户输⼊的最⼤⽂本长度；2. 默认值：界⾯录⼊时默认带出的值；3. 组件形式：单⾏⽂本代表显⽰字段输⼊；多⾏⽂本显⽰多⾏⽂本域；4. 设为名称字段：⼀个业务对象只能设置⼀个名称字段。2. 【长⽂本】 组件⽤来录⼊较长的⽂本信息，相关的属性：1. 组件形式：多⾏⽂本显⽰多⾏⽂本域；html⽂本格式；markdown⽂本格式。3. 【单选】 组件⽤来从静态值列表中选择⼀个值，相关的属性：1. 选项集：单选值的来源，选择⼀个选项集；2. 默认值：从已选择的选项集中选择⼀个默认的值；3. 组件形式：下拉和radio形式；4. 标签展⽰：字段显⽰为彩⾊的标签。4. 【浮点数】 组件⽤来录⼊⼀个浮点数，相关的属性：1. 默认值：提供⼀个整数默认值；2. 组件形式：数字或⾦额；3. 整数存储位数：浮点数中的整数位数；4. ⼩数存储位数：浮点数中的⼩数位数。5. 【关联关系】 组件是⽤来关联外部对象，相关的属性：1. 关联对象：选择⼀个已定义的业务对象，内部会存储关联对象的UUID值作为关联；2. ⼦级关系名称：关联关系名称。2. 填写信息完成后，点击添加属性窗⼝左下⾓的“创建”按钮完成业务对象属性添加5.1 定义⽂本组件（未列出的属性采⽤默认值）业务对象产品设备组设备设备设备设备设备设备属性名产品名称组名称设备名称MAC制造商序列号软件版本硬件版本属性编码PRODUCT_NAMEGROUP_NAMEDEVICE_NAMEMAC_ADDRESSMANUFACTURERSERIAL_NUMBERSOFTWARE_VERSIONHARDWARE_VERSION必填是是是否否否否否可搜索是是是否否否否否最⼤长度66060设为名称字段是是是否否否否否业务对象设备设备设备设备属性名设备位置设备编号连接⽤户名设备秘钥属性编码DEVICE_LOCATIONDEVICE_NUMBERCONNECT_USERNAMESECRET_KEY必填否否否否可搜索否否否否最⼤长度160603636设为名称字段否否否否5.2 定义长⽂本组件（未列出的属性采⽤默认值）业务对象产品设备组设备设备属性名产品描述设备组描述设备描述元数据属性编码PRODUCT_DESCRIPTIONGROUP_DESCRIPTIONDEVICE_DESCRIPTIONMETA_DATA必填否否否否可搜索否否否否5.3 定义浮点数组件（未列出的属性采⽤默认值）业务对象设备设备属性名位置经度位置纬度属性编码LONGITUDELATITUDE必填否否可搜索否否组件形式数字数字整数存储位数32⼩数存储位数665.4 定义单选组件（未列出的属性采⽤默认值）业务对象产品产品设备设备设备属性名云端协议产品类型上联系统运营商上联⽹络属性编码CLOUD_PROTOCOLPRODUCT_TYPEUP_SYSTEMOPERATORUP_NETWORK必填是是是否否可搜索是是是否否选项集云端协议产品类型上联系统运营商上联⽹络默认值MQTT设备云组件形式下拉下拉下拉下拉下拉5.5 定义关联关系（未列出的属性采⽤默认值）业务对象设备设备设备属性名设备组产品⽗设备属性编码BELONG_DEVICE_GROUPBELONG_PRODUCTPARENT_DEVICE必填是是否可搜索是是是关联对象设备组产品设备⼦级关系名称所属设备组所属产品所属设备6. 完成V1.0业务对象的定义定义好的业务对象和属性后的对象关系图如下：遇到问题怎么办在Buildrun使⽤过程中，任何平台的问题和建议，都可以点击页⾯右下⾓⽤户反馈按钮，实时向开发团队提交反馈，我们会在第⼀时间处理。前两节开发课程回顾下⼀节将讲解如何通过迭代计划和代办事项进⾏任务的管理，本系列开发教程不断更新中，欢迎持续关注。关于BuildRun带来了多云架构环境下基于视觉的企业级应⽤创建、集成、部署、⽣命周期管理和分发的能⼒，由开源Choerodon猪齿鱼核⼼团队创⽴的BuildRun公司（上海翘腾科技有限公司）的使命是以云原⽣的现代化软件架构来帮助企业提升软件开发⽣产⼒和业务敏捷性，它提供企业级DevOps平台和企业级低代码开发平台，帮助隐藏应⽤所依赖的基础环境的复杂性，让每个⼈都只需要专注在业务逻辑上，以新的⽅式让团队能够快速、持续地将他们的想法转化为真正的商业价值。欢迎免费注册体验试⽤低代码应⽤开发注册地址：官⽹：微信：BuildRun低代码开发平台