数据源配置

1 说明

主要适用于需要数据获取或者处理的元件

2 配置

2.1 单个数据

单个数据例如数据视图承接的一条表单数据，支持的数据源包括：上下文、集合元件、逻辑、关联关系、连接器。

2.1.1 上下文

上下文数据源是根据当前领域模型的配置的实体信息，通过配置项去选择创建的实体。当前数据容器对应的数据就是当前选中的实体的数据。运行时会根据上下文的主键信息去查询当前实体记录中的某单个数据，仅支持配置领域模型中配置的持久化实体。如果想使用非持久化数据的话，可以使用逻辑返回非持久化数据支持。

2.1.2 集合元件

集合元件是需要用户配置当前数据容器的实体信息是根据监听的集合元件选中某个数据拿到数据

集合组件数据源类型表示监听其他列表组件的数据，可配置当前页面的其他列表组件

选择列表组件后，当前数据视图会具有选择的列表组件对应的实体信息，内部元素可直接选择相应的实体属性，后续操作与 上下文 数据源一致

2.1.3 逻辑

逻辑数据源通过用户配置的逻辑返回一个单个实体数据，支持配置非持久化和持久化实体，能够通过逻辑初始化数据容器数据，可以是新增页面或者编辑页面。

数据源为逻辑时，需配置入参，右侧属性栏会列出这条逻辑的所有参数

例如下图，逻辑内进行检索，返回实体 member，把数据视图的数据源配置为这条逻辑，则数据源就是逻辑返回的实体

2.1.4 关联关系

关联关系的使用场景是将当前数据视图的数据交由上层处理。

外层放一个数据视图，数据源绑定一个实体

内部再放一个数据视图，打开“数据交由上层数据容器”的开关，数据源选择关联关系，此时这个内部承接到的数据可以通过关联关系交由上层数据视图的实体

2.1.5 连接器

连接器的配置方法参考业务接接器 ，数据源设置为连接器，可以展示接口拿到的单条数据或向接口保存数据，需要选择在这个连接器内调用的接口，并根据需要传参。

2.2 集合数据

集合数据，常见于表格、列表类数据容器所承接的数据类型

支持的数据源包括：数据库、逻辑、关联关系（比如数据表格元件）、连接器

2.2.1 数据库

数据库数据源是根据当前领域模型的配置去选择对应的实体

1. 运行时通过通用查询过滤需要的实体数据集合，可以设置默认筛选条件，作为初始化过滤；过滤条件配置方式如下图所示，可配置多个规则，并选择每个规则间取并还是或

1. 还可以设置哪些字段支持排序配置，配置完之后列表上排序字段右侧会出现排序标识，用户可以切换排序方式，获取到想要的排序数据。配置方式如下图所示，选择想要支持排序的实体属性，并选择默认正序/倒序

1. 开启多列排序：开启后运行时可支持两个排序规则同时生效，不开启时只有最新操作的排序项生效

2.2.2 逻辑

逻辑数据源通过用户配置的逻辑返回一个集合实体数据，支持配置非持久化和持久化实体，能够通过逻辑初始化数据容器数据。数据源为逻辑时，需配置入参，右侧属性栏会列出这条逻辑的所有参数。

例如下图，逻辑内进行高级搜索，返回实体集合 member，把数据表格的数据源配置为这条逻辑，则数据源就是逻辑返回的实体集合。

如果用户不想关心逻辑的传参，直接可以通过我们内置的规范来给逻辑进行传参，如果用户想有一些过滤条件或者辅助判断逻辑可以通过自定义方式配置传递多个入参数据。

2.2.3 关联关系

允许用户通过上层数据容器配置的数据源的实体的关联关系过滤出来其关联的实体数据信息，可以根据外层的数据容器对应的实体类型，配置当前实体对应的对多的关联线，将当前的数据容器和上层的数据容器进行绑定。

使用场景举例：

• 有以下两个实体，pet 和 petGoods，两者之间存在多对多关系

• 在外层放置一个数据视图，选择 pet 作为数据源，内层放置一个可编辑表格，数据源选择 pet 和 petGoods 的关联关系，并打开”数据交由上层容器“开关，则可编辑表格和上层的数据视图进行了绑定。

• 运行效果：在同一页面录入宠物的基本信息和物品信息，保存后，物品信息通过关联关系和宠物绑定上

2.2.4 连接器

连接器的配置方法参考业务连接器 ，连接器数据源允许用户从接口中拿到集合数据，或将数据传给接口。

2.3 通用配置项

1. 定时刷新：可开启定时刷新功能，每隔一段时间该数据容器自动刷新；可以选择是否等待接口响应，如果等待接口响应，则接口响应后再刷新，不等待接口响应，则不论接口是否响应均定时刷新
2. 初始化加载数据：页面初始化时是否加载该容器的数据，可以选择开启或关闭，关闭时可选择通过按钮或其他组件的点击事件触发加载动作；开启时初始化自动加载，无特殊需求建议打开该开关。