1. 新建数据源
1.1 如何新建数据源
点击 「添加」按钮,即可开始创建一个新的数据源,可以新建的数据源分为三个种类,用户在新建时可以选择其中一个种类,新建完成后该类型不允许切换。- 变量 :本地变量
- 远程请求 :从一个服务端接口中获取的数据
- 参数数据源: 系统默认传入该数据源,用于获取当前 url 中的参数。 例如 url 是 a.html?key1=value1&key2=value2 时,参数数据源的值为:
1.2 变量数据源
变量数据源一般用于保存配置项(如远程接口前缀 apiUrlPrefix)、页面临时变量等,支持字符串、对象、数组、数字、bool 等所有 JS 数据类型。1.3 远程请求
接口返回数据格式 远程数据源对数据的格式有少量的必要的限制:- GET
- POST
- JSONP 该方式需要服务端支持
1.4 自动加载
开启了「自动加载」的数据源会在页面渲染之前请求远程接口,所有自动加载的数据源加载完成之后才开始渲染页面。一般用于页面初始数据的加载 注意:过多的「自动加载」的数据源将导致页面渲染时间延长,请勿滥用。1.5 加载方式(需先打开自动加载选项)
串行:所有串行数据源会从上到下执行,如果有相互依赖的,被依赖的数据源需要在前面 并行:所有并行数据源同时执行 如果不想选择自动加载,避免请求阻塞页面渲染,但是又想达到串行加载的效果,目前的方式是,在「页面加载完成时」的函数中,手动触发数据源加载。调用示例如下:触发第一个远程数据源请求,请求返回之后再触发第二个远程数据源请求。
1.6 是否请求
支持传入一个布尔值,通过这个变量去判断这个请求是否应该发出。这个输入域也可以输入变量表达式以决定是否需要发送请求。1.7 willFetch
请求发送前处理函数;willFetch 允许用户在发送请求前修改请求的各种参数。示例:1.8 fit
请求返回时的数据适配;fit 可以修改请求的原始 Response 以适配对应的数据请求格式。示例:1.9 didFetch
请求完成回调函数;didFetch 允许用户对接收到的数据进行修改, 和 fit 不同的是, 接口返回的 success 为 true 才会执行。示例:1.10 onError
请求错误处理函数;onError 用于捕获远程数据源的接口异常,接口返回的 success 为 false 时会执行, 示例:1.11 默认数据
默认数据一般用于首屏渲染的场景,可以在远程数据源请求未返回时,给一个初始化的默认值。注意:默认数据的数据格式是 DidFetch 那层返回的数据格式,可以直接绑定使用。1.12 连接器数据源 NEW
连接器数据源中可以将连接器作为数据源,旨在打破系统/网页间的跨域、鉴权限制,详细介绍请参考文档使用自定义连接器解决跨域问题。2. 使用数据源
2.1 组件内绑定
在宜搭组件的属性设置面板中,我们可以给一个属性绑定一个变量,以达到动态的效果。方法如下:- 所有支持变量的属性都有如下图标,点击图标可打开「变量绑定面板」

- 「变量绑定面板」支持绑定如下类型的变量, 可通过点选直接使用:

2.2 开发者中心体验试玩
- 点此链接体验试玩
3. 常见问题
3.1 数据源请求后,无数据。
请确认:- 您的接口的路径和请求方式等等是正确的。
- 默认请求已开启或者手动调用已生效。
- 请求的接口服务所在服务器存在访问白名单限制。
- 入参格式不正确。
- 您的接口支持 www.yidaapps.com 的跨域访问。
- 您的接口是 https,并且证书是「安全」的。
3.2 排查思路
- 判断数据源的加载方式是 手动加载 还是 自动加载 ,如为 手动加载 ,请在数据源加载代码处 打断点 便于调试。
- 预览/访问页面。
- 打开浏览器控制台。
- 触发数据源加载。
- 查看控制台内对应请求信息进行排错。

3.3 调用宜搭平台接口时,报错307?
请检查你的组织是否开启了二级域名,若开启二级域名应该将接口访问地址由www.yidaapps.com/...更换为相对地址/dingtalk/web/APP_X1X2X3X4/v1/process/startInstance.json即可避免该错误的出现。