更新时间:2024-11-21 GMT+08:00

问卷星

问卷星连接器用于实现在工作流中通过配置操作问卷星相关功能。

问卷星是一个专业的在线问卷调查、考试、测评和投票平台,专注于为用户提供功能强大、人性化的在线设计问卷、采集数据、自定义报表、调查结果分析等系列服务。

创建问卷星连接

  1. 登录新版ROMA Connect控制台。
  2. 在左侧导航栏选择“连接器”,在连接器页面单击“新建连接”。
  3. 选择“问卷星”连接器。
  4. 在弹窗中配置连接器信息,完成后单击“确定”。

    参数

    说明

    连接名称

    填写连接器实例名称。

    开发ID

    填写问卷星的开发ID。

    开发密钥

    填写问卷星的开发密钥。

    描述

    填写连接器的描述信息,用于识别不同的连接器。

支持的动作

  • 更新问卷状态
  • 获取问卷列表
  • 获取问卷详情

配置参数

表1 更新问卷状态

参数

说明

问卷编号

填写问卷编号。

Unix时间戳

用于请求的有效期检查,有效期时间为请求时间起30s内。需填写请求调用时的Unix时间戳。(Unix时间戳:格林威治时间1970年01月01日00时00分00秒起至请求调用时间的总秒数)

是否使用缓存

指定查询类接口是否使用缓存,默认值为“是”。

问卷状态

选择问卷状态。

  • 发布或运行
  • 暂停
  • 删除
表2 获取问卷列表

参数

说明

Unix时间戳

用于请求的有效期检查,有效期时间为请求时间起30s内。需填写请求调用时的Unix时间戳。(Unix时间戳:格林威治时间1970年01月01日00时00分00秒起至请求调用时间的总秒数)

是否使用缓存

指定查询类接口是否使用缓存,默认值为“是”。

问卷发布者

不填时获取主账户发布的问卷,企业微信子账户需要在子账户名前加“qw$”前缀。

问卷编号

输入问卷编号。

文件夹名

获取该文件夹的问卷。

问卷名模糊查询关键字

不能包含特殊字符,精确匹配问卷名中包含模糊关键字的问卷,长度不超过10个字母或汉字。

查询开始时间戳

查询此时间戳以后的问卷(含节点时间),Unix时间戳(格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数)。

查询结束时间戳

查询此时间戳以前的问卷(不含节点时间),Unix时间戳(格林威治时间1970年01月01日00时00分00秒起至现在的总毫秒数)

分页页码

默认值为1,即返回第1分页。

分页大小

默认分页数为10,最大分页数为300,超过最大分页数时,使用默认分页数10。

是否获取企业的所有问卷

“是”表示获取企业的所有问卷,“否”表示仅获取主账户的问卷,仅在creator为主账户时有效,默认为“否”, 即仅获取主账户的问卷。

是否仅获取星标问卷

“是”表示仅获取星标问卷,“否”表示获取星标与非星标问卷,默认为“否”。

按时间查询类型

选择查询类型。

  • 不按时间查询
  • 按问卷开始时间
  • 按问卷创建时间

排序规则

选择排序规则。

  • 按问卷编号升序
  • 按问卷编号降序
  • 按问卷开始时间升序
  • 按问卷开始时间降序
  • 按问卷创建时间升序
  • 按问卷创建时间降序

问卷状态

获取指定状态的问卷。

  • 未发布
  • 已发布
  • 已暂停
  • 已删除
  • 彻底删除
  • 被审核

问卷审核状态

获取指定审核状态的问卷。

  • 已通过
  • 审核中
  • 未通过
  • 待实名
表3 获取问卷详情

参数

说明

问卷编号

输入问卷编号。

Unix时间戳

用于请求的有效期检查,有效期时间为请求时间起30s内。需填写请求调用时的Unix时间戳。(Unix时间戳:格林威治时间1970年01月01日00时00分00秒起至请求调用时间的总秒数)

是否使用缓存

指定查询类接口是否使用缓存,默认值为“是”。

是否获取题目信息

选择是否获取题目信息,默认值为“是”。

是否获取题目选项信息

选择是否获取题目选项信息,默认值为“是”。

是否获取问答选项列表

选择是否获取问答选项列表,默认值为“否”。

是否获取题目设置信息

选择是否获取题目设置信息,默认值为“否”。

是否获取分页信息

选择是否获取分页信息,默认值为“否”。

是否返回简洁数据

选择是否返回简洁数据,默认值为“否”。

  • 是:参数值为“是”时,是“否获取题目信息”、“是否获取题目选项信息”、“是否获取问答选项列表”、“是否获取题目设置信息”、“是否获取分页信息”的配置不生效。

数据是否返回json格式

仅“是否返回简洁数据”配置为“是”时生效。

选择数据是否返回json格式,默认值为“否”。

是否返回问卷标题

仅“数据是否返回json格式”配置为“是”时有效。

选择是否返回问卷标题,默认值为“否”。