文档首页 > > 用户指南> 开发模型>

创建聚合对象

创建聚合对象

分享
更新时间:2021/06/15 GMT+08:00

系统支持定义聚合对象(Aggregator),实现不同对象之间建立关联关系。

有两种方式:

  • 可通过定义对象中某一字段的字段类型为“Lookup”(查找关系)或者Master Detail”(主从关系类型)实现不同对象之间建立关联关系,只能向子对象进行关联。该场景下,系统支持基于聚合对象进行数据的增删改查操作,避免对多个对象分别进行多次数据操作。
  • 通过属性配置实现不同对象之间建立关联关系。该场景下,界面上暂不支持基于聚合对象进行数据的增删改查操作,仅可通过Restful接口进行数据的增删改查操作。

场景描述

新建一个订单聚合对象,该聚合对象里产品对象通过Lookup关联价格、库存子节点对象,并基于该订单聚合对象定义增加操作;再通过属性配置关联客户对象。

表1 对象说明

对象名

自定义字段名

字段类型

字段说明

Product__CST

description__CST

text

产品描述。

Price__CST

product__CST

Lookup

产品描述。该字段的取值来源于“Product__CST”对象。

price__CST

Currency

产品价格。

Stock__CST

remain__CST

Number

库存数量。

product__CST

Lookup

产品描述。该字段的取值来源于“Product__CST”对象。

Customer__CST

-

-

-

前提条件

表1中的对象及自定义字段已创建。

创建聚合对象并通过Lookup关联子节点对象

  1. 鼠标放在App下的文件夹旁会出现加号,单击加号,选择“聚合对象”。
  2. 选择“创建新的聚合对象”,输入基本信息后单击“添加”。

    图1 新建聚合对象
    表2 参数说明

    参数名称

    参数说明

    标签

    该聚合对象的显示标签名。长度不超过64个字节。

    名称

    该聚合对象的名称,唯一标识,系统自动生成。长度不超过255个字节。

    描述

    用于描述这个对象。

  3. 在“聚合根”中选择根节点对象。

    根节点对象为该聚合对象的基础对象。这里根节点对象设置为“Product__CST”。选择根节点对象后,该节点对象的所有字段详情会显示在右下侧区域空白处。

    图2 设置根节点对象

  4. 单击节点对象详情框中的“+”,选择与根节点关联的对象“Price__CST”,添加关联对象。只能向子对象进行关联。

    图3 选择关联对象

  5. 选择两个对象之间关联字段“product__CST”。

    两个关联对象之间可能会有多个字段进行关联。这里选择希望进行关联的具体字段。

    图4 选择关联字段

    选择关联字段后,关联对象“Price__CST”的所有字段详情会显示在区域中。两个关联对象之间会有连线,连线上显示关联的具体字段标签。

    图5 关联结果

  6. 参考4~5,添加与根节点关联的对象“Stock__CST”。

    图6 添加关联对象“Stock__CST”

  7. (可选)您可单击节点名称,在右侧“Properties”区域设置“Label”参数取值设置节点名称,以便区分不同节点。

    图7 设置节点名称
    表3 节点名“Properties”区域参数说明

    参数名

    说明

    标签

    该节点在界面上的展示名称。可编辑。

    名称

    该节点的唯一标识。可编辑。

    实体对象

    该节点对象名。不可编辑。

    对象字段

    所用到的该节点对象的字段。目前只能选该对象全部字段,不支持选择部分字段。

    父对象

    该节点对象的父对象。

    子对象

    该节点对象的子对象。

  8. 单击页面上方保存图标,保存该聚合对象设置。

    保存后,节点展示名称“标签”取值可更改,节点对象关联关系也可修改。

增加Action操作

  1. 基于该订单聚合对象定义增加操作。

    1. 在左侧“操作”下单击“+”,设置增加操作参数。
      图8 增加操作
      表4 “Property”区域参数说明

      参数名称

      参数说明

      标签

      Action在界面的展示名称。

      名称

      该Action的唯一标识。

      操作类型

      Action类型。

      • Flow Action:引用已创建的服务编排Flow执行操作。
      • Script Action:引用已创建的脚本执行操作。

      服务编排/脚本

      系统中具体的服务编排Flow或者脚本。

      描述

      该操作的描述信息。

      Flow/Sript入参

      展示该服务编排或者脚本的输入参数。

      Flow/Sript出参

      展示该服务编排或者脚本的输出参数。

    2. 单击“添加操作到聚合对象”。
    3. 单击页上方保存图标进行保存。

  2. 验证新增的“Insert” Action操作。

    1. 在该聚合对象编辑页面,单击选择该聚合对象名称。
      图9 选择对象名称
    2. 在“属性”页面选择“Insert”操作,输入相关入参,单击“执行”。
      图10 执行“insert”
    3. 弹出成功提示框。表示执行“Insert”操作成功。关闭该提示框。

  3. 使用预置的“查询” Action查询聚合对象数据记录。

    1. 在左侧“操作”下单击“查询”,为系统预置的查询聚合对象接口。
    2. 在右侧“属性”页面选中“输入根节点记录Id”,在“根节点记录Id”中输入插入数据的记录Id。若可以查出与根节点对象所关联的所有节点对象的数据记录,表示该聚合对象设置成功。
      • “根节点第一条记录”为查询根节点第一条记录相关的所关联的所有节点对象的数据记录。
      • “输入根节点记录Id”为查询根节点某条记录相关的所关联的所有节点对象的数据记录。
      图11 查询数据

增加属性配置

  1. 在左侧“属性”下单击“+”,设置属性参数,关联对象Customer_CST。

    图12 增加属性配置

  2. 单击“添加属性”。
  3. 单击页面上方保存图标进行保存。

    图13 属性配置关联结果

    有属性配置关联关系的BO暂不支持Action操作。

分享:

    相关文档

    相关产品