简道云数据表单&审批表单查询写入方案配置指南

*在讲解前，先放一个比较重要的一个链接：

简道云开放文档：新建单条数据接口 - 简道云 - 开放平台 (jiandaoyun.com)

如何获取appid和entryid：

在简道云平台打开对应表单，选择编辑，在上方的地址栏可以看到对应信息

简道云平台查询表单数据配置方法：

​ 使用的适配器为：\Adapter\Jiandaoyun\JDYQueryAdapter，调用的接口为v2版本的：/api/v2/app/{app_id}/entry/{entry_id}/data，主键配置：_id

1. 在请求参数里配置通用参数：

   1. 应用id：appId
   2. 表单ID：entryId
   3. 需要查询的字段（可不配置，不配置默认返回全部字段）：fields
   4. 每页返回数量（1-100）：limit

2. 配置对应的过滤参数：

   首先配置过滤参数filter，类型为子表对象

   然后是在过滤参数这个子表对象下配置过滤逻辑（or或者and）：rel

   然后过滤条件的参数需要按照如下进行配置，括号内值可替换：

   字段	字段名	字段值	字段类型
   cond_1	自定义字段过滤		子表对象
   field	过滤字段	（updateTime）	字符串
   type	过滤类型	（datetime）	字符串
   method	过滤方法	（range）	字符串
   value	过滤值	（{{LAST_SYNC_TIME|datetime}}）	字符串

   如果有其他的过滤条件，在filter下新增一个字段，按照cond_1的方式进行配置即可，修改后缀为_2

   如需更多帮助，可查看简道云开放文档：查询多条数据接口 - 简道云 - 开放平台 (jiandaoyun.com)

   整体结构如下：

   

简道云平台写入表单数据配置方法：

​ 使用的适配器为：\Adapter\Jiandaoyun\JDYExecuteAdapter，调用的接口为v2版本：/api/v2/app/{app_id}/entry/{entry_id}/data_create

1. 在其他请求参数配置通用参数，括号内值可以替换：

   字段	字段名	字段值	字段类型
   is_start_workflow	是否发起流程（仅流程表单有效）	（false）	字符串
   is_start_trigger	是否触发智能助手	（false）	字符串
   transaction_id	事务ID		字符串
   app_id	应用ID		字符串
   entry_id	表单ID		字符串

2. 在请求参数配置需要写入的字段，字段id按照如下方法进行查询：

   在简道云打开对应表单，选择编辑，选择扩展功能页签，点击数据推送功能，选择字段对照表及json样例，圈住的内容即为字段id

3. *请求参数需要加入开启解析器：

      {
        "name": "ConvertObjectParser",
        "params": "value"
      }

4. 子表单需要按照如下格式进行配置：

   
   子表字段需要开启解析器