功能简介
智能连接 字段是一个非常强大的控件，可以灵活的获取任意 API 系统的数据
体验二维码
体验地址
说明
智能连接基本原理就是通过，捕获用户的操作，然后触发 api 然后请求数据，然后系统根据用户预设的提取规则，进行解析，然后更新表单的值。
使用场景有
- 快递查询
- 实时汇率查询
- 身份三要素校验
- 订单数据拉取。
整体流程
使用条件
使用智能连接 必须购买 openApi 功能包，或者是旗舰版及以上用户。
配置「智能连接」字段
文本输入框模式
触发类型
- 聚焦触发-- 当字段进行聚焦时进行触发。进行触发。
- 失焦触发–当用户输入完成后，离鼠标开控件时，进行触发。
- 按钮触发–用户单击按钮是进行触发。
下拉框模式
为了方便用户使用下拉框获取第三方多个数据，比如，获取某个品类下的所有商品。当点击下拉箭头的时候直接调用第三方数据，等待数据回来以后，展示所有结构。
和文字输入模式最大的区别是，不能进行自动更新其他控件的数据。
| 配置项名称 | 介绍 | 可填内容 | 补充描述 |
|---|---|---|---|
| URL | 第三方系统api的地址 | api 地址，以及字段插入 | 插入的字段会根据情况进行自动替换。 |
| 请求类型 | HTTP 发送的类型 | GET/POST | |
| Header | HTTP 请求的 header | 固定值，或者 根据条件过滤表单控件（研发中） | |
| 请求类型 | 目前支持 form 表单请求和 json 请求 | 必须填一个 | |
| Body | 如果是 form 表单即为kv 结构。如果为json 是文本，以及字段插入 | 可以为空 | |
| 结果提取 | 目前只支持 json 返回结果。 每一行为 别名 + 提取类型+ 表达式 2.别名不限制次数。 |
1. JSONPath 可以对 json 的数据格式进行提取。 2.别名可以在下面的更新表单控件进行设置 |
使用介绍https://github.com/json-path/JsonPath JSON 在线解析 http://www.atoolbox.net/Tool.php?Id=792 |
| 更新表单控件 | 根据上一步提取的结果，自动进行赋值 | 1.如果智能连接字段在主字段更新了子表单某一个字段，那么回来的数据会更新设置控件的整列数据。 2.如果 智能连接 字段在子表单中，那么更新数据只能更新这一行的设置字段。 |
示例–文本模式
如果我们是一个外贸公司，想要获取最新的实时汇率，然后计算人民币的价钱.
- 去阿里云市场购买相应的api
- 查看自己的验证信息，以阿里云为例
- 根据接口调用要求进行配置
- 获取 URL
- 查看api 校验条件，注意 CURL 的-h 就代表了 header 的参数
- 查看美元汇率。根据 json path 进行提取，注意一定要使用json 校验 确认无误后在调用，减少不必要的浪费。
- 获取 URL
- 设置 智能连接 信息
- 设置 url
- 设置 header
- 设置 body
不用设置 - 设置 jsonpath
- 验证 jsonpath
- 更新控件
提取结果会存在多个值的情况，如果您需要在此控件显示提取结果，请您在下方进行配置。 - 体验一下
- 设置 url
示例–下拉框模式
我们以某个城市下的区县为示例演示。
速融云为大家提供了全国区县的数据，帮助大家实现 地址 5 级联动的选项
api 的地址为： 请求方式为 get
1.如果不传任何参数，就是默认获取所有的省
2.如果查市区乡镇 必须要传省。
3.查询的只是当前的一级数据，例如，您查了北京市，返回只为 北京下的所有区
返回数据
{
"code":0
"districts":["银闸社区","居委会"]
}
- 设置为下拉模式
- 设置请求方式为 get
- 设置请求URL参数
- 设置提取数据–下拉的框，没有支持更新字段的设计。
- 效果演示。