自定義鏈接參數API

什么是自定義鏈接

自定義鏈接是指：可以在普通問卷鏈接的基礎上添加參數，將參數值傳遞到問卷中，并存儲為問卷的答卷數據。

例如：您有自己的用戶系統，在為用戶配置問卷參與鏈接時，可以通過參數帶入用戶的各種信息，跟蹤答題狀態，回傳作答狀態及數據。

如果想做全局的配置，開發一次每個問卷都可以攜帶共同的一組參數，可以點擊此處了解。

場景案例

使用要求

免費版用戶無法使用自定義鏈接的功能。企業標準版及尊享版可使用默認的「sojumpparm」參數，無法添加更多參數。旗艦版及以上，不僅可以使用默認的「sojumpparm」參數，還可以添加更多的參數。

默認參數和添加題目參數

1、默認參數

問卷星默認會提供一個「sojumpparm」參數，通過此參數傳遞進來的數據，會保存在答卷的「來源詳情」的字段。該參數為：string類型（如果包含中文或特殊字符請使用UrlEncode編碼）、最大長度為100個字符。

2、添加題目參數

如果需要傳遞更多的參數，可以在頁面上點擊「添加參數」，這里添加的參數必須是問卷中的「填空題」、「單選題」或「多級下拉題」，所以需要在設計問卷時添加好對應的問卷題目，如果不想讓填寫者看到這些題目，可以將這些題目設置為隱藏狀態。

題目參數傳遞進來的數據，會存儲在對應的題目數據中，同填寫者正常作答的數據一致。題目參數的類型依據對應的題目類型的不同而不同，如「填空題」為字符串類型，「單選題」「多級下拉題」為選擇類型。

參數的代入

1、開發組裝鏈接參數

一般來說使用「開發組裝鏈接參數」都需要貴方開發人員參與，依據本篇文檔進行自定義鏈接參數的組裝，帶入貴方系統中的必要字段。需要注意的是：如果添加了多個參數，則只能通過「開發組裝」的方式來使用「自定義鏈接」。

2、開發POST參數

「開發POST參數」也需要貴方開發人員參與，通過POST的方式，將參數帶入。

POST地址：問卷的通用地址，可以在「鏈接與二維碼」頁面獲??；

數據格式：x-www-form-urlencoded；

參數帶入：以鍵值對形式帶入，參數名及參數值的計算同「鏈接傳參」一致。

3、手動填入

如果只使用一個參數，則可以在問卷星后臺手動批量生成帶參數的鏈接。如果是「sojumpparm」默認參數和「字符串」的參數，可以批量上傳一批參數值然后下載獲取對應的鏈接與二維碼。如果是「選擇類」參數，則無需上傳就可以直接批量導出帶參數的鏈接與二維碼。

關鍵參數

關鍵參數是用來控制「 每個關鍵參數值可作答次數」這個功能的，默認情況下是「sojumpparm」這個參數，添加多個參數后可以修改為其他的參數。

數據查詢

傳遞參數時帶入isquery參數就可以控制當前訪問是「作答」還是「查詢」，其中參數值為0時為作答問卷，參數值為1時為查詢答卷。isquery參數可以為空，為空時默認為作答問卷，isquery參數也不參與parmsign參數的簽名計算。

安全配置

1、「只允許從自定義鏈接訪問」，勾選后只能通過自定義鏈接參數作答，普通問卷鏈接會提示無法訪問。

2、「增加過期時間」，勾選后生成的自定義鏈接參數會增加一個過期時間戳字段（endts），超過后鏈接將失效。

3、「校驗參數簽名」，勾選后生成的自定義鏈接參數會增加一個簽名字段（parmsign），如果有人篡改參數值，鏈接將失效。

4、「提交后再次訪問可查詢作答記錄」，勾選后用戶在「沒有達到訪問次數」前可以正常訪問作答，在「達到訪問次數」后將直接進入答卷頁面。需要注意的是：這里的設置效果同「 每個關鍵參數值可作答次數」有強關聯。

DEMO

為了方便用戶進行開發調試，增加的任何參數或設置，均可以在「鏈接參數URL預覽」中體現，并且系統還提供了一個「DEMO」生成的功能，可以手動輸入參數進行調用測試。

回傳參數

帶入的參數，如果想回調到自己系統，可以在「設計問卷」》「問卷設置」》「提交后顯示」》「跳轉到指定頁面」中設置一個回調地址，并且按如下規則在回調地址中寫入之前帶入的參數。

默認「sojumpparm」參數的回調寫法{output}，需特別注意「sojumpparm」的回調寫法并非是{sojumpparm}，如果傳遞sojumpparm有進行簽名校驗，那在跳轉時也會帶上wjxsign的簽名參數以保證安全性。

q1參數的回調寫法為[q1]，其他序號題目依次類推。

在問卷頁面中顯示帶進來的參數

問卷頁面支持將默認的「sojumpparm」參數顯示在段落說明或題干中。插入方法：將[sojumpparm]這個字段輸入在段落說明或題干中，如下圖所示（顯示帶進來的參數僅限尊享版用戶使用）：

示例：http://www.njsvitsolutions.com/jq/37943379.aspx?sojumpparm=張三

關于循環評價題的自定義鏈接參數設置

比如用戶在“循環評價題”中設置了20個被評價對象，但本次只需要用戶固定評價其中的5個，則可以使用自定義鏈接進行設置，參數配置為對應的題號和被評價對象序號，各個序號用逗號隔開即可：如：q2=1,2

用戶用配置了自定義鏈接參數作答，“循環評價題”中即可自動選中1、2個被評價對象，無需用戶再進行選擇

自定義鏈接參數API_舊版文檔