编辑收集表 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

第三方应用开发

快速入门服务端API 客户端API 运营规范附录更新日志联系我们

第三方应用开发服务端API 文档管理收集表编辑收集表

编辑收集表

最后更新：2023/06/13

该接口用于编辑收集表。

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/modify_form?access_token=ACCESS_TOKEN

请求包体

{
  "oper": 1,
  "formid": "FORMID",
  "form_info": {
    "form_title": "FORM_TITLE",
    "form_desc": "FORM_DESC",
    "form_header": "FORM_HEADER",
    "form_question": {
      "items": [
        {
          "question_id": 1,
          "title": "TITLE",
          "pos": 1,
          "status": 1,
          "reply_type": 1,
          "must_reply": false,
          "note": "NOTE",
          "option_item": [
            {
              "key": 1,
              "value": "VALUE",
              "status": 1
            }
          ],
          "placeholder": "PLACEHOLDER",
          "question_extend_setting": {}
        }
      ]
    },
    "form_setting": {
      "fill_out_auth": 0,
      "fill_in_range": {
        "userids": [
          "USER_1",
          "USER_2",
          "USER_3"
        ],
        "departmentids": [
          10001,
          10002,
          10003
        ]
      },
      "setting_manager_range": {
        "userids": [
          "USER_4",
          "USER_5",
          "USER_6"
        ]
      },
      "timed_repeat_info": {
        "enable": false,
        "week_flag": 0,
        "remind_time": 0,
        "repeat_type": 0,
        "skip_holiday": false,
        "day_of_month": 1,
        "fork_finish_type": 0
      },
      "allow_multi_fill": false,
      "timed_finish": 0,
      "can_anonymous": false,
      "can_notify_submit": false
    }
  }
}

参数说明

参数	类型	是否必须	说明
oper	uint32	是	操作类型。1：全量修改问题；2：全量修改设置
formid	string	是	收集表id
form_title	string	否	收集表标题（操作1修改）
form_desc	string	否	收集表描述（操作1修改）
form_header	string	否	收集表表头背景图链接（操作1修改）
form_question	object	否	收集表的问题列表（操作1修改）
items	object[]	是	问题数组
question_id	uint32	是	问题id，从1开始。如果是家校范围收集表，id从2开始。
title	string	是	问题描述
pos	uint32	是	问题序号，从1开始。
status	uint32	是	问题状态。1：正常；2：被删除
reply_type	uint32	是	问题类型。1：文本；2：单选；3：多选；5：位置；9：图片；10：文件；11：日期；14：时间；15：下拉列表；16：体温；17：签名；18：部门；19：成员 22：时长
must_reply	bool	是	是否必答
note	string	否	问题备注
placeholder	string	否	编辑提示
question_extend_setting	object	否	问题的额外设置。不同问题类型有相应的设置，详见question_extend_setting字段描述
option_item	object[]	是	单选或者多选题的选项列表
key	uint32	是	选项key（1，2，3...）
value	string	是	选项内容
status	uint32	是	选项状态。1：正常；2：被删除
form_setting	object	否	收集表设置（操作2修改）
fill_out_auth	uint32	是	填写权限。0：所有人；1：企业内指定人/部门。若收集表当前为家校范围，则无法修改。
fill_in_range	object	否	指定的可填写的人/部门
userids	string[]	否	企业成员userid列表
departmentids	uint64[]	否	部门id列表
setting_manager_range	object	否	收集表管理员
timed_repeat_info	object	否	定时重复设置项
timed_repeat_info.enable	bool	否	是否开启定时重复
timed_repeat_info.remind_time	uint32	否	提醒时间
timed_repeat_info.repeat_type	uint32	否	重复类型。0：每周；1：每天；2：每月
timed_repeat_info.week_flag	uint32	否	每周几重复，只能repeat_type = 0 时填写。1：星期一；2：星期二；4：星期三；8：星期四；16：星期五；32：星期六；64：星期日
timed_repeat_info.skip_holiday	bool	否	自动跳过节假日，只能repeat_type = 1 时填写。
timed_repeat_info.day_of_month	uint32	否	每月的第几天（1 - 31），只能repeat_type = 2时填写
timed_repeat_info.fork_finish_type	uint32	否	是否允许补填。0：允许；1：仅当天；2：最后五天内；3：一个月内；4：下一次生成前
allow_multi_fill	bool	否	是否允许每人提交多份。默认false
timed_finish	uint32	否	定时关闭。定时重复与定时结束互斥，若都填，优先定时重复
can_anonymous	bool	否	是否支持匿名填写。默认false
can_notify_submit	bool	否	是否有回复时提醒。默认false

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）
第三方应用需具有“文档”权限
代开发自建应用需具有“文档”权限

返回示例

{
	"errcode": 0,
	"errmsg": "ok"
}

参数说明

参数	类型	说明
errcode	int32	错误码
errmsg	string	错误码说明

创建收集表

获取收集表信息

本节内容

编辑收集表