服务实体

通过整合已发布的脚本配置服务功能，可以进行服务实体的增删改查等操作。

# 1 创建服务实体

选中要创建的实体集，打开实体编辑界面，从实体框中拖拽服务实体到画布上。双击服务实体，可以对实体进行配置,以及对实体进行修改显示名称、修改名称、添加基本属性、上移下移、删除属性的操作。单击属性列可以修改对应的属性配置。

# 2 设置主键

主键值必须具有唯一性
主键值不能包含特殊符号
当前仅支持单个主键

# 3 一键生成服务

实体服务提供9种模板分别为：根据主键查询服务，分页查询服务，新增服务，修改服务，删除服务，批量查询服务，批量删除服务。

在使用一键生成服务之前，请确保已正确配置主键。

在服务配置页面中，找到并点击一键生成服务按钮。

在新建服务弹窗中，输入关键字，系统将自动根据关键字生成相应的服务编码。

确认生成服务后，可以在服务下实体服务中查看已生成的服务。

服务在视图中的使用情况如图一，后续将详细介绍各服务对应的视图功能。

图一

# 3.1 根据主键查询服务

根据主键查询服务主要用于通过ID查询目标服务实体。该服务有三个参数：datasourceName、entityName和id。返回值类数据型是DataObject。在视图层面，该服务主要用于单条数据的查看（如图一中的5所示）。

# 3.2 分页查询实体服务

分页查询实体服务用于服务实体绑定的分页查询目标服务，实现服务实体的分页查询。主要有六个参数，分别是datasourceName、entityName、condition、cascadeDeep、pageIndex、pageSize。返回值数据类型是PageResultList<DataObject>。在视图层面，该服务主要用于分页查询数据（如图一中的7所示）。

# 3.3 新增实体服务

新增实体服务用于服务实体绑定的新增目标服务或者表单的拓展新增逻辑，实现服务实体的数据新增或者表单的拓展新增。主要有三个参数，分别为datasourceName、entityName、models。没有返回值。在视图层面，该服务主要用于新增数据（如图一中的2所示）。

# 3.4 修改实体服务

修改实体服务用于服务实体绑定的修改目标服务或者表单的拓展修改逻辑，实现服务实体的数据修改或者表单的拓展修改。主要有三个参数，分别为datasourceName、entityName、models。返回值数据类型是DataObject类型的数组。在视图层面，该服务主要用于编辑单条数据（如图一中的4所示）。

# 3.5 删除实体服务

删除实体服务用于服务实体绑定的删除目标服务或者表单的拓展删除逻辑，实现服务实体的数据删除或者表单的拓展删除。主要有三个参数，分别为datasourceName、entityName、ids。返回值数据类型是DataObject类型的数组。在视图层面，该服务主要用于删除单条数据（如图一中的6所示）。

# 3.6 批量查询服务

批量查询服务实体服务用于服务实体绑定的查询目标服务，实现服务实体的批量查询服务。主要有三个参数，分别为datasourceName、entityName、ids。返回值数据类型是PageResultList<DataObject>。在视图层面，该服务主要用于筛选数据（如图一中的1所示）。

# 3.7 批量删除服务

批量删除实体服务用于服务实体绑定的删除目标服务或者表单的拓展删除逻辑，实现服务实体的数据批量删除或者表单的批量拓展删除。主要有四个参数，分别为datasourceName、entityName、ids、cascadeDeep。返回值数据类型是DataObject类型的数组。在视图层面，该服务主要用于批量删除数据（如图一中的3所示）。

# 4 服务实体关系

设计图上，服务实体之间并没有进行连线。需要通过实体属性配置手动关联实体。

其中，设置1:n关系时，需手动勾选数组类型，具体操作如下图：