附录: jsonPath 与 json 模板

2785 上次更新时间:2021-02-21 19:56:08

Document

在我们的智能 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!