1.数据源

数据源主要为 4 大类，分别为静态数据、CSV 文件、API 接口和数据库。

每种数据源的配置界面都不同，其中 API 接口和数据库参数配置区域内可以使用回调参数（英文冒号后面跟动态参数）。

API 接口（以API接口为例，更多数据源使用及详情见添加不同数据源类型）

1.1添加数据

可以选择已有的数据源或者新建数据源。新建数据源需要输入数据源名称和Bace URL（接口IP或域名）

注：新建前优先检查已有数据源中是否已经存在将要新建的数据源，如果有，则优先使用已有的，便于后期维护。

如果需要新建数据源，可以在工作台中，选择对应的团队，右上角点击“数据源”。

进入后点击“新建数据源”配置数据源信息。

1.2配置数据

进入项目，选中相应的数据组件，在右侧组件配置面板中选择数据=>数据源类型为【API接口】（默认数据源类型是静态数据）。

1.3选择请求方式

提供5种请求数据的方法：

• GET - 请求指定的页面信息，并返回实体主体；
• POST - 向指定资源提交数据进行处理请求；
• PUT - 从客户端向服务器传送的数据取代指定的文档内容；
• DELETL - 请求服务器删除指定的页面；
• PATCH - 是新引入的方法，是对PUT方法的补充，用来对已知资源进行局部更新。

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

1.4填写需要请求路径和参数

参数：在BaseURL末尾已经填写过的“/”，则无需重复填写。

路径：（&进行链接多个参数；: (英文字符冒号)后边接动态参数，直接使用，不能使用任何语法 ）

1.5在EasyV中调用其他应用的接口

（1）请求链路

前端发起

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

后端发起

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

（2）需要cookie

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

如果cookie和EasyV产品地址同域，直接访问；如果其他认证方式，需要自己手动根据自己的认证方式添加。

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

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

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

2.字段映射

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

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

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

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

3.数据过滤器

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

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

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

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

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

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

4.自动更新

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

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