创建聚合对象

系统支持定义聚合对象（Aggregator），实现不同对象之间建立关联关系。

有两种方式：

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

场景描述

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

表 1 对象说明

前提条件

表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或者脚本的输入参数。
      Flow/Sript出参	展示该Flow或者脚本的输出参数。

   2. 单击“添加操作到聚合对象”。

   3. 单击页上方进行保存。

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

   1. 在该聚合对象编辑页面，单击选择该聚合对象名称。

      图 9 选择对象名称
      

   2. 在“属性”页面选择“Insert”操作，输入相关入参，单击“执行”。

      图 10 执行“insert”
      

      弹出成功提示框。表示执行“Insert”操作成功。

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

   1. 在左侧“操作”下单击“查询”，为系统预置的查询聚合对象接口。

   2. 在右侧“属性”页面选中“输入根节点记录Id”，在“根节点记录Id”中输入插入数据的记录Id。若可以查出与根节点对象所关联的所有节点对象的数据记录，表示该聚合对象设置成功。

      说明：

      • “根节点第一条记录”为查询根节点第一条记录相关的所关联的所有节点对象的数据记录。
      • “输入根节点记录Id”为查询根节点某条记录相关的所关联的所有节点对象的数据记录。

      图 11 查询数据
      

增加属性配置

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

   图 12 增加属性配置
   

2. 单击“添加属性”。

3. 单击页面上方进行保存。

   图 13 属性配置关联结果
   

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