默认模板

本指南介绍 SurveyMars「默认模板问卷」的使用方法。默认模板问卷可将用户 ID、姓名、手机号码、邮箱、用户类型等基础信息作为用户层级的公共参数，统一预留在新创建的问卷中，便于开发人员通过链接传参完成系统对接，业务人员只需关注业务相关题目。

用途说明

SurveyMars 提供了自定义链接参数 API 功能，可在访问问卷时携带 paramuid 参数，也可将问卷中的某个题目作为参数，通过链接传参的方式自动作答对应题目。

以上方案存在一些不足：每个问卷都需要独立配置；若要传递的是题目参数，题目位置不同，参数名就需要根据问卷题目频繁变动。

为解决这些问题，可使用默认模板问卷方案：将固定的基础题目作为全局公共参数，统一预留在新问卷中，系统题号（题目参数名）保持固定，便于系统对接。

方案整体流程

从空白创建问卷时，问卷中没有任何题目。使用本方案的完整流程如下：

1. 主账号首先创建一个问卷（可包含用户 ID、姓名、手机号码、邮箱、用户类型等基础信息），并设置为默认模板问卷。

2. 其他子账户创建问卷时，会默认预留这些字段，且题目字段的系统题号（即题目参数的参数名）固定不变。

3. 业务人员创建问卷时，只需关注业务相关题目；开发人员可结合自定义链接参数 API，通过传参方式自动填充默认模板题目。

创建并设置默认模板问卷

题型限制

默认模板问卷仅支持以下题型：填空题（不得添加除「姓名」外的属性验证）、单选题、多选题、多级下拉题。如添加其他题型，将不能被设置为默认模板问卷。

设置限制

仅账户创建者可以将问卷设置为默认模板问卷，其他子账户均无权限进行默认模板问卷设置。

设置入口

进入 "我的账户" > "我的公司" > "企业模板库"，点击 "设置模板问卷"，在下拉列表中选择之前创建的模板问卷。

子账户创建问卷并使用

设置了默认模板后，其他子账户在使用时是完全无感的。

- 在没有传参前，问卷不会出现默认模板问卷中的题目。

- 只有在有传参行为后，问卷中才会出现默认模板问卷中的题目。

- 这些题目的系统题号从 30001 开始。

如何传递参数（针对开发者）

设置了默认模板问卷后，可在任何新创建的问卷中进行开发测试。新问卷中均预留了默认模板问卷题目的位置。默认模板问卷中的第 1 题，对应普通问卷的 第 30001 题，依次类推。结合自定义链接参数 API 中的题目参数，即可通过链接传参自动作答对应题目。

带参数链接示例如下：

https://surveymars.com/q/39k0U1zv5?paramuid=1&q30001={变量1}&q30002={变量2}&q30003={变量3}&q30004={变量4}

- q30001、q30002、q30003、q30004 分别对应默认模板问卷中的第 1、2、3、4 题。

- {变量1}、{变量2}、{变量3}、{变量4} 需要在贵公司业务系统中取得变量值。配置时为变量占位，单个用户访问时需替换为该用户的对应值。

常见问题

Q：是单问卷配置还是全局配置？

A：理论上设置了默认模板问卷后是全局配置。但如果问卷没有任何传参行为，其问卷结构不会有任何变化；只有在有传参行为后，问卷中才会出现默认模板问卷中的题目。因此，若访问链接未携带相应参数，该问卷就不会应用此全局配置。

Q：谁可以设置默认模板问卷？

A：仅账户创建者可以设置，其他子账户无此权限。

Q：默认模板问卷支持哪些题型？

A：仅支持填空题（除「姓名」外不得添加属性验证）、单选题、多选题、多级下拉题。添加其他题型将无法设置为默认模板问卷。

注意事项

- 仅账户创建者可设置默认模板问卷，请确认操作账号权限。

- 默认模板问卷的题型有限制，创建模板时请严格遵守，避免无法保存设置。

- 无传参行为时，新问卷不会显示默认模板题目；传参后题目才会出现，系统题号从 30000 开始。

- 默认模板第 N 题对应参数名为 q(30000+N) 格式，如第 1 题为 q30001，第 10 题为 q30010，开发人员对接时请保持题号映射一致。

- 传参需结合自定义链接参数 API 使用，参数值需从业务系统动态获取并拼接到访问链接中。

- 修改默认模板问卷后，请同步检查参数映射是否与现有对接逻辑一致。