預設模板

本指南介紹 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 使用，參數值需從業務系統動態取得並拼接到存取連結中。

- 修改預設模板問卷後，請同步檢查參數映射是否與現有對接邏輯一致。