智能连接字段

1700 上次更新时间:2021-02-21 16:17:32

Document

功能简介


智能连接 字段是一个非常强大的控件,可以灵活的获取任意 API 系统的数据


体验二维码


体验地址

说明

智能连接基本原理就是通过,捕获用户的操作,然后触发 api 然后请求数据,然后系统根据用户预设的提取规则,进行解析,然后更新表单的值。
使用场景有

  1. 快递查询
  2. 实时汇率查询
  3. 身份三要素校验
  4. 订单数据拉取。

整体流程

image.png

使用条件


使用智能连接 必须购买 openApi 功能包,或者是旗舰版及以上用户。

配置「智能连接」字段

文本输入框模式


触发类型

  1. 聚焦触发-- 当字段进行聚焦时进行触发。进行触发。
  2. 失焦触发–当用户输入完成后,离鼠标开控件时,进行触发。
  3. 按钮触发–用户单击按钮是进行触发。

下拉框模式


为了方便用户使用下拉框获取第三方多个数据,比如,获取某个品类下的所有商品。当点击下拉箭头的时候直接调用第三方数据,等待数据回来以后,展示所有结构。
和文字输入模式最大的区别是,不能进行自动更新其他控件的数据。




配置项名称 介绍 可填内容 补充描述
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.如果 智能连接 字段在子表单中,那么更新数据只能更新这一行的设置字段。

示例–文本模式

如果我们是一个外贸公司,想要获取最新的实时汇率,然后计算人民币的价钱.

  1. 去阿里云市场购买相应的api

image.png

  1. 查看自己的验证信息,以阿里云为例
    image.png
  2. 根据接口调用要求进行配置
    1. 获取 URLimage.png
    2. 查看api 校验条件,注意 CURL 的-h 就代表了 header 的参数
      image.png
    3. 查看美元汇率。根据 json path 进行提取,注意一定要使用json 校验 确认无误后在调用,减少不必要的浪费。
      image.png
  3. 设置 智能连接 信息
    1. 设置 url
      image.png
    2. 设置 header
      image.png
    3. 设置 body
      不用设置
    4. 设置 jsonpath
      image.png
    5. 验证 jsonpath
      image.png
    6. 更新控件    
      提取结果会存在多个值的情况,如果您需要在此控件显示提取结果,请您在下方进行配置。image.png
    7. 体验一下
      演示.gif

示例–下拉框模式

我们以某个城市下的区县为示例演示。

速融云为大家提供了全国区县的数据,帮助大家实现 地址 5 级联动的选项

api 的地址为: 请求方式为 get

1.如果不传任何参数,就是默认获取所有的省 2.如果查市区乡镇 必须要传省。 3.查询的只是当前的一级数据,例如,您查了北京市,返回只为 北京下的所有区 返回数据 { "code":0 "districts":["银闸社区","居委会"] }
  1. 设置为下拉模式
    image.png
  2. 设置请求方式为 get
    image.png
  3. 设置请求URL参数
    image.png
  4. 设置提取数据–下拉的框,没有支持更新字段的设计。
    image.png
  5. 效果演示。
    演示 2.gif