1. 自定义对象
  2. 扩展标准对象

在华炎魔方里,内置了很多标准对象,我们可能会在项目需求中希望对某些标准对象做一些调整,比如为标准对象创建自定义字段,或者隐藏某些内置字段,我们可以通过扩展标准对象来实现这些调整。

以下表格描述了在可视化界面上允许扩展标准对象的哪些功能:

功能
标准字段不允许不允许不允许
自定义字段允许允许允许
标准列表视图不允许不允许允许
自定义列表视图允许允许允许
标准操作按钮不允许不允许不允许
自定义操作按钮允许允许允许
标准页面布局不允许不允许允许
自定义页面布局允许允许允许

什么是标准对象

标准对象

标准对象指的是只存在于低代码配置文件中,并没有上传到数据库中的对象,在对象设置界面上是不能修改这些标准对象的,也无法在界面上创建或删除标准对象。

在一个魔方项目中,标准对象主要包括以下对象:

  • 华炎魔方内置的标准对象,指的是 Platform Standard Objects 这个NPM包中包含的所有对象。
  • 魔方项目中安装的外部软件包中的对象都是从代码配置文件中加载的,并没有保存到数据库中,所以也算标准对象。

虽然在可视化界面上我们不可以创建、修改或删除标准对象,但是我们可以通过为标准对象 扩展字段扩展列表视图扩展操作按钮扩展页面布局 来扩展其功能。

自定义对象

与标准对象对应,在可视化界面上直接配置的对象被称为自定义对象,这些对象会保存到数据库中,它们可以通过代码同步工具同步为代码,并在低代码配置文件中保存为以__c为后缀命名的对象。

在一个魔方项目中,自定义对象主要包括以下对象:

  • 在可视化界面上直接配置的对象。
  • 低代码配置文件中以 __c 为API名称后缀的对象。

可以在设置应用中进入“对象设置→对象”界面,点击右上角的新建按钮,在弹出的新建对象窗口中配置对象属性即可创建自定义对象,也可以在对象列表修改或删除已经存在的自定义对象。

扩展字段

标准字段

与标准对象一样,标准字段指的是只存在于低代码配置文件中,并没有上传到数据库中的字段,在可视化界面上是不能修改这些标准字段的,也无法在界面上创建或删除标准字段。

在一个魔方项目中,标准字段主要包括以下字段:

  • 华炎魔方内置的标准对象的标准字段,指的是 Platform Standard Objects 这个NPM包中字义的所有对象上的字段。
  • 魔方项目中安装的外部软件包中的对象上的字段都是从代码配置文件中加载的,并没有保存到数据库中,所以也算标准字段。

自定义字段

与标准字段对应,在可视化界面上直接配置的字段被称为自定义字段,这些字段会保存到数据库中,它们可以通过代码同步工具同步为代码,并在低代码配置文件中保存为以__c为后缀命名的字段。

在一个魔方项目中,自定义字段主要包括以下字段:

  • 在可视化界面上直接配置的字段。
  • 低代码配置文件中以 __c 为API名称后缀的字段。

可以在设置应用中进入“对象设置→对象”界面,点击对象列表中的对象名称进入对象详细界面,在“对象字段”子表列表右上角点击新建按钮即可创建自定义字段,也可以在“对象字段”列表修改或删除已经存在的自定义字段,但是无法修改或删除标准字段。

值得注意的是,我们在可视化界面上不止可以为自定义对象创建自定义字段,也可以为标准对象创建自定义字段来扩展标准对象的功能。

扩展列表视图

标准列表视图

与标准对象一样,标准列表视图指的是只存在于低代码配置文件中,并没有上传到数据库中的列表视图,在可视化界面上是不能修改这些标准列表视图的,也无法在界面上创建或删除标准列表视图。

在一个魔方项目中,主要包括以下标准列表视图:

  • 华炎魔方内置的标准对象上的标准列表视图,指的是 Platform Standard Objects 这个NPM包中字义的所有对象上的列表视图。
  • 魔方项目中安装的外部软件包中的对象上的列表视图都是从代码配置文件中加载的,并没有保存到数据库中,所以也算标准列表视图。

虽然在可视化界面上我们不可以创建、修改或删除标准列表视图,但是我们可以通过以下两种方式在界面上扩展标准对象的列表视图功能:

  • 为标准对象创建自定义列表视图。
  • 自定义标准对象上的标准列表视图。

第一种方式请参考下面 自定义列表视图 小节,第二种方式请在对象设置详细界面找到“列表视图”子表并点击要自定义的标准列表视图名称进入列表视图详细界面,然后点击其右上角的”自定义”按钮即可把该列表视图在代码中配置的属性上传到数据库中,这样就可以在界面上修改其属性了。

需要注意的是,列表视图的过滤条件并不是在后台对象设置中配置,而是在前台用户界面的对象列表视图右侧的过滤器中配置。

自定义列表视图

与标准列表视图对应,在可视化界面上直接配置的列表视图被称为自定义列表视图,这些列表视图会保存到数据库中,它们可以通过代码同步工具同步为代码,并在低代码配置文件中保存为以__c为后缀命名的列表视图。

在一个魔方项目中,主要包括以下自定义列表视图:

  • 在可视化界面上直接配置的列表视图。
  • 低代码配置文件中以 __c 为API名称后缀的列表视图。

可以在设置应用中进入“对象设置→对象”界面,点击对象列表中的对象名称进入对象详细界面,在“列表视图”子表列表右上角点击新建按钮即可创建自定义列表视图,也可以在“列表视图”列表修改或删除已经存在的自定义列表视图,但是无法直接修改或删除标准列表视图。

值得注意的是,我们在可视化界面上不止可以为自定义对象创建自定义列表视图,也可以为标准对象创建自定义列表视图来扩展标准对象的功能。

扩展操作按钮

标准操作按钮

与标准对象一样,标准操作按钮指的是只存在于低代码配置文件中,并没有上传到数据库中的操作按钮,在可视化界面上是不能修改这些标准操作按钮的,也无法在界面上创建或删除标准操作按钮。

在一个魔方项目中,主要包括以下标准操作按钮:

  • 华炎魔方内置的标准对象的标准操作按钮,指的是 Platform Standard Objects 这个NPM包中字义的所有对象上的操作按钮。
  • 魔方项目中安装的外部软件包中的对象上的操作按钮都是从代码配置文件中加载的,并没有保存到数据库中,所以也算标准操作按钮。

自定义操作按钮

与标准操作按钮对应,在可视化界面上直接配置的操作按钮被称为自定义操作按钮,这些按钮会保存到数据库中,它们可以通过代码同步工具同步为代码,并在低代码配置文件中保存为以__c为后缀命名的操作按钮。

在一个魔方项目中,主要包括以下自定义操作按钮:

  • 在可视化界面上直接配置的操作按钮。
  • 低代码配置文件中以 __c 为API名称后缀的操作按钮。

可以在设置应用中进入“对象设置→对象”界面,点击对象列表中的对象名称进入对象详细界面,在“操作按钮”子表列表右上角点击新建按钮即可创建自定义操作按钮,也可以在“操作按钮”列表修改或删除已经存在的自定义操作按钮,但是无法修改或删除标准操作按钮。

值得注意的是,我们在可视化界面上不止可以为自定义对象创建自定义操作按钮,也可以为标准对象创建自定义操作按钮来扩展标准对象的功能。

扩展页面布局

标准页面布局

与标准对象一样,标准页面布局指的是只存在于低代码配置文件中,并没有上传到数据库中的页面布局,在可视化界面上是不能修改这些标准页面布局的,也无法在界面上创建或删除标准页面布局。

在一个魔方项目中,主要包括以下标准页面布局:

  • 华炎魔方内置的标准对象的标准页面布局,指的是 Platform Standard Objects 这个NPM包中字义的所有对象上的页面布局。
  • 魔方项目中安装的外部软件包中的对象上的页面布局都是从代码配置文件中加载的,并没有保存到数据库中,所以也算标准页面布局。

虽然在可视化界面上我们不可以创建、修改或删除标准页面布局,但是我们可以通过以下两种方式在界面上扩展标准对象的页面布局功能:

  • 为标准对象创建自定义页面布局。
  • 自定义标准对象上的标准页面布局。

第一种方式请参考下面 自定义页面布局 小节,第二种方式请在对象设置详细界面找到“页面布局”子表并点击要自定义的标准页面布局名称进入页面布局详细界面,然后点击其右上角的”自定义”按钮即可把该页面布局在代码中配置的属性上传到数据库中,这样就可以在界面上修改其属性了。

自定义页面布局

与标准页面布局对应,在可视化界面上直接配置的页面布局被称为自定义页面布局,这些页面布局会保存到数据库中,它们可以通过代码同步工具同步为代码,并在低代码配置文件中保存为以__c为后缀命名的页面布局。

在一个魔方项目中,主要包括以下自定义页面布局:

  • 在可视化界面上直接配置的页面布局。
  • 低代码配置文件中以 __c 为API名称后缀的页面布局。

可以在设置应用中进入“对象设置→对象”界面,点击对象列表中的对象名称进入对象详细界面,在“页面布局”子表列表右上角点击新建按钮即可创建自定义页面布局,也可以在“页面布局”列表修改或删除已经存在的自定义页面布局,但是无法修改或删除标准页面布局。

值得注意的是,我们在可视化界面上不止可以为自定义对象创建自定义页面布局,也可以为标准对象创建自定义页面布局来扩展标准对象的功能。