简道云数据表单和审批表单查询与写入配置指南
简道云数据表单与审批表单查询写入配置指南
简道云开放文档：新建单条数据接口-简道云-开放平台
获取appid和entryid
在简道云平台打开对应表单，选择编辑，在上方的地址栏可以看到对应信息
查询表单数据配置方法
使用适配器：\Adapter\Jiandaoyun\JDYQueryAdapter，调用接口为v2版本：/api/v2/app/{app_id}/entry/{entry_id}/data，主键配置：_id
配置通用参数
- 应用id：appId
- 表单ID：entryId
- 查询字段（可选）：fields
- 每页返回数量（1-100）：limit
配置过滤参数
首先配置过滤参数filter，类型为子表对象。然后在过滤参数这个子表对象下配置过滤逻辑（or或者and）。
| 过滤条件的参数需要按照如下进行配置： | 字段 | 字段名 | 字段值 | 字段类型 |
|---|---|---|---|---|
| cond_1 | 自定义字段过滤 | 子表对象 | ||
| field | 过滤字段 | （updateTime） | 字符串 | |
| type | 过滤类型 | （datetime） | 字符串 | |
| method | 过滤方法 | （range） | 字符串 | |
| value | 过滤值 | （{{LAST_SYNC_TIME|datetime}}) | 字符串 |
如果有其他的过滤条件，在filter下新增一个字段，并按照cond_1的方式进行配置即可，修改后缀为_2。
更多帮助请查看查询多条数据接口-简道云-开放平台
整体结构如下：
写入表单数据配置方法
使用适配器：\Adapter\Jiandaoyun\JDYExecuteAdapter，调用接口为v2版本：/api/v2/app/{app_id}/entry/{entry_id}/data_create
配置通用参数（括号内值可以替换）
| 字段 | 字段名 | 字段值 | 字段类型 |
|---|---|---|---|
| is_start_workflow | 是否发起流程（仅流程表单有效） | （false） | 字符串 |
| is_start_trigger | 是否触发智能助手 | （false） | 字符串 |
| transaction_id | 事务ID | 字符串 | |
| app_id | 应用ID | 字符串 | |
| entry_id | 表单ID | 字符串 |
配置需要写入的字段
在简道云打开对应表单，选择编辑，选择扩展功能页签，点击数据推送功能，选择字段对照表及json样例，即可找到字段id。
请求参数加入解析器
{"name":"ConvertObjectParser","params":"value"}子表单配置格式示例：
子表字段需要开启解析器