数据源与数据配置

数据源

1. 数据源主要为 4 大类，分别为静态数据、CSV 文件、API 接口和数据库。
2. 每种数据源的配置界面都不同，其中 API 接口和数据库参数配置区域内可以使用回调参数（英文冒号后面跟动态参数）。

API 接口（以api接口为例，更多数据源使用及详情见https://dtstack.yuque.com/easyv/il3lgc/mq5zk5）

1. 添加数据源。可以选则已有的数据源或者新建数据源。

新建数据源需要输入数据源名称和Bace URL（接口IP或域名）注：新建前优先检查已有数据源中是否已经存在将要新建的数据源，如果有，则有限使用已有的，便于后期维护。

2. 在右侧组件配置面板中选择数据=>数据源类型为【API接口】（默认数据源类型是静态数据）。

3. 选择请求方式。提供5种请求数据的方法：

GET - 请求指定的页面信息，并返回实体主体；

POST - 向指定资源提交数据进行处理请求；

PUT - 从客户端向服务器传送的数据取代指定的文档内容；

DELETL - 请求服务器删除指定的页面；

PATCH - 是新引入的方法，是对PUT方法的补充，用来对已知资源进行局部更新。

请求方式GET/POST最为常用此处根据接口类型选择即可。

4. 填写需要请求路径。

注：若在BaseURL末已填写“/”，则无需重复填写

5. 填写需要请求参数。（&进行链接多个参数；: (英文字符冒号)后边接动态参数，直接使用，不能使用任何语法 ）

6. 在EasyV中调用其他应用的接口

• 请求链路

• 前端发起

• 调用目标接口必须支持跨域
• 浏览器所在设备与接口所在服务网络连通

• 后端发起

• EasyV后端服务与接口所在服务网络连通

• 需要cookie

情况一：通过前端调用，勾选cookie方式

如果cookie和EasyV产品地址同域，直接访问

如果其他认证方式，需要自己手动根据自己的认证方式添加

情况二：通过后端调用，同时勾选后端发起请求和需要cookie

如果cookie和EasyV平台同域，直接访问

如果cookie和EasyV平台不同域，需要自己手动添加Header的cookie字段

如果其他认证方式，需要自己手动根据自己的认证方式添加Header

字段映射

字段列表示组件所需的字段名称，映射列表示数据中将要匹配的字段。

在项目中，接入的数据大部分情况下和组件并不匹配，在数据结构匹配，仅字段不匹配时，通过字段映射可以快速实现字段的匹配。（注：轮播表格

例：获取到的结果中字段为 user，组件中所需的字段为 text，将映射列中的 text 改为 user 即可完成映射。

如果数据结构不相同，则需要使用数据过滤器进行处理。

数据过滤器

通过数据源获取数据后，如果数据不符合组件所需的数据格式，可以通过数据过滤器处理成符合需求的数据格式。（特性与用法https://dtstack.yuque.com/bndpr4/xm1b8g/kgmo4m8s6gdes132）

数据过滤器本质上是一个函数，包含固定参数 data 和 callbackArgs，data 为通过数据源获取的数据/前一个数据过滤器的返回值，callbackArgs 包含数据过滤器接收的回调参数（下面的回调参数中详细说明），return 所返回的值将向下传递。

每个组件都可以添加多个数据过滤器，处理顺序为从上向下，上一个数据过滤器的返回值将作为下一个数据过滤器的 data 参数，最后一个数据过滤器的返回值即为组件展示所用的数据。

点击测试按钮，弹出的窗口可以观察到数据处理的过程，原始数据中包含 s 值为 "系列二" 的数据，通过数据过滤器的处理后，结果中不再有 s 值为 "系列二"的数据。

再次过滤后，数据中将只剩下 y 值大于 200 的数据。

注：数据过滤器中不仅可以返回 JSON 格式数据，同样也可以返回字符串、数值、对象等多种类型的结果，一般在数据容器中这么使用，用于回调参数的中间处理。

自动更新

接入的 CSV/API 接口/数据库 数据可能会是动态更新的，需要定期更新，可以使用自动更新功能实现动态更新的效果。

开启自动更新后，平台会根据配置的时间间隔，定期发起请求获取最新的数据，组件也会根据最新的数据进行对应展示。