OneNET应用开发环境 由浅入深应用开发环境
应用开发环境介绍 初识应用开发环境 开发入门 开发进阶
开发指南
开发应用 定义数据对象 创建聚合对象 开发脚本 管理事件 开发流 配置审批流程 开发标准页面 开发高级页面 开发商业流 配置连接器 开发Email发送功能 配置工作流 开发报表 自定义BO 管理平台

方法和实践

下面我们开始创建第1个数据对象。

对应电梯信息管理,我们需要创建一个设备对象Equipment,保存设备品牌、型号、资产编号等信息,如表1所示。

表 1 电梯信息

设备属性

字段标签

字段名称

数据类型

是否唯一

是否必填

建议长度

设备名称

Equipment Name

name(复用平台预置的标准字段)

Name

NA

NA

设备编码

Equipment SN

equipmentSN

文本

16

设备品牌

Equipment Brand

equipmentBrand

选项列表,预置选项包括沃克斯、三菱、日立、迅达等。

16

设备型号

Equipment Model

equipmentModel

文本

16

设备所在省

Installation Site Province

installationSiteProvince

文本

16

设备所在市

Installation Site City

installationSiteCity

文本

16

设备所在区

Installation Site Area

installationSiteArea

文本

16

设备所在详细地址

Installation Detail Address

installationDetailAddress

文本

64

设备位置经度

Longitude

longitude

文本

32

设备位置纬度

Latitude

latitude

文本

32

完整地址

Full Address

fullAddress

文本

128

创建方法

  1. 进入之前创建的应用。
  2. 鼠标放在“Model”上,单击界面上出现的“+”,在弹出菜单中选择“对象”。
  3. 选中“创建新对象”,在“标签”和“名称”文本框中输入“Equipment”,单击“添加”。

    系统实际创建的对象名称为“HW__Equipment__CST”,“HW__”前缀由租户命名空间namespace决定,“__CST”后缀代表是自定义对象。

  4. 将标准字段“Name”作为“设备名称”字段。

    1. 在“标准字段”页签单击“Name”字段后的编辑图标
    2. 图1所示,修改字段标签,并设置字段内容唯一,单击“保存”。

      图 1 修改name字段的标签

  1. 按系统向导完成第1个字段“设备编码”的定义。

    1. 在“自定义字段”页签单击“新建”。
    2. 选中字段类型:设置字段类型为“文本”,单击“下一步”。
    3. 输入字段详细信息:如图2所示,设置字段标签、名称、字段长度,并定义字段为必填字段,且大小写敏感,单击“下一步”。

      注意

      • 平台会根据字段标签自动生成字段名称,但请参照表1,修改字段名。
      • 对于utf-8编码,一个汉字占用三个字节。

      图 2 定义“设备编码”详细信息

      系统实际创建的字段名称为“HW__equipmentSN__CST”,“HW__”前缀由租户命名空间namespace决定,“__CST”后缀代表是自定义字段。

    4. 配置字段级安全:选中“读”和“编辑”复选框,为所有预置profile配置能编辑和读取本字段的权限,单击“下一步”。

    5. 将字段添加到页面布局:选中“添加本字段到该页面布局”,单击“保存”。
  2. 按系统向导完成第2个字段“设备品牌”的定义。

    1. 在“自定义字段”页签单击“新建”。
    2. 设置字段类型为“选项列表”,单击“下一步”。
    3. 图3所示,设置字段标签、名称,输入可选值,单击“下一步”。

      注意:平台会根据字段标签自动生成字段名称,但请参照表1,修改字段名。

      图 3 定义“设备品牌”详细信息

    4. 选中“权限集”后“读取”和“编辑”复选框,为所有预置profile配置能编辑和读取本字段的权限,单击“下一步”。

    5. 选中“添加本字段到该页面布局”,单击“保存”。
  3. 重复步骤5,按表1定义剩余字段。

    注意

    • 平台会根据字段标签自动生成字段名称,但请参照表1,修改字段名。
    • 除“设备编码”外,其他字段都不是必填项;因此,不需要选中“是否必填”。

验证

您可以用对象的页面布局Layout能力,检查对象的定义是否符合预期。

创建对象时,系统会自动为对象创建两个页面布局:

  • 设备详情页面Equipment Detail:显示对象中单条记录的详细信息。因为我们在创建对象字段时,都选中了“添加本字段到该页面布局”,设备详情页面已包含name和所有的自定义字段。
  • 设备列表页面Equipment Records:显示对象中的记录列表。列表页面中默认只显示了name字段(设备名称);因为后续章节的测试中,我们经常需要检查记录ID、设备编码和设备名称,所以将其他几个字段也添加到列表页面中。

  • 修改设备对象的列表页面布局。

    1. 切换到设备对象HW__Equipment__CST的“布局”页签。
    2. 单击“Equipment Records”,打开页面布局详情。
    3. 图4所示,选中列表“Table”,再单击界面右侧“属性”页签中的

      图 4 刷新“Records”

    4. 图5所示,单击“Records”后的“编辑”。

      图 5 编辑“Records”

    5. 图6所示,选中要显示在页面上的字段,单击“下一步”,再单击“确定”。

      图 6 为“Records”添加字段

    6. 图5对话框中,单击“确定”。

    7. 图7所示,单击“添加字段”。

      图 7 添加“Records”字段到页面上的结果列中

    8. 在弹出对话框中选中所有字段,单击“确定”。

    9. 图7中,单击“已添加列”中的任意一项,单击或者,调整列的显示顺序。
    10. 单击编辑器上方保存图标。
  • 将页面布局添加到导航菜单中。

    1. 单击应用左侧导航下部的“配置”。
    2. 在“导航条”页签单击“菜单树”右侧的“+”,选择“添加页签”,页签类型选择“对象页签”。
    3. 新增导航菜单“testEquipment”,将菜单与设备对象“HW__Equipment__CST”、设备对象列表页“Equipment Records”关联。如图8所示。

      图 8 将新增的对象布局挂到导航菜单上

  1. 预览、测试对象。

    1. 单击界面左下角的预览按钮。
    2. 在应用预览页面,单击“testEquipment”菜单。
    3. 单击“Add”,再输入任意测试数据,单击“保存”。

      系统返回设备列表页面,并显示新插入的数据,则表示对象创建成功。

results matching ""

    No results matching ""