在我们的智能 api 和 webhook 和智能连接控件 我们采用了jsonPath 与 json 模板 帮助我们实现更加灵活高效的对接。所以我们专门解释下什么是 jsonPath和 json 模板
基础概念
1. jsonPath
一种可以快速提取 json 字符串数据的语法,用来提取给定JSON文档的部分内容,JsonPath提供的json解析非常强大,它提供了类似正则表达式的语法,基本上可以满足所有你想要获得的json内容。
示例:
这是一个非常简单的 jsonPath 示例,我们想要提取,json中 username 字段, 则可以通过 $.username 即可直接提取。
平台在 jsonPath 填写的地方内置 jsonPath 验证器,方便大家做数据校验。
想要了解更多请查看 https://www.cnblogs.com/wynjauu/articles/9556396.html
2.json 模板
json 模板为速融云平台自主创新研发出来的基于用户预设的模板,实现数据自动填充到模板。这种概念类似于 js 的模板替换。通过这样的设计可以实现开放平台接口的千人千面。而不必拘泥于官方指定的数据格式。
示例:我们批量获取表单数据设置返回的内容。
注意事项
jsonPath
-
1.请确保 jsonPath 语句的有效性,最好使用前先手动校验。
-
2.请保证 jsonPath 提取的数据需要与控件需要的类型保持一致,否则会导致公式等计算错误
json 模板
-
1.设计 JSON 模板时,(单行文本、多行文本、智能引用、下拉框、手机号等字符类型控件无需添加双引号)
-
2.在设置JSON 模板时,请务必保证字段名与字段类型保持一致。否则系统将会过滤掉不合法的字段模板.特别是修改控件名称以后,需要更新控件值。
-
字段模板构造示例: $${SINGLELINE_ke2gu300UkvW107H#表单名称}$$ SINGLELINE_ke2gu300UkvW107H为字段 ID 表单名称为控件名称。
视频教程
coming soon!